پرش به مطلب اصلی

نمای کلی زبان

BDL یک قرارداد JSON کنترل‌شده برای توصیف فراداده‌های قابل تألیف برسا، ساختار سیستم و عملیات پشتیبانی‌شده‌ای است که تحت کنترل Runtime قرار دارند.

BDL هدف و ساختار را بیان می‌کند. این زبان جایگزین Runtime بومی برسا نمی‌شود؛ Runtime همچنان مرجع نهایی اجرای سیستم است.

سند ریشه​

هر سند BDL از یک ساختار ریشه استاندارد آغاز می‌شود:

{
  "schema": "barsa.definition.v1",
  "project": {
    "code": "SampleProject",
    "caption": "Sample Project",
    "systemId": 123,
    "version": "1.0.0"
  },
  "references": {},
  "artifacts": []
}

سند ریشه شامل چهار بخش اصلی است:

ویژگیکاربرد
schemaSchema سند BDL را مشخص می‌کند.
projectهویت پروژه و اطلاعات نسخه آن را تعریف می‌کند.
referencesارجاعات موردنیاز تعریف را نگهداری می‌کند.
artifactsمصنوعات سیستمی توصیف‌شده توسط BDL را در بر می‌گیرد.

هویت پروژه​

شیء project پروژه BDL و سیستم مقصد در برسا را مشخص می‌کند.

شناسه‌های بومی مانند project.systemId باید از فراداده زنده سیستم استخراج و تعیین شوند. حدس‌زدن شناسه‌های بومی مجاز نیست.

مدل مصنوعات​

مدل پایه، انواع مصنوعات زیر را تعریف می‌کند:

  • entity
  • form
  • report
  • workflow
  • rule
  • command
  • permission
  • menu
  • notification
  • seedData
  • systemCode

BDL v5.2 علاوه بر این، page و group را نیز به‌عنوان انواع مستقل و درجه‌اول Artifact معرفی می‌کند.

وجود یک نوع Artifact در مدل زبان، به‌طور خودکار به این معنا نیست که همه ویژگی‌های آن برای تألیف محیط عملیاتی در دسترس هستند.

زبان در برابر Runtime​

هنگام ارزیابی یک قابلیت، این چهار موضوع را از یکدیگر جدا نگه دارید:

  1. Native Barsa capability
  2. Runtime support
  3. BDL expressibility
  4. BDL authoring availability

ممکن است یک قابلیت در یک لایه پشتیبانی شود، اما در لایه‌ای دیگر در دسترس نباشد.

مسیر استاندارد​

یک گردش‌کار کنترل‌شده BDL به‌طور کلی از این مراحل پیروی می‌کند:

  1. نیازمندی و Artifact میزبان را مشخص کنید.
  2. مستندات قابلیت و شکاف‌های شناخته‌شده را بررسی کنید.
  3. فراداده زنده و شناسه‌های موردنیاز را تعیین کنید.
  4. کوچک‌ترین JSON معتبر را تألیف کنید.
  5. عملیات Parse، Preflight و Validation را انجام دهید.
  6. برنامه اجرا و پیام‌های تشخیصی مسدودکننده را بررسی کنید.
  7. در موارد لازم، تأیید موردنیاز را دریافت کنید.
  8. اجرا را از طریق سرویس‌های بومی و کنترل‌شده Runtime انجام دهید.
  9. نتیجه را دوباره بارگذاری و بررسی کنید.
  10. خروجی‌گیری، رفت‌وبرگشت و تطبیق را انجام دهید و شواهد را ثبت کنید.

مرحله بعد​

برای آشنایی با ساختار و قواعد انواع مختلف Artifact در BDL، به بخش مرجع مصنوعات (Artifact Reference) ادامه دهید.