Präambel
Simplifier Apps sind im Grunde UI5 / Fiori Apps und vollständig kompatibel mit der UI5 Runtime, die auf Fiori Gateway Servern installiert ist.
Die folgende Richtlinie behandelt den Prozess des Exports der App aus dem Simplifier und des Imports des Quellcodes in das ABAP Repository.
Voraussetzungen
- HTTPS – Der SAP Fiori Gateway Server sollte die Fiori Apps über eine sichere HTTP-Verbindung an den Client liefern.
Die Nur-HTTP-Verbindung funktioniert in modernen Browsern nicht. - CORS-Konfiguration: Die Simplifier-CORS-Konfiguration sollte um den Hostnamen des SAP Fiori Gateways-Servers erweitert werden, um die gemeinsame Nutzung von Ressourcen zwischen Simplifier und SAP zu ermöglichen
- SAP-Berechtigungen: Für den Upload der Simplifier App benötigen Sie folgende Berechtigungsobjekte, die Ihrem Benutzer zugeordnet sind: S_DEVELOP, S_ICF_ADM, S_TCODE, S_TRANSPRT, S_CTS_ADMI und S_CTS_SADM
- ABAP Workbench Transport – Vorbereiten eines ABAP Workbench Requests für den Fall, dass Sie die ID transportieren und für eine spätere Eingabe notieren möchten
Cross-Origin Resource Sharing (CORS) ist ein HTTP-Header-basierter Mechanismus, der es einem Server ermöglicht, einen anderen Ursprung (Domäne, Schema oder Port) als seinen eigenen anzugeben, von dem aus ein Browser das Laden von Ressourcen zulassen sollte. (Weitere Informationen)
1 Vorbereiten der CORS-Konfiguration
Simplifier selbst verarbeitet keine CORS- oder Proxy-Konfiguration – Sie müssen den SAP-Hostnamen direkt in Ihren Proxy einfügen.
In unserem Beispiel verwenden wir Traefik2 als HTTP(S)-Proxy
1.1 Finden Sie den SAP-Hostnamen heraus, der von Ihren Clients verwendet wird
- Öffnen Sie Ihr Fiori Launchpad im Browser
- Zeigen Sie die Webseiten-URL in Ihrem Browserfenster an
Beachten Sie den öffentlichen Hostnamen, und fügen Sie diesen der CORS-Richtlinie
Access-Control-Allow-Origin
hinzu. Der Antwortheader Access-Control-Allow-Origin gibt an, ob die Antwort für Ihr entsprechendes SAP-System freigegeben werden kann.
In unserem Beispiel ändern wir die Traefik-Konfiguration, fügen den SAP-Hostnamen am Anfang hinzu (die Reihenfolge spielt keine Rolle)
accessControlAllowOriginList = ["https://sapid405.simplifier.io", "https://yourSimplifierHost", "ionic://localhost"]
Nach dem Neustart des Proxys, um die neue Konfiguration neu zu laden, ist das Sicherheits-Setup abgeschlossen.
2 – Simplifier-App exportieren
Um den Simplifier App Source Code zu exportieren müssen Sie die entsprechende App öffnen und auf die App Properties klicken:
Wählen Sie im Eigenschaftendialog das Symbol Download App und die Zielplattform “Self Hosted Web Application”
Klicken Sie auf Download, um den aktuellen Quellcode als ZIP-Datei zu exportieren.
Extrahieren Sie die ZIP-Datei in einen neuen Ordner – in diesem Beispiel ist es C:\TEMP\ui5
3 – Anwendung in SAP Repository importieren
Um den Import zu starten, melden Sie sich am SAP GUI an und starten Sie den Report /UI5/UI5_REPOSITORY_LOAD mit der Transaktion SA38
Klicken Sie auf die grüne Schaltfläche Ausführen in der linken oberen Ecke
Bestimmen Sie einen SAP-Anwendungsnamen – er beginnt normalerweise mit Z- oder Y-Namespace und enthält keine Leerzeichen oder Sonderzeichen
Wählen Sie den Unterordner www aus, in den die ZIP-Datei zuvor extrahiert wurde
Die Quelldateien werden hochgeladen, wie Sie im untenstehenden Protokoll sehen.
Klicken Sie auf das Detailsymbol in der linken oberen Ecke, um den Vorgang abzuschließen.
Füllen Sie die Beschreibung aus und vergeben Sie einen Package Name und eine ABAP Workbench Request ID, wenn Sie es später transportieren möchten.
4 – Testen und Ausführen der Anwendung
Um die Anwendung zu starten, starten Sie SE80, wählen Sie den Namen Ihrer hochgeladenen UI5-BSP-Anwendung und klicken Sie auf Test, um sie im Browser zu öffnen
Sie sehen die endgültige App im Browser: