| Inhalt | ||
|---|---|---|
|
...
Spezielle Fehler-Codes
- 400 (Bad Request): Im Falle, dass die Anfrage bei der ein ShareToken als Query-Parameter übergeben wurde nicht aus dem in der Freigabe hinterlegten IP-Adressbereich stammt, die Freigabe defekt, abgelaufen oder nicht mehr vorhanden ist
Abrufen eines Prozesssteckbriefs im PicXML 3-Format
...
Spezielle Fehler-Codes
- 400 (Bad Request): Im Falle, dass die Anfrage bei der ein ShareToken als Query-Parameter übergeben wurde nicht aus dem in der Freigabe hinterlegten IP-Adressbereich stammt, die Freigabe defekt, abgelaufen oder nicht mehr vorhanden ist
Abrufen eines Prozesskontextelementsteckbriefs im PicXML 3-Format
...
Spezielle Fehler-Codes
- 400 (Bad Request): Im Falle, dass die Anfrage bei der ein ShareToken als Query-Parameter übergeben wurde nicht aus dem in der Freigabe hinterlegten IP-Adressbereich stammt, die Freigabe defekt, abgelaufen oder nicht mehr vorhanden ist
Abrufen von Dateianhängen
Request
GET https://www{hostid}.prozessplattform.de/{tenant}/rest/files/fileAttachment/?file={file}&name={name}
...
Spezielle Fehler-Codes
- 400 (Bad Request): Im Falle, dass die Anfrage bei der ein ShareToken als Query-Parameter übergeben wurde nicht aus dem in der Freigabe hinterlegten IP-Adressbereich stammt, die Freigabe defekt, abgelaufen oder nicht mehr vorhanden ist
Abrufen von PDF-Exporten
Request
GET https://www{hostid}.prozessplattform.de/{tenant}/rest/workspace/{workspaceUUID}/entry/{entryUUID}/pdf/{type}
...
| Parameter-Typ | Name | Bedeutung |
|---|---|---|
| Path | hostid | Host-ID innerhalb des Hosting-Clusters, auf dem der Mandant betrieben wird (z.B. "88") |
| Path | tenant | Name des Mandanten (z.B. "musterhausen") |
| Path | workspaceUUID | UUID des Arbeitsbereichs Achtung: Bei einem Zugriff per ShareToken, wird die als Path-Parameter angegeben UUID des Arbeitsbereiches nicht ausgewertet, stattdessen wird die in der Portal-Freigabe hinterlegte Arbeitsbereich-UUID ausgewertet. Wir empfehlen daher bei einem Zugriff per ShareToken einen einheitlichen Dummy-Wert (z.B. "share") als Path-Parameter "workspaceUUID" anzugeben. |
| Path | entryUUID | UUID des Prozesses / der Prozesslandkarte |
| Path | type | Typ des PDF-Exportes Mögliche Werte:
|
| Query (optional **) | attributeViewUUID | UUID der anzuwenden Attributsicht. (Der Spezial-Wert "Combined" kann für die Attributsicht "(alle Attribute anzeigen)" genutzt werden.) |
| Cookie (Header, optional *) | JSESSIONID | ID einer authentifizierten HTTP-Session |
| Query (optional *) | shareToken | Token, das zum Zugriff auf die hierdurch identifizierte Portal-Freigabe Freigabe berechtigt (kann dem über die Benutzeroberfläche generierten Freigabe-Link entnommen werden) |
...
**) Wenn die Authentifizierung per ShareToken erfolgt, wird der Query-Parameter "attributeViewUUID" nicht benötigt, da bei der Erstellung der zugehörigen Portal-Freigabe genau eine Sicht festgelegt wird, die über die Freigabe exponiert wird. Wird der Query-Parameter "attributeViewUUID" bei einem Zugriff per ShareToken trotzdem angegeben wird er nicht ausgewertet, es wird in jedem Fall die in der Portal-Freigabe festgelegte Sicht angewendet. Wenn die Authentifizierung mit einem persönlichen Login bzw. JSESSIONID erfolgt, kann mit Hilfe des Query-Parameter "attributeViewUUID" die anzuwendende Sicht festgelegt werden. Wird der Query-Parameter "attributeViewUUID" bei einem Zugriff per persönlichem Login bzw. JSESSIONUD weggelassen wird oder keine Sicht mit der übergebenen UUID existiert, so werden die Attribute aus allen Sichten der Sicht berücksichtigt, welche zuletzt für den eingeloggten Benutzer freigeschaltet sindausgewählt wurde.
Response
- PDF-Export des angegebenen Prozessregistereintrages im angegebenen Format bzw. Typ
Spezielle Fehler-Codes
- 400 (Bad Request): Im Falle, dass die Anfrage bei der ein ShareToken als Query-Parameter übergeben wurde nicht aus dem in der Freigabe hinterlegten IP-Adressbereich stammt, die Freigabe defekt, abgelaufen oder nicht mehr vorhanden ist