IoT-Integration implementieren

1. IoT-Synchronisierung: Der Prozess der Synchronisierung von Daten zwischen SAP APM und SAP IoT Services. 
2. REST-Gateway: Ein für Web-Services verwendetes Protokoll, das die Integration von IoT-Daten in SAP APM ermöglicht. 
3. Zeitreihendaten: Zu verschiedenen Zeitpunkten gesammelte Daten, die häufig für Trendanalysen in IoT-Kontexten verwendet werden. 
4. JWT (JSON Web Token): Ein kompaktes URL-sicheres Mittel zur Darstellung von Forderungen, die zwischen zwei Parteien übertragen werden sollen. 
5. OAuth: Ein offener Standard für die Zugriffsdelegation, der häufig als Möglichkeit für Benutzer verwendet wird, Websites oder Anwendungen Zugriff auf ihre Informationen auf anderen Websites zu gewähren, jedoch ohne ihnen die Kennwörter zu geben. 
6. Modellzuordnungs-URL: Die URL, mit der technische Objekte den entsprechenden Modellen im IoT-Service zugeordnet werden. 
7. Payload: Der Teil der übertragenen Daten, der die tatsächlich beabsichtigte Nachricht ist. 
8. IoT-Messungs-URL: Der Endpunkt, an den Messungen von IoT-Geräten gesendet werden. 
9. API (Application Programming Interface): Eine Reihe von Protokollen für die Erstellung und Interaktion mit Softwareanwendungen. 
10. Häufigkeit des Synchronisierungsjobs: Bezieht sich darauf, wie oft die Synchronisierung zwischen Systemen wie SAP S/4HANA und SAP APM erfolgt. 
11. SAP IoT APIs: Anwendungsprogrammierschnittstellen, die von SAP für die Interaktion mit IoT-Daten und -Services bereitgestellt werden. 

Für diese Lektion möchte Jessica Martin die Fähigkeiten erwerben, um Zeitreihendaten wie Sensordaten in SAP Asset Performance Management zu nutzen. Sie wird erfahren, wie SAP Asset Performance Management in SAP Internet of Things integriert ist.

In dieser Lektion erfahren Sie, wie Sie IoT-Daten in SAP Asset Performance Management für einen lokalen Indikator aufnehmen, der einem technischen Objekt, z.B. einem Equipment, zugeordnet ist. Als Voraussetzung muss die Integration zwischen ERP und SAP APM abgeschlossen sein, und einige technische Objekte wurden in das System geladen.

Melden Sie sich an der SAP-APM-Lösung an, und navigieren Sie zur Anwendung Technische Objekte durchsuchen.

2. Wählen Sie ein beliebiges technisches Objekt aus, das Sie einem lokalen Indikator hinzufügen möchten.

Navigieren Sie zur Registerkarte Indikatoren, und wählen Sie Anlegen.

Geben Sie die Details für das lokale Kennzeichen ein. Beachten Sie, dass Merkmal, Position und Kategorie obligatorisch sind.

Der lokale Indikator wird nun angelegt.

Kehren Sie zur Startseite zurück, und navigieren Sie zur App Konnektivität technischer Objekte verwalten in der Gruppe Zustandsüberwachung technischer Objekte.

Suchen Sie das Equipment, für das Sie gerade den lokalen Indikator hinzugefügt haben, und wählen Sie Konfigurieren. Schalten Sie den Schalter IoT-Synchronisierung um. Die Gateway-Auswahl ist wichtig, wenn Sie die SAP-IoT-Gerätekonnektivitäts-APIs verwenden, die bestimmen, ob das Gerät für REST oder MQTT konfiguriert ist. Wenn Sie die von SAP APM bereitgestellten Zeitreihen-APIs verwenden, behalten Sie den Standardwert "REST-Gateway" bei.

Sie sehen, dass dieses Kennzeichen aus der Quelle "Messpunkt" zusammen mit der Messpunkt-ID 93 repliziert wird. Nun ist der Wert des Indikators 76.

Sie können versuchen, den Wert in Echtzeit zu ändern und zu sehen, ob die Daten in Echtzeit in die erweiterte Zahlungsverwaltung fließen.

Rufen Sie die Messbelegtransaktion IK11 auf, und öffnen Sie den Messpunkt 93. 

Sobald die Konfiguration abgeschlossen ist, wählen Sie „Mit IoT synchronisieren", wodurch das technische Objekt der erweiterten Zahlungsverwaltung mit SAP IoT synchronisiert wird. Der Synchronisierungsstatus ändert sich von In Bearbeitung in Erfolgreich. 

