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