Mengontrol urutan eksekusi dalam alur kerja

Halaman ini menunjukkan cara menggunakan jump atau loop for untuk mengontrol urutan langkah-langkah alur kerja yang dijalankan. Jump dasar memungkinkan Anda menentukan langkah mana yang akan dijalankan alur kerja berikutnya. Jump kondisional dibuat berdasarkan jump dasar, sehingga Anda dapat menggunakan ekspresi kondisional untuk mengontrol urutan eksekusi melalui alur kerja. Misalnya, Anda dapat menjalankan langkah-langkah tertentu hanya jika variabel atau respons dari langkah alur kerja lain memenuhi kriteria tertentu.

Contoh di halaman ini menggunakan contoh API yang menampilkan hari dalam seminggu.

Sebelum memulai

Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Anda harus sudah memiliki alur kerja yang ada dan ingin mengubah urutan eksekusinya. Untuk mempelajari cara membuat dan men-deploy alur kerja, lihat Membuat dan memperbarui alur kerja.

Menggunakan jump untuk mengubah urutan eksekusi

Secara default, semua alur kerja adalah daftar berurutan yang setiap langkahnya dijalankan sesuai urutan yang Anda tentukan dalam kode sumber alur kerja. Anda dapat memilih untuk mengganti urutan default ini menggunakan jump.

Jump dasar

Anda dapat menentukan langkah mana yang akan dijalankan berikutnya dalam alur kerja menggunakan jump dasar.

Konsol

Buka halaman Workflows di Google Cloud konsol:
Buka Workflows
Pilih nama alur kerja yang urutan eksekusi langkah-langkahnya ingin Anda ubah.
Di halaman Edit workflow, pilih Next untuk membuka editor alur kerja.

Tambahkan kolom next di akhir langkah untuk memberi tahu alur kerja agar melompat ke langkah tertentu:

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": {
          ...
        }
      }
    ]

Ganti STEP_NAME_TO_JUMP_TO dengan nama langkah yang ingin Anda jalankan berikutnya. Misalnya, next_step.

Pilih Deploy.

gcloud

Buka file definisi alur kerja Anda di editor teks pilihan Anda.

Tambahkan kolom next di akhir langkah untuk memberi tahu alur kerja agar melompat ke langkah tertentu:

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": {
        ...
      }
    }
  ]

Ganti STEP_NAME_TO_JUMP_TO dengan nama langkah yang ingin Anda jalankan berikutnya. Misalnya, next_step.

Simpan file alur kerja.
Untuk men-deploy alur kerja, masukkan perintah berikut:
```
gcloud workflows deploy WORKFLOW_NAME \
--source=WORKFLOW_FILE.YAML
```
Ganti kode berikut:
- WORKFLOW_NAME: wajib diisi. Nama alur kerja Anda.
- WORKFLOW_FILE.YAML: wajib diisi. File sumber untuk alur kerja.

Contoh

Misalnya, alur kerja berikut memiliki langkah-langkah yang tidak berurutan:

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}"
            }
          ]
        }
      }
    ]

Dalam contoh ini, kolom next telah ditambahkan ke langkah get_daylight_savings_bool dan return_daylight_savings_bool sehingga langkah-langkah tersebut dijalankan dalam urutan yang benar:

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"
        }
      }
    ]

Jump kondisional

Anda dapat menggunakan jump kondisional untuk menentukan langkah mana yang akan dijalankan berikutnya dalam alur kerja. Jump kondisional menggunakan blok switch, yang melompat ke langkah tertentu jika kondisi tertentu terpenuhi. Setiap blok switch dapat menyertakan maksimum 50 kondisi.

Konsol

Buka halaman Workflows di Google Cloud konsol:
Buka Workflows
Pilih nama alur kerja yang ingin Anda tambahkan blok switch.
Di halaman Edit workflow, pilih Next untuk membuka editor alur kerja.

Di halaman Define workflow, definisi alur kerja Anda saat ini akan ditampilkan. Untuk mengedit alur kerja sehingga menjalankan langkah tertentu berdasarkan pernyataan kondisional, tambahkan langkah yang menggunakan blok 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": {
          ...
        }
      }
    ]

Ganti kode berikut:

