Background

In Part 1 of this blog series, we looked at steps to trigger an IDoc from SAP ERP to HCI from the scratch using Basic Authentication.

In Part 2 of this blog series ( this blog ), we will look at how to use IDoc Numbers to search for IDocs in HCI Message Monitoring. We will also look at options to use other fields other than IDoc numbers to search for your Message in HCI

For Standard SAP content, this has already been blogged by Abinash Nanda in his blog End2End monitoring of HCI message flow in Standard Content – Made easy. In the comments of this blog I had asked the Abhinash the question – How can this be done for Custom Integration Flows eventually leading to this documentation link of HCI.I had previously also used this technique in my blog :   HCI -Integrating SalesForce (SFDC) using HCI -Part 2 and hence this in many ways can be repetitive content on SCN but I blog about this technique to ensure there is a continuity in the entire series.

Integration Flow Configuration to enable to use IDoc Number Search

Description
Screen Shot

As-Is recap of the Integration Flow from Part 1

  • Point to Point Integration Flow with IDoc as a Sender Channel and SFTP as a Receiver Channel
  • Additional processing / modification of messages

Add a Content Modifier to your Integration Flow

  • Modify your Integration flow to add a Content Modifier Step with the below Header
    • Name: SAP_ApplicationID
    • Type: XPATH
    • Data Type: java.lang.Integer
    • Value: <XPATH of IDoc Number> , in this case: /ORDERS05/IDOC/EDI_DC40/DOCNUM

Save & Deploy your Integration Flow & You are done!

Test Your Configuration

Description Screen Shot

Trigger your IDoc from SAP ERP & Note your IDoc Number

  • 28048 in our case

Eclipse

  • Go to Message Monitoring in HCI.
  • In the ID field, provide your IDoc Number
    • Note: While your IDoc can have the prefix of Zeroes, as this is saved as an Integer in the Content Modifier Header, make sure you search the IDoc without the prefixed Zeroes

WebUI

  • Go to your Message Monitoring in WebUI
  • Provide the IDoc Number in the ID field

Additional Options

Description
Screenshot

Use SAP_Sender and SAP_Receiver in the Content Modifier

  • Add the SAP_Sender and SAP_Receiver Field in the Content Modifier as per the screenshot.
    • SAP_Sender = EDI_DC40 –> SNRPRN
    • SAP_Receiver = EDI_DC40 -> RCVPRN
  • Save / Deploy and Test your Integration flow
  • This will change the Receiver in the Message Monitoring accordingly.

Can I change the ID to search for the PO Number instead of the IDoc Number?

Description Screenshot
  • Change the SAP_ApplicationID to point to the PO Number Field in the Content Modifier Step,
    • XPATH will change from /ORDERS05/IDOC/EDI_DC40/DOCNUM to /ORDERS05/IDOC/E1EDK01/BELNR
    • Type will change from java.lang.Integer to java.lang.String
  • Save / Deploy your Integration Flow
  • Trigger a IDoc and note the PO Number . PO#2 in my case.
  • Search for PO#2 in the ID field of Message Monitoring

Note: This setting will now mean that you cannot search with your IDoc Number.

  • Re-trigger the IDoc in WE19 with same PO number and Message Monitoring with show both messages

Limitation

In case when the IDoc is triggered from ERP with a packet size greater than 1, the IDoc XML will contain multiple IDoc Tags. What this would mean is that you will have multiple IDoc Numbers in the corresponding payload. Hence, this approach cannot but used with IDoc’s with packet size greater than 1.

Summary

SAP HCP-IS / HCI provides inbuilt functionality to enable searching for your messages using IDoc Number / Other Fields of the IDoc. It is as simple as adding a Content Modifier with the Header Fields – SAP_ApplicatioID and the corresponding XPATH to be used.

We will now proceed to look at extending this scenario to use a Client Authentication from SAP ERP to HCI instead of Basic Authentication in Part 3 of this blog series.

To report this post you need to login first.

1 Comment

You must be Logged on to comment or reply to a post.

Leave a Reply