Controllo dell'ordine di esecuzione in un flusso di lavoro

Questa pagina mostra come utilizzare i salti o i loop for per controllare l'ordine in cui vengono eseguiti i passaggi del flusso di lavoro. I salti di base ti consentono di definire il passaggio successivo del flusso di lavoro. I salti condizionali si basano sui salti di base e ti consentono di utilizzare espressioni condizionali per controllare l'ordine di esecuzione in un flusso di lavoro. Ad esempio, puoi eseguire determinati passaggi solo quando una variabile o una risposta di un altro passaggio del flusso di lavoro soddisfa criteri specifici.

Gli esempi in questa pagina utilizzano un'API di esempio che restituisce il giorno della settimana.

Prima di iniziare

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Dovresti già avere un flusso di lavoro esistente in cui vuoi modificare l'ordine di esecuzione. Per scoprire come creare ed eseguire il deployment di un flusso di lavoro, consulta Creare e aggiornare un flusso di lavoro.

Utilizzare i salti per modificare l'ordine di esecuzione

Per impostazione predefinita, tutti i flussi di lavoro sono elenchi ordinati in cui ogni passaggio viene eseguito nell'ordine definito nel codice sorgente del flusso di lavoro. Puoi scegliere di eseguire il override di questo ordinamento predefinito utilizzando i salti.

Salti di base

Puoi specificare il passaggio successivo da eseguire in un flusso di lavoro utilizzando i salti di base.

Console

  1. Apri la pagina Workflows nella console Google Cloud:
    Vai a Workflows

  2. Seleziona il nome del flusso di lavoro in cui vuoi modificare l'ordine di esecuzione dei passaggi esistenti.

  3. Nella pagina Modifica flusso di lavoro, seleziona Avanti per accedere all'editor del flusso di lavoro.

  4. Aggiungi il campo next alla fine di un passaggio per indicare al flusso di lavoro di saltare a un determinato passaggio:

    YAML

         - step_a:
         ...
         next: STEP_NAME_TO_JUMP_TO
     - step_b:
         ...
     - next_step:
         ...

    JSON

        [
      {
        "step_a": {
          ...
          "next": "STEP_NAME_TO_JUMP_TO"
        }
      }
      {
        "step_b": {
          ...
        }
      }
      {
        "next_step": {
          ...
        }
      }
    ]

    Sostituisci STEP_NAME_TO_JUMP_TO con il nome del passaggio che vuoi che venga eseguito successivamente dal flusso di lavoro. Ad esempio, next_step.

  5. Seleziona Esegui il deployment.

gcloud

  1. Apri il file di definizione del flusso di lavoro nell'editor di testo che preferisci.

  2. Aggiungi il campo next alla fine di un passaggio per indicare al flusso di lavoro di saltare a un determinato passaggio:

    YAML

         - step_a:
         ...
         next: STEP_NAME_TO_JUMP_TO
     - step_b:
         ...
     - next_step:
         ...

    JSON

      [
    {
      "step_a": {
        ...
        "next": "STEP_NAME_TO_JUMP_TO"
      }
    }
    {
      "step_b": {
        ...
      }
    }
    {
      "next_step": {
        ...
      }
    }
  ]

    Sostituisci STEP_NAME_TO_JUMP_TO con il nome del passaggio che vuoi che venga eseguito successivamente dal flusso di lavoro. Ad esempio, next_step.

  3. Salva il file del flusso di lavoro.

  4. Per eseguire il deployment del flusso di lavoro, inserisci il seguente comando:

    gcloud workflows deploy WORKFLOW_NAME \
--source=WORKFLOW_FILE.YAML

    Sostituisci quanto segue:

    • WORKFLOW_NAME: obbligatorio. Il nome del flusso di lavoro.

    • WORKFLOW_FILE.YAML: obbligatorio. Il file di origine per il flusso di lavoro.

Esempio

Ad esempio, i passaggi del seguente flusso di lavoro non sono in ordine:

YAML

  - get_time:
     call: http.get
     args:
         url:  https://us-central1-workflowsample.cloudfunctions.net/datetime
     result: currentTime
  - return_daylight_savings_bool:
     return: ${daylightSavings}
  - get_daylight_savings_bool:
     assign:
         - daylightSavings: ${currentTime.body.isDayLightSavingsTime}

JSON

    [
      {
        "get_time": {
          "call": "http.get",
          "args": {
            "url": "https://us-central1-workflowsample.cloudfunctions.net/datetime"
          },
          "result": "currentTime"
        }
      },
      {
        "return_daylight_savings_bool": {
          "return": "${daylightSavings}"
        }
      },
      {
        "get_daylight_savings_bool": {
          "assign": [
            {
              "daylightSavings": "${currentTime.body.isDayLightSavingsTime}"
            }
          ]
        }
      }
    ]

In questo esempio, ai passaggi get_daylight_savings_bool e return_daylight_savings_bool sono stati aggiunti i campi next in modo che vengano eseguiti nell'ordine corretto:

YAML

  - get_time:
     call: http.get
     args:
         url:  https://us-central1-workflowsample.cloudfunctions.net/datetime
     result: currentTime
     next: get_daylight_savings_bool
  - return_daylight_savings_bool:
     return: ${daylightSavings}
  - get_daylight_savings_bool:
     assign:
         - daylightSavings: ${currentTime.body.isDayLightSavingsTime}
     next: return_daylight_savings_bool

JSON

    [
      {
        "get_time": {
          "call": "http.get",
          "args": {
            "url": "https://us-central1-workflowsample.cloudfunctions.net/datetime"
          },
          "result": "currentTime",
          "next": "get_daylight_savings_bool"
        }
      },
      {
        "return_daylight_savings_bool": {
          "return": "${daylightSavings}"
        }
      },
      {
        "get_daylight_savings_bool": {
          "assign": [
            {
              "daylightSavings": "${currentTime.body.isDayLightSavingsTime}"
            }
          ],
          "next": "return_daylight_savings_bool"
        }
      }
    ]

Salti condizionali

Puoi utilizzare i salti condizionali per determinare quale passaggio eseguire successivamente in un flusso di lavoro. I salti condizionali utilizzano blocchi switch, che passano a un passaggio specificato se viene soddisfatta una determinata condizione. Ogni switch blocco può includere un massimo di 50 condizioni.

Console

  1. Apri la pagina Workflows nella console Google Cloud:
    Vai a Workflows

  2. Seleziona il nome del flusso di lavoro a cui vuoi aggiungere un blocco switch.

  3. Nella pagina Modifica flusso di lavoro, seleziona Avanti per accedere all'editor del flusso di lavoro.

  4. Nella pagina Definisci flusso di lavoro, viene visualizzata la definizione corrente del flusso di lavoro. Per modificare il flusso di lavoro in modo che esegua un determinato passaggio in base a un'istruzione condizionale, aggiungi un passaggio che utilizzi un blocco switch:

    YAML

         - SWITCH_STEP_NAME:
         switch:
             - condition: ${EXPRESSION_ONE}
               next: STEP_A
             - condition: ${EXPRESSION_TWO}
               next: STEP_B
             ...
         next: STEP_C
     - STEP_A
         ...
     - STEP_B
         ...
     - STEP_C
         ...

    JSON

        [
      {
        "SWITCH_STEP_NAME": {
          "switch": [
            {
              "condition": "${EXPRESSION_ONE}",
              "next": "STEP_A"
            },
            {
              "condition": "${EXPRESSION_TWO}",
              "next": "STEP_B"
            }
          ],
          "next": "STEP_C"
        }
        "STEP_A": {
          ...
        }
        "STEP_B": {
          ...
        }
        "STEP_C": {
          ...
        }
      }
    ]

    Sostituisci quanto segue:

    • SWITCH_STEP_NAME: il nome del passaggio contenente il blocco switch.

    • EXPRESSION_ONE: la prima espressione da valutare. Se questa espressione restituisce true, il flusso di lavoro esegue STEP_A successivamente. Se questa espressione restituisce false, il flusso di lavoro valuta l'espressione successiva.

    • EXPRESSION_TWO: la seconda espressione da valutare. Se questa espressione restituisce true, il flusso di lavoro esegue STEP_B successivamente. Se questa espressione restituisce false, il flusso di lavoro esegue STEP_C.

    • STEP_A, STEP_B, STEP_C: nomi dei passaggi segnaposto.

  5. Seleziona Esegui il deployment.

