Kundenanforderungen
Die Erweiterung erfordert eine funktionierende Installation von SAP Asset Manager (SAM) unter Verwendung von Mobile Services für die Kommunikation. Die Mobile Services-Instanz wird geändert, indem zwei neue Ziele hinzugefügt werden, die die Kommunikation mit dem Erweiterungs-Back-End ermöglichen.
Um die automatischen Berichts-Uploads nutzen zu können, ist ein funktionierendes DMS-Setup erforderlich, das das Repository über die Integration Option API (CMIS API) verfügbar macht. Die verwendeten Client-Zugangsdaten und DMS-Endpunkte für die Authentifizierung und den Browser-Bindungszugriff müssen TeamViewer mitgeteilt werden, um das Erweiterungs-Backend zu konfigurieren.
Änderung der Mobile Services
Die Mobile Services-Instanz, die für Asset Manager verwendet wird, wird geändert, um Informationen und Dienste für den erweiterten Asset Manager bereitzustellen. Diese Änderung ändert die Asset Manager-Vorgänge nicht und fügt nur Funktionen zu den vorhandenen Diensten hinzu.
Hinweis: Sie benötigen Informationen zu Ihrer Frontline-Instanz, die von TeamViewer bereitgestellt werden, um diesen Schritt auszuführen.
Mobile Connectivity
Öffnen Sie in Ihrer Mobile Services-Instanz die Einstellungen für Mobile Connectivity .
Mobile Destinations
Sie erstellen zwei neue Mobile Destinations. Die Reihenfolge bein Erstellen spielt keine Rolle.
Reiseziel DEST_AM_URL
Die Ziel DEST_AM_URL gibt Informationen zur Frontline-Instanz für die Erweiterung zurück.
Geben Sie die URL Ihrer Instanz mit /connector/am/settings in das URL-Feld ein.
Fügen Sie im Abschnitt Custom Headers die folgende Überschrift hinzu:
- Accept with value application/json;charset=utf8
und wählen Sie Override Client.
Dies ist erforderlich, um eine korrekte Antwort aus dem Backend zu erstellen.
Lassen Sie die restlichen Felder auf Standard. Es gibt keinen Authentifizierungs-/SSO-Mechanismus.
Hinweise: Dieser Endpunkt gibt keine vertraulichen Daten zurück.
Schließen Sie die Erstellung des Endpunkts ab.
Sie können den Endpunkt testen, indem Sie ihn in einem Browser öffnen.
Dadurch wird eine kleine JSON-Struktur mit Informationen zu Ihrer Frontline-Instanz zurückgegeben, z. B.
- {"amUrl":"https://fccam.c-48c3187.kyma.shoot.live.k8s-hana.ondemand.com/connector/amapp.html"}
Wenn Sie diese Art von Antwort sehen, wurde das Ziel korrekt eingerichtet.
Reiseziel DEST_CALL_TOKEN
Das DEST_CALL_TOKEN Ziel wird verwendet, um ein signiertes Token vom Frontline-Backend anzufordern, das zum Einrichten eines Videoanrufs verwendet werden kann.
Geben Sie die URL Ihrer Frontline-Instanz mit /connector/am/getCallToken in das URL-Feld ein.
Fügen Sie im Abschnitt Custom Headers die folgende Überschrift hinzu:
- Accept with value application/json;charset=utf8
und wählen Sie Override Client.
Dies ist erforderlich, um eine korrekte Antwort aus dem Backend zu erstellen.
Wählen Sie im Abschnitt Destination Configuration die Basic Authentication als SSO-Mechanismus aus und geben Sie Ihre von TeamViewer bereitgestellten Anmeldeinformationen ein.
Schließen Sie die Erstellung des Endpunkts ab, indem Sie ihn in einem Browser öffnen:
Sie erhalten zunächst eine Fehlermeldung wie diese:
{"timestamp":"2022-07-14T15:48:20.255+00.00","status"400,error":"BadRequest","path":"/connector/am/getCallToken"}
Sie können der generierten URL '&subject=tester' hinzufügen und die Seite erneut laden, z.B.
https://<your-mobile-service-host>/DEST_CALL_TOKEN?auth=uaa&subject=tester
Dies führt zu einer JSON-Struktur wie dieser:
{"token":"eyJhbGciOiJIUZUxMiJ9.eyJpc3MiOiJGcm9udGxpbmUtQUOiLCJzdW liOiJOZXNoZXIiLCJpYXQiOjE2NTc4MTM3MzUslmV4cCI6MTY1NzgxNDYzNXO.a5ePJ_zHffOAj69h2Q8znYHgog_slzzQKrrJ96/CXCXGCK6RIKKZjJ8-HecFGIOW8IBmjWXNTLq_YhLv040KGw","issuedAt":1657813735623,"expiresAt":1657814635623}
Hinweis: Diese Token sind nur für kurze Zeit gültig und werden von der Nebenstelle angefordert, wenn die Anruffunktion benötigt wird.
Wenn Sie diese Art von Antwort sehen, wurde das Ziel korrekt eingerichtet.
{"token":"eyJhbGciOiJIUZUxMiJ9.eyJpc3MiOiJGcm9udGxpbmUtQUOiLCJzdW liOiJOZXNoZXIiLCJpYXQiOjE2NTc4MTM3MzUslmV4cCI6MTY1NzgxNDYzNXO.a5ePJ_zHffOAj69h2Q8znYHgog_slzzQKrrJ96/CXCXGCK6RIKKZjJ8-HecFGIOW8IBmjWXNTLq_YhLv040KGw","issuedAt":1657813735623,"expiresAt":1657814635623}
Asset Manager-Pakete importieren
Wenn Sie ein vorgefertigtes Metadatenpaket für die Asset Manager-Integration erhalten haben, können Sie es direkt in Ihrer Mobile Services-Instanz bereitstellen.
Öffnen Sie in Ihrer Mobile Services-Instanz die Einstellungen für Mobile App Updates.
Wählen Sie die Option Upload.
Folgen Sie den Anweisungen, um Ihre Bundle-Datei hochzuladen.
Nachdem der Upload abgeschlossen ist, stellen Sie die neue Anwendungsversion bereit.
Verteilen Sie nach Abschluss des Uploads die neue App-Version.
Ihre Asset Manager-App nimmt das Update automatisch auf und fordert den Benutzer auf, es anzuwenden.
Asset Manager-Metadaten-Extension
Wenn Sie kein bereitgestelltes Metadatenpaket verwenden, können Sie Ihren vorhandenen Asset Manager auch mithilfe von Business Application Studio ändern. Die Erweiterung wird als MDK-Projekt bereitgestellt, das in Component Integration Metadata (CIM) integriert ist. Eine CIM-Datei wird zusammen mit dem Projekt als Referenz bereitgestellt.
Die Extension-Ressourcen werden im FrontlineExtension.zip Archiv bereitgestellt.
Projekt importieren
Importieren Sie aus dem bereitgestellten Archiv das FrontlineExtension-Projekt in Ihren Arbeitsbereich. Die Dateien im Ordner i18n enthalten Übersetzungen für Nachrichten, die von der Erweiterung verwendet werden.
Hinweis: Diese Dateien überschreiben die Übersetzungsnachrichten im Asset Manager-Projekt. Wenn Sie Änderungen an Übersetzungen vorgenommen haben, müssen Sie die Übersetzungen manuell zusammenführen.
Beispiel für zusammengeführte Eigenschaften für de:
CIM einrichten
Platzieren Sie die bereitgestellte Datei FrontlineExtension.cim in Ihrem Asset Manager-Projekt. Dadurch werden die erforderlichen Integrationspunkte für den benutzerdefinierten Client eingerichtet.
Sie sollten das CIM-Setup überprüfen, um sicherzustellen, dass keine anderen Anpassungen von den Integrationspunkten betroffen sind.
Softwareverteilung
Mit diesen Änderungen können Sie die geänderten Metadaten in Ihrer Mobile Services-Instanz bereitstellen.
Ihre Asset Manager-App nimmt das Update automatisch auf und fordert den Benutzer auf, es anzuwenden.
DMS-Zugang
Der DMS-Zugriff ermöglicht es dem Extension-Backend, PDF-Berichte in den Kundenspeicher hochzuladen. Dies ist optional und kann bei Bedarf nach der Ersteinrichtung eingerichtet werden.
Befolgen Sie die SAP-Richtlinien zur Aktivierung der DMS-Integrationsoptions-API für Ihre Einrichtung, z. B. im SAP-Hilfeportal unter Verbindung mit Document Management Service, Repository-Option über API .
Das Frontline-Backend muss in der Lage sein, ein JSON-Web-Token für den Zugriff auf das DMS anzufordern. Die erforderlichen Einstellungen und Anmeldeinformationen finden Sie in dem von Ihnen erstellten Dienstschlüssel :
Sie müssen Informationen zu den Endpunkten und der Authentifizierung für Ihren TeamViewer Kontakt über einen sicheren Kanal bereitstellen:
Im Abschnitt "Endpunkte" wird der Wert ecmservice / url angezeigt.
Aus dem uaa-Abschnitt die Werte clientid, clientsecret und url (Authentifizierungs-URL).
Zusätzlich zu den Zugangsdaten müssen wir auch wissen, welches Repository verwendet werden soll. Wenn Sie die DMS-Anwendungsoption verwenden, finden Sie den Namen in der Repository-Übersicht, z.B.:
