עיבוד באצווה מאפשר לשלוח קבוצה של פעולות, שיכול להיות שהן תלויות זו בזו, לכמה שירותים בלי להמתין באופן סינכרוני להשלמת הפעולות. אפשר להשתמש בעיבוד באצווה כדי ליצור ולנהל קמפיינים למיקסום הביצועים.
המדריך הזה מספק פרטים ספציפיים לקמפיינים למיקסום הביצועים כשעובדים עם עיבוד ברצף (batch processing). במדריך הכללי לעיבוד בקבוצות יש מידע כללי על עיבוד בקבוצות, ובמדריך ליצירת בקשות יש מידע מפורט על יצירת בקשות ליצירה או לניהול של קמפיינים למיקסום הביצועים.
כדי ליצור קמפיין למיקסום ביצועים באמצעות עיבוד באצווה, פועלים לפי השלבים הבאים:
יצירת משימה באצווה חדשה
כדי ליצור BatchJob משאב, פועלים לפי השלב ליצירת משימה של עיבוד ברצף כללי.
הכנת רשימה של פעולות מוטציה
כדי ליצור קמפיינים למיקסום הביצועים, צריך לבצע פעולות ליצירת כמה משאבים קשורים, שמפורטים במדריך לבקשות מבנה. יוצרים MutateOperation לכל משאב שרוצים לכלול במשימה באצווה.
CampaignOperation ודרישות CampaignAssetOperation
כשמפעילים ספר מותג בקמפיין (מידע נוסף על ספר מותג), צריך לקשר נכסים שקשורים למותג לקמפיין באמצעות מקורות מידע של CampaignAsset. בנוסף, במשימה באצווה, יצירת המשאבים האלה CampaignAsset חייבת להתרחש מיד אחרי יצירת המשאב Campaign עצמו. אם המשאבים מסוג CampaignAsset לא נוצרים מיד אחרי המשאב מסוג Campaign (כשספר המותג מופעל – ראו פתרון בעיות), הבקשה תיכשל ותחזיר את השגיאה CampaignError, שמציינת שחסרים נכסים.
הוספת פעולות היצירה של CampaignAsset בהמשך אותה רשימת פעולות לא תמנע את השגיאה הזו.
הדרישות של AssetGroupOperation ושל AssetGroupAssetOperation
הפעולות מהסוג MutateOperation שיוצרות משאבי AssetGroup ו-AssetGroupAsset במשימה באצווה חייבות להיות רציפות, ללא פעולות אחרות ביניהן, בגלל האופן שבו הפעולות האלה מקובצות יחד במהלך העיבוד. אחרת, הבקשה תחזיר את השגיאה
AssetGroupError שמציינת שחסרים נכסים, גם אם הפעולות שנדרשות כדי
לעמוד בדרישות המינימום של נכסים נכללות בהמשך ברשימת הפעולות.
AssetGroupListingGroupFilterOperation שיטות מומלצות
כשעובדים עם מסננים של קבוצות כרטיסי מוצר בהקשר של AssetGroupListingGroupFilter, מומלץ להוסיף פעולות AssetGroupListingGroupFilterOperation שמטרתן אותו AssetGroup לעבודה בקבוצות ברצף, כדי שהמערכת תתייחס לקבוצת הפעולות כאטומית במהלך פיצול העבודה בקבוצות. מידע נוסף על פיצול קבוצות לעיבוד באצווה ועל גורמים אחרים שמשפיעים על קבוצות של כרטיסי מוצר זמין במאמר עיבוד באצווה של קבוצות של כרטיסי מוצר.
הוספת פעולות השינוי למשימה
מוסיפים את פעולות השינוי משלב 2 לרשימה וקוראים ל-AddBatchJobOperations כדי להוסיף את רשימת השינויים למשימה באצווה שנוצרה בשלב 1.
כדי להוסיף את רשימת פעולות השינוי, פועלים לפי השלב להוספת פעולות במדריך הכללי לעיבוד באצווה.
הרצת המשימה באצווה
כדי להפעיל את המשימות שהועלו, מפעילים את RunBatchJob. דוגמה מופיעה בשלב הפעלת משימה באצווה במדריך הכללי לעיבוד ברצף (batch processing).
אחזור הסטטוס של המשרה
משימות באצווה מתחילות כפעולות ממושכות ובדרך כלל לוקח זמן עד שהן מסתיימות.
אחרי שמתחילים את המשימה, משתמשים ב-method GetOperation של הפעולה הממושכת כדי לדגום את סטטוס המשימה עד שהיא מסתיימת.
כשכל משימות האצווה מסתיימות, קוראים ל-ListBatchJobResults כדי להדפיס את הסטטוסים והתגובות שלהן לפי השלב list all batch job results במדריך הכללי לעיבוד ברצף.