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 . In alternativa, fai clic con il pulsante destro del mouse sul blocco e seleziona Modifica parametri per aprire la finestra . Una volta che un blocco dispone di parametri, il pulsante diventa .
Per configurare i blocchi per l'esempio, segui questi passaggi:
-
Apri la finestra per l'azione
.Elenca impostazioni locali
-
I campi e richiedono valori dinamici, risolti in fase di esecuzione.
-
Fai clic sull'icona di collegamento
per il campo e seleziona l'azione
.Recupera i token di accesso
Il collegamento diventa verde e il campo può essere modificato.
-
La sintassi per accedere alle proprietà di un trigger o di un'azione a cui si fa riferimento è:
{{$.path.to.value}}L'output di
è:Recupera i token di accesso
{ "tokens": {"strings_token": "STRINGS_TOKEN", "tms_token": "TMS_TOKEN"} }quindi l'espressione richiesta per il campo è
{{$.tokens.strings_token}}. -
Fai clic sull'icona di collegamento
per il campo e seleziona il trigger
.uploads:create
Il collegamento diventa verde e il campo può essere modificato.
-
L'output del trigger
assomiglia a:uploads:create
{ "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 è
{{$.project.id}}. -
Clicca su Salva.
La finestra si chiude e i parametri per l'azione vengono salvati
-
-
Per creare un lavoro, devi passare l'ID dell'impostazione locale predefinita del progetto all'azione
. L'azioneCrea un lavoro
accetta un input JSON, applica il filtro specificato e quindi restituisce nuovamente JSONTrasforma JSON con jq
-
Nella scheda della finestra , cerca phrase-jq.
Trascina il blocco azione
sotto l'azioneTrasforma JSON con jq
e rilascialo per collegare i due blocchi.Elenca impostazioni locali
-
Apri la finestra per l'azione
Trasforma JSON con jq. -
Seleziona dal campo a discesa .
-
Fai clic sull'icona di collegamento
per il campo e seleziona l'azione
.Elenca impostazioni locali
Il collegamento diventa verde e il campo può essere modificato.
-
Il campo 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 . -
Fai clic sull'icona di collegamento
per il campo e seleziona l'azione
.Elenca impostazioni locali
Il collegamento diventa verde e il campo può essere modificato.
-
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 . -
Clicca su Salva.
La finestra si chiude e i parametri per l'azione vengono salvati
-
-
Ora puoi configurare l'azione
seguendo gli stessi criteri usati per i blocchi precedenti.Crea un lavoro
-
Fai clic sull'icona di collegamento
per il campo e seleziona l'azione
.Recupera i token di accesso
Il collegamento diventa verde e il campo può essere modificato.
Inserisci l'espressione
{{$.tokens.strings_token}}. -
Fai clic sull'icona di collegamento
per il campo e seleziona il trigger
.uploads:create
Il collegamento diventa verde e il campo può essere modificato.
Inserisci l'espressione
{{$.project.id}}. -
Fai clic sull'icona di collegamento
per il campo e seleziona l'azione
Trasforma JSON con jq.Il collegamento diventa verde e il campo può essere modificato.
Inserisci l'espressione
{{@.outputs.result}}. -
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 , inserisci 2023-12-31T12:00:00Z.
-
Clicca su Salva.
La configurazione viene salvata e i dettagli possono essere visualizzati nella scheda .
-
-
Ogni azione può avere una o più condizioni combinate con gli operatori logici
ANDeOR. 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
e fai clic su Modifica condizioni nella scheda . In alternativa, fai clic con il pulsante destro del mouse sul blocco e seleziona Modifica condizioni.Crea un lavoro
Si apre la finestra .
-
Come nei blocchi precedenti, collega il campo al trigger
e inserisci l'espressioneuploads:create
{{$.upload.tag}}. -
Seleziona NOT dal primo menu a discesa per invertire la condizione.
-
Seleziona IsNull dal menu a discesa .
-
Clicca su Salva.
La condizione viene visualizzata nella scheda .
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).
-
-
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
nella finestra , come nel passaggio 3.Trasforma JSON con jq
-
Nel campo di entrambe le azioni, inserisci l'espressione
{{@.outputs.result}}, collegala all'azionee salva il parametro.Elenca lingue
-
Nel campo di un'azione, inserisci l'espressione
map(select(.name == "es-ES"))|.[0]e collegala all'azione.Elenca lingue
Salva il parametro.
-
Nella seconda azione, inserisci l'espressione
map(select(.name == "de-DE"))|.[0]e collegala all'azione.Elenca lingue
Salva il parametro.
-
-
Ora le lingue di destinazione verranno aggiunte al lavoro durante la sua creazione.
Configura le due azioni
seguendo gli stessi schemi definiti in precedenza.Aggiungi una lingua di destinazione a un lavoro
-
Ora puoi avviare il lavoro.
Configura l'azione
seguendo gli stessi schemi definiti in precedenza.Avvia un lavoro
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 .
-
Invia una richiesta
POSTall'endpoint/orchestrator/api/v1/workflows/{workflow_id}/executionsdell'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 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.