Technical Articles
SAP Process Integration Test Tool (PIT) – News in SP19
SP19 comes with enhancements in the monitoring area as well as the new functions message preprocessing and an dataset editor.
Monitoring
You can include or exclude test messages from the display list by checking “Include test messages” checkbox in the Custom Settings area of the Table Settings dialog.
Test Dataset Editor
Please keep in mind that test datasets and their test messages are immutable. In order to ensure that continuous test verifications with a dataset produce meaningful, comparable and consistent results, we do not allow any modifications. Consequently, you can only create new datasets with the editor. Even when you save a modified dataset, you do not update the object. Instead the editor internally replaces it with a corresponding new object. In fact, the save-functionality just offers you a shortcut for deleting an existing – and so far unused – dataset and creating a new one with a modified test message list and the previous name.
In case you would like to create a modified variant of a dataset which is already used in run configurations, just change it in the editor and then select Save As in the File menu. A regular Save is not possible in this case because such a dataset cannot be deleted and replaced. Therefore, after creating the new modified dataset, you will need to close the original editor without saving. Using the Save As functionality, it is of course also possible to create unmodified copies of existing datasets.
You can merge test data set and transfer test messages with copy, cut, and paste between data sets only if the datasets are compatible. Two datasets are compatible if they reference the same configuration object and are extracted from the same test system.
Copy: adds the selected test messages to an internal clipboard.
Paste: adds the test messages from the internal clipboard to the dataset.
Cut: deletes the selected test messages from the dataset and adds them to an internal clipboard.
Delete: deletes the selected test messages from the dataset.
Use the find functionality if you are interested in a particular message identifier which you ideally have already copied to the clipboard, for example from the NWA message monitor. The text field also offers an input-assist to complete identifiers in case you can memorize the first 2 or 3 digits.
Copy Test Case
It is possible now to create a copy of a Test Case using the Save As menu item in SAP NetWeaver Developer Studio (NWDS) . To copy a test case open it and select the menu File -> Save As. A new dialog opens and you can provide a new name. It must be a new, unique name. You can also decide if existing datasets should be taken over to the new Test Case as well.
Message Preprocessing
Message preprocessing allows you to replace values in the payload or values of dynamic headers on the fly before the message is injected in the target system. The replacement can be valid for all system combinations or only for one specific system.
Message preprocessing can be defined as part of a test case. You must create a preprocessing ruleset to define substitution rules to apply to the message.
Each preprocessing ruleset contains at least one preprocessing rule. The rule is applicable to a specified area – currently you can choose between payload or dynamic header. It contains at least one preprocessing instruction with a specified substitution flavor.
Each preprocessing instruction must contain either for the ‘Payload’ area a valid Xpath expression which points to an XML node or for the ‘Dynamic Header’ name and namespace.
You can combine preprocessing instructions pointing to the same or to different Xpath expressions/headers within one preprocessing rule. At runtime, a value will be only replaced, if the corresponding XML node/header is found in the message and there is a suitable instruction for it. It is not possible to add or to remove an XML node or header into/from the message. A preprocessing instruction supports the usage of “*” wildcard which means ‘arbitrary value´.
Select this option to apply an existing replacement rule. If there are no replacement rules defined for the test case, this option is unavailable.
In the run configuration you can decide which preprocessing ruleset should be used at runtime. Only one preprocessing ruleset can be used per run.
The verification logs whether a message was modified by the preprocessing logic are also impacted. In the target system, its Before Mapping version will be different than in the source.
Payload preprocessing can also have implications on the outgoing message version, namely when the value from the incoming message is taken over to the outgoing message during mapping. Such differences are not exempted by default and must be exempted manually.
More Information about the PIT can be found in SAP Help Portal with direct links to
Message Preprocessing and Dataset Editor.
and please have also a look at the other blogs for the SAP Process Integrated Test Tool.
SAP Process Integration Test Tool (PIT) – First Steps
SAP Process Integration Test Tool (PIT) – Create and Execute a Test Case
SAP Process Integration Test Tool (PIT) – News in SP15
SAP Process Integration Test Tool (PIT) – News in SP16
Dear Elke,
I have been following your blogs about PIT, and it has been a long awaited feature. It is good to see that we now get a chance to better protect and validate our developments before passing them onto business experts and productive systems.
I have been testing various scenarios, and PIT looks good. However, I am having some issues with the B2B scenarios, where the EDI-Separator is used. Can you verify whether this adapter is supported by PIT? I am not able to view the recorded payload, so I cannot tell whether it is the raw EDI payload or the EDI-Separator parsed XML, that is recorded. But there seem to be a problem passing this payload onto the PIT test/target system. All my other non-EDI-Separator scenarios are working fine. The B2 scenarios represents a significant part of the scope, and there wil loften be a stricter requirement for regression testing B2B. So I find it crucial that the EDI-Separator is supported by PIT. If not, I would suspect that it will be pointless to implement global PIT governance in a large scale PO landscape.
Thank you for sharing.
Best regards, Emil Jessen
Dear Emil,
The PIT Tool don't support any adapter - SAP Help NW 7.5 SP20 .
But to take a look at the details - it would be good, if you can open a ticket at BC-XI-PIT
We need the description of the scenario as well as the error message.
Best Regards,
Elke