Skip to Content
Technical Articles

SAP Process Integration Test Tool (PIT) – First Steps

For an Overview about the PIT Tool please read the Blog

Process Integration Test Tool shipped with sap process orchestration

The PIT Tool is a framework with which you can setup automatic tests for process integration scenarios. The main idea is that successfully processed messages are extracted from the runtime of either an SAP Process Integration or a SAP Process Orchestration system (sources system). Those messages are stored in the PIT system’s data base and can later be replayed on a different system (target system). The replayed messages are gathered from the target system after the run. The results can be compared against the reference messages from the source.

In this very first version we can collect messages on the source side from “classical” PI dual stack scenarios, Integrated Configuration Objects (ICO) and Integration Flows. On the target side we support ICOs and Integration Flows.



Sources System

  • System has at least PI/PO 7.31 SP 17 or PI/PO 7.50 SP6 with patch level according to SAP Note 2650265 
  • SAP Notes 2650265, 2739354 and 2707854 are installed on the systems
  • Only successfully processed messages are extracted
  • Log with Payload is enabled for all three stages (BI, MS, AM) – that means logging shall be enabled for a particular scenario – SAP Help – how to turn the logging on

Target System

  • Target system is PI-AEX or PO with at least 7.50 SP 14 with the latest Kernel Patch level
  • For setting up the PIT tool at the target system, the CTC called PI Test Tool Target can be carried out. The following parameters will be set:
    • Injector application is deployed and running, and application property pit.injector.enabled = true
    • For synchronous messages an HTTP destination should exists, which points to PIT and property contains the name of the destination (retrieve the response of the sync message) Default destination name PIT_SYSTEM need a user with the action pit_resp_retriever

Test Tool (PIT) System

  • the PIT system is PI-AEX or PO with at least 7.50 SP 14 with the latest Kernel Patch level
  • The configuration is done via CTC PI Test Tool 
    • JobHandlerJob is planned
  • A HTTP or RFC destination is created in NWA for each system which shall be connected to PIT (HTTP and RFC in case of a Dual Stack Sources System)


The Configuration and the Test Run Starts will be done in the NetWeaver Developer Studio (NWDS)

Entry point in NWDS

Open the Perspective SAP Process Integration Test


Open preferences “SAP Process Integration Test” and define connection to PIT Tool system.



Now you are able to connect to the PIT System.



Now you can start to configure the Landscape.

Please have in your mind that each system that you connect to the PIT Tool System needs an http destination and each connected PI Dual Stack system also an RFC destination. This should be created in the NWA before maintaining the Test Systems in the PIT Test System Browser.

