Skip to Content

#7.pngThis is a part of the implementation details of How To… Implement End-to-End Push Notifications with HCPms and SAP Gateway.

 

Steps to Test

/wp-content/uploads/2015/11/11_822566.png

Testing the Push Report

 

Let’s test if your test push message can really create a queue. First thing is to “subscribe” a specific OData collection. Start your REST Client. (This example uses Firefox REST Client)

 

Set those parameters for the client:

 

Method – GET

URL – https://<hcmps server>/<your app id>

Headers – X-CSRF-Token = Fetch

          X-SMP-APPCID = <your app connection id on HCPms>

          Content-Type = application/atom+xml; charset=UTF-8

/wp-content/uploads/2015/11/6_21_829475.png

The URL maps to the Service Document of the Gateway service that was configured on HCPms.

 

As an extra security measure, Gateway services guard against Cross-Site Request Forgery (CSRF) by requiring a Gateway-supplied token in all modifying requests (for example, POST). To retrieve a token, use the GET method to set the header “X-CSRF-TOKEN” with value “Fetch” on one of the given service’s read operations. This also applies when you are accessing the service document.

The service document is shown in the response. Take a look at the various collections (for example, “SubscriptionCollection”).

You can obtain the CSRF token (valid throughout a session) from the Response Headers tab:

/wp-content/uploads/2015/11/6_22_822568.png

Set up the REST Client with the following parameters:

 

Method – POST

URL – https://<hcmps server>/<your app id>/SubscriptionCollection

Headers – X-CSRF-Token = <the value obtained>

          X-SMP-APPCID = <your app connection id on HCPms>

          Content-Type = application/atom+xml; charset=UTF-8

Body – The XML body contains the payload needed for the subscription request. You can use the sample subscription payload (but be sure to replace the value of deliveryAddress):

 

— test payload —

<?xml version=”1.0″ encoding=”UTF-8″?>

<atom:entry xmlns:atom=”http://www.w3.org/2005/Atom”>

  <atom:id />

  <atom:title>Subscription for sample user</atom:title>

  <atom:author />

  <atom:updated />

  <atom:content type=”application/xml”>

    <m:properties xmlns:m=”http://schemas.microsoft.com/ado/2007/08/dataservices/metadata” xmlns:d=”http://schemas.microsoft.com/ado/2007/08/dataservices”>

      <d:deliveryAddress>urn:sap-com:channel:HCPMS_PUSH:db4dcf68-d511-40fd-91f6-88e49e8b1441</d:deliveryAddress>

      <d:collection>FlightCollection</d:collection>

      <d:filter></d:filter>

      <d:select>*</d:select>

      <d:persistNotifications>false</d:persistNotifications>

      <d:changeType>created</d:changeType>

    </m:properties>

  </atom:content>

</atom:entry>

— test payload —

 

For the detailed explanation of this payload, have a read at the appendix section, but in a nutshell, here’s the format of <d:deliveryAddress>:

 

urn:sap-com:channel:<HTTP destination of HCPms defined in SM59>:<application connection id of HCPms>

 

/wp-content/uploads/2015/11/6_24_829471.png

Click Send. A successful request results in an HTTP “201 Created” response.

/wp-content/uploads/2015/11/6_25_829477.png

Run the transaction code SE11. You can verify this in the ABAP table “/IWBEP/D_MGW_SUB”. You should be able to confirm a newly created subscription entry.

/wp-content/uploads/2015/11/6_27_829476.png

Remark> Make sure “SOURCE SYSTEM ID” in the /IWBEP/D_MGW_SUB table equals with “Destination System” value in SPRO path “SAP NetWeaver” > “Gateway Service Enablement” > “Backend OData Channel” > “Connection Settings to SAP NetWeaver Gateway” > “SAP NetWeaver Gateway Settings”.

/wp-content/uploads/2015/11/6_11_822572.png

Here you’ll find the current setting – and the value of “Destination System” has to be the same with the value of “SOURCE SYSTEM ID” in the table “/IWBEP/D_MGW_SUB“. If you don’t have the value, create a new one with System Alas = LOCAL and RFC Destination = NONE.

/wp-content/uploads/2015/11/6_26_822573.png

 

Now you can run the test report /IWBEP/R_MGW_PUSH_TEST in the transaction code SE38!

 

(Be sure to have the flight service & data exist – the FLIGHT data can be generated via transaction code SE38 with the program name “SAPBC_DATA_GENERATOR“.)

/wp-content/uploads/2015/11/6_28_822574.png

