Implémentation de l'intégration IoT

1. Synchronisation IoT : processus de synchronisation des données entre SAP APM et les services SAP IoT. 
2. Passerelle REST : protocole utilisé pour les services Web qui permet l'intégration des données IoT dans SAP APM. 
3. Données de séries chronologiques : données collectées à différents moments, souvent utilisées pour l'analyse des tendances dans les contextes IoT. 
4. JWT (JSON Web Token) : Un moyen compact et sécurisé par URL de représenter les réclamations à transférer entre deux parties. 
5. OAuth : Une norme ouverte pour la délégation d'accès, couramment utilisée comme un moyen pour les utilisateurs d'accorder aux sites Web ou aux applications l'accès à leurs informations sur d'autres sites Web, mais sans leur donner les mots de passe. 
6. URL de mappage de modèle : URL utilisé pour mapper les objets techniques sur leurs modèles correspondants dans le service IoT. 
7. Données utiles : partie des données transmises qui est le message réel prévu. 
8. URL de mesure IoT : point d'extrémité auquel les mesures des appareils IoT sont envoyées. 
9. API (Application Programming Interface) : Un ensemble de protocoles pour la construction et l'interaction avec les applications logicielles. 
10. Fréquence du job de synchronisation : fait référence à la fréquence à laquelle la synchronisation entre les systèmes tels que SAP S/4HANA et SAP APM a lieu. 
11. API SAP IoT : interfaces de programmation d'applications fournies par SAP pour interagir avec les données et services IoT. 

Pour ce sujet, Jessica Martin cherchera à acquérir les compétences nécessaires pour exploiter les données de séries chronologiques, telles que les données de capteur, dans SAP Asset Performance Management. Elle découvrira comment SAP Asset Performance Management s'intègre à SAP Internet of Things.

Dans ce sujet, vous allez apprendre à ingérer des données IoT dans SAP Asset Performance Management dans un indicateur local affecté à un objet technique, tel qu'un équipement. Comme condition préalable, l'intégration entre ERP et SAP APM doit être terminée et certains objets techniques ont été chargés dans le système.

Connectez-vous à la solution SAP APM et accédez à l'application Exploration des objets techniques.

2. Sélectionnez un objet technique pour lequel vous souhaitez ajouter un indicateur local.

Accédez à l'onglet Indicateurs et sélectionnez Créer.

Renseignez les détails du code local. Notez que la caractéristique, la position et la catégorie sont obligatoires.

L'indicateur local est maintenant créé.

Revenez à l'écran d'accueil et accédez à l'application Gestion de la connectivité des objets techniques sous le groupe Monitorage du fonctionnement des immobilisations.

Recherchez et sélectionnez l'équipement pour lequel vous venez d'ajouter l'indicateur local, puis cliquez sur Configurer. Basculez le commutateur Synchronisation IoT. La sélection de la passerelle est importante si vous utilisez les API de connectivité des appareils SAP IoT car cela déterminera si l'appareil est configuré pour REST ou MQTT. Si vous utilisez les API Timeseries fournies par SAP APM, conservez la "passerelle REST" par défaut.

Vous pouvez voir que ce code est répliqué à partir de la source "Point de mesure" avec l'ID du point de mesure 93. Maintenant, la valeur de l'indicateur est 76.

Essayons de modifier la valeur en temps réel et de voir si les flux de données passent à la gestion avancée des paiements en temps réel.

Accédez à la transaction DE DOCUMENT DE MESURE IK11 et ouvrez le point de mesure 93. 

Une fois la configuration terminée, sélectionnez "Synchroniser avec IoT" pour synchroniser l'objet technique APM avec SAP IoT. Le statut de synchronisation passera de En cours à Réussite. 

Après le statut Réussite de l'objet technique dans l'interface utilisateur APM, les données de séries chronologiques peuvent être intégrées à SAP APM via plusieurs moyens :

