トリガーのチュートリアル初めてのワークフロー、手順を追って

初めてのワークフロー、手順を追って

ページをコピーする

Workflow Trigger Extensionsトリガーを使用して、最初のShopify Flowワークフローを作成し、条件とアクションを追加してから、「イベント履歴」で確認してください。

このチュートリアルでは、Shopify Flowの空のキャンバスから、価格が10%以上値下げされた際にチームに通知するという、1つの完全なワークフローを構築します。「商品バリエーション価格変更」を使用していますが、このアプリのすべてのトリガーは同じように使用されるため、以下の5つの手順はすべてのトリガーに適用されます。

アプリをインストールし、「**商品、バリエーション、コレクションのデータへのアクセス権限」**を付与する必要があります。まだお済みでない場合は、インストールと設定 から手続きを開始してください。

1. ワークフローを作成し、トリガーを選択します

管理画面([アプリ] > [Flow])から「Shopify Flow」を開き、「ワークフローを作成」をクリックしてください。Flow が開くと、中央にプロンプトフィールドがある空のワークフローが表示されます。このアプリのトリガーを設定するには、その下にある「**トリガーを選択」**をクリックしてください。

プロンプト欄と、「トリガーを選択」ボタンおよび「テンプレートを参照」ボタンが付いた、新しい空の「Shopify Flow」ワークフロー
新しいワークフローです。このアプリのトリガーについては、「トリガーを選択」をクリックしてください。

開いたパネルで、「Workflow Trigger Extensions」を開いてください。そこには、アプリのすべてのトリガーが、1行の説明文とともに一覧表示されています。また、上部の検索フィールドに名前を入力することもできます。「商品バリエーション価格変更」を選択してください。

Shopify Flowの「Select」トリガーパネルで、「Workflow Trigger Extensions」が開かれており、各トリガーに説明文が付いて一覧表示されています
アプリのすべてのトリガーと、それぞれに対する1行の説明が表示されます。検索フィールドを使用すると、リストを絞り込むことができます。

トリガーは、ワークフローの最初のステップとなりました。そのパネルには、トリガーが送信する内容、つまり、条件やアクションで使用できるデータが表示されます。

最初のステップとして「商品バリエーション価格の変更」を含むワークフローキャンバス
トリガーは、ワークフローの最初のステップです。

2. 条件を追加する

トリガーの下にある「+」をクリックし、「条件」を選択してください。「条件を追加」をクリックすると、Shopify Flow 変数ピッカーが開きます。トリガー名の下に表示される項目はすべて、このアプリからのものです。

priceChangeという価格変更の場合、新旧の価格の差額(delta)、その割合(percentChange)、およびdirectionが算出されます。これらが存在する理由は、Shopify Flowの条件式では計算が行えず、金額がテキストとして渡されるためです。そのため、アプリが計算を行い、結果を数値として表示します。

トリガーステップの下にある「+」マークが開き、「アクション」と「条件」が表示されました
ステップの下にある「+」記号は、ワークフローを構成する2つの要素、すなわち「条件」と「アクション」を表しています。
Shopify Flowの変数ピッカーでは、priceChangeの下にoldPrice、newPrice、delta、percentChange、およびdirectionが表示されます。
このトリガーがワークフローに与える影響は、変更前後の価格、その差額、割合、および変動の方向です。

「percentChange」を選択し、**「Less than」**を選び、「-10」と入力してください。これで、値引き率が10パーセントを超える場合のみ、ワークフローが継続されるようになります。

Shopify Flow 条件:priceChange.percentChange が -10 未満である
完成した状態です。

3. アクションを追加する

「Then」の下にある**「+」をクリックし、「アクション」を選択してください。アラートの場合、「社内メールを送信」が最も簡単です。他のアプリは必要ありません。「変数を追加」**を使って、テキストに変数を挿入してください。例えば、次のような感じです:

{{productVariant.product.title}} / {{productVariant.title}}: {{priceChange.oldPrice.amount}} -> {{priceChange.newPrice.amount}} ({{priceChange.percentChange}} %)

Shopify Flowでできることはすべて、ここでも利用できます。タグの追加、メタフィールドの更新、SlackやERPへのHTTPリクエストの送信などが可能です。

オプション:「コードを実行」でデータを整形します

必要な処理が、丸め処理、空の値に対する代替処理、計算など、いくつかの変数を超える場合は、条件とアクションの間にShopify Flowの「**コードを実行」**ステップを追加してください。このステップは、トリガーのデータをinputとして受け取り、後のステップで使用できるオブジェクトを返します。

Shopify Flowの「Run」コードステップが、トリガーからoldPrice、newPrice、およびpercentChangeを読み取ります
「コードの実行」は、トリガーのデータを入力として受け取り、その後に続くステップの値を返します。

4. ワークフローを有効にします

ワークフローに名前を付け、「**ワークフローを有効にする」**をクリックしてください。Flowは、このトリガーを持つワークフローが稼働中であることをアプリに通知し、あとはアプリが自動的に処理を行います:

  • これによりトリガーがオンになり、
  • 変更トリガーの場合、一致するレコードの現在の状態を一度読み取ります(ベースライン同期)。これにより、最初の変更でも比較対象となるデータがすでに用意されることになります。

大規模なカタログの場合、ベースラインの同期には数分かかることがあります。同期が完了するまでは、レコードに対する最初の変更が反映されない場合があります。

完成したワークフロー:トリガー、条件、「コードを実行」、そして右上に「ワークフローを有効にする」が表示されています。
完成したワークフローです。「ワークフローを有効にする」ボタンは右上隅にあります。

5. 変更を行い、イベント履歴を確認してください

テストバリエーションの価格を10%以上変更してください。その後、アプリで「イベント履歴」を開いてください。そこには、アプリからShopify Flowに送信されたすべてのイベントが、そのステータスとともに一覧表示されています。**「成功」と表示されている場合は、**Shopify Flowがそれを受け入れたことを意味します。

このアプリの「イベント履歴」ページには、発火したトリガーとそのステータスが一覧表示されています
「イベント履歴」には、アプリがShopify Flowに送信したすべてのイベントが一覧表示されます。

イベントをクリックすると、実際に送信された内容(条件で認識されたのと同じ値)を確認できます。ワークフローが期待どおりに動作しなかった場合、まずここを確認してください。そのイベントが存在するか、そして想定していた値が含まれているかどうかを確認してください。

「イベント履歴」にイベントが記録されました:価格が89.00から69.00へ変更され、デルタ、percentChange、および方向が記録されています。
1つのイベントが開かれました:まさに、条件式で検出された値そのものです。