עיבוד באצווה מאפשר לשלוח קבוצה של פעולות, שיכול להיות שהן תלויות זו בזו, לכמה שירותים בלי להמתין באופן סינכרוני להשלמת הפעולות. אתם יכולים להשתמש בעיבוד ברצף (batch processing) כדי ליצור ולנהל קמפיינים למיקסום הביצועים.
במדריך הזה מפורטים פרטים ספציפיים לקמפיינים למיקסום הביצועים כשעובדים עם עיבוד באצווה. במדריך הכללי לעיבוד באצ'ים מוסבר איך לעבד באצ'ים, ובמדריך ליצירת בקשות מוסבר איך ליצור בקשות ליצירה או לניהול של קמפיינים למיקסום הביצועים.
כדי ליצור קמפיין למיקסום הביצועים באמצעות עיבוד באצווה, פועלים לפי השלבים הבאים:
יצירת משימה באצווה חדשה
פועלים לפי השלב ליצירת משימה של עיבוד ברצף (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. דוגמה לכך מופיעה בשלב הרצת משימת האצווה במדריך הכללי לעיבוד באצווה.
אחזור הסטטוס של המשימה
משימות אצווה מתחילות כפעולות ארוכות טווח, ובדרך כלל לוקח זמן עד שהן מסתיימות.
אחרי שמתחילים את המשימה, משתמשים ב-method GetOperation של הפעולה הממושכת כדי לדגום את סטטוס המשימה עד שהיא מסתיימת.
כשהמשימות של כל האצוות מסתיימות, מפעילים את ListBatchJobResults כדי להדפיס את הסטטוסים והתגובות שלהן, לפי השלב הצגת כל התוצאות של המשימות באצווה במדריך הכללי לעיבוד באצווה.