Shopify Flow でのワークフローエディタの使用

ワークフローエディタは、Shopify Flow でワークフローの機能をカスタマイズおよび編集できるツールです。ワークフローエディタのドラッグ&ドロップインターフェイスを使用すると、さまざまなタイプのステップを上から下へ垂直方向に追加し、ワークフローを整理および設計できます。

ワークフローエディタを使用してワークフローに追加できる最初のステップは、常にトリガーステップです。ワークフローのトリガーを追加したら、+ アイコンを使用して、ワークフローのシーケンスで次に実行される条件ステップやアクションステップを追加できます。ワークフローエディタでは異なるステップが矢印でつながれ、実行される条件やアクションに基づいて、どのステップから別のステップへ直接進むかが示されます。

ステップが機能するためには、ワークフロー内の少なくとも 1 つの他のステップに接続されている必要があります。エディタ内の任意の場所でワークフローの外にステップを追加できますが、矢印で別のステップに接続されていない限り、ワークフローには組み込まれません。各ステップには先行するステップを 1 つしか設定できないため、ワークフローの複数の分岐を単一のステップパスに統合することはサポートされていません。

ワークフローエディタの左側にある設定パネルを使用して、条件ステップとアクションステップの詳細を設定できます。設定パネルは、ステップが選択されている場合にのみ表示されます。

このページの内容

ワークフローエディタでワークフローを開く

Shopify Flowでは、新しいワークフローを作成するか、既存のワークフローをクリックしてから [編集] をクリックすることで、ワークフローエディタにアクセスできます。

手順：

管理画面で、[アプリ] > [Flow] の順に移動します。
[ワークフロー] セクションで、次のいずれかのアクションを実行します。
- 新しい空のワークフローのワークフローエディタを開くには、[ワークフローを作成] をクリックします。
- 既存のワークフローのワークフローエディタを開くには、ワークフローをクリックしてから、[編集] をクリックします。

ワークフローにステップを追加する

ワークフローエディタでは、次のいずれかの方法でステップをワークフローに追加できます。

既存のステップにカーソルを合わせ、 + アイコンをクリックして、ワークフローの次の接続として追加する条件またはアクションのステップを選択します。
- 条件ステップには2つの + アイコンがあります。1つは条件が満たされた場合の [True] パス用、もう1つは条件が満たされない場合の [False] パス用です。
- [For eachループ (繰り返し)] アクションステップにも2つの + アイコンがあります。1つは、リスト内の各アイテムに対して実行されるステップを定義できる [各アイテムを繰り返す] 用、もう1つは、リストの最後のアイテムが返された後に実行されるステップを定義できる [最後のアイテムの後] 用です。
ワークフローエディタ内の任意の空白スペースをクリックします。ワークフローに既存のトリガーがない場合は、設定パネルにトリガーステップのオプションが表示されます。ワークフローに既存のトリガーがある場合は、設定パネルにアクションステップのオプションが表示されます。

ワークフロー内のステップをコピーして貼り付ける

ワークフローを構築する際、別の場所ですでに設定したステップを再作成しなければならないことがよくあります。ワークフローエディタでは、ステップを最初から構築し直す代わりに、既存のアクションや条件のステップをコピーして、同じワークフローまたは別のワークフローに貼り付けることができます。Flow では、コピーしたステップの設定フィールド値が保持され、条件ステップの場合はロックも保持されるため、貼り付けたステップは少し編集するだけですぐに使用できます。

一度にコピーして貼り付けることができるアクションまたは条件のステップは 1 つだけです。トリガーステップはコピーできません。マーケティングメールを送信などのカスタム設定ページを使用するステップはコピーできません。

手順：

ワークフローエディタでワークフローを開きます。
コピーするアクションまたは条件のステップをクリックします。
PC では ctrl + C、Mac では command + C を押してステップをコピーします。
オプション: 別のワークフローにステップを貼り付ける場合は、ワークフローエディタでそのワークフローを開きます。貼り付け先のワークフローには、あらかじめトリガーステップが含まれている必要があります。
PC では ctrl + V、Mac では command + V を押してステップを貼り付けます。貼り付けたステップはカーソルの近くに追加されます。カーソルがエディタ上にない場合、ステップはエディタの中央に追加されます。
ワークフローを有効にする前に、ステップをワークフローの他の部分に接続します。

ワークフローでステップを接続する

ステップが機能するためには、ワークフロー内の少なくとも 1 つの他のステップに接続されている必要があります。ワークフローエディタでは、どのステップが互いに接続されているかが方向を示す矢印で表されます。デフォルトでは、エディタ内でワークフローは上から下へ垂直に流れます。

`+` アイコンを使用して別のステップからワークフローにステップを追加すると、新しいステップは先行するステップに自動的に接続されます。また、最初のステップで `+` をクリックしたまま矢印の端を2番目のステップまでドラッグすることで、ステップ間の接続を手動で作成することもできます。各ステップは先行するステップへの接続を1つしか持つことができないため、ワークフローの複数の分岐を1つのステップパスに再統合することはサポートされていません。

削除する矢印にカーソルを合わせ、アイコンをクリックすると、ステップ間の接続を削除できます。

Shopify Flowワークフローエディタの画像。進行中のワークフローが表示されています。条件ステップの「True」パスからの2つの接続がハイライト表示され、それぞれが下にある異なるアクションステップを指しています。右端の接続を削除するオプションがごみ箱アイコンとともに表示されています。

ワークフローエディタでステップを配置する