1. Manuellement dans l'onglet Indicateurs de la page Objet technique
2. Exploitation des API SAP APM ou des API SAP IoT
3. Si le code n'est pas local mais qu'il s'agit plutôt d'un point de mesure intégré à partir de SAP S/4HANA, un document de mesure crée automatiquement la valeur de série chronologique via l'interface SAP Event Mesh évoquée précédemment.

Nous allons maintenant parcourir les deux premières méthodes d'intégration des données de séries chronologiques.

Pour illustrer une valeur manuelle, revenez à la page Objet technique pour cet équipement. Sélectionnez le code et appuyez sur Ajouter nouvelle valeur.

Remplissez la page et appuyez sur Enregistrer. Le code sera alors mis à jour avec cette valeur.

Au bout d'un certain temps, le diagramme de suivi des indicateurs sera également mis à jour avec cette valeur.

La saisie manuelle des séries chronologiques est suffisante dans de nombreux scénarios, en particulier lorsque les données sont collectées manuellement. Cependant, les séries chronologiques sont souvent générées par des capteurs et ici, nous voulons utiliser une API pour importer ces données dans le système. Cela montrera un exemple sur la manière dont l'utilisation d'un client REST, comme Postman, peut importer des données. Cependant, dans un projet réel, un outil d'intégration, tel que SAP Plant Connectivity ou SAP Data Intelligence, peut être utilisé.

Pour utiliser l'API SAP APM, vous aurez besoin de deux choses :

1. X-API-KEY qui peut être obtenu sur demande via un incident avec SAP. Pour ce faire, créez un ticket dans la composante APM-OPS-SERV avec la priorité Moyenne. Fournissez les détails suivants :
2. Sous-domaine de sous-compte
3. ID de sous-compte
4. API de sous-compte
5. ID d'e-mail (pour envoyer la clé)
6. Clé de service créée lors de la création d'une instance de service dans le sous-compte BTP. Les API sont sécurisées via oAuth 2.0 et l'ID client et la clé secrète client sont contenus dans la clé de service.

Remarque : Chaque demande d'API doit alors avoir deux en-têtes :

• X-API-KEY avec la clé API comme valeur.
• Autorisation avec le porteur <jeton> comme valeur. Le <jeton> est extrait en utilisant l'ID client/la clé secrète du client/et l'URL d'autorisation à partir de la clé de service.

Pour créer correctement des données de séries chronologiques via les API SAP APM, nous devons utiliser deux API.

1. API d'indicateur pour extraire les ID internes de l'indicateur.
2. API Timeseries pour créer les valeurs de séries chronologiques.

Pour récupérer la définition de l'indicateur, faites une demande au service d'indicateurs. Exploitez l'URL de service "indicateurs" trouvée dans la clé de service APM. Vous pouvez également ajouter une chaîne de filtre OData pour réduire l'exemple d'ensemble à l'objet technique dont vous avez besoin. Voici un exemple d'appel :

https://api-apm.prod.apimanagement.us10.hana.ondemand.com/IndicatorService/v1/Indicators?$filter=technicalObject_number eq '217100092'

Ensuite, nous utilisons l'API de séries chronologiques, ainsi que les données extraites de l'API Indicateurs pour créer des données de séries chronologiques. Ici, nous exploitons une API POST pour le service de séries chronologiques, où les données utiles sont les suivantes :

123456789101112131415
{
"SSID": "",
"technicalObjectType": "",
"technicalObjectNumber": "\",
"categoryName": ""
"positionID": "",
"values": [
{
"characteristicsInternalId": "\",
"value": "",
"time": "2024-03-01T16:00:00.0000000Z"
}
]
}

Notez que toutes les zones, à l'exception des zones "valeur" et "heure", sont obtenues à partir du résultat de l'API Indicateur. Un exemple de données utiles complet se présente comme suit :

123456789101112131415
{
"SSID": "S4HCLNT100",
"technicalObjectType": "EQUI",
"technicalObjectNumber": "217100092",
"categoryName": "M",
"positionID": "24aa638b97194cb8b9d0cf4c2a46eb95",
"values": [
{
"characteristicsInternalId": "53",
"value": "45",
"time": "2024-03-01T16:00:00.0000000Z"
}
]
}

