ایجنت چه زمانی بگوید درخواست ثبت شد؟ وقتی قرارداد سامانه، ذخیرهٔ قطعی را تأیید کرده باشد. پاسخ «پردازش شروع شد» یا شناسهٔ عملیات هنوز به معنی ثبت نهایی نیست. از قبل برای هر وضعیت جمله‌ای مشخص بنویسید تا پیام به کاربر از مرحلهٔ واقعی جلو نزند.
شناسهٔ عملیات و شناسهٔ درخواست
در یک نمونهٔ ساختگی، پاسخ started با شناسهٔ عملیات همراه است. متن مناسب «درخواست در حال پردازش است» خواهد بود. وقتی پاسخ saved و شناسهٔ نهایی درخواست رسید، می‌توانید ثبت را اعلام کنید. در مقابل، وضعیت failed قطعی باید با توضیح روشن و مسیر پیگیری همراه باشد. نام این فیلدها مثال است و به قرارداد واقعی سرویس وابسته است.
در HTTP، پاسخ ۲۰۲ پذیرش برای پردازش را نشان می‌دهد و پردازش ممکن است هنوز کامل نشده باشد. این کد به‌تنهایی نتیجهٔ ثبت را تعیین نمی‌کند. در طراحی ابزار، مشخص کنید کدام منبع وضعیت قطعی را می‌دهد و چه زمانی دیگر انتظار فایده ندارد. اگر سامانهٔ مقصد اصلاً پیگیری وضعیت ارائه نمی‌کند، جمله‌ای برای همین محدودیت داشته باشید.
سناریوی پاسخ نامعلوم
فرض کنید درخواست به سرویس رسیده، ولی ارتباط قبل از رسیدن پاسخ قطع شده است. ایجنت نباید موفقیت را اعلام کند. از طرف دیگر، ارسال دوباره هم ممکن است ثبت تکراری بسازد. ابتدا وضعیت همان عملیات را بررسی کنید. اگر سرویس کلید یکتایی برای درخواست دارد، رفتار درخواست تکراری با همان کلید را در محیط آزمایشی بسنجید. پشتیبانی از این رفتار را برای سرویس‌های دیگر فرض نکنید.
برای هر مسیر در برگه، پاسخ دریافتی، پیام به کاربر و تعداد فراخوانی ثبت را بنویسید. یک سناریو داشته باشید که ابتدا started و بعد saved برگرداند. در سناریوی دوم، ذخیره رخ دهد ولی پاسخ از دست برود. در سناریوی سوم، شکست قطعی را شبیه‌سازی کنید. اگر فقط مسیر اول تست شده باشد، تیم دربارهٔ رفتار تکرار یا خطا شاهدی ندارد.
مرز پایان انتظار
برای انتظار یک حد تعریف کنید و بنویسید بعد از آن ایجنت چه می‌گوید. «هنوز تأیید ثبت را ندارم» با «ثبت نشد» فرق دارد. اگر تیم مسئول می‌تواند وضعیت را بعداً بررسی کند، تنها در صورت وجود مسیر واقعی پیگیری آن را پیشنهاد دهید. شناسهٔ عملیات را هم با کد پیگیری نهایی اشتباه نگیرید.
تمرین را با مقصد ساختگی اجرا کنید تا هیچ درخواست واقعی نسازد. برای قبولی، عبارت «ثبت شد» فقط پس از شاهد ثبت قطعی پخش شود و در حالت نامعلوم، تلاش دوم بدون بررسی نتیجهٔ اول انجام نشود. برگهٔ همراه برای ثبت همین شاهد و رفتار قابل مشاهده است.
برگهٔ همراه
راهنمای مرتبط اپرا · آشنایی با راهکار مرتبط اپرا