ワークフローエディタでステップをドラッグ&ドロップして、ワークフローのレイアウトを手動で整理できます。これにより、構築中にワークフロー全体を把握しやすくなります。デフォルトでは、ステップは上から下へ向かう形式で互いに接続されますが、ステップ間の矢印による接続を解除することなく、ワークフローエディタ内の任意の場所にステップをドラッグ&ドロップできます。

キーボードの Shift キーを押しながら、グループとして選択するステップをクリックすることで、複数のステップを一度に移動できます。灰色のグループボックス内の任意のステップをクリックしてドラッグすると、含まれるすべてのステップを一括で移動できます。

ステップ間にデフォルトの間隔を空けてワークフローのレイアウトを自動的にリセットし、ワークフローを確認しやすくすることができます。アイコンをクリックし、[ワークフローを配置] をクリックしてリセットを確定します。

ワークフローからステップを削除する

ワークフローエディタでは、削除するステップにカーソルを合わせ、ステップの横にあるアイコンをクリックすることで、ワークフローからステップを削除できます。ステップの削除は元に戻せません。

キーボードの Shift キーを押しながら、グループとして選択するステップをクリックすることで、複数のステップを一度に削除できます。灰色のグループボックスの上にあるアイコンをクリックして、ステップを一括削除します。

他のステップが接続されているステップを削除した場合、その接続されていたステップはワークフローエディタに残りますが、先行するステップからは切断されます。ワークフローでそれらのステップを引き続き使用するには、切断されたステップを手動で再接続する必要があります。

ワークフローエディタの下部にある表示ツールバーで、以下のいずれかのアイコンをクリックできます。

またはを使用して、ワークフローをズームアウトまたはズームインします。
ワークフロー全体が表示されるズームレベルで、ワークフローエディタの表示領域の中央にワークフローを配置するには、を使用します。
を使用して、新しいブラウザータブでShopify Flow ヘルプセンターのドキュメントを開きます。
を使用して、ワークフローのレイアウトを整理します。

ワークフローエディタでステップ設定パネルを使用する

ステップを選択すると、ワークフローエディタの左側に設定パネルが表示されます。設定パネルにはステップの詳細が表示され、ステップに実行させたい内容に応じて、変数の設定、論理演算子の割り当て、カスタムアクション情報の追加など、特定のステップの機能をカスタマイズできます。

設定パネルに表示されるオプションは、選択したステップの種類に直接関連しています。

Shopify Flowワークフローエディタの画像。進行中のワークフローが表示されています。条件ステップの設定パネルが選択され、画像内でハイライト表示されています。

ステップの説明の追加または編集

設定パネルから、条件ステップまたはアクションステップの説明を編集できます。「説明を追加」または「説明を編集」をクリックし、ステップの説明を自分の言葉で入力します。自分の言葉で説明を記載すると、ワークフローの動作を自分や他のスタッフが理解しやすくなります。説明フィールドのテキストをすべて削除すると、ステップの説明をリセットできます。

設定コンテンツが不足しているステップの確認

ステップの機能に影響するデータや設定の詳細が欠落している場合、ステップの上部に「要確認」バナーが表示されます。ステップをクリックして設定パネルを開き、不足しているデータを追加すると、「要確認」バナーは表示されなくなります。フィールドに任意であるとの記載がない限り、ステップの設定を完了するには入力が必須です。

ステップが他のステップに接続されていない場合も、「要確認」バナーが表示されます。ステップの詳細設定を続けるには、ワークフロー内の別のステップにそのステップを接続する必要があります。

Shopify Flowの「注文タグを追加する」アクションステップの画像。ステップには青い「要確認」バナーが表示され、ステップの説明には「次の注文タグを追加：(空)」と記載されています。

ワークフローを有効化しようとする前に「要確認」バナーが解決されていない場合、そのステップはエラーとして表示され、ワークフローは有効になりません。ワークフローを有効にするには、ワークフロー内のすべての設定エラーを解決する必要があります。

「変数を追加」ダイアログの使用

ステップ設定パネルの一部のフィールドには、設定コンテンツに変数を追加するための「変数を追加」オプションがあります。「変数を追加」ダイアログに表示されるデータセットは、ワークフローの先行するステップから返されるデータによって決まります。たとえば、デフォルトでは、「変数を追加」ダイアログに以下のオプションが表示されます。

名前または説明で変数を検索するための検索バー。
ワークフローのトリガーによって返されるデフォルトの変数データセット。通常、以下のオプションが含まれます。
- ストアに共通のグローバルなshop変数。
- ワークフローのトリガーに基づいた、少なくとも他に1種類のタイプ。

Shopify Flowの「変数を追加」ダイアログの画像。表示されているトリガーの例は「注文が作成されました」で、ダイアログで利用可能な2つのデータセットは「order」と「shop」です。

ただし、「データを取得」アクションや「コードを実行」など、追加のデータを返すステップをワークフローに追加すると、その時点で追加のデータが利用可能になります。そのため、ワークフローのブランチで後続のステップでは、追加の変数データセットがダイアログに表示され、選択できるようになります。返されたデータは、新しいものから順に表示されます。

追加のデータセットオプションがあるShopify Flowの「変数を追加」ダイアログの画像。利用可能な3つのデータソースが表示されています。「コードを実行」はrunCodeデータを返します。「顧客データを取得」はgetCustomerDataデータを返します。「注文が作成されました」はorderデータとshopデータを返します。

さまざまな変数オプションをクリックしていくと、特定の変数に移動できます。一部の変数にはネストされたオプションがあり、変数APIパスにサブオプションが存在することを示す > が表示されます。変数APIパスの末尾に到達すると > は表示されなくなり、代わりにその変数が返す情報の種類 (String、Boolean、DateTime、Intなど) を示すコンテンツタイプバッジが表示されます。