Orchestrator

Configurare un flusso di lavoro

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Per continuare con il flusso di lavoro di esempio, devi configurarlo.

Per accedere alla configurazione di un blocco, fai clic su Modifica parametri nella scheda Configura. In alternativa, fai clic con il pulsante destro del mouse sul blocco e seleziona Modifica parametri per aprire la finestra Modifica parametri. Una volta che un blocco dispone di parametri, il pulsante Aggiungi parametri diventa Modifica parametri.

Per configurare i blocchi per l'esempio, segui questi passaggi:

  1. Apri la finestra Modifica parametri per l'azione language-blue.svgElenca impostazioni locali.

  2. I campi Token di accesso e Progetto richiedono valori dinamici, risolti in fase di esecuzione.

    1. Fai clic sull'icona di collegamento Icona di collegamento per il campo Token di accesso e seleziona l'azione circle-blue.svgRecupera i token di accesso.

      Il collegamento diventa verde e il campo può essere modificato.

    2. La sintassi per accedere alle proprietà di un trigger o di un'azione a cui si fa riferimento è:

      {{$.path.to.value}}

      L'output di circle-blue.svgRecupera i token di accesso è:

      { "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }

      quindi l'espressione richiesta per il campo Token di accesso è {{$.tokens.strings_token}}.

    3. Fai clic sull'icona di collegamento Icona di collegamento per il campo Progetto e seleziona il trigger history-orange.svguploads:create.

      Il collegamento diventa verde e il campo può essere modificato.

    4. L'output del trigger history-orange.svguploads:create assomiglia a:

      {
        "branch": {
          "name": "my_branch"
        },
        "event": "uploads:create",
        "message": "user-1 initialized file upload file.yml in project name_1672734591_11 within branch my_branch\n",
        "project": {
          "created_at": "2023-01-03 08:29:51 UTC",
          "id": "abcdabcdabcdabcd-11",
          "main_format": "yml",
          "name": "name_1672734591_10",
          "point_of_contact": null,
          "project_image_url": null,
          "slug": "name_1672734591_10",
          "updated_at": "2023-01-03 08:29:51 UTC"
        },
        "upload": {
          "created_at": "2023-01-03 08:29:48 UTC",
          "filename": "file.yml",
          "format": "yml",
          "id": "upload-1",
          "state": "initialized",
          "summary": {},
          "tag": null,
          "updated_at": "2023-01-03 08:29:48 UTC"
        },
        "user": {
          "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
          "id": "9c365b9a6f77c247c3de959f6152b231",
          "name": "Joe Sixpack",
          "username": "user-1"
        }
      }
      

      quindi l'espressione richiesta per il campo Progetto è {{$.project.id}}.

    5. Clicca su Salva.

      La finestra Modifica parametri si chiude e i parametri per l'azione vengono salvati

  3. Per creare un lavoro, devi passare l'ID dell'impostazione locale predefinita del progetto all'azione work-blue.svgCrea un lavoro. L'azione circle-blue.svgTrasforma JSON con jq accetta un input JSON, applica il filtro specificato e quindi restituisce nuovamente JSON

    1. Nella scheda Azioni della finestra Blocchi del flusso di lavoro, cerca phrase-jq.

      Trascina il blocco azione circle-blue.svgTrasforma JSON con jq sotto l'azione language-blue.svgElenca impostazioni locali e rilascialo per collegare i due blocchi.

    2. Apri la finestra Modifica parametri per l'azione Trasforma JSON con jq.

    3. Seleziona JSON dal campo a discesa Tipo di input.

    4. Fai clic sull'icona di collegamento Icona di collegamento per il campo Input e seleziona l'azione language-blue.svgElenca impostazioni locali.

      Il collegamento diventa verde e il campo può essere modificato.

    5. Il campo Input accetta l'input JSON. Una speciale espressione fissa (@ anziché $) fa sì che l'intero output dell'azione a cui si fa riferimento venga passato al campo.

      Inserisci l'espressione {{@.outputs.result}} nel campo Input.

    6. Fai clic sull'icona di collegamento Icona di collegamento per il campo Jq e seleziona l'azione language-blue.svgElenca impostazioni locali.

      Il collegamento diventa verde e il campo può essere modificato.

    7. Devi applicare all'elenco delle impostazioni locali un filtro che restituisca un nuovo elenco contenente tutti gli elementi per cui la proprietà default è true.

      Ogni progetto può avere una sola impostazione locale predefinita, quindi nell'elenco c'è un unico elemento da individuare. Si accede direttamente a tale elemento con la sintassi degli array .[0].

      Inserisci l'espressione map(select(.default))|.[0] nel campo Jq.

    8. Clicca su Salva.

      La finestra Modifica parametri si chiude e i parametri per l'azione vengono salvati

  4. Ora puoi configurare l'azione work-blue.svgCrea un lavoro seguendo gli stessi criteri usati per i blocchi precedenti.

    1. Fai clic sull'icona di collegamento Icona di collegamento per il campo Token di accesso e seleziona l'azione circle-blue.svgRecupera i token di accesso.

      Il collegamento diventa verde e il campo può essere modificato.

      Inserisci l'espressione {{$.tokens.strings_token}}.

    2. Fai clic sull'icona di collegamento Icona di collegamento per il campo Progetto e seleziona il trigger language-orange.svguploads:create.

      Il collegamento diventa verde e il campo può essere modificato.

      Inserisci l'espressione {{$.project.id}}.

    3. Fai clic sull'icona di collegamento Icona di collegamento per il campo Lingua di origine e seleziona l'azione Trasforma JSON con jq.

      Il collegamento diventa verde e il campo può essere modificato.

      Inserisci l'espressione {{@.outputs.result}}.

    4. La data di scadenza può essere calcolata con le funzioni sprig o Expr, ma in questo esempio verrà usata una data fissa riconosciuta dall'API.

      Nel campo Data di scadenza, inserisci 2023-12-31T12:00:00Z.

    5. Clicca su Salva.

      La configurazione viene salvata e i dettagli possono essere visualizzati nella scheda Configura.

  5. Ogni azione può avere una o più condizioni combinate con gli operatori logici AND e OR. Queste condizioni vengono valutate durante l'esecuzione: l'azione e le sue azioni figlie vengono eseguite solo se la condizione risulta vera.

    Per applicare questa regola nell'esempio, seleziona l'azione work-blue.svgCrea un lavoro e fai clic su Modifica condizioni nella scheda Condizioni. In alternativa, fai clic con il pulsante destro del mouse sul blocco e seleziona Modifica condizioni.

    Si apre la finestra Modifica condizioni.

    1. Come nei blocchi precedenti, collega il campo variabile al trigger language-orange.svguploads:create e inserisci l'espressione {{$.upload.tag}}.

    2. Seleziona NOT dal primo menu a discesa per invertire la condizione.

    3. Seleziona IsNull dal menu a discesa confronta.

    4. Clicca su Salva.

      La condizione viene visualizzata nella scheda Condizioni.

    Il flusso di lavoro si interromperà a questo punto se il caricamento non contiene un tag (ovvero se non sono state aggiunte o aggiornate chiavi o traduzioni).

  6. Ora è necessario specificare le lingue di destinazione per il lavoro. Per questo esempio verranno aggiunte due lingue di destinazione: spagnolo (es-ES) e tedesco (de-DE). Le lingue verranno aggiunte alle due azioni circle-blue.svgTrasforma JSON con jq nella finestra Modifica parametri, come nel passaggio 3.

    1. Nel campo Input di entrambe le azioni, inserisci l'espressione {{@.outputs.result}}, collegala all'azione language-blue.svgElenca lingue e salva il parametro.

    2. Nel campo Jg di un'azione, inserisci l'espressione map(select(.name == "es-ES"))|.[0] e collegala all'azione language-blue.svgElenca lingue.

      Salva il parametro.

    3. Nella seconda azione, inserisci l'espressione map(select(.name == "de-DE"))|.[0] e collegala all'azione language-blue.svgElenca lingue.

      Salva il parametro.

  7. Ora le lingue di destinazione verranno aggiunte al lavoro durante la sua creazione.

    Configura le due azioni work-blue.svgAggiungi una lingua di destinazione a un lavoro seguendo gli stessi schemi definiti in precedenza.

  8. Ora puoi avviare il lavoro.

    Configura l'azione work-blue.svgAvvia un lavoro seguendo gli stessi schemi definiti in precedenza.

Esecuzione di un flusso di lavoro su richiesta

Dopo aver configurato i blocchi, puoi eseguire il flusso di lavoro su richiesta per testarlo senza attendere l'evento che lo attiva, ad esempio una pianificazione o un webhook.

Avvia un'esecuzione in uno di questi modi:

  • Nell'editor del flusso di lavoro, usa il pulsante Esecuzione di prova per aprire la finestra di dialogo Esegui.

  • Invia una richiesta POST all'endpoint /orchestrator/api/v1/workflows/{workflow_id}/executions dell'API pubblica.

Un'esecuzione utilizza sempre la revisione più recente del flusso di lavoro. La revisione non deve essere pubblicata, ma deve superare la convalida di pubblicazione. Ogni avvio crea una nuova esecuzione, che viene elencata nella pagina Esecuzioni con l'etichetta Manuale.

Nota

Le esecuzioni su richiesta sono disponibili solo per i flussi di lavoro che utilizzano il motore di nuova generazione. Per i flussi di lavoro legacy, il pulsante Esecuzione di prova non viene visualizzato nell'editor e l'API restituisce un errore 422.

I bundle di azioni e i modelli non possono essere eseguiti e il flusso di lavoro deve avere un proprietario.

Questo articolo ti è stato utile?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.