SWITCH_STEP_NAME: nama langkah yang berisi blok switch.
EXPRESSION_ONE: ekspresi pertama yang akan dievaluasi. Jika ekspresi ini bernilai benar (true), alur kerja akan menjalankan STEP_A berikutnya. Jika ekspresi ini bernilai salah (false), alur kerja akan mengevaluasi ekspresi berikutnya.
EXPRESSION_TWO: ekspresi kedua yang akan dievaluasi. Jika ekspresi ini bernilai benar (true), alur kerja akan menjalankan STEP_B berikutnya. Jika ekspresi ini bernilai salah (false), alur kerja akan menjalankan STEP_C.
STEP_A, STEP_B, STEP_C: nama langkah placeholder.

Pilih Deploy.

gcloud

Buka definisi alur kerja Anda di editor teks pilihan Anda.

Untuk mengedit alur kerja sehingga menjalankan langkah tertentu berdasarkan pernyataan kondisional, tambahkan langkah yang menggunakan blok 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": {
      ...
    }
  }
]

Ganti kode berikut:

SWITCH_STEP_NAME: nama langkah yang berisi blok switch.
EXPRESSION_ONE: ekspresi pertama yang akan dievaluasi. Jika ekspresi ini bernilai benar (true), alur kerja akan menjalankan STEP_A berikutnya. Jika ekspresi ini bernilai salah (false), alur kerja akan mengevaluasi ekspresi berikutnya.
EXPRESSION_TWO: ekspresi kedua yang akan dievaluasi. Jika ekspresi ini bernilai benar (true), alur kerja akan menjalankan STEP_B berikutnya. Jika ekspresi ini bernilai salah (false), alur kerja akan menjalankan STEP_C.
STEP_A, STEP_B, STEP_C: nama langkah placeholder.

Simpan file alur kerja.
Untuk men-deploy alur kerja, masukkan perintah berikut:
```
gcloud workflows deploy WORKFLOW_NAME \
--source=WORKFLOW_FILE.YAML
```
Ganti kode berikut:
- WORKFLOW_NAME: wajib diisi. Nama alur kerja Anda.
- WORKFLOW_FILE.YAML: wajib diisi. File sumber untuk alur kerja.

Contoh

Misalnya, alur kerja ini menggunakan blok switch untuk mengontrol urutan eksekusi alur kerja:

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."
        }
      }
    ]

Dalam contoh ini, blok switch memiliki dua kondisi. Parser mengevaluasi setiap kondisi secara berurutan, dan jika hasil ekspresi kondisi adalah true, langkah next kondisi tersebut akan dipanggil. Jika tidak ada kondisi yang terpenuhi, alur kerja akan memanggil langkah yang ditentukan oleh kolom next di luar blok switch, yang dalam contoh ini adalah langkah workWeek.

Misalnya, jika hari dalam seminggu adalah "Saturday", alur kerja akan melompat ke langkah weekend dan menampilkan pesan "It's the weekend!". Alur kerja tidak menjalankan langkah friday karena jump kondisional melewatinya, dan alur kerja tidak menjalankan langkah workWeek karena return menghentikan eksekusi alur kerja di akhir langkah weekend.

Menggunakan loop `for` untuk melakukan iterasi

Anda dapat menggunakan loop for untuk melakukan iterasi pada urutan angka atau melalui kumpulan data, seperti daftar atau peta.

Anda dapat menelusuri setiap item dalam daftar atau peta menggunakan iterasi berbasis item. Jika Anda memiliki rentang nilai numerik tertentu untuk diiterasi, Anda dapat menggunakan iterasi berbasis rentang.

Untuk mengetahui informasi dan contoh selengkapnya, lihat referensi sintaksis tentang iterasi.

Langkah berikutnya

Menjalankan alur kerja

Mengontrol urutan eksekusi dalam alur kerja Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Menggunakan jump untuk mengubah urutan eksekusi

Jump dasar

Konsol

YAML

JSON

gcloud

YAML

JSON

Contoh

YAML

JSON

YAML

JSON

Jump kondisional

Konsol

YAML

JSON

gcloud

YAML

JSON

Contoh

YAML

JSON

Menggunakan loop for untuk melakukan iterasi

Langkah berikutnya

Mengontrol urutan eksekusi dalam alur kerja

Menggunakan loop `for` untuk melakukan iterasi