Skip to main content

Endpoint del flusso di lavoro

Endpoint e parametri del flusso di lavoro

Per ulteriori informazioni sulle relazioni tra oggetti e su come utilizzarle nell'API, consulta la sezione Relazioni tra oggetti.

Per ulteriori informazioni sui flussi di lavoro, consulta la pagina di assistenza Flussi di lavoro.

Caricamento di un nuovo flusso di lavoro

Per caricare un nuovo flusso di lavoro, utilizza l'endpoint POST {baseURL}/v3/workflows.

Parametri

  • file (file): obbligatorio. Consente di selezionare il file che desideri caricare sul sistema. Il tipo di media deve essere un file YXZP.

  • name (stringa): obbligatorio. Immetti il nome di un flusso di lavoro. Si tratta del nome del flusso di lavoro da visualizzare nell'interfaccia utente di Server.

  • ownerId (stringa): obbligatorio. Immetti l'ID del proprietario.

  • workerTag (stringa): opzionale. Specifica il tag worker definito nei worker per facilitare l'assegnazione dei processi a determinati nodi worker. Per ulteriori informazioni, consulta la pagina di assistenza Worker.

  • districtTags (stringa): opzionale. Invia come array in formato JSON, ad esempio, ["id1", "id2"]. Utilizza i distretti per raggruppare i flussi di lavoro pubblici condivisi per tag in modo che gli utenti possano trovarli facilmente. Per ulteriori informazioni, consulta la pagina di assistenza Distretti.

  • comments (stringa): opzionale. Immetti i commenti.

  • isPublic (booleano): obbligatorio. Seleziona "true" per rendere il flusso di lavoro disponibile pubblicamente. Seleziona "false" per rendere il flusso di lavoro privato e non disponibile pubblicamente.

  • isReadyForMigration (booleano): obbligatorio. Specifica se il flusso di lavoro è pronto per la migrazione. Per ulteriori informazioni sulla migrazione da un ambiente Server a un altro, consulta la pagina di assistenza Abilitazione dei flussi di lavoro per la migrazione.

  • sourceAppId (stringa): opzionale. Imposta l'ID dell'app di origine di un flusso di lavoro. Puoi utilizzarlo come riferimento "sourceId" per l'endpoint POST admin/v1/workflows. Se fornisci un parametro sourceAppId preesistente, la richiesta non sarà valida.

  • othersMayDownload (booleano): obbligatorio. Specifica se altri utenti possono scaricare il flusso di lavoro.

  • othersCanExecute (booleano): obbligatorio. Specifica se altri utenti possono eseguire il flusso di lavoro.

  • executionMode (stringa): obbligatorio. I valori accettati sono "Provvisoria", "Semi provvisoria" e "Standard". Per ulteriori informazioni sulla modalità di esecuzione, consulta la pagina di assistenza Modalità di esecuzione Provvisoria e Semi provvisoria: strumenti, eventi e connettori dati bloccati.

  • hasPrivateDataExemption (booleano): opzionale. Fornisci un'esenzione per consentire l'esecuzione di un flusso di lavoro con dati privati. Seleziona "true" per consentire un'esenzione o "false" per rifiutarla. Per ulteriori informazioni, consulta la pagina Opzioni del flusso di lavoro nell'interfaccia di amministrazione.

  • workflowCredentialType (stringa): obbligatorio. I valori accettati sono "Predefinito", "Obbligatorio" e "Specifico".

  • credentialId (stringa): opzionale. Specifica il parametro credentialId del flusso di lavoro.

  • collectionIds (stringa): opzionale. Immetti il parametro collectionId(s) in cui aggiungere il flusso di lavoro. Invia come array in formato JSON, ad esempio, ["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: BadRequest

  • 401: Autorizzazione negata

Caricamento di una nuova versione in un flusso di lavoro esistente

Per caricare una nuova versione di un flusso di lavoro esistente, utilizza l'endpoint POST {baseURL}/v3/workflows/{workflowId}/versions.

Parametri

  • workflowId (stringa): obbligatorio. Immetti l'ID del flusso di lavoro di cui desideri caricare una nuova versione.

  • file (file): obbligatorio. Scegli il file che desideri caricare nel sistema come nuova versione. Il tipo di media deve essere un file YXZP.

  • name (stringa): obbligatorio. Immetti il nome del flusso di lavoro. Si tratta del nome del flusso di lavoro da visualizzare nell'interfaccia utente di Server.

  • ownerId (stringa): obbligatorio. Immetti l'ID del proprietario.

  • othersMayDownload (booleano): obbligatorio. L'impostazione predefinita è "true".

  • othersCanExecute (booleano): obbligatorio. L'impostazione predefinita è "true".

  • executionMode (stringa): obbligatorio. I valori accettati sono "Provvisoria", "Semi provvisoria" e "Standard". Per ulteriori informazioni sulla modalità di esecuzione, consulta la pagina di assistenza Modalità di esecuzione Provvisoria e Semi provvisoria: strumenti, eventi e connettori dati bloccati.

  • hasPrivateDataExemption (booleano): opzionale. Fornisci un'esenzione per consentire l'esecuzione di un flusso di lavoro con dati privati. Seleziona "true" per consentire un'esenzione o "false" per rifiutarla. Per ulteriori informazioni, consulta la pagina Opzioni del flusso di lavoro nell'interfaccia di amministrazione.

  • comments (stringa): opzionale. Immetti i commenti.

  • makePublished (booleano): obbligatorio. L'impostazione predefinita è "true". Il parametro makePublished consente di controllare se la nuova versione di un flusso di lavoro che invii a Server deve essere o meno quella pubblicata. Puoi impostare il valore su "false" quando invii il flusso di lavoro a Server, nel qual caso solo tu potrai eseguirlo.

  • workflowCredentialType (stringa): obbligatorio. Immetti il tipo di credenziale da utilizzare per il flusso di lavoro. I valori accettati sono "Predefinito", "Obbligatorio" e "Specifico".

  • credentialId (stringa): opzionale. Specifica il parametro credentialId per il flusso di lavoro. Per ulteriori informazioni sugli endpoint delle credenziali, consulta Endpoint delle credenziali.

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: BadRequest

  • 401: Autorizzazione negata

  • 404: Indica che workflowId, l'ID flusso di lavoro, nel percorso non è valido.

Recupero di tutti i flussi di lavoro

Per ottenere informazioni su tutti i record del flusso di lavoro, utilizza l'endpoint GET {baseURL}/v3/workflows/.

Parametri

  • view (stringa): opzionale. Seleziona la modalità di visualizzazione delle informazioni del flusso di lavoro. È possibile non specificare nessun valore o selezionare ‘Default’ and ‘Full’. Se il parametro è impostato su "Default", viene restituito un oggetto vista ridotto. Se non è specificato nessun valore, viene utilizzato "Default".

  • name (stringa): opzionale. Immetti il nome del flusso di lavoro se desideri filtrare i flussi di lavoro per nome. Si tratta del nome del flusso di lavoro visualizzato nell'interfaccia utente di Server.

  • ownerId (stringa): opzionale. Immetti l'ID del proprietario se desideri filtrare i flussi di lavoro per proprietario.

  • createdAfter (stringa): opzionale. Immetti la data e l'ora dopo le quali è stato creato il flusso di lavoro. Immetti la data e l'ora in formato ISO8601.

  • createdBefore (stringa): opzionale. Immetti la data e l'ora prima delle quali è stato creato il flusso di lavoro. Immetti la data e l'ora in formato ISO8601.

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: BadRequest

  • 401: Autorizzazione negata

Recupero del record di un flusso di lavoro specifico

Per ottenere informazioni su un flusso di lavoro specifico, utilizza l'endpoint GET {baseURL}/v3/workflows/{workflowId} .

Nota

Gli utenti non amministratori possono utilizzare l'endpoint GET v3/workflows/{workflowId} per i flussi di lavoro a cui hanno accesso. In passato, questo endpoint era limitato solo agli amministratori.

Parametri

  • workflowId (stringa): obbligatorio. Immetti l'ID del flusso di lavoro per ottenere informazioni sul flusso di lavoro.

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: Autorizzazione negata

  • 404: NotFound

Aggiornamento di un flusso di lavoro esistente

Per modificare le informazioni su un flusso di lavoro esistente, utilizza l'endpoint PUT {baseURL}/v3/workflows/{workflowId}.

Nota

Solo gli amministratori possono usare questo endpoint API.

Per modificare il parametro ownerId, il nuovo proprietario deve far parte della stessa iscrizione di quello corrente.

Parametri

  • workflowId (stringa): obbligatorio. Immetti l'ID del flusso di lavoro da aggiornare.

  • updateWorkflowContract (corpo): obbligatorio. Immetti i dati del flusso di lavoro da aggiornare.

    • name (stringa): obbligatorio. Immetti il nome del flusso di lavoro. Si tratta del nome del flusso di lavoro da visualizzare nell'interfaccia utente di Server.

    • versionId (stringa): obbligatorio. Immetti l'ID della versione.

    • makePublished (booleano): opzionale. Se non è specificato, il valore rimane invariato. Il parametro makePublished consente di controllare se la nuova versione di un flusso di lavoro che invii a Server deve essere o meno quella pubblicata. Puoi impostare il valore su "false" quando invii il flusso di lavoro a Server, nel qual caso solo tu potrai eseguirlo.

    • ownerId (stringa): obbligatorio. Immetti l'ID del proprietario.

    • workerTag (stringa): obbligatorio. Se non è presente nessun parametro workerTag, utilizza "".

    • districtTags (stringa): obbligatorio. Immetti i tag dei distretti. Utilizza i distretti per raggruppare i flussi di lavoro pubblici condivisi per tag in modo che gli utenti possano trovarli facilmente. Per ulteriori informazioni, consulta la pagina di assistenza Distretti.

    • comments (stringa): obbligatorio. Immetti i commenti.

    • isPublic (booleano): opzionale. Se non è specificato, il valore rimane invariato.

    • isReadyForMigration (booleano): opzionale. Se non è specificato, il valore rimane invariato.

    • othersMayDownload (booleano): opzionale. Se non è specificato, il valore rimane invariato. Se è impostato su "false" per un flusso di lavoro pubblico, il flusso di lavoro sarà inutilizzabile.

    • othersCanExecute (booleano): opzionale. Se non è specificato, il valore rimane invariato. Se è impostato su "false" per un flusso di lavoro pubblico, il flusso di lavoro sarà inutilizzabile.

    • executionMode (stringa) opzionale. I valori accettati sono "Provvisoria", "Semi provvisoria" e "Standard". Per ulteriori informazioni sulla modalità di esecuzione, consulta la pagina di assistenza Modalità di esecuzione Provvisoria e Semi provvisoria: strumenti, eventi e connettori dati bloccati.

    • hasPrivateDataExemption (booleano): opzionale. Fornisci un'esenzione per consentire l'esecuzione di un flusso di lavoro con dati privati. Seleziona "true" per consentire un'esenzione o "false" per rifiutarla. Se non è specificato, il valore rimane invariato. Per ulteriori informazioni, consulta la pagina Opzioni del flusso di lavoro nell'interfaccia di amministrazione.

    • WorkflowCredentialType (stringa): opzionale. I valori accettati sono "Predefinito", "Obbligatorio" e "Specifico".

    • credentialId (stringa): opzionale. Specifica il parametro credentialId per il flusso di lavoro.

  • Valore di esempio di 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: BadRequest

  • 401: Autorizzazione negata

  • 404: NotFound

Download di un pacchetto del flusso di lavoro

Per scaricare un pacchetto del flusso di lavoro, utilizza l'endpoint GET {baseURL}/v3/workflows/{workflowId}/package.

Parametri

  • workflowId (stringa): obbligatorio. Immetti l'ID del flusso di lavoro per il quale desideri scaricare il pacchetto.

  • versionId (stringa): opzionale. Immetti l'ID della versione specifica di un flusso di lavoro. Se non viene fornita alcuna versione, viene scaricata quella pubblicata.

    Nota

    Se versionID ha due cifre, potrebbe raggiungere le dimensioni massime consentite e potrebbe apparire l'errore "414 - URI troppo lungo". In questo caso, analizza la stringa JSON versionID e ritagliala in modo da includere solo la versione più recente. Ciò permetterà di controllare la lunghezza del campo.

Esempio di richiesta: cURL

curl -X GET --header 'Accept: application/octet-stream' --header 'Authorization: Bearer BearerTokenGoesHere' 'http://localhost/webapi/v3/workflows/635a4be7dc6e24bb8ff0/package'

Esempio di risposta

  • 200: Il flusso di download del file YXZP.

  • 400: VersionId non valido

  • 401: Autorizzazione negata

  • 403: L'utente autenticato non dispone dell'autorizzazione per il download del flusso di lavoro o il flusso di lavoro non può essere scaricato direttamente.

  • 404: NotFound

Recupero delle informazioni sulle domande relative a un flusso di lavoro

Per ottenere informazioni sulle domande relative a un flusso di lavoro, utilizza l'endpoint GET {baseURL}/v3/workflows/{workflowId}/questions.

Parametri

  • workflowId (stringa): obbligatorio. Immetti l'ID del flusso di lavoro per il quale desideri recuperare le informazioni.

  • versionId (stringa): opzionale. Immetti l'ID della versione specifica di un flusso di lavoro. Se non viene fornita alcuna versione, viene utilizzata quella pubblicata.

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: BadRequest

  • 401: Autorizzazione negata

  • 403: L'utente autenticato non ha accesso al flusso di lavoro o alle domande.

  • 404: NotFound

Informazioni sui processi di un flusso di lavoro specifico

Per ottenere informazioni sui processi di un flusso di lavoro specifico, utilizza l'endpoint GET {baseURL}/v3/workflows/{workflowId}/jobs.

Nota

Un processo potrebbe essere restituito come Completato anche se lo stato della query è Errore. Ciò indica che si è verificato un errore durante l'esecuzione, ma il flusso di lavoro è stato eseguito.

Parametri

  • workflowId (stringa): obbligatorio. Immetti l'ID del flusso di lavoro per il quale desideri recuperare le informazioni.

  • sortField (stringa): opzionale. Immettere il nome del campo per il quale si desidera ordinare i risultati.

  • direction (stringa): opzionale. Specifica qui il tipo di ordinamento. I valori accettati sono "asc" (crescente) e "desc" (decrescente). Se non è specificato alcun ordinamento, il valore predefinito sarà crescente.

  • offset (stringa): opzionale. Fa riferimento al record con cui si desidera che inizino i risultati.

  • limit (stringa): opzionale. Si riferisce all'ultimo record con cui si desidera che terminino i risultati.

  • status (stringa): opzionale. Lo stato generale dell'esecuzione del processo. Un processo completato può comunque avere esito negativo. I valori consentiti sono: "Completo", "Errore", "In esecuzione" e "In coda".

  • resultCode (stringa): opzionale. Il codice del risultato dell'esecuzione di un flusso di lavoro. Esso indica un flusso di lavoro non riuscito, ma un processo riuscito. I valori accettati sono: "Operazione riuscita", "Avvertenza" ed "Errore".

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: BadRequest

  • 401: Autorizzazione negata

  • 404: NotFound

Eliminazione di un flusso di lavoro

Per eliminare un flusso di lavoro specifico, utilizza l'endpoint DELETE {baseURL}/v3/workflows/{workflowId}.

Nota

Solo gli amministratori possono usare questo endpoint API.

Parametri

  • workflowId (stringa): obbligatorio. Immetti l'ID del flusso di lavoro da eliminare.

  • force (booleano): opzionale. In assenza di una specifica, il valore predefinito è "false". Se è pianificato un flusso di lavoro, il parametro impostato su "true" eliminerà tutte le pianificazioni prima di procedere con l'eliminazione.

curl -X 'DELETE' \
  'http://localhost/webapi/v3/workflows/670ce95bf10214f22a665bc4' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer BearerTokenGoesHere'
  • 200: OK

  • 400: BadRequest

  • 401: Autorizzazione negata

  • 404: NotFound

Creazione di un nuovo processo

Per creare un nuovo processo e aggiungerlo alla coda di esecuzione dei processi., utilizza l'endpoint POST /v3/workflows/{workflowId}/jobs.

Parametri

  • workflowId (stringa): obbligatorio. Immetti l'ID di un flusso di lavoro che desideri pianificare.

  • contract (corpo): per creare un nuovo processo, specifica i seguenti parametri:

    • workerTag (stringa): opzionale. Specifica il worker assegnato. In assenza di specifica, il valore sarà 'none'.

    • credentialId (stringa): opzionale. Specifica il parametro credentialId per il flusso di lavoro.

    • questions (stringa): opzionale. Per le app analitiche, specifica le domande e le risposte per eseguire il flusso di lavoro.

      • name (stringa): opzionale.

      • value (stringa): opzionale.

    • priority (stringa): opzionale. Specifica la priorità per l'esecuzione della pianificazione. Puoi scegliere tra i seguenti valori: "Bassa", "Media", "Alta" e "Critica". In assenza di specifica, il valore predefinito sarà "Bassa".

Valore di esempio del contratto:

{
  "workerTag": "string",
  "credentialId": "string",
  "questions": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "priority": "Default"
}

Esempio di richiesta di creazione di un processo:

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: BadRequest

  • 401: Autorizzazione negata

  • 403: L'utente autenticato non dispone dell'accesso per eseguire il flusso di lavoro.

  • 404: NotFound

Trasferimento di flussi di lavoro e pianificazioni a un proprietario specifico

Per trasferire un flusso di lavoro specifico a un proprietario specifico, insieme alle pianificazioni, se si desidera, utilizza l'endpoint PUT {baseURL}/v3/workflows/{workflowId}/transfer.

Nota

  • Solo gli amministratori possono usare questo endpoint API.

  • Se un qualsiasi flusso di lavoro richiede connessioni DCM, connessioni server o un'esecuzione specifica come credenziali per l'esecuzione, questi elementi devono essere aggiornati prima che di poter eseguire il flusso di lavoro.

  • Se gli utenti non si trovano nello stesso studio e quando un flusso di lavoro viene trasferito al nuovo studio, tutti gli altri utenti nello studio del nuovo proprietario riceveranno anche l'accesso al flusso di lavoro e tutti gli utenti del vecchio studio perderanno l'accesso.

  • I flussi di lavoro possono essere trasferiti solo a un utente con il ruolo di Creatore o Amministratore.

  • Se il trasferimento riguarda le pianificazioni, il nuovo proprietario deve avere accesso al flusso di lavoro pianificato, altrimenti non potrai trasferire tale flusso di lavoro al nuovo proprietario.

  • Se il trasferimento riguarda le pianificazioni, il nuovo proprietario deve disporre dell'autorizzazione per pianificare i flussi di lavoro.

  • Se l'utente viene eliminato, restituisce un elenco di ID pianificazione che verranno interrotti o disattivati dopo il trasferimento.

Parametri

  • workflowId (stringa): obbligatorio. Specifica l'ID del flusso di lavoro da trasferire.

  • contract (corpo): obbligatorio. Specifica le seguenti informazioni:

    • ownerId (stringa): obbligatorio. Specifica l'ID del nuovo proprietario.

    • transferSchedules (booleano): obbligatorio. Specifica se le pianificazioni devono essere trasferite a un nuovo proprietario insieme al flusso di lavoro. Solo le pianificazioni di proprietà del proprietario del flusso di lavoro corrente verranno trasferite al nuovo proprietario.

Valore di esempio del contratto:

{
  "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: BadRequest

    "string"
  • 401: Autorizzazione negata

  • 403: Forbidden

    "string"
  • 404: NotFound

    "string"
  • 500: InternalServerError

Relazioni tra oggetti

Se stai caricando un flusso di lavoro, puoi utilizzare gli oggetti creati nel modo seguente:

Oggetto creato: "workflowId" (ad esempio, "id": "7917969784f84bd09442f66996ecb8f3")

Puoi utilizzarlo come:

Esempi di richiesta Postman

GET /v3/workflows/{workflowId}

Use GET /v3/workflows/{workflowId} endpoint.

Per ulteriori informazioni sulle richieste Postman, consulta la pagina di assistenza Come utilizzare Postman.