Nach dem Status "Erfolgreich" des technischen Objekts auf der APM-UI können Zeitreihendaten auf verschiedene Weise in SAP APM integriert werden:

1. Manuell auf der Registerkarte Indikatoren auf der Seite Technisches Objekt
2. Nutzung der SAP-APM-APIs oder SAP-IoT-APIs
3. Wenn der Indikator nicht lokal ist, sondern ein aus SAP S/4HANA integrierter Messpunkt ist, legt ein Messbeleg automatisch den Zeitreihenwert über die zuvor besprochene SAP-Event-Mesh-Schnittstelle an.

Als Nächstes gehen wir die ersten beiden Methoden zur Integration von Zeitreihendaten durch.

Um einen manuellen Wert zu veranschaulichen, kehren Sie zur Seite Technisches Objekt für dieses Equipment zurück. Markieren Sie das Kennzeichen, und wählen Sie Neuen Wert hinzufügen.

Füllen Sie die Seite aus, und wählen Sie Sichern. Das Kennzeichen wird dann mit diesem Wert aktualisiert.

Nach einiger Zeit wird das Indikatorüberwachungsdiagramm ebenfalls mit diesem Wert aktualisiert.

Die manuelle Zeitreiheneingabe ist in vielen Szenarios ausreichend, insbesondere wenn Daten manuell gesammelt werden. Zeitreihen werden jedoch häufig von Sensoren generiert, und hier möchten wir ein API nutzen, um diese Daten in das System zu übertragen. Dies zeigt ein Beispiel dafür, wie ein REST-Client wie Postman Daten einbringen kann. In einem eigentlichen Projekt kann jedoch ein Integrationswerkzeug wie SAP Plant Connectivity oder SAP Data Intelligence verwendet werden.

Um das SAP-APM-API verwenden zu können, benötigen Sie zwei Dinge:

1. Der X-API-KEY, der auf Anfrage über eine Meldung bei SAP abgerufen werden kann. Legen Sie dazu ein Ticket unter der Komponente APM-OPS-SERV mit der Priorität Mittel an. Geben Sie die folgenden Details ein:
2. Unterkontounterdomäne
3. Unterkonto-ID
4. Unterkonto-API
5. E-Mail-ID (zum Senden des Schlüssels)
6. Der Serviceschlüssel, der beim Anlegen einer Serviceinstanz im BTP-Unterkonto angelegt wurde. Die APIs werden über OAuth 2.0 gesichert, und die Client-ID und der geheime Client-Schlüssel sind im Service-Schlüssel enthalten.

Hinweis: Jeder API-Request muss dann zwei Header haben:

• X-API-KEY mit dem API-Schlüssel als Wert.
• Berechtigung mit Bearer <Token> als Wert. Das <Token> wird abgerufen, indem die Client-ID/der geheime Client-Schlüssel / und die Berechtigungs-URL aus dem Service-Schlüssel verwendet werden.

Um Zeitreihendaten über die SAP-APM-APIs erfolgreich anzulegen, müssen wir zwei APIs nutzen.

1. Indikator-API zum Abrufen der internen IDs des Indikators.
2. Das Zeitreihen-API zum Anlegen der Zeitreihenwerte.

Um die Indikatordefinition abzurufen, senden Sie eine Anforderung an den Indikatorservice. Nutzen Sie die Service-URL „Indikatoren", die im SAP-APM-Serviceschlüssel gefunden wurde. Sie können auch einen OData-Filterstring hinzufügen, um den Beispielsatz auf das von Ihnen benötigte technische Objekt zu reduzieren. Ein Beispielaufruf würde wie folgt aussehen:

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

Als Nächstes verwenden wir das Zeitreihen-API zusammen mit den aus dem Kennzeichen-API abgerufenen Daten, um Zeitreihendaten anzulegen. Hier nutzen wir ein POST-API für den Zeitreihenservice, wobei die Payload wie folgt lautet:

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

Beachten Sie, dass alle Felder mit Ausnahme der Felder "Wert" und "Zeit" aus dem Ergebnis des Indikator-APIs abgerufen werden. Ein vollständiges Payload-Beispiel würde wie folgt aussehen:

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

Wenn der Vorgang erfolgreich ist, sollten Sie die Antwort "201 Created" erhalten.

X-API-KEY abrufen

