SAP Gateway Notification Support

There are no specific handling requirements for sending notifications on the SAP gateway side. SAP Mobile Platform sends notifications using gateway-specific headers.

The SAP Mobile Platform identifies the device type, based on the device type converts the gateway notification headers into the third-party notification context data for APNS, GCM or BES/BIS,WNS, and MPNS.

Note: Non-SAP gateway back ends also use the headers listed below to send generic notifications. In this scenario, the backend is unaware of the device platform.

SAP gateway-specific headers that are handled by SAP Mobile Platform for sending notifications:

Structure Header Consists of
<x-sap-poke-title> Text of the alert message
<x-sap-poke-entriesofinterest> Number that appears as the badge on the application icon
<x-sap-poke-data> Custom payload data values. These values must use the JSON structured and primitive types such as dictionary (object), array, string, number, and boolean
  1. APNS

    The SAP Mobile Platform converts the gateway notification headers into APNS notifications:

    Structure Header Consists of
    <x-sap-poke-title> Text of the alert message
    <x-sap-poke-entriesofinterest> Number that appears as the badge on the application icon
    <x-sap-poke-data> Custom payload data values. These values must use the JSON structured and primitive types such as dictionary (object), array, string, number, and boolean.
  2. GCM

    The SAP Mobile Platform converts the gateway notification headers into GCM notifications:

    Header Structure Consists of
    <x-sap-poke-title> An arbitrary string (such as "Updates Available") collapses a group of like messages when the device is offline, so that only the last message is sent to the client
    <x-sap-poke-data> Payload data. Size should not exceed 4KB
  3. BIS/BES

    The SAP Mobile Platform converts the gateway notification headers into BIS/BES notifications:

    Structure Header Consists of
    <x-sap-poke-data> BES/BIS notification data
  4. WNS

    The SAP Mobile Platform converts the gateway notification headers into WNS notifications:

    Structure Header Consists of
    <x-sap-poke-title> Text of the alert message to be shown on the Tile and Toast notifications
    <x-sap-poke-entriesofinterest> Number that appears as the badge on the application icon
    <x-sap-poke-data> Custom payload data to be sent to the device as a raw notification