Automatic Device Onboarding - SAP Internet of Things

Modeling and creation of equipment has to be followed as per the document: Creating a Piece of Equipment. Once the equipment is created and published, it is synchronized and objects are created in SAP Internet of Things.

If you are onboarded before 2011 release, then refer to Automatic Device Onboarding.

Prerequisite: SAP IoT Services system is configured.

If you are onboarded after 2011 release, then follow the below steps mentioned in this topic.

IoT Sync Flag:

  • IoT Sync flag allows a user to enable sync to IoT Services.

Behaviour:

  • By default, the flag will be visible only when an IoT Services system is configured .

  • Flag can be toggled to switch the behavior.

    If the flag is switched from Yes to No and the objects were created in external systems, they will be retained and the same can be reused by switching the flag.

    If the flag is switched from No to Yes, the manual mapping of indicators, if configured, will be invalidated.

Important Information for the Synchronization

While the publishing to SAP Internet of Things, the following points need to be considered:

  • Only equipment with model in SAP Asset Intelligence Network is synchronized with SAP Internet of Things. This means that lean equipment will not be synchronized with SAP Internet of Things.

  • The equipment create API should have the following properties for the scenarios given below:
    • Both IoT services 4.0 and PdMS sync enabled

      • objectsSync: [{externalSys: "HCP IoT 4.0", status: true}, {externalSys: "PdMS", status: true}]

      • gateWayID: "2"

    • Both IoT services 4.0 and PdMS sync disabled

      • objectsSync: [{externalSys: "HCP IoT 4.0", status: false}, {externalSys: "PdMS", status: false}]

      • gateWayID: "2"

    • Only IoT services 4.0 sync is enabled

      • objectsSync: [{externalSys: "HCP IoT 4.0", status: true}]

      • gateWayID: "2"

    • Only PdMS sync is enabled

      • objectsSync: [{externalSys: "HCP IoT 4.0", status: false}, {externalSys: "PdMS", status: true}]

      • gateWayID: null

  • For every equipment a device is created. The device will be associated with capabilities corresponding to indicator groups, the indicators coming from both model templates and equipment templates .

  • When you have created a piece of equipment based on a template , for every template a sensor type is created. Also, only one sensor will be created for each device corresponding to a piece of equipment.

  • To support update of capabilities with the new properties from SAP Asset Intelligence Network, default capabilities, for example, IG_EDGE_CONFIG and MachineAlarmPST are created inside a sensor type. The sensor types' default name is DEFFAULT_CAPABILITY_TEMPLATE_DEFAULT. The capabilities and the sensor type should not be removed.

  • For a successful synchronization, each indicator group can have only one indicator of type Date.

The mapping between objects is as follows (AIN, ASPM):

  1. Steps to enable synchronization across SAP Internet of Things:

    1. Create SAP IoT destination.

      You can configure the SAP Internet of Things (SAP IoT) for theSAP Asset Intelligence Network by following the steps explained in this topic:

      1. Customer SAP IoT subscription

        Go to customer account space and service market place and subscribe to SAP IoT.

      2. Create SAP IoT service instance

        Go to service instance and create an SAP IoT instance. Once you create an instance, you get client ID, secret, and URL which can be used in a destination creation that communicates to SAP Asset Intelligence Network.

        The clientid, clientsecret, and url are used to configure the destination.

      3. Create SAP IoT destination

        • Go to subaccount and create new destination with <name>SAPIoTRemoteConnection.

        • It is of OAuth2ClientCredentials authentication and client secretand URL will be from the previous step.

          Token Service URL will be url from previous step suffixed with /oauth/token.

    2. To add SAP IoT service system:

      1. On the SAP Fiori launchpad, choose the tile Application Settings.

      2. Choose External Systems.

      3. Choose Add.

      4. Choose the external system: SAP Cloud platform Internet of Things 4.0.

        Field

        Description

        System Name

        <Any name>

        System Status

        Active

        URL Information

        		 Maintain the URL from the service key for SAP IoT service instance. URL that is displayed in the field <iot-device-connectivity>.

        User name

        You have to use oauth.

        Password

        <password>. Any dummy password can be used as it will not be used anywhere else.

        Additional Information

        As required

        Primary system?

        Use Toggle
Related Information