Zustands-APIs im SAP Business Accelerator Hub

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

Denken Sie an eine Zeit, in der Sie eine neue Technologie oder einen neuen Prozess erlernen mussten, die außerhalb Ihres gewohnten Fachwissens lag, ähnlich wie die Integration von IoT-Geräten mit SAP Asset Performance Management. Wie haben Sie mit der Lernkurve umgegangen und welche Strategien haben Ihnen geholfen, die Konzepte und Verfahren zu verstehen?

Expertenantwort auf persönliche Reflexionsfrage:  

Die Bewältigung neuer Technologien wie die IoT-Integration mit SAP APM ist ein bisschen wie Schwimmen lernen. Sie beginnen im flachen Ende, indem Sie wissen, was IoT-Geräte tun und wie sie über APIs miteinander kommunizieren. Es ist, als ob du dich im Wasser wohlfühlst, bevor du versuchst zu schwimmen. 

Als Nächstes lernen Sie, wie sich diese Geräte mit SAP APM verbinden. Es ist wie beim Schwimmen von Laps, die Striche zu üben, bis sie sich natürlich fühlen. Und genau wie Schwimmer oft mit einem Coach oder einem Team besser lernen, stellte ich fest, dass die Arbeit durch Herausforderungen mit Kollegen oder das Teilen meines Wissens den Lernstock gemacht hat. 

Wenn wir also über das Einrichten von IoT in SAP APM sprechen, von der Synchronisierung von Equipment bis zum Senden von Daten, ist es ein Prozess, bei dem jeder Schritt auf dem letzten aufbaut. Meine vergangenen Erfahrungen erinnern mich daran, es Schritt für Schritt zu machen, um Hilfe zu bitten, wenn ich es brauche, und zu teilen, was ich auf dem Weg lerne. Es geht darum, geduldig und hartnäckig zu sein, und so fallen die Stücke ins Spiel. 

Ziel: Übernimmt den Prozess der Integration von IoT-Daten für technische Objekte in SAP Asset Performance Management (APM) und stellt sicher, dass Equipmentdaten aus SAP S/4HANA effektiv synchronisiert werden.

Wichtige Informationen:

1. Vorbereitung:
   1. Bestätigen Sie, dass Equipment aus SAP S/4HANA mit SAP APM synchronisiert wird.
   2. Greifen Sie in SAP APM auf die Anwendung für technische Objekte im Explorer zu.
2. Synchronisierung des technischen Objekts:
   1. Suchen Sie das synchronisierte technische Objekt aus SAP S/4HANA.
   2. Prüfen Sie die Häufigkeit des Synchronisierungsjobs, um sicherzustellen, dass das Objekt in APM angezeigt wird.
3. Indikatorerstellung und IoT-Synchronisierung:
   1. Generieren Sie neue lokale Indikatoren für ein technisches Objekt.
   2. Verwenden Sie die Funktion "Technische Objekte synchronisieren - IoT", um technische Objekte mit SAP IoT zu verknüpfen.
4. IoT-Datenaufnahme konfigurieren:
   1. Validieren Sie den erfolgreichen Synchronisierungsstatus für das technische Objekt und die Indikatoren.
   2. Verwenden Sie die Funktion "Neuen Wert hinzufügen", um Zeitreihendaten für Equipment-Indikatoren einzugeben.
5. SAP-IoT-API-Interaktion:
   1. JWT-Token über APM-Authentifizierungs-URLs abrufen.
   2. Verwenden Sie Modellzuordnungs-URLs, um Mapping-IDs für technische Objekte abzurufen.
   3. Buchen Sie Zeitreihendaten über das IoT-Messungs-API an Indikatoren.
6. Datenintegration prüfen:
   1. Prüfen Sie nach dem Buchen der Daten die UI der erweiterten Zahlungsverwaltung, um sicherzustellen, dass die Indikatorwerte die neuen Eingaben widerspiegeln.
   2. Bestätigen Sie die Datenreflexion in SAP APM, um eine durchgängige Datenintegration sicherzustellen.

Ergebnisse: Die Teilnehmer erhalten die Möglichkeit, IoT-Daten in SAP APM zu integrieren und zu validieren und so eine erweiterte Überwachung und Leistungsanalyse für technische Objekte zu ermöglichen. Dadurch wird sichergestellt, dass Equipmentdaten auf dem neuesten Stand sind und eine umfassende Sicht auf den Zustand und die Leistung technischer Objekte bieten.