پردازش دستهای روشی برای ارسال مجموعهای از عملیاتها (که ممکن است به یکدیگر وابسته باشند) به چندین سرویس بدون انتظار همزمان برای تکمیل عملیاتها ارائه میدهد. میتوانید از پردازش دستهای برای ایجاد و مدیریت کمپینهای «عملکرد بیشینه» استفاده کنید.
این راهنما جزئیات خاصی را برای پویشهای «بیشینهسازی عملکرد» هنگام کار با پردازش دستهای ارائه میدهد. راهنمای پردازش دستهای عمومی اطلاعات کلی درباره پردازش دستهای ارائه میدهد و راهنمای ساختار درخواستها حاوی اطلاعات دقیق درباره ساخت درخواستها برای ایجاد یا مدیریت پویشهای «بیشینهسازی عملکرد» است.
برای ایجاد پویش «بیشینهسازی عملکرد» بااستفاده از پردازش دستهای، این مراحل را دنبال کنید:
ایجاد کار دستهای جدید
مرحله ایجاد کار پردازش دستهای عمومی را برای ایجاد منبع BatchJob دنبال کنید.
فهرستی از عملیات تغییریافته آماده کنید
پویشهای «عملکرد بیشینه» برای ایجاد چندین منبع مرتبط به عملیات نیاز دارند که در
راهنمای درخواستهای ساختار بهطور مفصل شرح داده شده است. برای هر منبعی که باید در کار دستهای گنجانده شود، یک
MutateOperation ایجاد کنید.
الزامات CampaignOperation و CampaignAssetOperation
وقتی رهنمودهای نمانام برای پویشی فعال باشد (به
رهنمودهای نمانام مراجعه کنید)، باید داراییهای نمانام را بااستفاده از منابع CampaignAsset به پویش پیوند دهید. علاوهبراین، در کار دستهای، ایجاد این منابع CampaignAsset
باید بلافاصله پساز ایجاد خود منبع Campaign
انجام شود. اگر منابع CampaignAsset بلافاصله پساز منبع Campaign ایجاد نشوند (وقتی رهنمودهای نمانام فعال باشند - به عیبیابی مراجعه کنید)، درخواست ناموفق خواهد بود و CampaignError برمیگرداند که نشاندهنده داراییهای مفقود است.
گنجاندن عملیات ایجاد CampaignAsset در ادامه همان فهرست عملیاتها مانع از بروز این خطا نمیشود.
الزامات AssetGroupOperation و AssetGroupAssetOperation
عملیاتهای نوع MutateOperation که
منابع AssetGroup و
AssetGroupAsset را در کار دستهای ایجاد میکنند باید
متوالی باشند و عملیات دیگری بین آنها نباشد، زیرا این
عملیاتها هنگام پردازش باهم گروهبندی میشوند. درغیراینصورت، درخواست
AssetGroupError را برمیگرداند که نشان میدهد برخیاز داراییها
وجود ندارند،
حتی اگر عملیات لازم برای
برآورده کردن حداقل الزامات دارایی بعداً
در فهرست عملیات گنجانده شود.
روالهای مطلوب AssetGroupListingGroupFilterOperation
هنگام کار با فیلترهای گروه فهرستگان در بافت
AssetGroupListingGroupFilter،
توصیه میکنیم
عملیات AssetGroupListingGroupFilterOperation
را که همان AssetGroup را هدف قرار میدهند بهطور متوالی به یک
کار دستهای اضافه کنید تا مجموعه عملیات بهصورت اتمی
درطول تقسیم دستهای پردازش شوند. برای مطالعه بیشتر درباره تقسیم دستهای و سایر عوامل
تأثیرگذار بر گروههای فهرستگان، به
راهنمای پردازش دستهای گروه فهرستگان مراجعه کنید.
افزودن عملیات جهش به کار
عملیات جهش را از مرحله ۲ به فهرست اضافه کنید و
AddBatchJobOperations
را فراخوانی کنید تا فهرست جهشها به کار دستهای ایجادشده در مرحله ۱ اضافه شود.
مرحله افزودن عملیات را در راهنمای کلی پردازش دستهای دنبال کنید تا فهرست عملیات تغییر را اضافه کنید.
اجرای کار دستهای
با فراخوانی RunBatchJob، به کارهای بارگذاریشده اجازه دهید اجرا شوند. برای مشاهده نمونه، به مرحله
اجرای کار دستهای
در راهنمای کلی پردازش دستهای مراجعه کنید.
بازیابی وضعیت کار
کارهای دستهای بهعنوان عملیات طولانیمدت شروع میشوند و معمولاً مدتی طول میکشد تا تمام شوند.
پساز شروع کار، از روش
GetOperation
عملیات طولانیمدت برای نظرسنجی وضعیت کار
تا زمان تکمیل آن استفاده کنید.
وقتی همه کارهای دستهای شما تمام شد،
ListBatchJobResults را فراخوانی کنید تا
وضعیتها و پاسخهای آنها را طبق
مرحله فهرست کردن همه نتایج کار دستهای در
راهنمای کلی پردازش دستهای چاپ کنید.