Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Die serverseitigen Komponenten der PPP werden entweder von der PICTURE GmbH im Rechenzentrum ihres Hosting-Providers betrieben (Software-as-a-Service) oder alternativ durch die Kunden der PICTURE GmbH in eigener Verantwortung (on - premise).

...

Integrationsszenarien 

...

Hinweis

Der von uns empfohlene Weg zum Einbinden einer Freigabe ist die Verwendung von Hyperlinks. Hyperlinks bringen Sicherheitsvorteile und eine bessere Bedienbarkeit gegenüber iFramesIFrames.

Sollen Inhalte aus der PPP optisch unmittelbar in ein webbasiertes Drittsystem eingebunden werden - ohne Umweg über den Klick auf einen Hyperlink - so bietet sich die Einbettung einer PICTURE-App in einem HTML-IFrame an. 

...

Codeblock
languagehtml/xml
<iframe src="https://www88.prozessplattform.de/musterhausen/apps/current/viewer.html?shareToken=b32f4bea-4fbe-4933-b586-63d18c1a0303&workspace=de20c00c-dc23-4069-a01b-5beb1e70f6a0" width="100%" height="1000" name="Auslagen bearbeiten (Detailmodell)">
  <p>Ihr Browser kann leider keine eingebetteten Frames anzeigen:
  Sie k&ouml;nnen die eingebettete Seite &uuml;ber den folgenden Verweis
  aufrufen: <a href="https://www88.prozessplattform.de/musterhausen/apps/current/viewer.html?shareToken=b32f4bea-4fbe-4933-b586-63d18c1a0303&workspace=de20c00c-dc23-4069-a01b-5beb1e70f6a0">Auslagen bearbeiten (Detailmodell)</a></p>
</iframe>

Tipp

Tipp

...

: Größe der Darstellung anpassen

...

Sie betten einen Portal-Browser über ein IFrame ein und möchten Ihren Anwendern den Einstieg erleichtern, indem Sie die Größe des Einstiegsmodells an die Größe des IFrames anpassen?
Über die Angabe des optionalen URL-Parameters zoom können Sie die Darstellung des Einstiegsmodells skalieren. Die Angabe des Query-Parameters erfolgt als Faktor in Dezimalschreibweise im Wertebereich 0-1 (d.h. 0 - 100%) und kann einfach an der URL für die Portal-Browser-Freigabe hinzugefügt werden.

Beispiel:
Sie nutzen eine Prozesslandkarte als Einstiegsmodell und möchten diese beim Öffnen initial auf 60% Skalieren, um diese optimal in die bestehende HTML-Seite einzubetten. Ergänzen Sie hierzu an der URL im src-Attribut des IFrames zoom=0.6 als Query Parameter:

<iframe src="https://www88.prozessplattform.de/musterhausen/apps/current/viewer.html?shareToken=b32f4bea-4fbe-4933-b586-63d18c1a0303&workspace=de20c00c-dc23-4069-a01b-5beb1e70f6a0&zoom=0.6" width="100%" height="1000" name="Auslagen bearbeiten (Detailmodell)">

Standardmäßig wird die Voreinstellung für den Zoom auf alle Ansichten (bzw. Diagramme) des Einstiegsmodells angewandt. Wenn der Zoom lediglich auf die erste Ansicht des Einstiegmodells angewandt werden soll, kann optional der weitere Query-Parameter zoomFirstViewOnly mit dem Wert true ergänzt werden.


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. 

...

  • Ein HTTP-Request auf die REST-Schnittstelle muss entweder einer bereits authentifizierten HTTP-Session (die Zuordnung eines Requests zur User-Session erfolgt dabei anhand eines Session-Cookies) oder einem gültigen Freigabe-Token zugeordnet werden können, sonst wird der Zugriffsversuch abgewiesen.

  • Falls dem Nutzer oder der Freigabe eine IP-Zugirffsbeschränkung Zugriffsbeschränkung zugeordnet wurde und das Request nicht aus dem dort angegebenen IP-Adressbereich stammt, wird der Zugriffsversuch ebenfalls abgewiesen.

  • 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.