קבלת נתונים של ניסיון חיוב עבור מינוי
בזרימות עבודה שדורשות נתונים של ניסיונות חיוב עבור מינויים, תוכל להשתמש בפעולה קבלת נתונים של ניסיון חיוב עבור מינוי כדי לאחזר נתוני הזמנות מהחנות שלך.
תצורה
שדות
הפעולה קבלת נתונים של ניסיון חיוב עבור מינוי מכילה את השדות הבאים, המשמשים לבניית השאילתה:
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | חובה. הפרמטרים שלפיהם ימוינו הנתונים המוחזרים משאילתת החיפוש. |
| מספר תוצאות מרבי | חובה. הכמות המרבית של תוצאות שיכולות להיות מוחזרות משאילתת החיפוש שבחרת. ניתן להחזיר עד 100 בכל פעם. |
| שאילתה | חובה. אפשר לבחור מתוך שאילתות נפוצות או לבחור באפשרות מתקדם כדי ליצור שאילתה משלך. |
מחרוזת שאילתה
זוהי דוגמה לשאילתה לקבלת ניסיונות חיוב עבור מינויים שנוצרו בשלושת הימים האחרונים:
created_at:>'{{ createdAt | date_minus: "3 day" }}'המשתנה created_at הוא מסנן הזמין בשאילתת ניסיון חיוב עבור מינוי וניתן להשתמש בו כדי לבחור הודעת שגיאה ספציפית עבור ניסיונות חיוב של מינויים.
בעת יצירת שאילתה לנתונים, כדאי לדעת:
- רשימה של מסננים זמינים עבור ניסיון חיוב של מינוי
- שאילתות חייבות להיות בהתאם לתחביר מסוים
- ערכי שדות של שאילתות אינם תמיד מתועדים. במקרים מסוימים, ניתן למצוא את הערכים על ידי עיון במסמכי ה-API. לחלופין, לעתים קרובות אפשר למצוא את ערכי השדות בכתובות ה-URL במנהל בזמן ביצוע סינון. לדוגמה, כדי למצוא ערכי שאילתה מסוימים של הזמנות, יש לסנן את דף ההזמנות במנהל, ולאחר מכן לבדוק את כתובת ה-URL.
- תוכל להפעיל או לבדוק שאילתה בחנות שלך באמצעות אפליקציית Shopify GraphiQL.
- כדאי לשים לב למה שקורה אם השאילתה נכשלת. לעתים קרובות ה-API יחזיר את כל התוצאות (במקום אף תוצאה).
נתונים שהוחזרו
כל הפעולות מסוג קבלת נתונים מחזירות רשימה שכוללת בין 0 ל-100 משאבים. בהתאם למקרה השימוש, ייתכן שתרצה להשתמש בנתונים אלה בדרכים שונות:
- אם עליך לטפל בכל פריט ברשימה בנפרד, למשל כדי להוסיף תג לכל אחד מהם, תוכל להשתמש בפעולה עבור כל.
- אם עליך לצבור נתונים, למשל כדי לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות ספירה או סכום.
- אם עליך להפיק פלט של הרשימה, למשל כדי לשלוח דוא"ל עם כל הפריטים, תוכל להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.
כדי לגשת לנתונים שהוחזרו בשלבים שמגיעים לאחר פעולה זו, יש להשתמש במשתנה קבלת נתונים של ניסיון חיוב עבור מינוי, שהוא רשימה של ניסיונות חיוב עבור מינויים. ניתן להשתמש במשתנה זה הן בתנאים והן בפעולות. לדוגמה, אפשר לשלוח את הרשימה של ניסיונות חיוב עבור מינויים בפעולה שליחת דוא"ל פנימי באופן הבא:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}דוגמה
לדוגמה, זרימת עבודה מתוזמנת לפעול בכל יום ראשון בשעה 9:00 בבוקר. הפעולה קבלת נתונים של ניסיון חיוב עבור מינוי משמשת לאיסוף נתונים עבור ניסיונות חיוב של מינויים שנוצרו בשבוע האחרון. אם יש להם הודעת שגיאה, המערכת תשלח דוא"ל לגבי ניסיונות החיוב.