חיפוש ומעקב אחרי הפעלות של זרימות עבודה

אחרי שזרימת עבודה מתבצעת, Flow מספקת יומן של מה שאירע, שנקרא הפעלת זרימת עבודה, המאפשר לך לעקוב אחרי הביצועים וההתנהגות שלה.

גישה להפעלות של זרימות עבודה

ניתן לעקוב אחרי כל ההפעלות של זרימות עבודה באפליקציה Flow. סקירה של הפעלות זרימות עבודה יכולה לעזור לך לזהות בעיות אפשריות בהתנהגות של זרימת העבודה.

ייתכן שתרצה לסקור את ההפעלות בכל זרימות העבודה כשאתה מבצע פתרון בעיות או כשאינך בטוח איזו זרימת עבודה לבדוק. אם ידוע לך בדיוק איזו זרימת עבודה ברצונך לסקור, תוכל לגשת להפעלות האחרונות של אותה זרימת עבודה בלבד.

שלבים:

סקירת כל ההפעלות של זרימות העבודה
  1. במנהל של Shopify, יש לעבור אל אפליקציות > Flow.

  2. יש ללחוץ על הפעלות אחרונות.

  3. אופציונלי: אפשר ללחוץ על הפעלה מסוימת כדי לסקור את הפרטים שלה.

סקירת הפעלות עבור זרימת עבודה מסוימת
  1. במנהל של Shopify, יש לעבור אל אפליקציות > Flow.

  2. יש לבחור את זרימת העבודה שההפעלות שלה ברצונך לסקור.

  3. במקטע הפעלות אחרונות, יש לסקור את ההפעלות המופיעות ברשימה.

  4. אופציונלי: אפשר ללחוץ על הפעלה מסוימת כדי לסקור את הפרטים שלה.

חיפוש של הפעלת זרימת עבודה מסוימת

ניתן לחפש הפעלות של זרימות עבודה ב-Flow באחת מהשיטות הבאות:

מה אפשר לחפש

רשימת ההפעלות האחרונות באפליקציה Flow כוללת אפשרות לסנן את כל רשימת ההפעלות לפי כל שילוב של המסננים הבאים:

  • כולל טקסט (Includes text): סינון לפי תוכן הטקסט הגולמי של הנתונים שבהם נעשה שימוש בהפעלת זרימת העבודה, כגון מזהה הזמנה במטען נתונים (payload) של טריגר, או שם התג בתנאי.
  • זרימות עבודה (Workflows): סינון לפי השם של זרימת העבודה.
  • פעולות שבוצעו (Actions taken): סינון לפי השאלה אם ההפעלה ביצעה פעולות כלשהן (נכון) או לא עשתה דבר (שקר).
  • שגיאות (Errors): סינון לפי קיומן או היעדרן של שגיאות בהפעלה.
  • שעת התחלה (Start time): סינון לפי טווח תאריכים ושעות שבו ההפעלה הייתה אמורה להתחיל. למידע נוסף על סינון הפעלות לפי זמן.
  • סוג טריגר (Trigger type): סינון לפי אופן ההתחלה של ההפעלה. האפשרויות כוללות אירוע של טריגר, הפעלה ידנית או ניסיון חוזר ידני.
  • סטטוס ניסיון חוזר (Retry status): סינון לפי קיומם או היעדרם של ניסיונות חוזרים בהפעלה.
  • מזהה הפעלה (Run ID): סינון לפי מזהה הפעלה מסוים. ניתן גם לבחור לכלול ניסיונות חוזרים שקשורים למזהה הפעלה ספציפי.
  • תגים (Tags): סינון לפי תגי זרימת העבודה שחלים על ההפעלה.

