עיבוד באצווה מאפשר לשלוח קבוצה של פעולות, שיכולות להיות תלויות זו בזו, לכמה שירותים בלי לחכות באופן סינכרוני להשלמת הפעולות. אפשר להשתמש בעיבוד באצווה כדי ליצור ולנהל קמפיינים למיקסום הביצועים.
במדריך הזה מפורטים פרטים ספציפיים לקמפיינים למיקסום הביצועים כשעובדים עם עיבוד באצווה. במדריך הכללי לעיבוד אצווה מוסבר על עיבוד אצווה, ובמדריך לבניית בקשות יש מידע מפורט על בניית בקשות ליצירה או לניהול של קמפיינים למיקסום הביצועים.
כדי ליצור קמפיין למיקסום ביצועים באמצעות עיבוד באצווה, פועלים לפי השלבים הבאים:
יצירת משימת אצווה חדשה
כדי ליצור משאב 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. דוגמה מופיעה בשלב הפעלת העבודה באצווה במדריך הכללי לעיבוד באצווה.
אחזור הסטטוס של העבודה
משימות אצווה מתחילות כפעולות ממושכות, ובדרך כלל לוקח זמן עד שהן מסתיימות.
אחרי שמפעילים את העבודה, משתמשים בשיטה GetOperation של הפעולה הממושכת כדי לבדוק את סטטוס העבודה עד שהיא מסתיימת.
כשכל העבודות בקבוצה מסתיימות, קוראים ל-ListBatchJobResults כדי להדפיס את הסטטוסים והתגובות שלהן לפי השלב list all batch job results במדריך הכללי לעיבוד קבוצות.