gcloud

  1. Apri la definizione del flusso di lavoro nell'editor di testo che preferisci.

  2. Per modificare il flusso di lavoro in modo che esegua un determinato passaggio in base a un'istruzione condizionale, aggiungi un passaggio che utilizzi un blocco switch:

    YAML

     - SWITCH_STEP_NAME:
     switch:
         - condition: ${EXPRESSION_ONE}
           next: STEP_A
         - condition: ${EXPRESSION_TWO}
           next: STEP_B
         ...
     next: STEP_C
 - STEP_A
     ...
 - STEP_B
     ...
 - STEP_C
     ...

    JSON

    [
  {
    "SWITCH_STEP_NAME": {
      "switch": [
        {
          "condition": "${EXPRESSION_ONE}",
          "next": "STEP_A"
        },
        {
          "condition": "${EXPRESSION_TWO}",
          "next": "STEP_B"
        }
      ],
      "next": "STEP_C"
    }
    "STEP_A": {
      ...
    }
    "STEP_B": {
      ...
    }
    "STEP_C": {
      ...
    }
  }
]

    Sostituisci quanto segue:

    • SWITCH_STEP_NAME: il nome del passaggio contenente il blocco switch.

    • EXPRESSION_ONE: la prima espressione da valutare. Se questa espressione restituisce true, il flusso di lavoro esegue STEP_A successivamente. Se questa espressione restituisce false, il flusso di lavoro valuta l'espressione successiva.

    • EXPRESSION_TWO: la seconda espressione da valutare. Se questa espressione restituisce true, il flusso di lavoro esegue STEP_B successivamente. Se questa espressione restituisce false, il flusso di lavoro esegue STEP_C.

    • STEP_A, STEP_B, STEP_C: nomi dei passaggi segnaposto.

  3. Salva il file del flusso di lavoro.

  4. Per eseguire il deployment del flusso di lavoro, inserisci il seguente comando:

    gcloud workflows deploy WORKFLOW_NAME \
--source=WORKFLOW_FILE.YAML

    Sostituisci quanto segue:

    • WORKFLOW_NAME: obbligatorio. Il nome del flusso di lavoro.

    • WORKFLOW_FILE.YAML: obbligatorio. Il file di origine per il flusso di lavoro.

Esempio

Ad esempio, questo flusso di lavoro utilizza un blocco di switch per controllare l'ordine di esecuzione:

YAML

  - getCurrentTime:
      call: http.get
      args:
          url:  https://us-central1-workflowsample.cloudfunctions.net/datetime
      result: currentTime
  - conditionalSwitch:
      switch:
          - condition: ${currentTime.body.dayOfTheWeek == "Friday"}
            next: friday
          - condition: ${currentTime.body.dayOfTheWeek == "Saturday" OR currentTime.body.dayOfTheWeek == "Sunday"}
            next: weekend
      next: workWeek
  - friday:
      return: "It's Friday! Almost the weekend!"
  - weekend:
      return: "It's the weekend!"
  - workWeek:
      return: "It's the work week."

JSON

    [
      {
        "getCurrentTime": {
          "call": "http.get",
          "args": {
            "url": "https://us-central1-workflowsample.cloudfunctions.net/datetime"
          },
          "result": "currentTime"
        }
      },
      {
        "conditionalSwitch": {
          "switch": [
            {
              "condition": "${currentTime.body.dayOfTheWeek == "Friday"}",
              "next": "friday"
            },
            {
              "condition": "${currentTime.body.dayOfTheWeek == "Saturday" OR currentTime.body.dayOfTheWeek == "Sunday"}",
              "next": "weekend"
            }
          ],
          "next": "workWeek"
        }
      },
      {
        "friday": {
          "return": "It's Friday! Almost the weekend!"
        }
      },
      {
        "weekend": {
          "return": "It's the weekend!"
        }
      },
      {
        "workWeek": {
          "return": "It's the work week."
        }
      }
    ]

In questo esempio, il blocco switch ha due condizioni. Il parser valuta ogni condizione in ordine e, se il risultato dell'espressione della condizione è true, viene chiamato il passaggio next della condizione. Se nessuna delle condizioni è soddisfatta, il flusso di lavoro chiama il passaggio specificato dal campo next all'esterno del blocco switch, che in questo esempio è il passaggio workWeek.

Ad esempio, se il giorno della settimana è "Saturday", il flusso di lavoro passa al passaggio weekend e restituisce il messaggio "It's the weekend!". Il flusso di lavoro non esegue il passaggio friday perché il salto condizionale lo ignora, e il flusso di lavoro non esegue il passaggio workWeek perché return interrompe l'esecuzione del flusso di lavoro alla fine del passaggio weekend.

Utilizza i loop for per eseguire l'iterazione

Puoi utilizzare i cicli for per eseguire l'iterazione su una sequenza di numeri o su una raccolta di dati, ad esempio un elenco o una mappa.

Puoi esaminare ogni elemento di un elenco o di una mappa utilizzando l'iterazione basata sugli elementi. Se hai un intervallo specifico di valori numerici da esaminare, puoi utilizzare l'iterazione basata sull'intervallo.

Per ulteriori informazioni ed esempi, consulta il riferimento alla sintassi sull'iterazione.

Passaggi successivi