/
/
/
/
Optional Options یکی از قابلیت‌های Providerهای مبتنی بر Database است که برای تعریف تنظیمات اختیاری و قابل انتخاب در زمان استفاده از Provider استفاده می‌شود. این قابلیت زمانی کاربرد دارد که رفتار Provider بر اساس انتخاب‌های مختلف کاربر یا مصرف‌کننده تغییر کند.
Provider از نوع Optional Options
در این نوع Provider، به‌جای تعریف چند Provider جداگانه برای سناریوهای مشابه، می‌توان گزینه‌های قابل انتخاب تعریف کرد و رفتار Provider را بر اساس انتخاب انجام‌شده کنترل کرد.
نکته مهم
Optional Options برای مدیریت حالت‌های مختلف اجرای یک Provider استفاده می‌شود و باعث می‌شود منطق انتخاب در زمان استفاده از Provider قابل تنظیم باشد.
ساختار Optionها
در Optional Options، گزینه‌ها در قالب گروه و آیتم‌های قابل انتخاب تعریف می‌شوند. هر Option می‌تواند مقدار مشخصی داشته باشد که در زمان اجرای Provider مورد استفاده قرار می‌گیرد.
| مفهوم | توضیح |
|---|---|
| Option Group | گروهی برای دسته‌بندی گزینه‌های مرتبط |
| Option | گزینه‌ای که کاربر یا مصرف‌کننده می‌تواند انتخاب کند |
| Option Value | مقداری که در زمان اجرا به Provider منتقل می‌شود |
تعریف Option Group
Option Group برای دسته‌بندی مجموعه‌ای از انتخاب‌های مرتبط استفاده می‌شود. با استفاده از Group می‌توان گزینه‌ها را منظم‌تر مدیریت کرد و ساختار قابل فهم‌تری برای مصرف‌کننده ایجاد کرد.
تعریف Option
پس از ایجاد گروه، گزینه‌های مورد نیاز داخل آن تعریف می‌شوند. هر Option دارای اطلاعاتی است که مشخص می‌کند چه مقداری در زمان اجرای Provider استفاده شود.
- عنوان گزینه برای نمایش به کاربر
- مقدار واقعی Option
- ترتیب نمایش گزینه‌ها
- وضعیت فعال بودن گزینه
مثال استفاده از Optional Options
فرض کنید یک Provider برای دریافت اطلاعات بر اساس ماه نیاز دارد. به‌جای ساخت چند Provider جداگانه، می‌توان یک Option Group برای ماه ایجاد کرد و گزینه‌های مختلف را داخل آن قرار داد.
Option Group: Month Options: January → 1 February → 2 March → 3
نکات اجرایی
- Optionها باید دارای نام قابل فهم برای مصرف‌کننده باشند.
- مقدار داخلی Option باید با منطق Query یا Provider هماهنگ باشد.
- تغییر Optionهای موجود ممکن است روی Providerهای وابسته اثر بگذارد.
- قبل از حذف یا تغییر Optionها، مصرف‌کنندگان Provider بررسی شوند.
Warning
جزئیات رفتار Optionها باید مطابق تنظیمات واقعی Build مقصد تست شود، زیرا نحوه استفاده از Optionها می‌تواند به نوع Provider و تنظیمات اجرایی وابسته باشد.