ワークフローの実行の検索と監視

ワークフローが実行されると、Flow はそのパフォーマンスと動作を監視できる、ワークフロー実行と呼ばれるログを提供します。

ワークフローの実行にアクセスする

Flow アプリでは、すべてのワークフローの実行を監視できます。ワークフローの実行を確認すると、ワークフローの動作に関する潜在的な問題を特定するのに役立ちます。

トラブルシューティングを行っている場合や、どのワークフローを確認すればよいかわからない場合は、すべてのワークフローの実行を確認することをおすすめします。確認したいワークフローが具体的にわかっている場合は、そのワークフローの最近の実行のみにアクセスできます。

手順：

特定のワークフロー実行を検索する

Flowでは、以下のいずれかの方法を使用してワークフローの実行を検索できます。

• 注文や商品など、Shopify 管理画面のリソースページから
• Flowアプリ内から、以下の一般的な検索フィルターを使用して、最近の実行リストを絞り込むことができます。
  • お客様IDや注文IDなど、ステップデータ内のテキスト
  • 実行されたはずの日時など、期間

検索対象

Flowアプリの「最近の実行」リストには、以下のフィルターを任意に組み合わせて、実行リスト全体を絞り込むオプションがあります。

• テキストを含む：トリガーのペイロード内の注文IDや条件内のタグ名など、ワークフローの実行で使用されたデータの未加工のテキストコンテンツで絞り込みます。
• ワークフロー：ワークフロー名で絞り込みます。
• 実行されたアクション：実行によって何らかのアクションが実行された (true) か、何も実行されなかった (false) かで絞り込みます。
• エラー：実行にエラーが含まれているかどうかで絞り込みます。
• 開始時間：実行が開始されたはずの日時の範囲で絞り込みます。時間による実行の絞り込みについて、詳しくはこちら。
• トリガータイプ：実行の開始方法で絞り込みます。オプションには、トリガーイベント、手動実行、手動での再試行があります。
• 再試行ステータス：実行に再試行が含まれているかどうかで絞り込みます。
• 実行ID：特定の実行IDで絞り込みます。指定した実行IDに関連する再試行を含めることもできます。
• タグ：実行に適用されるワークフロータグで絞り込みます。

検索する前に、ワークフローの実行でどのような情報を検索できるかを確認してください。この情報はワークフローの実行の詳細に表示され、以下のタイプが含まれます。

• 注文IDやお客様IDなど、ワークフローの実行で使用されたリソースのあらゆるID。
• タグ名や商品名など、ワークフローの実行に含まれていたあらゆるテキストやデータ。

さらに、ワークフローの実行を検索する際には、以下の制限事項を考慮してください。

• 検索では、大文字と小文字は区別されません。
• 検索文字列に句読点を含めないでください。たとえば、注文IDを検索する場合、gid://shopify/Order/43843493ではなく43843493を検索します。
• ログには、ワークフローで使用されるリソースに関するすべての詳細が含まれているわけではありません。たとえば、ワークフローで商品IDを使用する場合、これらのフィールドも使用しない限り、ワークフローの実行ログに商品名やタイトルは含まれません。
• 検索は、過去14日間のワークフローの実行に限定されます。

Shopify 管理画面から検索する

「その他の操作」メニューがあるリソースでは、「Flow の実行を検索する」オプションを選択してワークフローの実行検索を開始できます。このオプションは、以下のリソースで利用できます。

• 注文
• 下書き注文
• お客様
• 商品
• バリエーション
• コレクション

実行を見つけられない場合は、検索対象を確認してください。

手順：

1. Shopify 管理画面で、注文や商品など、検索するリソースを開きます。
2. 「その他の操作」をクリックします。
3. 「Flow の実行を検索する」をクリックします。

ステップデータ内のテキストで検索する

Flowアプリでは、ワークフローの実行のステップデータセクションに含まれているデータを検索できます。

実行を見つけられない場合は、検索対象を確認してください。

手順：

1. Flowアプリの「最近の実行」リストで、「フィルターを追加」をクリックします。
2. 「テキストを含む」を選択します。
3. 検索するテキストまたはIDを入力します。

期間で検索する

期間でワークフローの実行を検索する場合は、以下の考慮事項を確認してください。

• デバイスのタイムゾーンがストアのタイムゾーンと異なる場合、ワークフローの実行日時が不正確になることがあります。この差異を考慮に入れて、「開始時間」フィルターを使用してください。
• 取引量の多いストアでは、特定のワークフローの実行を見つけやすくするために、期間を短くしたり、他のフィルターを使用したりする必要がある場合があります。
• ワークフローの実行は、完了後14日間のみ保存されます。
• ワークフローが実行されてから、その結果が「最近の実行」ページに表示されるまでに、遅延が生じる場合があります。最近のワークフローの結果がまだ表示されていない場合は、数分待ってからもう一度お試しください。

