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

نمونهٔ فرم

این نمونه نمایش مصنوع فرم در کنار موجودیت در سند BDL را نشان می‌دهد. تمرکز عمدی بر ترکیب مصنوعات و قصد ارجاع است؛ ساختارهای مستندنشدۀ کنترل یا چیدمان اختراع نمی‌شوند.

نمونه​

{
  "schema": "barsa.definition.v1",
  "project": {
    "code": "SAMPLE",
    "caption": "Sample",
    "systemId": "${RESOLVE_SYSTEM_ID}",
    "version": "1.0.0"
  },
  "references": {},
  "artifacts": [
    {
      "kind": "entity",
      "code": "Customer",
      "caption": "Customer"
    },
    {
      "kind": "form",
      "code": "CustomerMainForm",
      "caption": "Customer Main Form"
    }
  ]
}

آنچه این نمونه نشان می‌دهد​

  • فرم‌ها مصنوعات درجه‌اول BDL هستند.
  • فرم می‌تواند در کنار موجودیتی باشد که برای نمایش آن در نظر گرفته شده است.
  • فرم هویت پایدار مستقل برای تألیف دارد.
  • هویت مصنوع باید صریح و جدا از متن نمایشی باشد.

اتصال فرم به موجودیت​

در تعریف واقعی، فرم باید با ساختار پشتیبانی‌شدهٔ نسخهٔ مبنای فعال BDL به موجودیت هدف صحیح متصل شود. شناسهٔ موجودیت، مرجع فراداده، اتصال کنترل یا ویژگی چیدمان را اختراع نکنید.

وقتی فرم، موجودیت موجودی را هدف می‌گیرد، اشیای برسا را از فرادادهٔ معتبر تعیین کنید.

کنترل‌ها و چیدمان​

فرم‌های واقعی معمولاً به این موارد نیاز دارند:

  • فیلدها یا کنترل‌ها
  • ساختار چیدمان
  • بخش‌ها یا گروه‌ها
  • اتصال‌های داده
  • قواعد نمایش یا رفتار
  • مجوزها

ساختار دقیق این عناصر باید از نسخهٔ مبنای فعال زبان و دانش گرفته شود. این نمونهٔ حداقلی عمداً آن ساختارها را جعل نمی‌کند.

بررسی قابلیت​

پیش از تألیف فرم واقعی تأیید کنید:

  1. Native Barsa رفتار موردنظر فرم را پشتیبانی می‌کند.
  2. Runtime از فرم و کنترل‌ها پشتیبانی می‌کند.
  3. BDL می‌تواند ساختار موردنظر فرم را بیان کند.
  4. سطح فعلی تألیف، تولید آن ساختار را مجاز می‌داند.

الگوی تألیف ایمن​

ابتدا کوچک‌ترین فرم معتبر را ایجاد کنید. سپس کنترل‌ها، چیدمان، اتصال‌ها و قواعد را تدریجی اضافه کنید و پس از تغییرات معنادار اعتبارسنجی کنید.

اگر نوع کنترل یا ساختار اتصال مستند نیست، توقف کنید و فرادادهٔ لازم را تعیین کنید؛ حدس نزنید.

ادامه​

نمونهٔ بعدی مصنوع گزارش را نشان می‌دهد.