نمونهها و الگوها
این بخش نمونههای عملی BDL و الگوهای تألیف قابل استفادهٔ مجدد را ارائه میکند.
هدف نمونهها نمایش کوچکترین تعریف روشن برای بیان قصد طراحی است؛ بدون اختراع وضعیت بومی برسا، شناسهها، رفتار Runtime یا قابلیتهای تألیف پشتیبانینشده.
نحوهٔ استفاده از نمونهها
هر نمونه را همراه با مرجع BDL و مدل قابلیت بخوانید. پیش از استفاده در سیستم واقعی، هر چهار لایه را بررسی کنید:
- Native Barsa — آیا برسا قابلیت را پشتیبانی میکند؟
- Runtime Support — آیا Runtime میتواند آن را اجرا کند؟
- BDL Expressibility — آیا BDL میتواند آن را توصیف کند؟
- BDL Authoring Availability — آیا سطح تألیف فعلی مجاز به تولید آن است؟
نمایش یک ساختار زبان در نمونه، خودبهخود دسترسپذیری همهٔ عملیات مرتبط Runtime یا تألیف را ثابت نمیکند.
سند حداقلی BDL
کوچکترین سند مفید BDL با Schema زبان، هویت پروژه، مراجع و مصنوعات آغاز میشود.
{
"schema": "barsa.definition.v1",
"project": {
"code": "SAMPLE",
"caption": "Sample",
"systemId": "${RESOLVE_SYSTEM_ID}",
"version": "1.0.0"
},
"references": {},
"artifacts": []
}
مقدار systemId در این نمونه عمداً تعیین نشده است. مؤلفان و سامانههای هوش مصنوعی باید شناسههای وابسته به محیط را از فرادادهٔ زنده یا زمینهٔ معتبر استقرار تعیین کنند؛ نه اینکه آنها را بسازند.
اصول نمونهها
- از کوچکترین تعریف معتبر آغاز کنید.
- هرگز شناسههای بومی یا وضعیت موجود سیستم را اختراع نکنید.
- ساختار زبان را از فرضیات Runtime جدا نگه دارید.
- پیش از تغییر داده اعتبارسنجی کنید.
- پیامهای تشخیصی صریح را به مقادیر حدسی ترجیح دهید.
systemCodeرا کد کنترلشده بدانید، نه راه دورزدن محدودیتها.- زمینهٔ نسخه و شواهد را حفظ کنید.
نمونههای برنامهریزیشده
این بخش شامل این موضوعات خواهد بود:
- تعریفهای حداقلی پروژه
- موجودیتها و فیلدها
- فرمها و چیدمانها
- گزارشها
- گردشکارها
- قواعد و فرمانها
- مجوزها و ناوبری
- اعلانها و دادههای اولیه
- صفحات و گروهها
- کنترل کد سیستم
- الگوهای ترکیب مصنوعات
- الگوهای تألیف ایمن با هوش مصنوعی
تفاوت الگو و قابلیت
الگو روشی پیشنهادی برای ترکیب مصنوعات BDL را توصیف میکند. بیان قابلیت مشخص میکند یک لایهٔ معین برسا، Runtime، BDL یا تألیف واقعاً چه چیزی را پشتیبانی میکند.
نمونه یا الگو را شاهد وجود یک قابلیت ندانید.