שימוש בשדות API עם ארגומנטים ב-Shopify Flow ליצירת משתנים
משתנים מסוימים דורשים פרמטרים נוספים כדי לתפקד כראוי בזרימת עבודה של Shopify Flow. פרמטרים אלה הם ארגומנטים שחייבים לכלול ערכים שהוגדרו על ידך לפני שהמשתנה ייחשב למושלם ושמיש בזרימת העבודה.
לדוגמה, השדה product.inCollection קובע אם מוצר נמצא באוסף מסוים או לא, ומחזיר תוצאה בוליאנית של true או false. עם זאת, יש לכלול את הארגומנט id של האוסף עבור שדה זה, מכיוון שאחרת המשתנה לא יידע איזה אוסף ספציפי עליו לבדוק. כדי להשתמש בשדה כראוי, עליך לכלול את הארגומנט כחלק מהשדה. לדוגמה, שאילתה על product.inCollection(id: "gid://shopify/Collection/123456") כדי ש-Flow יוכל לקבוע אם המוצר נמצא באוסף עם המזהה 123456 או לא, ולאחר מכן להחזיר true או false כצפוי. בעת יצירת משתנים ב-Shopify Flow, אינך צריך לחפש ערכים כגון מזהי מוצרים או אוספים. Flow מספק בורר משאבים כדי לבחור את הערך הרצוי, והמזהה ימולא באופן אוטומטי.
כדי לפשט את חוויית התשאול של שדות עם ארגומנטים, אפשר להקצות שם משתנה חדש למשתנה שנוצר מהשדה והארגומנט ב-Shopify Flow. לדוגמה, אם השם של האוסף עם המזהה 123456 הוא Summer Bestsellers, אפשר להקצות למשתנה inCollection(id: "gid://shopify/Collection/123456") שם פשוט יותר, inSummerBestsellers. לאחר מכן, בכל השלבים הבאים של זרימת העבודה, אפשר פשוט להשתמש במשתנה product.inSummerBestsellers.
מכיוון שארגומנטים משתנים בהתאם לערכים המוקצים להם, אפשר ליצור משתנים חדשים מרובים משדה יחיד שדורש ארגומנטים. לדוגמה, אפשר ליצור 3 משתנים ייחודיים רק מהשדה product.inCollection:
product.inCollection(id: "gid://shopify/Collection/123456")יכול להיותproduct.inSummerBestsellers.product.inCollection(id: "gid://shopify/Collection/654321")יכול להיותproduct.inSwimwear.product.inCollection(id: "gid://shopify/Collection/112233")יכול להיותproduct.inBeachAccessories.
בדף זה
שדות GraphQL Admin API נתמכים ב-Shopify Flow
Shopify Flow תומכת בשדות הבאים ב-GraphQL Admin API הדורשים ארגומנטים:
- channel.hasCollection
- collection.hasProduct
- collection.publishedOnChannel
- collection.publishedOnPublication
- companyLocation.inCatalog
- inventoryItem.inventoryLevel
- location.inventoryLevel
- metaobject.field
- market.assignedCustomization
- marketLocalizableResource.marketLocalizations
- product.inCollection
- product.publishedOnChannel
- product.publishedOnPublication
- product.restrictedForResource
- publication.hasCollection
- publishable.publishedOnChannel
- publishable.publishedOnPublication
- sellingPlanGroup.appliesToProduct
- sellingPlanGroup.appliesToProductVariant
- sellingPlanGroup.appliesToProductVariants
- 20 שדות מסוג
translations, כגון collection.translations וכן product.translations
שדות GraphQL Admin API שאינם נתמכים ב-Shopify Flow
Shopify Flow אינה תומכת בשדות הבאים:
- deliveryCarrierService.availableServicesForCountries
- inventoryLevel.quantities
- return.suggestedFinancialOutcome
- return.suggestedRefund
- shop.search
כדי להשתמש בנתונים מהשדות הלא נתמכים האלה בזרימת העבודה שלך, יש להשתמש בפעולה שליחת בקשת HTTP.
יצירת משתנה משדה עם ארגומנט
אפשר ליצור משתנה ב-Shopify Flow עבור כל שדה נתמך שדורש ארגומנט. צריך ליצור את המשתנה פעם אחת בלבד בזרימת עבודה יחידה, מכיוון שהמשתנה נשאר זמין כאפשרות בכל השלבים הבאים של זרימת העבודה.
המשתנה שיצרת לא משותף עם זרימות עבודה אחרות, כך שכדי להשתמש בו בזרימת עבודה אחרת, עליך להוסיף אותו מחדש באותה זרימת עבודה.
שלבים:
- בזרימת עבודה של Shopify Flow, יש ללחוץ על הוספת משתנה בפעולה או בתנאי.
- יש לבחור שדה שדורש ארגומנט. שדות אלו מציגים לחצן
+. לאחר מכן, יש ללחוץ על + יצירת משתנה. - בתיבת הדו-שיח יצירת משתנה , יש לבצע את השלבים הבאים:
- בהתבסס על השדה שבחרת, יש להגדיר ערך לארגומנט הדרוש.
- אופציונלי: בשדה שם משתנה חדש, אפשר להתאים אישית את השם של המשתנה החדש. שם זה חל רק על זרימת העבודה הנוכחית.
- יש ללחוץ על הוספה כדי לרענן את חלונית בחירת המשתנים.
לאחר הוספת המשתנה החדש לזרימת עבודה, המשתנה נשאר זמין כאפשרות שדה ואפשר להפנות אליו במהירות בשלבים הבאים. כשבוחרים באפשרות הוספת משתנה, הוא מוצג מקונן מתחת לאפשרות השדה המקורית ברשימת השדות.
יצירת משתנה מתוך מטא שדה ב-Shopify Flow
מטא שדות הם סוג של משתנה עם שדות הדורשים ארגומנטים. קבלת נתוני מטא שדות בזרימת עבודה של Shopify Flow שונה מעט מקבלת נתוני שדה רגילים במשתנים אחרים, מכיוון שעליך ליצור ולהגדיר את ערכי השדות namespace ו-key של המטא שדה, ולכן הם תמיד ייחודיים לחנות שלך.
לדוגמה, השדה product.inCollection תמיד דורש את הארגומנט id, ללא קשר לחנות שבה מתבצעת העבודה. עם זאת, מכיוון שאתה מגדיר את מרחב השמות והמפתח עבור כל מטא שדה שאתה יוצר בחנות, הארגומנטים הנדרשים הם מותאמים אישית. לכן, משתנה עבור מטא שדה של מוצר ששומר את הוראות הטיפול עבור מוצר של בגדי קיץ עשוי להיות product.careGuideSummer.value, או משתנה עבור מטא שדה של מוצר שמתעד את המזהה של קבוצת הגיל שהמוצר מיועד לה עשוי להיות product.ageGroup.value_item.taxonomyReference.id. שמות השדות והארגומנטים נקבעים לחלוטין על ידך.
למידע נוסף על מטא שדות ב-Shopify Flow.