...
| Tipp |
|---|
Unter einer "App" wird hier eine in HTML/JavaScript implementierte Anwendung mit klarem, engem Fokus verstanden. Diese ist optisch so gestaltet, dass sie als "externes Modul" in eine vorhandene HTML-Seite eingebettet werden kann, in deren Layout ein Platzhalter für externe Inhalte freigelassen wurde. Zur Programmierung des Apps kommen ausschließlich clientseitig gerendertes HTML und clientseitig ausgeführtes JavaScript zum Einsatz, sodass es als statischer Content von jedem beliebigen Webserver ausgeliefert werden kann. Die darzustellenden PPP-Inhalte werden durch die App dynamisch zur Laufzeit mittels AJAX-Requests von der Server-Komponente der PPP-Webanwendung geladen. Die Übertragung der Daten erfolgt hierbei in den Formaten XML bzw. JSON/JSONP.
|
Im Standard-Lieferumfang des Portalmoduls der PPP sind Apps für typische Anwendungsfälle bereits enthalten:
...
| Codeblock | ||
|---|---|---|
| ||
<iframe src="https://www.prozessplattform.de/testfirma/prime/viewer.html?workspaceUUID=afa1fb03-624c-4d80-91cc-211be3366f47&bpmnModelUUID=05695ee0-2d01-47df-aa10-1076c1ab330b&authToken=8a672216-cb01-4b54-a6e7-94d84d8d8f2f" width="100%" height="1000" name="Auslagen bearbeiten (Detailmodell)"> <p>Ihr Browser kann leider keine eingebetteten Frames anzeigen: Sie können die eingebettete Seite über den folgenden Verweis aufrufen: <a href="https://www.prozessplattform.de/testfirma/prime/viewer.html?workspaceUUID=afa1fb03-624c-4d80-91cc-211be3366f47&bpmnModelUUID=05695ee0-2d01-47df-aa10-1076c1ab330b&authToken=8a672216-cb01-4b54-a6e7-94d84d8d8f2f">Auslagen bearbeiten (Detailmodell)</a></p> </iframe> |
...
Durch geschickte Kombination der mitgelieferten Apps lassen sich bereits vielfältige Integrationsszenarien abbilden. Sollten die vorgefertigten Apps für bestimmte Informationsbedarfe nicht ausreichen, so besteht die Möglichkeit, eigene Apps unter Nutzung der generischen Funktionen der REST-Schnittstelle zu entwickeln.
...
Die größte Integrationstiefe kann durch die Entwicklung eigener (Web-)Anwendungen unter Nutzung der REST-Schnittstelle der PPP erreicht werden, die wir Ihnen auf Anfrage zur Verfügung stellen können. Das REST-API ermöglicht den lesenden Zugriff auf alle Modelle, die mit der PPP erstellt werden können, in verschiedenen Darstellungsarten und Dateiformaten (z.B. XML, JSON, PDF, PNG). Weiterhin stehen einfache Funktionen zur Navigation bzw. Suche im Modellbestand zur Verfügung. Diese Programmierschnittstelle kann genutzt werden, um beliebige eigene Oberflächen für den Zugriff auf die Daten aus der PPP und deren Darstellung bzw. eigene Dienstprogramme zu implementieren. Hierzu können alle Programmiersprachen und -umgebungen verwendet werden, für welche Client-Bibliotheken für das HTTP-Protokoll zur Verfügung stehen bzw. mit denen sich einfache HTTP-Zugriffe selbständig programmieren lassen.
...
- Ein HTTP-Request auf die REST-Schnittstelle muss einer bereits authentifizierten HTTP-Session zugeordnet werden können, sonst wird der Zugriffsversuch abgewiesen. Die Zuordnung des Requests zur Session erfolgt dabei anhand eines Session-Cookies bzw. anhand eines entsprechenden URL-Parameters).
- Die Authentifizierung einer bis dato nicht authentifizierten Session erfolgt für persönliche Accounts durch den Aufruf einer Login-URL (Benutzername und Passwort werden dabei als Parameter übergeben). Ein programmatischer Logout erfolgt analog durch den Aufruf einer Logout-URL.
- Zur Authentifizierung einer Session für einen "anonymen Leser" kann jedem Request auf die REST-Schnittstelle das Authentifizierungs-Token eines Lese-Accounts per URL-Parameter mitgegeben werden. Ist das Token gültig, wird die HTTP-Session, aus welcher der Request kam, für den Leseaccount authentifiziert.