לפני ביצוע חיפוש, כדאי לקחת בחשבון איזה מידע ניתן לחפש בהפעלת זרימת העבודה. מידע זה מוצג בתוך פרטי הפעלת זרימת העבודה, והוא כולל את הסוגים הבאים:

  • כל מזהה עבור משאבים שנעשה בהם שימוש בהפעלת זרימת העבודה, כגון מזהי הזמנות או מזהי לקוחות.
  • כל טקסט או נתונים שנכללו בהפעלת זרימת העבודה, כגון שם של תג או כותרת מוצר.

בנוסף, בעת חיפוש של הפעלת זרימת עבודה, יש לקחת בחשבון את המגבלות הבאות:

  • החיפוש אינו תלוי רישיות (אותיות גדולות או קטנות).
  • מחרוזת החיפוש אינה צריכה לכלול סימני פיסוק. לדוגמה, אם מחפשים מזהה הזמנה, יש לחפש 43843493 במקום gid://shopify/Order/43843493.
  • היומנים לא מכילים את כל הפרטים לגבי המשאבים ששימשו בזרימת העבודה שלך. לדוגמה, אם משתמשים במזהה מוצר בזרימת העבודה, יומן הפעלת זרימת העבודה לא יכיל את שם או כותרת המוצר, אלא אם נעשה שימוש גם בשדות אלה.
  • החיפוש מוגבל ל-14 הימים האחרונים של ריצות זרימות העבודה.

חיפוש מלוח המנהל של Shopify

עבור משאבים שיש להם תפריט פעולות נוספות, אפשר להתחיל חיפוש של ריצות זרימת עבודה על ידי בחירה באפשרות חיפוש ריצות Flow. אפשרות זו זמינה עבור המשאבים הבאים:

  • הזמנות
  • טיוטות הזמנות
  • לקוחות
  • מוצרים
  • גרסאות
  • אוספים

אם נתקלת בקושי במציאת ריצה, כדאי לעיין במידע על מה ניתן לחפש.

שלבים:

  1. בלוח המנהל של Shopify, יש לפתוח את המשאב שברצונך לחפש, כמו הזמנה או מוצר.
  2. יש ללחוץ על פעולות נוספות.
  3. יש ללחוץ על חיפוש ריצות Flow.

חיפוש לפי טקסט בנתוני שלב

באפליקציית Flow, אפשר לחפש כל נתון שנכלל במקטעי נתוני שלב בריצת זרימת העבודה.

אם נתקלת בקושי במציאת ריצה, כדאי לעיין במידע על מה ניתן לחפש.

שלבים:

  1. ברשימה ריצות אחרונות שבאפליקציית Flow, יש ללחוץ על הוספת מסנן.
  2. יש לבחור באפשרות כולל טקסט.
  3. יש להזין את הטקסט או את המזהה לחיפוש.

חיפוש לפי טווח זמנים

כדאי לעיין בשיקולים הבאים למציאת ריצת זרימת עבודה לפי טווח זמנים:

  • אם אזור הזמן בהתקן שלך שונה מאזור הזמן של החנות, ייתכן שהתאריך והשעה של ריצת זרימת העבודה לא יהיו מדויקים. יש לקחת הבדל זה בחשבון במסנן שעת התחלה שבו נעשה שימוש.
  • בחנויות עם נפח פעילות גבוה, ייתכן שיהיה עליך להשתמש בטווח זמנים צר ובמסננים נוספים כדי להקל על מציאת ריצה ספציפית של זרימת עבודה.
  • ריצות של זרימות עבודה נשמרות למשך 14 ימים בלבד לאחר השלמת הריצה.
  • ייתכן שיהיה עיכוב בין מועד הריצה של זרימת העבודה לבין מועד הצגת התוצאות שלה בדף ריצות אחרונות. אם התוצאות של זרימת עבודה שפעלה לאחרונה אינן זמינות עדיין, כדאי להמתין מספר דקות ולנסות שוב.

