尋找並監控工作流程執行

工作流程執行後,Flow 會提供發生事項的記錄,稱為「工作流程執行」,可讓您監控其成效與行為。

存取工作流程執行

您可以在 Flow app 中監控所有工作流程執行。檢視工作流程執行可協助您找出工作流程行為的潛在問題。

當您在進行疑難排解或不確定要檢查哪個工作流程時,您可能會想要檢視所有工作流程的執行。若您已確定欲檢視的工作流程,則可僅存取該流程的最近執行。

步驟:

檢視所有工作流程執行
  1. 在您的 Shopify 管理介面中,前往 應用程式 > Flow

  2. 按一下「最近執行」。

  3. 選用:按一下特定的執行以檢視詳情。

檢視特定工作流程的執行
  1. 在您的 Shopify 管理介面中,前往 應用程式 > Flow

  2. 請選取您要檢視其執行的工作流程。

  3. 最近執行 區段中,檢視列出的執行。

  4. 選用:按一下特定的執行以檢視詳情。

搜尋特定工作流程的執行

您可以在 Flow 中使用下列任一方法搜尋工作流程的執行:

可搜尋的內容

Flow app 的 最近執行 清單提供選項,可使用下列篩選條件的任意組合篩選整份執行清單:

  • 包含文字:依據工作流程執行所用資料中的原始文字內容進行篩選,例如觸發條件傳遞的訂單 ID,或條件中的標籤名稱。
  • 工作流程:依據工作流程名稱進行篩選。
  • 採取動作:依據該次執行是否有採取任何動作(true),或未執行任何動作(false)進行篩選。
  • 錯誤:依據該次執行是否包含錯誤進行篩選。
  • 開始時間:依據該次執行應開始的日期與時間範圍進行篩選。瞭解詳情依時間篩選執行
  • 觸發類型:依據該次執行的開始方式進行篩選。選項包括觸發事件、手動執行或手動重試。
  • 重試狀態:依據該次執行是否包含重試進行篩選。
  • 執行 ID:依據特定的執行 ID 進行篩選。您也可以選擇包含與指定執行 ID 相關的重試。
  • 標籤:依據套用到該次執行的工作流程標籤進行篩選。

在搜尋前,請先考量可在工作流程執行中搜尋哪些資訊。這些資訊會顯示在工作流程執行的詳情中,包含下列類型:

  • 在工作流程執行中使用的資源的任何 ID,例如訂單 ID 或顧客 ID。
  • 工作流程執行中包含的任何文字或資料,例如標籤名稱或產品名稱。

此外,搜尋工作流程執行時請留意下列限制:

  • 搜尋不區分大小寫。
  • 搜尋字串不應包含標點符號。例如,若您要搜尋訂單 ID,請搜尋 43843493,而非 gid://shopify/Order/43843493
  • 記錄不會包含您的工作流程所用資源的全部詳情。例如,若您的工作流程使用了產品 ID,則該工作流程執行的記錄不會包含產品名稱或標題,除非您也使用了那些欄位。
  • 搜尋僅限於過去 14 日的工作流程執行。

從 Shopify 管理介面搜尋

對於具有 更多操作 選單的資源,您可以選擇 搜尋 Flow 執行 來啟動工作流程執行的搜尋。此選項適用於下列資源:

  • 訂單
  • 訂單草稿
  • 顧客
  • 產品
  • 子類
  • 商品系列

如果您找不到執行,請參閱可搜尋的內容

步驟:

  1. 在 Shopify 管理介面中,開啟您要搜尋的資源,例如訂單或產品。
  2. 按一下 更多操作
  3. 按一下 搜尋 Flow 執行

依步驟資料中的文字搜尋

在 Flow app 中,您可以搜尋工作流程執行中 步驟資料 區段包含的任何資料。

如果您找不到執行,請參閱可搜尋的內容

步驟:

  1. 在 Flow app 的 最近執行 清單中,按一下 新增篩選
  2. 選取 包含文字
  3. 輸入要搜尋的文字或 ID。

依時間範圍搜尋

請留意以下事項,以便透過時間範圍尋找工作流程執行:

  • 若您的裝置時區與商店時區不同,工作流程執行的日期與時間可能會不準確。請在您使用的 開始時間 篩選條件中考量這項差異。
  • 在高交易量的商店中,您可能需要使用較小的時間範圍,並搭配其他篩選條件,以便更容易找到特定的工作流程執行。
  • 工作流程執行在完成後只會保留 14 日。
  • 工作流程執行與其結果顯示在 最近執行 頁面之間可能會有延遲。若最近的工作流程結果尚未顯示,請稍候幾分鐘再試一次。

