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

نمونهٔ گزارش

این نمونه جایگاه مصنوع گزارش را در سند BDL نشان می‌دهد. هویت گزارش و ترکیب مصنوعات را بدون اختراع ساختارهای مستندنشدۀ پرس‌وجو، منبع داده، ستون، فیلتر یا نمایش توضیح می‌دهد.

نمونه​

{
  "schema": "barsa.definition.v1",
  "project": {
    "code": "SAMPLE",
    "caption": "Sample",
    "systemId": "${RESOLVE_SYSTEM_ID}",
    "version": "1.0.0"
  },
  "references": {},
  "artifacts": [
    {
      "kind": "report",
      "code": "CustomerList",
      "caption": "Customer List"
    }
  ]
}

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

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

منبع داده و ساختار پرس‌وجو​

گزارش واقعی معمولاً به منبع داده نیاز دارد و ممکن است شامل این موارد باشد:

  • موجودیت یا نمای منبع
  • منطق پرس‌وجو یا انتخاب
  • ستون‌ها
  • فیلترها
  • مرتب‌سازی
  • پارامترها
  • گروه‌بندی یا تجمیع
  • مجوزها

ساختار دقیق این عناصر باید از نسخهٔ مبنای فعال BDL گرفته شود. نحو مستندنشدۀ گزارش را از این نمونهٔ حداقلی استنباط نکنید.

فرادادهٔ موجود​

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

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

پیش از تولید گزارش بررسی کنید:

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

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

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

ادامه​

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