Workflow-Endpunkte
Workflow-Endpunkte und Parameter
Weitere Informationen zu Objektbeziehungen und deren Verwendung in der API finden Sie im Abschnitt Objektbeziehungen.
Weitere Informationen zu Workflows finden Sie auf der Hilfeseite Workflows.
Einen neuen Workflow hochladen
Um einen neuen Workflow hochzuladen, verwenden Sie den Endpunkt POST {baseURL}/v3/workflows
.
Parameter
file (Datei): Erforderlich. Wählen Sie die vorliegende Datei, die Sie in das System hochladen möchten. Der Medientyp muss eine YXZP-Datei sein.
name (Zeichenfolge): Erforderlich. Geben Sie einen Workflow-Namen ein. Dies ist der Name des Workflows, der in der Server-Benutzeroberfläche angezeigt werden soll.
ownerId (Zeichenfolge): Erforderlich. Geben Sie die ID des Besitzers ein.
workerTag (Zeichenfolge): Optional. Geben Sie das in den Workern definierte Worker-Tag an, um Worker-Knoten Aufträge einfacher zuzuweisen. Weitere Informationen finden Sie auf der Hilfeseite zu Worker.
districtTags (Zeichenfolge): Optional. Übermitteln Sie dies als Array im JSON-Format, z. B. ["id1", "id2"]. Verwenden Sie Bereiche, um freigegebene, öffentliche Workflows nach Tags zu gruppieren, damit Benutzer sie leicht finden können. Weitere Informationen finden Sie auf der Hilfeseite Bereiche.
comments (Zeichenfolge): Optional. Geben Sie Ihre Kommentare ein.
isPublic (boolescher Wert): Erforderlich. Wählen Sie „true“ aus, um den Workflow öffentlich verfügbar zu machen. Wählen Sie „false“ aus, um den Workflow privat zu machen, d. h., dass er öffentlich nicht verfügbar ist.
isReadyForMigration (boolescher Wert): Erforderlich. Wählen Sie aus, ob der Workflow zur Migration bereit ist. Weitere Informationen zur Migration von einer Server-Umgebung in eine andere finden Sie auf der Hilfeseite Workflows für Migration aktivieren.
sourceAppId (Zeichenfolge): Optional. Legt die Quell-App-ID für einen Workflows fest. Sie können diese als die Referenz „sourceId“ für den Endpunkt
POST admin/v1/workflows
verwenden. Die Angabe einer bereits vorhandenen „sourceAppId“ führt zu einer ungültigen Anforderung.othersMayDownload (boolescher Wert): Erforderlich. Geben Sie an, ob andere Benutzer diesen Workflow herunterladen dürfen.
othersCanExecute (boolescher Wert): Erforderlich. Geben Sie an, ob andere Benutzer diesen Workflow ausführen dürfen.
executionMode (Zeichenfolge): Erforderlich. Akzeptierte Werte sind „Safe“, „SemiSafe“ und „Standard“. Weitere Informationen zum Ausführungsmodus finden Sie auf der Hilfeseite Sichere und halbsichere Ausführungsmodi: gesperrte Tools, Ereignisse und Datenkonnektoren.
hasPrivateDataExemption (boolescher Wert): Optional. Erteilen Sie eine Ausnahme, damit ein Workflow mit privaten Daten ausgeführt werden kann. Wählen Sie „true“ aus, um eine Ausnahme zuzulassen oder „false“, um eine Ausnahme zu verweigern. Weitere Informationen finden Sie auf der Hilfeseite Workflow-Optionen in Admin.
workflowCredentialType (Zeichenfolge): Erforderlich. Akzeptierte Werte sind „Standard“, „Erforderlich“ und „Spezifisch“.
credentialId (Zeichenfolge): optional. Geben Sie die credentialId für diesen Workflow an.
collectionIds (Zeichenfolge): Optional. Geben Sie die collectionId(s) ein, denen dieser Workflow hinzugefügt werden soll. Übermitteln Sie dies als Array im JSON-Format, z. B.: ["id1", "id2"].
curl -X 'POST' \ 'http://localhost/webapi/v3/workflows' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere' \ -H 'Content-Type: multipart/form-data' \ -F 'file=@Workflow2.yxzp;type=application/yxzp' \ -F 'name=Workflow2' \ -F 'ownerId=66ebd0896e52ae73b4951072' \ -F 'isPublic=true' \ -F 'isReadyForMigration=true' \ -F 'othersMayDownload=true' \ -F 'othersCanExecute=false' \ -F 'executionMode=Standard' \ -F 'workflowCredentialType=Default'
200: OK
"string"
400: Fehlerhafte Anfrage
401: Keine Berechtigung
Eine neue Version in einen bestehenden Workflow hochladen
Um eine neue Version eines vorhandenen Workflows hochzuladen, verwenden Sie den Endpunkt POST {baseURL}/v3/workflows/{workflowId}/versions
.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, für die Sie eine neue Version hochladen möchten.
file (Datei): Erforderlich. Wählen Sie die tatsächliche Datei aus, die Sie als neue Version in das System hochladen möchten. Der Medientyp muss eine YXZP-Datei sein.
name (Zeichenfolge): Erforderlich. Geben Sie den Workflow-Namen ein. Dies ist der Name des Workflows, der in der Server-Benutzeroberfläche angezeigt werden soll.
ownerId (Zeichenfolge): Erforderlich. Geben Sie die ID des Besitzers ein.
othersMayDownload (boolescher Wert): Erforderlich. Die Standardeinstellung ist „true“.
othersCanExecute (boolescher Wert): Erforderlich. Die Standardeinstellung ist „true“.
executionMode (Zeichenfolge): Erforderlich. Akzeptierte Werte sind „Safe“, „SemiSafe“ und „Standard“. Weitere Informationen zum Ausführungsmodus finden Sie auf der Hilfeseite Sichere und halbsichere Ausführungsmodi: gesperrte Tools, Ereignisse und Datenkonnektoren.
hasPrivateDataExemption (boolescher Wert): Optional. Erteilen Sie eine Ausnahme, damit ein Workflow mit privaten Daten ausgeführt werden kann. Wählen Sie „true“ aus, um eine Ausnahme zuzulassen oder „false“, um eine Ausnahme zu verweigern. Weitere Informationen finden Sie auf der Hilfeseite Workflow-Optionen in Admin.
comments (Zeichenfolge): Optional. Geben Sie Ihre Kommentare ein.
makePublished (boolescher Wert): Erforderlich. Die Standardeinstellung ist „true“. Mit dem Parameter „makePublished“ können Sie steuern, ob die neue Version eines Workflows, den Sie an Server senden, die veröffentlichte Version sein soll oder nicht. Sie können den Wert auf „false“ setzen, wenn Sie den Workflow an Server senden. In dem Fall können dann nur Sie ihn ausführen.
workflowCredentialType (Zeichenfolge): Erforderlich. Geben Sie den Typ der Anmeldedaten ein, die für diesen Workflow verwendet werden sollen. Akzeptierte Werte sind „Standard“, „Erforderlich“ und „Spezifisch“.
credentialId (Zeichenfolge): optional. Geben Sie die ID für die Anmeldedaten für diesen Workflow an. Weitere Informationen zu Endpunkten mit Anmeldedaten finden Sie unter Endpunkte mit Anmeldedaten.
curl -X 'POST' \ 'http://localhost/webapi/v3/workflows/66ebd18d6e52ae73b4951085/versions' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere' \ -H 'Content-Type: multipart/form-data' \ -F 'file=@Workflow3.yxzp;type=application/yxzp' \ -F 'name=Workflow1_3' \ -F 'ownerId=66ebd0896e52ae73b4951072' \ -F 'othersMayDownload=true' \ -F 'othersCanExecute=true' \ -F 'executionMode=Standard' \ -F 'makePublished=true' \ -F 'workflowCredentialType=Default'
200: OK
{ "id": "string", "sourceAppId": "string", "dateCreated": "2024-09-19T07:33:01.072Z", "runCount": 0, "versions": [ { "versionId": "string", "versionNumber": 0, "dateCreated": "2024-09-19T07:33:01.072Z", "uploadSource": "Designer", "uploadDate": "2024-09-19T07:33:01.072Z", "packageWorkflowType": "App", "published": true, "comments": "string", "runDisabled": true, "executionMode": "Safe", "workflowCredentialType": "Default", "credentialId": "string", "hasPrivateDataExemption": true, "othersMayDownload": true, "othersCanViewHistory": true, "details": { "isAmp": true, "fileName": "string", "author": "string", "copyright": "string", "description": "string", "name": "string", "noOutputFilesMessage": "string", "outputMessage": "string", "url": "string", "urlText": "string" } } ], "name": "string", "ownerId": "string", "workerTag": "string", "districtTags": [ "string" ], "comments": "string", "isPublic": true, "isReadyForMigration": true, "publishedVersionId": "string", "othersMayDownload": true, "othersCanViewHistory": true, "othersCanExecute": true, "executionMode": "Safe", "hasPrivateDataExemption": true }
401: Fehlerhafte Anfrage
401: Keine Berechtigung
404: Gibt an, dass die Workflow-ID im Pfad ungültig ist.
Alle Workflows abrufen
Um Informationen zu allen Workflow-Datensätzen abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/
.
Parameter
view (Zeichenfolge): optional. Wählen Sie aus, wie Sie die Workflow-Informationen anzeigen lassen möchten. Kann ohne Wert belassen werden. Sie können aus den folgenden Werten wählen: „Standard“ und „Vollständig“. Wenn dieser Parameter auf „Standard“ gesetzt ist, wird ein reduziertes Ansichtsobjekt zurückgegeben. Wenn keine Angaben gemacht werden, wird der Standardwert verwendet.
name (Zeichenfolge): Optional. Geben Sie den Namen des Workflows ein, falls Sie die Workflows nach Namen filtern möchten. Dies ist der Name des Workflows, der in der Server-Benutzeroberfläche angezeigt wird.
ownerId (Zeichenfolge): Optional. Geben Sie die ID des Besitzers ein, falls Sie die Workflows nach dem jeweiligen Besitzer filtern möchten.
createdAfter (Zeichenfolge): Optional. Geben Sie das Datum und die Uhrzeit ein, wonach der Workflow erstellt wurde. Geben Sie Datum und Uhrzeit im ISO8601-Format ein.
createdBefore (Zeichenfolge): Optional. Geben Sie das Datum und die Uhrzeit ein, wovor der Workflow erstellt wurde. Geben Sie Datum und Uhrzeit im ISO8601-Format ein.
curl -X 'GET' \ 'http://localhost/webapi/v3/workflows' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere'
200: OK
{ "id": "string", "sourceAppId": "string", "name": "string", "ownerId": "string", "dateCreated": "2024-08-15T11:14:56.965Z", "publishedVersionNumber": 0, "isAmp": true, "executionMode": "Safe" } ]
400: Fehlerhafte Anfrage
401: Keine Berechtigung
Einen spezifischen Workflow-Datensatz abrufen
Um Informationen zu einem bestimmten Workflow abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/{workflowId}
.
Anmerkung
Nicht-Administrator:innen können den Endpunkt GET v3/workflows/{workflowId}
für Workflows nutzen, auf die sie Zugriff haben. Bisher war dieser Endpunkt auf Administrator:innen beschränkt.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, um Informationen zu diesem Workflow abzurufen.
curl -X 'GET' \ 'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere'
200: OK
{ "id": "string", "sourceAppId": "string", "dateCreated": "2024-09-05T10:42:53.360Z", "runCount": 0, "versions": [ { "versionId": "string", "versionNumber": 0, "dateCreated": "2024-09-05T10:42:53.360Z", "uploadSource": "Designer", "uploadDate": "2024-09-05T10:42:53.360Z", "packageWorkflowType": "App", "published": true, "comments": "string", "runDisabled": true, "executionMode": "Safe", "workflowCredentialType": "Default", "credentialId": "string", "hasPrivateDataExemption": true, "othersMayDownload": true, "othersCanViewHistory": true, "details": { "isAmp": true, "fileName": "string", "author": "string", "copyright": "string", "description": "string", "name": "string", "noOutputFilesMessage": "string", "outputMessage": "string", "url": "string", "urlText": "string" } } ], "name": "string", "ownerId": "string", "workerTag": "string", "districtTags": [ "string" ], "comments": "string", "isPublic": true, "isReadyForMigration": true, "publishedVersionId": "string", "othersMayDownload": true, "othersCanViewHistory": true, "othersCanExecute": true, "executionMode": "Safe", "hasPrivateDataExemption": true }
401: Keine Berechtigung
404: Nicht gefunden
Einen vorhandenen Workflow aktualisieren
Um Informationen zu einem vorhandenen Workflow zu ändern, verwenden Sie den Endpunkt PUT {baseURL}/v3/workflows/{workflowId}
.
Anmerkung
Nur Administratoren können diesen API-Endpunkt verwenden.
Um die „ownerId“ zu ändern, muss sich der neue Besitzer im selben Abonnement wie der aktuelle Besitzer befinden.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie die ID des Workflows ein, den Sie aktualisieren möchten.
updateWorkflowContract (Text): Erforderlich. Geben Sie die zu aktualisierenden Workflowinformationen ein.
name (Zeichenfolge): Erforderlich. Geben Sie den Workflow-Namen ein. Dies ist der Name des Workflows, der in der Server-Benutzeroberfläche angezeigt werden soll.
versionId (Zeichenfolge): Erforderlich. Geben Sie die Versions-ID ein.
makePublished (boolescher Wert): Optional. Wenn keine Angabe gemacht wird, bleibt der Wert unverändert. Mit dem Parameter „makePublished“ können Sie steuern, ob die neue Version eines Workflows, den Sie an Server senden, die veröffentlichte Version sein soll oder nicht. Sie können den Wert auf „false“ setzen, wenn Sie den Workflow an Server senden. In dem Fall können dann nur Sie ihn ausführen.
ownerId (Zeichenfolge): Erforderlich. Geben Sie die Besitzer-ID ein.
workerTag (Zeichenfolge): Erforderlich. Wenn kein Worker-Tag vorhanden ist, verwenden Sie stattdessen .""
districtTags (Zeichenfolge): Erforderlich. Geben Sie die Bereichs-Tags ein. Verwenden Sie Bereiche, um freigegebene, öffentliche Workflows nach Tags zu gruppieren, damit Benutzer sie leicht finden können. Weitere Informationen finden Sie auf der Hilfeseite Bereiche.
comments (Zeichenfolge): Erforderlich. Geben Sie Ihre Kommentare ein.
isPublic (boolescher Wert): Optional. Wenn keine Angabe gemacht wird, bleibt der Wert unverändert.
isReadyForMigration (boolescher Wert): Optional. Wenn keine Angabe gemacht wird, bleibt der Wert unverändert.
othersMayDownload (boolescher Wert): Optional. Wenn keine Angabe gemacht wird, bleibt der Wert unverändert. Wenn der Wert für einen öffentlichen Workflow auf „false“ gesetzt ist, kann der Workflow nicht verwendet werden.
othersCanExecute (boolescher Wert): Optional. Wenn keine Angabe gemacht wird, bleibt der Wert unverändert. Wenn der Wert für einen öffentlichen Workflow auf „false“ gesetzt ist, kann der Workflow nicht verwendet werden.
executionMode (Zeichenfolge): Optional. Akzeptierte Werte sind „Safe“, „SemiSafe“, „Standard“. Weitere Informationen zum Ausführungsmodus finden Sie auf der Hilfeseite Sichere und halbsichere Ausführungsmodi: gesperrte Tools, Ereignisse und Datenkonnektoren.
hasPrivateDataExemption (boolescher Wert): Optional. Erteilen Sie eine Ausnahme, damit ein Workflow mit privaten Daten ausgeführt werden kann. Wählen Sie „true“ aus, um eine Ausnahme zuzulassen oder „false“, um eine Ausnahme zu verweigern. Wenn keine Angabe gemacht wird, bleibt der Wert unverändert. Weitere Informationen finden Sie auf der Hilfeseite Workflow-Optionen in Admin.
workflowCredentialType (Zeichenfolge): Optional. Akzeptierte Werte sind „Standard“, „Erforderlich“ und „Spezifisch“.
credentialId (Zeichenfolge): Optional. Geben Sie die ID für die Anmeldedaten für diesen Workflow an.
Beispielwert von updateWorkflowContract:
{ "name": "string", "versionId": "string", "makePublished": true, "ownerId": "string", "workerTag": "string", "districtTags": [ "string" ], "comments": "string", "isPublic": true, "isReadyForMigration": true, "othersMayDownload": true, "othersCanExecute": true, "executionMode": "Safe", "hasPrivateDataExemption": true, "workflowCredentialType": "Default", "credentialId": "string" }
curl -X 'PUT' \ 'http://localhost/webapi/v3/workflows/66ebd18d6e52ae73b4951085' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere' \ -H 'Content-Type: application/json' \ -d '{ "name": "Workflow_3_4", "versionId": "66ebd18d3d6200007e000d89", "makePublished": true, "ownerId": "66ebd0896e52ae73b4951072", "workerTag": "", "districtTags": [], "comments": "nothing", "isPublic": true, "isReadyForMigration": true, "othersMayDownload": true, "othersCanExecute": true, "executionMode": "Safe", "hasPrivateDataExemption": true, "workflowCredentialType": "Default", "credentialId": "" }'
200: OK
{ "id": "string", "sourceAppId": "string", "dateCreated": "2024-08-15T11:20:45.231Z", "runCount": 0, "versions": [ { "versionId": "string", "versionNumber": 0, "dateCreated": "2024-08-15T11:20:45.231Z", "uploadSource": "Designer", "uploadDate": "2024-08-15T11:20:45.231Z", "packageWorkflowType": "App", "published": true, "comments": "string", "runDisabled": true, "executionMode": "Safe", "workflowCredentialType": "Default", "credentialId": "string", "hasPrivateDataExemption": true, "othersMayDownload": true, "othersCanViewHistory": true, "details": { "isAmp": true, "fileName": "string", "author": "string", "copyright": "string", "description": "string", "name": "string", "noOutputFilesMessage": "string", "outputMessage": "string", "url": "string", "urlText": "string" } } ], "name": "string", "ownerId": "string", "workerTag": "string", "districtTags": [ "string" ], "comments": "string", "isPublic": true, "isReadyForMigration": true, "publishedVersionId": "string", "othersMayDownload": true, "othersCanViewHistory": true, "othersCanExecute": true, "executionMode": "Safe", "hasPrivateDataExemption": true }
400: Fehlerhafte Anfrage
401: Keine Berechtigung
404: Nicht gefunden
Workflow-Paket herunterladen
Um ein Workflowpaket herunterzuladen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/{workflowId}/package
.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, für die Sie das Paket herunterladen möchten.
versionId (Zeichenfolge): Optional. Geben Sie die spezifische Versions-ID eines Workflows ein. Wenn Sie keine Version angeben, wird die veröffentlichte Version heruntergeladen.
Anmerkung
Wenn die VersionID zweistellig ist, kann die Größenbeschränkung erreicht werden, und Sie erhalten möglicherweise den Fehler „414 - URI Too Long“. In diesem Fall parsen Sie die JSON-VersionID-Zeichenfolge, und schneiden Sie sie nur auf die neueste Version zu. Dadurch wird die Feldlänge unter Kontrolle gehalten.
Anforderungsbeispiel: cURL
curl -X GET --header 'Accept: application/octet-stream' --header 'Authorization: Bearer BearerTokenGoesHere' 'http://localhost/webapi/v3/workflows/635a4be7dc6e24bb8ff0/package'
Antwortbeispiel
200: Der Download-Stream der YXZP-Datei.
400: Ungültige VersionId
401: Keine Berechtigung
403: Der authentifizierte Benutzer hat keine Berechtigung zum Herunterladen des Workflows oder der Workflow kann nicht direkt heruntergeladen werden.
404: Nicht gefunden
Frageninformationen für einen Workflow abrufen
Um Frageinformationen zu einem Workflow oder einer Analyse-App abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/{workflowId}/questions
.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, für die Sie die Informationen abrufen möchten.
versionId (Zeichenfolge): Optional. Geben Sie die spezifische Versions-ID eines Workflows ein. Wenn Sie keine Version angeben, wird die veröffentlichte Version verwendet.
curl -X 'GET' \ 'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/questions' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere'
200: OK
[ { "name": "string", "questionType": "string", "description": "string", "value": "string", "multiple": true, "items": [ { "key": "string", "value": "string" } ] } ]
400: Fehlerhafte Anfrage
401: Keine Berechtigung
403: Der authentifizierte Benutzer hat keinen Zugriff auf den Workflow oder die Fragen.
404: Nicht gefunden
Informationen zu Aufträgen für einen spezifischen Workflow abrufen
Um Informationen über Aufträge für einen spezifischen Workflow abzurufen, verwenden Sie den Endpunkt GET {baseURL}/v3/workflows/{workflowId}/jobs
.
Anmerkung
Ein Auftrag wird möglicherweise als abgeschlossen zurückgegeben, auch wenn der Abfragestatus „Fehler“ lautet. Dies weist darauf hin, dass während der Ausführung ein Fehler aufgetreten ist, der Workflow aber ausgeführt wurde.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie die Workflow-ID ein, für die Sie die Informationen abrufen möchten.
sortField (Zeichenfolge): Optional. Geben Sie den Feldnamen ein, nach dem die Ergebnisse sortiert werden sollen.
direction (Zeichenfolge): Optional. Geben Sie hier die Sortierreihenfolge an. Zulässige Werte sind „asc“ (aufsteigend) und „desc“ (absteigend). Wenn keine Sortierung angegeben ist, ist die Standardeinstellung „aufsteigend“.
offset (Zeichenfolge): Optional. Bezieht sich auf den Datensatz, mit dem Ihre Ergebnisse beginnen sollen.
limit (Zeichenfolge): Optional. Bezieht sich auf den letzten Datensatz, mit dem Ihre Ergebnisse enden sollen.
status (Zeichenfolge): Optional. Der Gesamtstatus der Auftragsausführung. Ein abgeschlossener Auftrag kann auch fehlgeschlagen sein. Akzeptierte Werte sind „Abgeschlossen“, „Fehler“, „Wird ausgeführt“ und „In Warteschlange“.
resultCode (Zeichenfolge) Optional. Der Ergebniscode für die Ausführung eines Workflows. Dieser weist auf einen fehlgeschlagenen Workflow, aber auf einen erfolgreich ausgeführten Auftrag hin. Akzeptierte Werte sind „Erfolg“, „Warnung“ und „Fehler“.
curl -X 'GET' \ 'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/jobs' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere'
200: OK
[ { "id": "string", "createDate": "2024-08-15T11:29:53.357Z", "status": "Created", "priority": "string", "workerTag": "string", "runWithE2": true } ]
400: Fehlerhafte Anfrage
401: Keine Berechtigung
404: Nicht gefunden
Workflow löschen
Um einen spezifischen Workflow zu löschen, verwenden Sie den Endpunkt DELETE {baseURL}/v3/workflows/{workflowId}
.
Anmerkung
Nur Administratoren können diesen API-Endpunkt verwenden.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie die zu löschende Workflow-ID ein.
force (boolescher Wert): Optional. Wenn Sie diese Option nicht ausgewählt haben, lautet der Standardwert „false“. Wenn ein Workflow geplant ist, werden durch den auf „true“ gesetzten Parameter alle Zeitpläne gelöscht, bevor der Workflow gelöscht wird.
curl -X 'DELETE' \ 'http://localhost/webapi/v3/workflows/670ce95bf10214f22a665bc4' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere'
200: OK
400: Fehlerhafte Anfrage
401: Keine Berechtigung
404: Nicht gefunden
Neuen Auftrag erstellen
Um einen neuen Auftrag zu erstellen und ihn der Auftragsausführungswarteschlange hinzuzufügen, verwenden Sie den Endpunkt POST /v3/workflows/{workflowId}/jobs
.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie eine Workflow-ID ein, die geplant werden soll.
contract (Text): Geben Sie die folgenden Parameter an, um einen neuen Auftrag zu erstellen:
workerTag (Zeichenfolge): Optional. Geben Sie den zugewiesenen Worker an. Wenn keine Angabe gemacht wird, ist der Wert „none“.
credentialId (Zeichenfolge): Optional. Geben Sie die ID für die Anmeldedaten für diesen Workflow an.
questions (Zeichenfolge): Optional. Geben Sie bei einer analytischen App die Fragen und Antworten zur Ausführung des Workflows an.
name (Zeichenfolge): Optional.
value (Zeichenfolge): Optional.
priority (Zeichenfolge): Optional. Geben Sie die Priorität für die Ausführung des Zeitplans an. Wählen Sie aus den folgenden Werten aus: „Low“ (Niedrig), „Medium“ (Mittel), „High“ (Hoch) und „Critical“ (Kritisch). Wenn keine Angabe gemacht wird, ist der Standardwert „Low“.
Beispielwert des Vertrags:
{ "workerTag": "string", "credentialId": "string", "questions": [ { "name": "string", "value": "string" } ], "priority": "Default" }
Beispiel für eine Anforderung zum Erstellen eines Auftrags:
curl -X 'POST' \ 'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/jobs' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere' \ -H 'Content-Type: application/json' \ -d '{ "workerTag": "", "credentialId": "", "priority": "Low" }'
200: OK
{ "id": "string", "appId": "string", "createDateTime": "2024-09-05T11:13:04.586Z", "status": "string", "disposition": "string", "outputs": [ { "id": "string", "availableFormats": [ "string" ], "fileName": "string" } ], "messages": [ { "status": 0, "text": "string", "toolId": 0 } ], "priority": "Default", "workerTag": "string", "runWithE2": true }
400: Fehlerhafte Anfrage
401: Keine Berechtigung
403: Der authentifizierte Benutzer hat keinen Zugriff auf die Ausführung des Workflows.
404: Nicht gefunden
Workflows und Zeitpläne an einen angegebenen Eigentümer übertragen
Um einen bestimmten Workflow zusammen mit Zeitplänen (bei Bedarf) an bestimmte Eigentümer:innen zu übertragen, verwenden Sie den Endpunkt PUT {baseURL}/v3/workflows/{workflowId}/transfer
.
Anmerkung
Nur Administratoren können diesen API-Endpunkt verwenden.
Wenn für einen Workflow DCM-Verbindungen, Serververbindungen oder bestimmte „Run-as“-Anmeldedaten erforderlich sind, müssen diese Elemente aktualisiert werden, bevor der Workflow ausgeführt werden kann.
Wenn sich Benutzer:innen nicht im selben Studio befinden und ein Workflow in das neue Studio übertragen wird, erhalten alle anderen Benutzer:innen im Studio des neuen Eigentümers bzw. der neuen Eigentümerin ebenfalls Zugriff auf den Workflow und alle Benutzer:innen des alten Studios haben keinen Zugriff mehr.
Workflows können nur an Benutzer:innen mit der Rolle „Creator“ oder „Administrator“ übertragen werden.
Wenn Zeitpläne übertragen werden, muss der neue Eigentümer bzw. die neue Eigentümerin Zugriff auf den geplanten Zeitplan haben. Andernfalls können Sie diesen Zeitplan nicht an neue Eigentümer:innen übertragen.
Wenn Zeitpläne übertragen werden, muss der neue Eigentümer bzw. die neue Eigentümerin über die Berechtigung verfügen, Workflows zu planen.
Wenn Benutzer:innen gelöscht werden, wird eine Liste der Zeitplan-IDs zurückgegeben, die nach der Übertragung nicht mehr gelten oder deaktiviert sind.
Parameter
workflowId (Zeichenfolge): erforderlich. Geben Sie die ID des Workflows an, der übertragen werden soll.
contract (Text): erforderlich. Geben Sie die folgenden Informationen an:
ownerId (Zeichenfolge): erforderlich. Geben Sie die ID des neuen Eigentümers oder der neuen Eigentümerin an.
transferSchedules (boolescher Wert): Erforderlich. Geben Sie an, ob die Zeitpläne zusammen mit dem Workflow an einen neuen Eigentümer oder eine neue Eigentümerin übertragen werden sollen. Es werden nur die Zeitpläne, deren Eigentümer der aktuelle Workflow-Eigentümer ist, an den neuen Eigentümer bzw. an die neue Eigentümerin übertragen.
Beispielwert des Vertrags:
{ "ownerId": "string", "transferSchedules": true }
curl -X 'PUT' \ 'http://localhost/webapi/v3/workflows/670ce5cef10214f22a6637a3/transfer' \ -H 'accept: application/json' \ -H 'authorization: Bearer BearerTokenGoesHere' \ -H 'Content-Type: application/json' \ -d '{ "ownerId": "670ceafbf10214f22a666c76", "transferSchedules": true }'
200: OK
400: Fehlerhafte Anfrage
"string"
401: Keine Berechtigung
403: Verboten
"string"
404: Nicht gefunden
"string"
500: Interner Server-Fehler
Objektbeziehungen
Wenn Sie einen Workflow hochladen, können Sie erstellte Objekte wie folgt verwenden:
Objekt erstellt: "workflowId" (z. B. "id": "7917969784f84bd0942f66996ecb8f3")
Sie können sie wie folgt verwenden:
workflowId, wenn Sie Workflows einer Sammlung hinzufügen.
appId, wenn Sie Workflows aus einer Sammlung entfernen.
workflowId, wenn Sie nach einem spezifischen Workflow suchen.
workflowId, wenn Sie einen spezifischen Workflow löschen.
workflowId, wenn Sie einen vorhandenen Workflow aktualisieren.
workflowId, wenn Sie eine neue Version eines vorhandenen Workflows hochladen.
workflowId, wenn Sie nach einem Zeitplan suchen.
workflowId, wenn Sie einen Zeitplan erstellen.
workflowId, wenn Sie ein Workflow-Paket herunterladen.
workflowId, wenn Sie Frageinformationen für einen Workflow abrufen möchten.
workflowId, wenn Sie Informationen zu Aufträgen für einen Workflow abrufen möchten.
Beispiele für eine Postman-Anforderung
GET /v3/workflows/{workflowId}

Weitere Informationen zu Postman-Anforderungen finden Sie auf der Hilfeseite Postman verwenden.