Enter the value ID/1. Execute. You won’t get neither successful nor error message (unless you debug the code one line by one)… time to check the queue!

/wp-content/uploads/2015/11/6_29_822575.png

Check the queue via the transaction code SBGRFCMON. The queue should be created.

/wp-content/uploads/2015/11/6_30_822576.png

You don’t find it? Yes you might not be able to find it. That’s because it is created so fast and deleted if the queue was transferred successfully to HCPms. So it is actually a good idea to post a subscription with a wrong value, such as:

 

<d:deliveryAddress>urn:sap-com:channel:DUMMY ENDPOINT</d:deliveryAddress>

 

Note – The DUMMY_ENDPOINT is the value that actually does exists in SM59, but it contains the wrong value (such as the host name doesn’t exist). So the queue should be created and be there with the error status messages. In this way you can ensure if the queue is really created or not. You need to make sure the DUMMY_ENDPOINT exists in SM59, otherwise the message doesn’t stop at the queue, but only shows up in the Gateway Error Log.

/wp-content/uploads/2015/11/6_31_822577.png

Other useful error log location for troubleshooting:

 

  • Gateway Backend Error Log: tx code /IWBEP/ERROR_LOG
  • Gateway Error Log: tx code /IWFND/ERROR_LOG
  • Application Log: tx code SLG1 (Object = /IWBEP/* for Backend info, /IWFND/* for Gateway Hub info)

 

Once you confirm the queue is successfully created, let’s check how it goes to HCPms side.

 

Tip – An ABAP report “SRT_ADMIN_CHECK” with a “Check bgrfc configuration” checkbox shows the current status of bgRFC config.

/wp-content/uploads/2015/11/rep_870434.png

 

Check the HCPms push log. Go to the log console of HCPms – typically the Mobile Service Cockpit URL is like https://hcpmsadmin-<id>trial.dispatcher.hanatrial.ondemand.com.  Find and click “Logs” icon.

/wp-content/uploads/2015/11/7_1_1_822507.png

Click on “Log Settings” and change the log level for the Push component with Debug/Enabled. It should be a good idea to disable all the other components so that you can focus on the Push message only.

/wp-content/uploads/2015/11/7_1_2_822508.png

After you run the push test report and ensure the queue is successfully created and transferred to HCPms, check the log file. You should be able to find log information for Notification, which indicates the pushed messages are coming in and HCPms is communicating with Push Provider.

/wp-content/uploads/2015/11/7_1_3_829478.png

Check the device for push notification. The push messages shall come in!

 

Note – If you’re so sure that it will work by confirming the HCPms log but the message doesn’t come in the device, please be aware of the fact that the subscription should be made with the app connection id, which is currently alive on the device. That means every time an app gets installed after the uninstallation, it registers with a new app connection id. You might forgot this during your active app development cycle.

 

 

What’s next? If you need the ERP backend in addition to a single Gateway Hub box, wire the Gateway Hub and ERP backend.

 

 

#8 How To… Implement End-to-End Push Notifications with HCPms and SAP Gateway

 

 

Appendix:

 

Details of the subscription payload

 

(Note – formal help document: Subscription Push Scenario – SAP NetWeaver Gateway – SAP Library)

 

OData services exposed by SAP Gateway are not automatically enabled for subscription. Confirm this by calling the Gateway service document URL and checking the collections that are exposed. A “SubscriptionCollection” indicates that you can subscribe to the collections of a given service. For more information about enabling subscription for a Gateway service, see the SAP help portal.

 

The demo Flight service (RMTSAMPLEFLIGHT) that is included with an SAP Gateway server is enabled for subscriptions out-of-the-box.

 

In general, to subscribe for notifications, the app must send a subscription request that specifies the following:

 

  • User (specified in the HTTP header)
  • Delivery address
  • OData collection
  • Select
  • Change type
  • Filter

 

deliveryAddress

 

The delivery address is the location to which the notification is sent from Gateway. The delivery address must use the format:

 

urn:sap-com:channel:<HTTP destination of HCPms>:<application connection id of HCPms>

 

In the sample request, suppose this delivery address is used:

 

<d:deliveryAddress>urn:sap-com:channel:HCPMS_PUSH:db4dcf68-d511-40fd-91f6-88e49e8b1441</d:deliveryAddress>

 

An HTTP destination of type G called “SMP_PUSH” is referenced (defined in tx SM59), followed by the application connection ID given by the HCPms.

 

collection

 

The collection is the name of the business object collection for which the subscription is being created, in this case, “FlightCollection”. The service document of the OData service shows the collections that are available for the service.

 

select

 

The select attribute must follow the OData $select notation. This attribute allows the subscriber to control the notification format by specifying the subset of the business object hierarchy sent along with the notification. Currently only two values are supported:

 

<d:select></d:select> (empty or missing attribute) A short (base) notification without a business object is sent to the subscriber.

<d:select>*</d:select> The complete hierarchy of the business object is sent.

 

changeType

 

The changeType attribute allows you to subscribe to notifications based on a particular operation that is performed in the SAP back end, and must be one of:“created”, “updated”, “failed”, or “deleted”. . For example, to subscribe notifications only for create operations, use a change type of “created”. However, you must also develop application specific handling for sending notifications in the back end based on the subscribed changeType.

 

filter

 

A filter is where the device user can specify whether to subscribe to all business object instances or to only a specific business object instance. Adhere to theOData $filter syntax and combine any fields using only the AND operation. The only filter criteria that SAP Gateway evaluates is business object ID.

To report this post you need to login first.

20 Comments

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

      1. Mathew Davis

        So in RFC IWFND_ODATA_PUSH, should I give the target host or just leave it blank

        without giving the target host, in SBGRFCMON , can see list of queues

        pushqu.PNG

        But not getting notification on device, or no logs seen in HCPms

        Thanks

        (0) 
            1. Kenichi Unnai Post author

              Perhaps you might want to clean up the existing queues (right click on each and select delete menu) and see you can create a new one.

              If you’re confident the queue is properly created, you can double check the log to see the queue is correctly sent to HCPms.

              If your config is fine, be sure the step #4 is working.

              (0) 
              1. Mathew Davis

                Hi Ken

                I have deleted all the existing queues as you said, and could able to create new one. Step #4  is working fine.

                Please tell me how to check the log whether queue is sent to HCPms

                Thanks

                (0) 
                1. Mathew Davis

                  Hi Ken

                    I got the notification when I tried with ‘Run unit with trace’.

                  push2.PNG

                  How to do this automatically, everytime when I run the push report the queues are generated here and I have to run manually.

                  Thanks

                  (0) 
                      1. Mathew Davis

                        Hi Ken/Jeff

                        Can you guys help with this bgRFC queues.

                        When I execute the push report, bgRFC queues are created, and I have to manually trigger them from SBGRFCMON so as to get notification on the device.

                        Any idea what configuration I would be missing ?

                        Thanks

                        (0) 
    1. Kenichi Unnai Post author

      Can you try run the abap report “srt_admin_check” with “Check bgrfc configuration”? It should show how your bgRFC is configured. You might be able to get some clue.

      (0) 
      1. Mathew Davis

        Thank You Ken,

        Finally it worked..!!! 🙂 😆

        When I executed the report srt_admin_check, it listed out the error, that supervisor destination user password logon error. So I created new supervisor destination in SBGRFCCONF with new BGRFC user.


        Thanks

        Mathews

        (0) 
        1. Kenichi Unnai Post author

          Happy to hear you identified the root cause. I added the tip with SRT_ADMIN_CHECK in the step. I believe other folks will benefit out of your question.

          (0) 
  1. Ganesh Babu

    Hi Kennichi,

    Am currently trying to implement Push notifications for an iOS app through SMP.

    Regarding the Delivery address in the body of Subscription collection URL, which of the 2 am I supposed to use?

    1. <d:deliveryAddress>http://xx.xx.xx.xxx:8080/application/486039f7-6b20-49b6-a27c-0631ec2f94c6</d:deliveryAddress&gt;

    OR

    2. <d:deliveryAddress>http://xx.xxx.xx.xxx:8080:486039f7-6b20-49b6-a27c-0631ec2f94c6</d:deliveryAddress&gt;

    Here “HTTP://xx.xxx.xx.xxx:8080” is the Push URL of the app inside SMP.

    Also in one of your comments I read “/restnotifcation” is the new way for sending notifcations. So in the HTTP connection (type G) in sm59 should contain “/Notificaion” as path prefix or “restnotification” ?

    Am quite confused between those 2. Please suggest which is the better way.

    Thanks and Regards.

    (0) 
  2. Dhani Sebastian

    Hi Ken,

    I have done the configurations as explained in the previous blogs. I got 405- Method not implemented when I do the connection test.

    I am able to get the service document through rest client using the application id. Now when I do the post method to the Subscriptioncollection, I am getting error “Check Subscription Authority method not implemented” error.

    Can you please give me some leads regarding this?

    Regards,

    Dhani

    (0) 

Leave a Reply