En cas de réussite, vous devriez recevoir une réponse "201 Créé".

Obtention de X-API-KEY

API pour l'état des actifs sur SAP Business Accelerator Hub

https://api.sap.com/package/SAPAssetPerformanceManagementAssetHealth/overview

Pensez à une époque où vous deviez apprendre une nouvelle technologie ou un nouveau processus qui se situait en dehors de votre expertise habituelle, comme l'intégration de terminaux IoT à SAP Asset Performance Management. Comment avez-vous géré la courbe d'apprentissage et quelles stratégies vous ont aidé à comprendre les concepts et les procédures ?

Réponse de l'expert à la question de réflexion personnelle :  

S'attaquer aux nouvelles technologies, comme l'intégration de l'IoT à SAP APM, est un peu comme apprendre à nager. Vous commencez par prendre le relais de ce que font les appareils IoT et comment ils communiquent les uns avec les autres à l'aide d'API. C'est comme se mettre à l'aise dans l'eau avant d'essayer de nager. 

Ensuite, vous vous plongez dans les détails, en apprenant comment ces terminaux s'intègrent à SAP APM. C'est comme nager des lapins qui pratiquent les coups jusqu'à ce qu'ils se sentent naturels. Et tout comme les nageurs apprennent souvent mieux avec un entraîneur ou une équipe, j’ai constaté que travailler à travers des défis avec des collègues ou partager mes connaissances rendait le bâton d’apprentissage. 

Ainsi, lorsque nous parlons de la configuration de l'IoT dans SAP APM, de la synchronisation des équipements à l'envoi des données, c'est un processus où chaque étape s'appuie sur la dernière. Mes expériences passées me rappellent de le faire pas à pas, de demander de l'aide lorsque j'en ai besoin et de partager ce que j'apprends en cours de route. Il s'agit d'être patient et persistant, et c'est ainsi que les morceaux tombent en place. 

Objectif : Maîtriser le processus d'intégration des données IoT pour les objets techniques dans SAP Asset Performance Management (APM), en veillant à ce que les données d'équipement de SAP S/4HANA soient synchronisées efficacement.

Points clés :

1. Préparation :
   1. Confirmez que l'équipement de SAP S/4HANA est synchronisé avec SAP APM.
   2. Accédez à l'application d'objet technique Explorer dans SAP APM.
2. Synchronisation de l'objet technique :
   1. Localisez l'objet technique synchronisé à partir de SAP S/4HANA.
   2. Vérifiez la fréquence de la tâche de synchronisation pour vous assurer que l'objet apparaît dans APM.
3. Création d'indicateurs et synchronisation IoT :
   1. Générer de nouveaux indicateurs locaux pour un objet technique.
   2. Utilisez la fonction 'Synchroniser objets techniques - IoT' pour lier des objets techniques à SAP IoT.
4. Configuration de l'ingestion des données IoT :
   1. Validez le statut de synchronisation réussi pour l'objet technique et les indicateurs.
   2. Utilisez la fonctionnalité "Ajouter une nouvelle valeur" pour saisir des données de série chronologique pour les indicateurs d'équipement.
5. Interaction de l'API SAP IoT :
   1. Récupérez les jetons JWT à l'aide des URL d'authentification APM.
   2. Utilisez des URL de mappage de modèle pour obtenir des ID de mappage pour les objets techniques.
   3. Enregistrer les données de séries chronologiques dans les indicateurs via l'API de mesure IoT.
6. Vérification de l'intégration des données :
   1. Après avoir comptabilisé les données, vérifiez l'interface utilisateur APM pour vous assurer que les valeurs de l'indicateur reflètent les nouvelles entrées.
   2. Confirmez la réflexion des données dans SAP APM pour garantir l'intégration des données de bout en bout.

Résultats : les participants auront la possibilité d'intégrer et de valider les données IoT dans SAP APM, ce qui permettra une surveillance et une analyse des performances améliorées pour les objets techniques. Cela garantit que les données d'équipement restent à jour, offrant ainsi une vue complète de l'état et de la performance des actifs.