Informationsobjekte auflisten

Auflistung der Inhalte eines Ordners (Prozesse & Prozesslandkarten)

Request 

GET https://www{hostid}.prozessplattform.de/{tenant}/rest/repository/workspace/{workspaceUUID}/find/processes/directory/{directoryUUID}

Nutzungsvoraussetzungen

Dieser API-Endpunkt steht nur zur Verfügung, wenn für den jeweiligen Prozessplattform-Mandanten das Portal-Modul lizensiert ist.

Möglichkeiten zur Authentifizierung & Autorisierung

PERSÖNLICHER LOGIN

Request-Parameter 

Parameter-Typ

Name

Bedeutung

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

Path

directoryUUID

UUID des abzufragenden Ordners (die ID des Wurzelordners ist "root")

Cookie (Header)

JSESSIONID

ID einer authentifizierten HTTP-Session 

Response

  • JSON-Array mit den Namen aller direkten Unterordner und allen Einträgen des Ordners (Datenstruktur: Array von RepositoryEntry-Objekten)

Auflistung der aktuellen Treffermenge eines (Prozessregister-)Filterbündels

Request 

GET https://www{hostid}.prozessplattform.de/{tenant}/rest/repository/workspace/{workspaceUUID}/find/processes/filterBundle/{filterBundleUUID}

Nutzungsvoraussetzungen

Dieser API-Endpunkt steht nur zur Verfügung, wenn für den jeweiligen Prozessplattform-Mandanten das Portal-Modul lizensiert ist.

Möglichkeiten zur Authentifizierung & Autorisierung

PERSÖNLICHER LOGIN

Request-Parameter 

Parameter-Typ

Name

Bedeutung

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

Path

filterBundleUUID

UUID des abzurufenden Filterbündels
(Weitere Informationen zum Konzept der “gespeicherten Filterbündel” finden Sie im Abschnitt “Prozessregister mithilfe von Filtern durchsuchen | Als Filterbündel speichern “.)

Cookie (Header)

JSESSIONID

ID einer authentifizierten HTTP-Session 

Response 

  • JSON-Array mit allen Einträgen, die den Kriterien des Filterbündels entsprechen (Datenstruktur: Array von RepositoryEntry-Objekten)

Auflistung der Prozessregistereinträge, die in einer Freigabe enthalten sind

Request 

GET https://www{hostid}.prozessplattform.de/{tenant}/rest/share/{shareToken}/iframelist

Nutzungsvoraussetzungen

Dieser API-Endpunkt steht nur zur Verfügung, wenn für den jeweiligen Prozessplattform-Mandanten das Portal-Modul lizensiert ist.

Möglichkeiten zur Authentifizierung & Autorisierung

SHARE TOKEN (FREIGABE)

Request-Parameter 

Parameter-Typ

Name

Bedeutung

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

shareToken

Token, das zum Zugriff auf die hierdurch identifizierte Portal-Freigabe Freigabe berechtigt (kann dem über die Benutzeroberfläche generierten Freigabe-Link entnommen werden)

Response 

  • JSON-Array mit allen Prozessregistereinträgen, die in der Freigabe enthalten sind (Datenstruktur: Array von PortalList-Objekten)

Spezielle Fehler-Codes

  • 400 (Bad Request): Im Falle, dass die Anfrage nicht aus dem in der Freigabe hinterlegten IP-Adressbereich stammt, die Freigabe defekt, abgelaufen oder nicht mehr vorhanden ist 

Schlagwortsuche nach Prozessregister-Einträgen

Request 

GET https://www{hostid}.prozessplattform.de/{tenant}/rest/workspace/{workspaceUUID}/find/processes?searchTerm={searchTerm}

Nutzungsvoraussetzungen

Dieser API-Endpunkt steht nur zur Verfügung, wenn für den jeweiligen Prozessplattform-Mandanten das Portal-Modul lizensiert ist.

Möglichkeiten zur Authentifizierung & Autorisierung

Request-Parameter 

Parameter-Typ

Name

Bedeutung

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

Query

searchTerm

Suchbegriff (Name / Schlagwort bzw. ein Teil davon)

Achtung: der hier angegebene Wert muss "urlencoded" sein, da er als Query-Parameter benutzt wird!

Cookie (Header)

JSESSIONID

ID einer authentifizierten HTTP-Session 

Response 

  • JSON-Array mit allen Einträgen, deren Bezeichnung oder Schlagworte den Suchbegriff enthalten (Datenstruktur: Array von RepositoryEntry-Objekten).

Schlagwortsuche nach Freigabe-Inhalten

Nutzungsvoraussetzungen

Dieser API-Endpunkt steht nur zur Verfügung, wenn für den jeweiligen Prozessplattform-Mandanten das Portal-Modul lizensiert ist.

Request 

GET https://www{hostid}.prozessplattform.de/{tenant}/rest/share/{shareToken}/portalSearch/{searchTerm}

Möglichkeiten zur Authentifizierung & Autorisierung

Request-Parameter 

Parameter-Typ

Name

Bedeutung

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

shareToken

Token, das zum Zugriff auf die hierdurch identifizierte Portal-Freigabe Freigabe berechtigt (kann dem über die Benutzeroberfläche generierten Freigabe-Link entnommen werden)

Path

searchTerm

Suchbegriff (Name / Schlagwort bzw. ein Teil davon)

Achtung: der hier angegebene Wert muss "urlencoded" sein, da er als Path-Parameter benutzt wird!

Response 

  • JSON-Array mit allen Einträgen, deren Bezeichnung oder Schlagworte den Suchbegriff enthalten (Datenstruktur: Array von PortalEntry-Objekten)

Spezielle Fehler-Codes

  • 400 (Bad Request): Im Falle, dass die Anfrage nicht aus dem in der Freigabe hinterlegten IP-Adressbereich stammt, die Freigabe defekt, abgelaufen oder nicht mehr vorhanden ist

Abrufen einer Prozesskontext-Baumstruktur

Request 

GET https://www{hostid}.prozessplattform.de/{tenant}/rest/repository/workspace/{workspaceUUID}/processContext/tree/{type}

Möglichkeiten zur Authentifizierung & Autorisierung 

Request-Parameter 

Parameter-Typ

Name

Bedeutung

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

Path

type

Typ des Prozesskontextes.

Mögliche Werte:

  • OrganisationUnit

  • Product

  • Software

  • Hardware

  • Document

  • Rule

  • ExternalParticipant

  • Person

  • SalaryBracket

Cookie (Header)

JSESSIONID

ID einer authentifizierten HTTP-Session 

Response 

  • JSON-Array mit den (geschachtelten) Baumknoten (Datenstruktur: Array von TreeNode-Objekten). Das Array enthält die Baum-Knoten auf Wurzel-Ebene (die Datenstruktur lässt mehrere Wurzeln zu).