手順：

1. Flowアプリの「最近の実行」リストで「フィルターを追加」をクリックし、次に「開始時間」をクリックします。
2. 「From」フィールドに、イベントが発生したはずの時刻と等しい日時を入力します。たとえば、「注文が作成されたとき」トリガーの場合は、注文が作成された時刻を使用します。必ず正しいAM/PMの値を入力してください。
3. 「To」フィールドに、「From」の日時から10分後の日時を入力します。
4. 検索結果を確認します。通常、ワークフローはトリガーイベントと同時に、またはその直後に実行されます。
5. 時刻が一致する結果をクリックし、表示されるリソースが、探しているリソース (注文など) と一致することを確認します。

「最近の実行」リストの列

ワークフローの「最近の実行」リストには、ワークフローの実行に関する主要データが表示されます。

ワークフローの実行の詳細を表示する

個々のワークフローの実行に関する詳細情報にアクセスするには、そのワークフローの実行の行をクリックします。

上部の **[ステータス]** セクションにはワークフローが完了したかどうかが表示されます。**[アクション]** セクションには、ワークフローで正常に実行されたアクションの数が表示されます。

**[詳細]** セクションには、ワークフローのプレビューが表示され、ワークフローがたどったパスがハイライト表示されます。

ワークフローのプレビューの下で、ワークフローの各ステップの結果、ログ、データを確認できます。

各ステップで、**[ステップデータ]** セクションを展開すると、ワークフローの実行で使用されたデータを確認できます。このデータには、注文IDやお客様IDなど、ワークフローの実行で使用されたリソースのIDや、タグ名や商品名など、ワークフローの実行に含まれていたテキストやデータが含まれます。

「項目ごとループ」アクションを含むワークフロー

項目ごとループ (反復処理) アクションを含むワークフローでは、ステップが複数回繰り返されます。Flowでは、ワークフローのプレビューで、パスをたどったアイテムの数がハイライト表示されます。

また、Flowでは各ループの反復処理の結果も表示され、実行されたアクションやエラーで絞り込むことで、ループのトラブルシューティングを迅速に行うことができます。

実行中のワークフローの実行をキャンセルする

**[実行中]** または **[レート制限]** ステータスのワークフローの実行は、完了前にワークフローを停止したい場合にキャンセルできます。ワークフローの実行をキャンセルすると、API 制限への到達を回避したり、意図しない動作をしているワークフローを止めたり、失敗した実行で **[最近の実行]** リストが煩雑になるのを防いだりするのに役立ちます。

実行中のワークフローの実行をキャンセルする場合の考慮事項

実行中のワークフローの実行をキャンセルする前に、以下の考慮事項を確認してください。

• Flow アプリでワークフローの実行をキャンセルするには、デスクトップデバイスを使用する必要があります。
• すでに完了した実行はキャンセルできません。
• キャンセルされた実行は、後で再開することはできません。ワークフローを再度実行する必要がある場合は、ワークフローが自動的にトリガーされるのを待つか、実行を再試行するか、新しいワークフローの実行を手動で開始することができます。
• ワークフローの実行をキャンセルしても、関連するワークフローが自動的にオフになるわけではありません。ただし、ワークフローをオフにすると、実行中のすべてのワークフローの実行が自動的にキャンセルされます。
• ワークフローの実行のキャンセルには、ワークフローの複雑さに応じて、数秒から1分程度かかる場合があります。

実行中のワークフローの実行をキャンセルする

実行中のワークフローの実行はいつでもキャンセルできます。実行中のワークフローの実行をキャンセルするには、複数の方法があります。

• 特定の実行をキャンセルするには、ワークフローの実行の詳細ページから直接キャンセルできます。
• 単一のワークフローの複数の実行をキャンセルするには、そのワークフローの **[最近の実行]** リストから実行を一括でキャンセルできます。

手順：

ワークフローの実行のトラブルシューティング

場合によっては、ワークフローの実行でエラーが発生したり、意図したとおりに実行されなかったりすることがあります。これは、ほとんどの場合、ワークフローの構成に問題があるときに発生します。Flow のエラーのトラブルシューティングや、過去の実行の結果をさかのぼって修正するためのワークフローの実行の再試行について、詳しくはこちらをご覧ください。