步驟:

  1. 在 Flow app 的 最近執行 清單中,按一下 新增篩選,接著按一下 開始時間
  2. 起始 欄位中,輸入等於事件應發生時間的日期與時間。例如,對於 Order created 觸發條件,請使用訂單建立的時間。請確認輸入正確的 AM/PM 值。
  3. 結束 欄位中,輸入比 起始 日期與時間晚 10 分鐘的日期與時間。
  4. 檢視搜尋結果。工作流程通常會在觸發事件的同一時間或稍後執行。
  5. 按一下與該時間相符的結果,並確認顯示的資源是否與您要尋找的資源相符,例如該筆訂單。

時間篩選範例

最近執行清單中的欄位

工作流程的最近執行清單會顯示工作流程執行的關鍵資料:

工作流程執行表格包含的資料
說明
開始時間該次工作流程執行開始的時間。
執行狀態
  • 進行中:目前正在執行或重試。
  • 等待wait step 已延後工作流程。
  • 已受速率限制:工作流程使用的資源過多,Flow 因此限制執行速率。瞭解詳情:troubleshooting rate limited runs
  • 已取消:工作流程在完成前已cancelled
  • 已完成:執行已結束。
結果列出已完成的動作,以及各步驟的錯誤清單。
重試如果該執行已retried,會提供重試清單的連結。
觸發類型

檢視工作流程執行的詳細資料

若要查看特定工作流程的詳細資料,請按一下該工作流程執行的列。

頁面頂端的狀態區段會顯示工作流程是否已完成。動作區段則會顯示在工作流程中成功執行的動作數量。

詳細資料區段會顯示工作流程的預覽,並標示工作流程走過的路徑。

工作流程執行記錄的範例。狀態顯示在頂端,圖表突顯整個執行皆成功。

在工作流程預覽之後,您可以檢視每個步驟的結果、記錄與資料。

工作流程執行記錄中「結果」區段的範例。

對於每個步驟,您可以展開步驟資料區段,查看工作流程執行中所使用的資料。這些資料包含執行所用資源的 ID,例如訂單 ID 或顧客 ID,以及執行中包含的文字或資料,例如標籤名稱或產品名稱。

「取得訂單草稿資料」的「步驟資料」區段範例。

含有「For each loop」動作的工作流程

包含For each loop (iterate)動作的工作流程會重複執行步驟多次。Flow 會在工作流程預覽中標示有多少品項沿著某個路徑執行。

包含 For each loop 的最新工作流程執行範例。範例圖表顯示此執行中的迴圈動作共執行 7 次。

Flow 也會顯示每次迴圈執行的結果,並允許您依採取的動作與錯誤進行篩選,以便快速針對迴圈進行疑難排解。

包含 For each loop 的最新執行之步驟資料範例。範例步驟資料著重於 Items 選單,讓您選擇要查看哪 7 個品項的步驟資料。

取消進行中的工作流程執行

當您希望在工作流程完成前停止它時,您可以取消狀態為進行中已受速率限制的工作流程執行。取消工作流程執行有助於避免觸及 API 限制、在您發現工作流程未如預期運作時中止、或避免失敗的執行使您的最近的執行清單顯得混亂。

取消進行中的工作流程執行的注意事項

在取消進行中的工作流程執行前,請先檢視以下注意事項:

  • 您必須使用桌面裝置,才能在 Flow app 中取消工作流程的執行。
  • 您無法取消已完成的執行。
  • 已取消的執行之後無法繼續。如果您需要讓工作流程再次執行,可以等待工作流程自動觸發、retry the run,或start a new workflow run manually
  • 取消工作流程的執行不會自動停用相關的工作流程。不過,turning off a workflow 會自動取消該工作流程的所有進行中執行。
  • 工作流程的執行取消所需時間,視工作流程的複雜度而定,可能從幾秒到約一分鐘不等。

取消進行中的工作流程執行

您可以隨時取消進行中的工作流程執行。取消方式有多種:

  • 若要取消特定執行,您可以直接在該工作流程執行的詳細資料頁面取消。
  • 若要取消單一工作流程的多筆執行,您可以在該工作流程的最近的執行清單中批次取消執行。

步驟:

取消工作流程的特定執行
  1. 在您的 Shopify 管理介面中,前往 應用程式 > Flow

  2. 按一下含有您要取消之進行中執行的工作流程。

  3. 最近的執行區段中,按一下您要取消的進行中執行。

  4. 按一下取消

取消某個工作流程的多筆執行
  1. 在您的 Shopify 管理介面中,前往 應用程式 > Flow

  2. 按一下含有您要取消之進行中執行的工作流程。

  3. 最近的執行區段中,選取您要取消的所有進行中執行。

  4. 按一下取消執行

疑難排解工作流程執行

在某些情況下,工作流程的執行可能發生錯誤,或未依預期運作。這通常是因為工作流程的設定有問題。瞭解詳情:troubleshooting Flow errorsretrying workflow runs,以事後修正過去執行的結果。