Don`t use the destination PIT_SYSTEM for this connection. It is a destination on the target system pointed to the PIT System for synchronous messages only.


Then you can start to add and to configure the test systems



You have a few possibilities for the Authentication Mechanism.

for more information please take a look at the SAP Help – Create Test System

The same system can be used as sources, PIT and target systems depending on the use case as long as it is a Java ( PI-AEX or PO) System with NW 7.50 SP14. In the migration use case, source and target system are different, in the regression use case however source and target may be the same.

Starting with SP15 the Decentral Adapter Engine is supported.

It can be loaded from the SLD or maintained manually.

After having setup the test landscape in your PIT System, you can start creating the first Test Case. For this, please check out the following blog.

SAP Process Integration Test Tool (PIT) – Create and Execute a Test Case



You must be Logged on to comment or reply to a post.
  • 24 minutes ago | 2 Views

    Hello Elke,

    In your blog you said the following :

    System has at least PI/PO 7.31 SP 17 or PI/PO 7.50 SP6 with patch level according to SAP Note 2650265

    –> Do it mean that the source system can’t be anPO 7.40 ?

    It is not clear which release for the “Source System” is supported by the tools as I understood from your sentence 7.31 or 7.50 and not 7.40….?

    It should be supported as from 7.XX to 7.XX but here as you mentionned only 2 release with an “or” I’m confused.

    Thanks in advance for the clarification


    • Hi,


      You can use as Source system all 7.31 SP 17 and higher.

      You can use all 7.40 System with the equivalent SP from 7.31. SP17 – this is Java SP12 and SPS14  and higher.

      You can use all 7.50 Systems 7.50 SP06 and higher.


      Best Regards,

      Elke Döring

  • HI Elke,

    As this is a new tool i want to use it but before that i need some clarity.

    1. Basically this tool is used to check the compatibility of the old message in the new PO environment. Do we need to configure everything in the target system like configuring the module beans or else deploying the java mappings , graphical mappings or else any other objects.
    2. Will it work in case of BPM scenarios that means in my source system we are using BPM’s then we want to migrate them in this case how it’ll be useful.
    3. For this tool to work do we need separate PI box ?




    • Hi Satish,

      1. You have to have the same directory configuration on both systems.
      2. No
      3. No – you can use an existing PO or PI-AEX system – but please have in you mind that the message will be stored in the DB of this system.

      Best Regards,


  • Hi Elke,


    thanks for the nice blog, this is a tool with really great potential.

    A question though. Following your instructions, I am looking for the PIT perspective in NWDS 7.50 but it looks like it does not exist. Is there a specific version we need to have? Currently have downloaded 7/5/012/0009,




    • Hi Markos,


      The PIT client is implemented as an NWDS Plug-In.

      You have selected the new perspective (SAP Process Integration Test Tool) in the NWDS, as described here: Understanding User Interface.

      You need at least a NW 7.50 SP14 version.


      Best Regards,

      Elke Döring

  • Hi Elke,


    Thanks for this blog. These seems to be powerful tool especially for migration/regression tests.

    We are currently on PO 7.5 SP11. I can see the option of test tool in NWDS perspective (using 7.5 SP14 version) but when I try to connect to this perspective, I get an error as ‘Login failed, you are not authorized).

    I know that its not supported by SP11 but will it not even allow us to use this perspective on SP11? Could it be problem with roles?




  • Hi Elke,

    just for clarify: do we need PO or is PI enough?

    In you description you write that Source, Target and Test-Tool System must be PO or PI-AEX. But the link says “shipped with Process Orchestration” ??

    So: PI-AEX (Single-Stack) is enough?


    What about licenses? Do we need a special license for the Test-Tool-System?




  • Hi Varinder,


    The PIT Software is shipped with NW 7.50 SP14 only. So you can’t use it on SP11.


    Hi Rene,

    A PI-AEX is enough for the Test Tool and the Target.

    As Source Systems you can also use PI Systems and also older version of it.


    Best Regards,


  • HI Elke ,


    Even i am using NWDS 7.5  SP15  i am getting same issue .

    while trying to connect PIT i am getting “Login failed you are not authorized” . Is it required below roles need to add on my user before login PIT ?




    Ramanjaneya Reddy

  • Hi Elke,

    I am using NWDS 7.5 SP14 but getting error as ” Cannot create a new test system. Details: ‘pwctrl’ can not be mapped as a property or an annotation. [HTTP/1.1 400 Bad Request]”. Do you please suggest if i am missing something here?


    Gaurav Kant

    • Hi Gaurav,

      please make sure that the latest patchlevels of the PIT Server and NWDS are installed on your system. If the issue persists even with the latest patch, please open a ticket for that issue in component BC-XI-PIT.


      Kind regards,


  • Hello SAP team,

    Can you please clarify on below:

    1. Would it be possible to connect other PO environments from PIT to fetch test messages?
    2. When a test message is triggered from PIT, It is possible to see the message status in NWDS-PIT monitoring tool. But we can’t find any data transmission on SAP PO-Message Monitoring. Is that expected?
    3. What is the retention period of messages triggered from PIT? Is it same as the retention period set in SAP PO system on which PIT is connected to?
    4. In latest versions, Is it possible to use PIT for SAP CPI testing?



    • Hi Naresh,

      1. the Source Systems can be at least PI/PO 7.31 SP 17, PI/PO 7.40 SP12 or PI/PO 7.50 SP6 with patch level according to SAP Note 2650265 

      2. The Messages sended to the Target System can be seen in the normal message monitor. They have all the Connection Name PITTEST

      3. the Messages triggered by the PIT Tool have the same live cycle as all other PI/PO messages

      4. no


      Best Regards, Elke


  • Hi Elke, This is a nice tool.

    Can PIT be used for testing interface migration to CPI? Can CPI be configured as the Target System? If not, do you have it on your product roadmap?



  • Hi Nishant,


    The tool can not be used with CPI as a target system. We can check if we can get it to the roadmap.


    Best Regards,

    Elke Döring