Configure a Workflow

Apri la finestra Modifica parametri per l'azione Elenco impostazioni locali.

I campi Access token e Progetto richiederanno valori dinamici che vengono risolti durante l'esecuzione.

1. Clicca sull'icona del link per il campo Access token e seleziona l'azione Fetch access tokens.

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

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

   {{$.path.to.value}}

   Con l'output per Fetch access tokens che è:

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

   rendendo l'espressione necessaria per il campo Access token {{$.tokens.strings_token}}.

3. Clicca sull'icona del link per il campo Progetto e seleziona il trigger uploads:create.

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

4. L'output del trigger uploads:create è simile a:

   {
     "branch": {
       "name": "my_branch"
     },
     "evento": "uploads:create",
     "messaggio": "utente-1 ha inizializzato il caricamento del file file.yml nel progetto name_1672734591_11 all'interno del 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",
       "stato": "inizializzato",
       "summary": {},
       "tag": null,
       "updated_at": "2023-01-03 08:29:48 UTC"
     },
     "user": {
       "gravatar_uid": "29a2d1baa67d4ea524cf0f247f7bbb94",
       "id": "9c365b9a6f77c247c3de959f6152b231",
       "name": "Joe Sixpack",
       "username": "user-1"
     }
   }
   

   rendendo l'espressione obbligatoria per il campo Progetto {{$.project.id}}.

5. Clicca su Salva.

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

La locale predefinita del progetto è necessaria per creare un lavoro passando l'ID all'azione Crea lavoro. L'azione Trasforma JSON con jq prende un input JSON, applica il filtro specificato e poi genera di nuovo un output JSON

1. Dalla scheda Azioni nella finestra Blocchi di flusso di lavoro, cerca frase-jq.

   Trascina e rilascia il blocco di azione Transform JSON with jq sotto il blocco di azione Elenco impostazioni locali per collegarli.

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 del link per il campo Input e seleziona l'azione Elenco impostazioni locali.

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

5. Il campo Input prende l'input JSON. Un'espressione fissa speciale (@ invece di $) garantisce che l'intero output dell'azione di riferimento venga passato nel campo.

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

6. Fai clic sull'icona del link per il campo Jq e seleziona l'azione Elenco impostazioni locali.

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

7. È necessario filtrare l'elenco delle impostazioni locali per restituire un nuovo elenco che contenga tutti gli elementi in cui la proprietà default è true.

   Può esserci solo un'impostazione locale predefinita per ogni progetto e l'elenco ha un elemento identificabile e obbligatorio. Quell'elemento è accessibile direttamente con la sintassi dell'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

L'azione Crea un lavoro può ora essere configurata e utilizzerà modelli dai blocchi precedenti.

1. Clicca sull'icona del link per il campo Access token e seleziona l'azione Fetch access tokens.

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

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

2. Clicca sull'icona del link per il campo Progetto e seleziona il trigger uploads:create.

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

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

3. Clicca sull'icona del link per il campo Origine locale e seleziona l'azione Transform JSON with jq.

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

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

4. La data di scadenza può essere calcolata con funzioni sprig o Expr, ma per questo esempio verrà utilizzata 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.

Ogni azione può avere una o più condizioni combinate con gli operatori logici AND e OR. Queste condizioni vengono valutate in tempo reale e l'azione e le sue entità subordinate verranno eseguite solo se la condizione risulta vera.

Per riflettere questo nell'esempio, mentre hai selezionato l'azione Crea un lavoro, fai clic su Modifica condizioni dalla scheda Condizioni o fai clic con il tasto destro sul blocco e seleziona Modifica condizioni.

Si apre la finestra Modifica condizioni.

1. Seguendo i modelli dei blocchi precedenti, collega il campo variabile al trigger uploads:create e inserisci l'espressione {{$.upload.tag}}.

2. Seleziona NOT dal primo elenco a discesa per invertire l'affermazione.

3. Seleziona IsNull dall'elenco a discesa Confronta.

4. Clicca su Salva.

   La condizione è presentata nella scheda Conditions.

Il flusso di lavoro si fermerà a questo punto se il caricamento non contiene un tag (cioè se non ci sono nuove/aggiornate chiavi/traduzioni).

Le impostazioni locali di destinazione sono ora richieste per il lavoro. Ai fini dell'esempio, verranno creati due impostazioni locali; una per lo spagnolo (es-ES) e una per il tedesco (de-DE). Le impostazioni locali verranno aggiunte alle due azioni Transform JSON with jq nella finestra Modifica parametri come nel passaggio 3.

1. Nel campo Input di entrambe le azioni, inserisci l'espressione {{@.outputs.result}}, collega all'azione Elenco impostazioni locali e salva il parametro.

2. Nel campo Jg di una delle azioni, inserisci l'espressione map(select(.name == "es-ES"))|.[0] e collega all'azione Elenco impostazioni locali.

   Salva il parametro.

3. Nella seconda azione, inserisci l'espressione map(select(.name == "de-DE"))|.[0] e collega all'azione Elenco impostazioni locali.

   Salva il parametro.

Le impostazioni locali verranno ora applicate alla creazione del lavoro.

Configura le due azioni Aggiungi un'impostazione locale di destinazione a un lavoro con gli stessi modelli definiti in precedenza.

Il lavoro può ora essere avviato.

Configura l'azione Avvia un lavoro usando gli stessi modelli definiti in precedenza.