שלבים:

  1. ברשימה ריצות אחרונות שבאפליקציית Flow, יש ללחוץ על הוספת מסנן ולאחר מכן על שעת התחלה.
  2. בשדה מ-, יש להזין תאריך ושעה התואמים לזמן שבו האירוע היה אמור להתרחש. לדוגמה, עבור הטריגר נוצרה הזמנה, יש להשתמש בשעה שבה ההזמנה נוצרה. יש לוודא שהוזן הערך הנכון של AM/PM.
  3. בשדה עד, יש להזין תאריך ושעה המאוחרים ב-10 דקות מהתאריך והשעה שבשדה מ-.
  4. יש לבדוק את תוצאות החיפוש. זרימות עבודה פועלות בדרך כלל בדיוק באותו זמן של אירוע הטריגר, או זמן קצר לאחר מכן.
  5. יש ללחוץ על תוצאה התואמת לשעה, ולוודא שהמשאב המוצג (כמו ההזמנה) תואם למשאב שחיפשת.

דוגמה למסנן זמן

עמודות ברשימת הריצות האחרונות

רשימת הריצות האחרונות של זרימת העבודה מציגה נתוני מפתח על ריצות זרימת העבודה:

נתונים הכלולים בטבלת הריצות של זרימת העבודה
עמודהתיאור
שעת התחלההשעה שבה החלה ריצת זרימת העבודה.
סטטוס הריצה
תוצאותרשימת הפעולות שהושלמו ורשימת שגיאות לפי שלב.
ניסיונות חוזריםאם הריצה בוצעה שוב, יסופק קישור לרשימת הניסיונות החוזרים.
סוג טריגר
  • ניסיון חוזר ידני - הריצה הייתה ניסיון חוזר של ריצה קודמת
  • טריגר ידני - זרימת העבודה הופעלה ידנית מלוח המנהל של Shopify
  • אירוע טריגר - הופעל על ידי אירוע או תזמון

צפייה בפרטים של ריצת זרימת עבודה

כדי לגשת למידע מפורט על זרימת עבודה מסוימת, יש ללחוץ על השורה של ריצת זרימת העבודה.

בחלק העליון, המקטע סטטוס מציין אם זרימת העבודה הושלמה. המקטע פעולות מציין כמה פעולות בזרימת העבודה בוצעו בהצלחה.

המקטע פרטים מציג תצוגה מקדימה של זרימת העבודה ומדגיש את הנתיב (או הנתיבים) שזרימת העבודה עברה בו.

דוגמה ליומן ריצה של זרימת עבודה. הסטטוס מוצג למעלה והתרשים מדגיש שהריצה המלאה עברה בהצלחה.

לאחר התצוגה המקדימה של זרימת העבודה, אפשר להציג את התוצאות, היומנים והנתונים של כל שלב בזרימת העבודה.

דוגמה למקטע התוצאות ביומן ריצה של זרימת עבודה.

בכל שלב, אפשר להרחיב את המקטע נתוני שלב כדי להציג את הנתונים שנעשה בהם שימוש בריצת זרימת העבודה. נתונים אלו כוללים מזהים (IDs) של משאבים שנעשה בהם שימוש בריצה, כגון מזהי הזמנות או מזהי לקוחות, וכל טקסט או נתון שנכללו בריצה, כמו שם תג או כותרת מוצר.

דוגמה למקטע 'נתוני שלב' (Step data) עבור 'קבלת נתוני טיוטת הזמנה' (Get draft order data).

זרימות עבודה עם פעולות מסוג 'לולאת For each'

זרימות עבודה הכוללות את הפעולה לולאת For each (איטרציה) יחזרו על שלבים מספר פעמים. בתצוגה המקדימה של זרימת העבודה, Flow מדגישה כמה פריטים עברו בנתיב מסוים.

דוגמה של ריצת זרימת עבודה אחרונה עם לולאת For each. התרשים לדוגמה מדגיש שפעולת הלולאה בוצעה 7 פעמים במהלך ריצה זו.

Flow מציג גם את התוצאות מכל איטרציה של לולאה ומאפשר לך לסנן לפי פעולות שבוצעו ושגיאות כדי לפתור בעיות בלולאות במהירות.

