اتصال یک گزارش به یک موجودیت

هدف

یک گزارش را به یک موجودیت برنامه‌های Model-Driven متصل کنید — برای نمونه یک موجودیت Invoice — تا گزارش رکوردهای آن موجودیت را از یک محیط بخواند و فیلدهای آن را به صورت ستون‌های گزارش بچیند.

پیش‌نیازها

• موجودیتی که می‌خواهید از آن گزارش بگیرید در محیطی که علیه آن گزارش می‌گیرید وجود دارد. هر جدول از همان لحظهٔ ساخت داده‌اش را پشت خود دارد (به وقتی جدولی را ذخیره می‌کنید چه می‌شود نگاه کنید).
• اعتبارنامه‌هایی دارید که دسترسی خواندن گزارش به آن محیط را می‌دهند: یا ثبت یک برنامهٔ بیرونی که دامنهٔ دسترسی reporting.read (یا modelapps.read) به آن اعطا شده است (به ثبت یک برنامهٔ بیرونی نگاه کنید)، یا از درون پوستهٔ پلتفرم گزارش می‌گیرید که همان دسترسی را برای برنامه‌ای که در آن کار می‌کنید فراهم می‌کند.
• می‌دانید کدام محیط داده‌های مورد نظر شما را نگه می‌دارد (گزارش‌گیری همیشه داده‌های دقیقاً یک محیط را می‌خواند).

گام‌ها

1. در ابزار گزارش‌گیری، یک گزارش بسازید یا باز کنید و یک منبع دادهٔ Parsware اضافه کنید.
2. منبع داده را به نشانی گزارش‌گیری محیط مقصد نشانه بگیرید و اعتبارنامه‌های گزارش‌گیری را که در پیش‌نیازها آمد فراهم کنید.
3. موجودیتی را که می‌خواهید از آن گزارش بگیرید از فهرست موجودیت‌های قابل اتصال انتخاب کنید. هر جدولِ آن محیط در فهرست ظاهر می‌شود — برای نمونه Invoice.
4. ابزار، ستون‌های قابل اتصال موجودیت را بارگذاری می‌کند (برچسب و نوع دادهٔ هر فیلد، با فیلد اصلی موجودیت در ابتدا). ستون‌هایی را که می‌خواهید روی گزارش باشند انتخاب کنید.
5. به‌اختیار روی همان ستون‌ها فیلترها و مرتب‌سازی‌ها (برای نمونه، «جمع کل بزرگ‌تر از ۵۰ است»، تازه‌ترین ابتدا) و یک اندازهٔ صفحه اضافه کنید.
6. گزارش را پیش‌نمایش کنید. ابزار یک صفحه از ردیف‌ها را برای ستون‌های انتخاب‌شده درخواست می‌کند و آن‌ها را رندر می‌کند. گزارش را ذخیره کنید.

پشت صحنه چه اتفاقی می‌افتد

اتصال یک گزارش، یک ارتباط فقط‌خواندنی به داده‌های موجودیت همان یک محیط می‌سازد. منبع دادهٔ گزارش‌گیری هرگز نمی‌نویسد: می‌تواند جدول‌های محیط را فهرست کند، ستون‌های یک موجودیت را توصیف کند و صفحه‌هایی از ردیف‌ها را برای ستون‌ها و فیلترهایی که انتخاب کرده‌اید برگرداند. دسترسی به جای یک نقش کاربردی، با دامنهٔ دسترسی خواندن گزارش روی اعتبارنامه‌های شما اعطا می‌شود، و به همین دلیل یک یکپارچه‌سازی گزارش‌گیری به مجوزهای نوشتن سازنده یا مدیر نیاز ندارد. هر درخواست تنها همان محیطی را می‌خواند که منبع داده را به آن نشانه گرفته‌اید — داده‌های یک محیط هرگز نمی‌توانند در گزارشی که به محیط دیگری متصل است ظاهر شوند.

عیب‌یابی

• «Reading reporting data requires the 'reporting.read' or 'modelapps.read' scope.» — اعتبارنامه‌های روی منبع داده دسترسی خواندن گزارش را نمی‌دهند. از ثبت برنامه‌ای استفاده کنید که دامنهٔ دسترسی reporting.read (یا modelapps.read) دارد، یا از درون پوسته گزارش بگیرید.
• موجودیت در فهرست موجودیت‌های قابل اتصال نیست. — در این محیط وجود ندارد؛ احتمالاً منبع داده را به محیط دیگری نشانه گرفته‌اید. منبع داده را به محیطی نشانه بگیرید که آن جدول را نگه می‌دارد، یا راه‌حلی را که آن را می‌آورد درون‌ریزی کنید.
• یک فیلتر یا مرتب‌سازی به عنوان فیلد ناشناخته رد می‌شود. — آن فیلتر یا مرتب‌سازی فیلدی را نام می‌برد که روی موجودیت تعریف نشده است. ستونی را از فهرست فیلدهای خود موجودیت انتخاب کنید.

سناریوهای مرتبط

• وقتی جدولی را ذخیره می‌کنید چه می‌شود.
• ثبت یک برنامهٔ بیرونی.
• پرس‌وجوی داده‌های موجودیت برای گزارش‌گیری (توسعه‌دهنده).