קבלת נתונים של חוזה מינוי
בזרימות עבודה שמשתמשות בנתונים של חוזה מינוי, ניתן להשתמש בפעולה קבלת נתונים של חוזה מינוי כדי לאחזר מידע על חוזי מינויים מהחנות שלך.
תצורה
שדות
הפעולה קבלת נתונים של חוזה מינוי מכילה את השדות הבאים, המשמשים לבניית השאילתה:
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | חובה. הפרמטרים שלפיהם ימוינו הנתונים המוחזרים משאילתת החיפוש. |
| מספר תוצאות מרבי | חובה. הכמות המרבית של תוצאות שיכולות להיות מוחזרות משאילתת החיפוש שבחרת. ניתן להחזיר עד 100 בכל פעם. |
| שאילתה | חובה. אפשר לבחור מתוך שאילתות נפוצות או לבחור באפשרות מתקדם כדי ליצור שאילתה משלך. |
מחרוזת שאילתה
זוהי שאילתה לדוגמה לקבלת חוזי מינוי עם סטטוס ACTIVE:
status: ACTIVEהמשתנה status הוא מסנן שזמין בשאילתת חוזי מינוי וניתן להשתמש בו מספר פעמים.
בעת יצירת שאילתה לנתונים, כדאי לדעת את הדברים הבאים:
- רשימה של מסננים זמינים
- שאילתות חייבות להיות בהתאם לתחביר מסוים
- ערכי שדות של שאילתות אינם מתועדים תמיד. במקרים מסוימים, ניתן למצוא את הערכים על ידי עיון במסמכי ה-API. לחלופין, לרוב אפשר למצוא את ערכי השדות בכתובות ה-URL במנהל בעת ביצוע סינון. לדוגמה, כדי למצוא ערכים מסוימים של שאילתת הזמנות, יש לסנן את הדף 'הזמנות' במנהל, ולאחר מכן לבדוק את כתובת ה-URL.
- ניתן להפעיל או לבדוק שאילתה בחנות שלך באמצעות האפליקציה Shopify GraphiQL.
- יש לשים לב למה שקורה במקרה של כשל בשאילתה. לרוב ה-API יחזיר את כל התוצאות (במקום לא להחזיר אף תוצאה).
נתונים שהוחזרו
כל הפעולות מסוג קבלת נתונים מחזירות רשימה שכוללת בין 0 ל-100 משאבים. בהתאם לתרחיש השימוש שלך, ייתכן שתרצה להשתמש בנתונים האלה בדרכים שונות:
- אם עליך לטפל בכל פריט ברשימה בנפרד, למשל כדי להוסיף תג לכל אחד מהם, תוכל להשתמש בפעולה עבור כל.
- אם עליך לצבור נתונים, למשל כדי לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות ספירה או סכום.
- אם עליך להפיק פלט של הרשימה, למשל כדי לשלוח דוא"ל עם כל הפריטים, תוכל להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.
כדי לגשת לנתונים שהוחזרו בשלבים שבאים לאחר פעולה זו, יש להשתמש במשתנה שנקרא קבלת נתונים של חוזה מינוי, שהוא רשימה של חוזי מינוי. ניתן להשתמש במשתנה זה הן בתנאים והן בפעולות. לדוגמה, אפשר לשלוח את רשימת ההזמנות בפעולה שליחת דוא"ל פנימי באופן הבא:
{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}טריגרים
אפשר להשתמש בפעולה הזו בכל זרימת עבודה, כולל בטריגר זמן מתוזמן. בזרימת עבודה שמשתמשת בטריגר זמן מתוזמן, זרימת העבודה מתחילה בשעה שהגדרת, ולא כתוצאה מאירוע. מכיוון שאין אירוע ספציפי בחנות שלך או מיישום שמתחיל את זרימת העבודה, נתונים לא נכללים בה באופן אוטומטי.