דוגמה לנתוני שלב של ריצה אחרונה עם לולאת For each. הנתונים של השלב לדוגמה מדגישים את תפריט הפריטים, ומאפשרים לך לבחור לאיזה מתוך 7 הפריטים ברצונך לבדוק את נתוני השלב.

ביטול ריצות של זרימות עבודה בתהליך

ניתן לבטל ריצה של זרימת עבודה עם סטטוס בתהליך (In progress) או מוגבל בקצב (Rate limited) כשרוצים לעצור זרימת עבודה לפני שהיא מסתיימת. ביטול ריצה של זרימת עבודה עשוי להיות אפשרות שימושית כדי למנוע הגעה למגבלות API, כשמבחינים שזרימת העבודה לא רצה כמתוכנן, או כדי למנוע מריצות שנכשלו להעמיס על הרשימה ריצות אחרונות.

שיקולים לביטול ריצות של זרימות עבודה בתהליך

לפני ביטול ריצה של זרימת עבודה בתהליך, מומלץ לעיין בשיקולים הבאים:

  • יש להשתמש במחשב שולחני כדי לבטל ריצות של זרימות עבודה ביישום Flow.
  • לא ניתן לבטל ריצות שכבר הושלמו.
  • לא ניתן לחדש במועד מאוחר יותר ריצות שבוטלו. אם צריך שזרימת העבודה תרוץ שוב, ניתן להמתין שהטריגר של זרימת העבודה יופעל באופן אוטומטי, לנסות שוב את הריצה או להתחיל ריצה חדשה של זרימת העבודה באופן ידני.
  • ביטול ריצות של זרימת עבודה לא מכבה באופן אוטומטי את זרימת העבודה המשויכת. עם זאת, כיבוי של זרימת עבודה מבטל באופן אוטומטי את כל ריצות זרימות העבודה שלה שנמצאות בתהליך.
  • ביטול ריצות של זרימות עבודה עשוי להימשך ממספר שניות ועד דקה, בהתאם למורכבות זרימת העבודה.

ביטול ריצות של זרימות עבודה בתהליך

ניתן לבטל ריצה של זרימת עבודה בתהליך בכל עת. ישנן מספר דרכים לבטל ריצות של זרימות עבודה בתהליך:

  • כדי לבטל ריצה ספציפית, ניתן לבטל אותה ישירות מדף פרטי הריצה של זרימת העבודה.
  • כדי לבטל מספר ריצות עבור זרימת עבודה אחת, ניתן לבטל את הריצות באופן גורף מרשימת ריצות אחרונות של זרימת העבודה.

שלבים:

ביטול ריצה ספציפית של זרימת עבודה
  1. במנהל של Shopify, יש לעבור אל אפליקציות > Flow.

  2. לחץ על זרימת העבודה עם הריצה בתהליך שברצונך לבטל.

  3. במקטע ריצות אחרונות, לחץ על הריצה בתהליך שברצונך לבטל.

  4. לחץ על ביטול.

ביטול מספר ריצות של זרימת עבודה
  1. במנהל של Shopify, יש לעבור אל אפליקציות > Flow.

  2. לחץ על זרימת העבודה עם הריצה בתהליך שברצונך לבטל.

  3. במקטע ריצות אחרונות, בחר את כל הריצות בתהליך שברצונך לבטל.

  4. לחץ על בטל ריצה.

פתרון בעיות בריצות של זרימות עבודה

במקרים מסוימים, ריצה של זרימת עבודה עלולה להיתקל בשגיאה או לא לרוץ כמתוכנן. לרוב, זה קורה כשיש בעיית תצורה בזרימת העבודה. למידע נוסף על פתרון בעיות בשגיאות Flow ועל ניסיון חוזר לריצות של זרימות עבודה כדי לתקן בדיעבד את התוצאה של ריצות קודמות.