ربط تقرير بكيان
الهدف
اربط تقريرًا بكيان من كيانات التطبيقات المدفوعة بالنموذج — على سبيل المثال، كيان Invoice — بحيث يقرأ التقرير سجلات ذلك الكيان من بيئة واحدة ويعرض حقوله بوصفها أعمدة في التقرير.
المتطلبات المسبقة
- الكيان الذي تريد إعداد تقرير عنه موجود في البيئة التي تُعِدّ التقرير مقابلها. فكل جدول تكون بياناته خلفه منذ لحظة إنشائه (راجع ماذا يحدث عند حفظ جدول).
- لديك بيانات اعتماد تمنح صلاحية قراءة التقارير في البيئة: إما تسجيل تطبيق خارجي
مُنِح النطاق
reporting.read(أوmodelapps.read) (راجع تسجيل تطبيق خارجي)، أو أنك تُعِدّ التقرير من داخل قشرة المنصة، التي توفّر الصلاحية نفسها للتطبيق الذي تعمل فيه. - أنت تعرف البيئة التي تحتوي على البيانات التي تريدها (فإعداد التقارير يقرأ دائمًا بيانات بيئة واحدة بالضبط).
الخطوات
- في أداة التقارير، أنشئ تقريرًا أو افتح تقريرًا قائمًا، ثم أضف مصدر بيانات Parsware.
- وجّه مصدر البيانات إلى عنوان التقارير الخاص بالبيئة الهدف، وقدّم بيانات اعتماد التقارير المذكورة في المتطلبات المسبقة.
- اختر الكيان المراد إعداد التقرير عنه من قائمة الكيانات القابلة للربط. ويظهر في القائمة كل جدول في تلك البيئة — على سبيل المثال، Invoice.
- تحمّل الأداة أعمدة الكيان القابلة للربط (تسمية كل حقل ونوع بياناته، مع الحقل الأساسي للكيان أ ولًا). حدّد الأعمدة التي تريدها في التقرير.
- أضف اختياريًا عوامل تصفية وترتيب على تلك الأعمدة (على سبيل المثال، «الإجمالي أكبر من 50»، والأحدث أولًا) وحجم الصفحة.
- اعرض معاينة التقرير. تطلب الأداة صفحة من الصفوف للأعمدة المحددة وتعرضها. احفظ التقرير.
ما الذي يحدث خلف الكواليس
ينشئ ربط التقرير اتصالًا للقراءة فقط ببيانات كيان تلك البيئة الواحدة. ولا يكتب مصدر بيانات التقارير أبدًا: فهو يستطيع سرد جداول البيئة، ووصف أعمدة كيان، وإرجاع صفحات من الصفوف للأعمدة وعوامل التصفية التي اخترتها. وتُمنَح الصلاحية عبر نطاق قراءة التقارير في بيانات اعتمادك لا عبر دور تطبيقي، ولهذا لا يحتاج تكامل التقارير إلى صلاحيات كتابة خاصة بالمصمم أو المسؤول. وكل طلب يقرأ البيئة التي وجّهت مصدر البيانات إليها فقط — فلا يمكن أبدًا أن تظهر بيانات بيئة في تقرير مرتبط ببيئة أخرى.
حل المشكلات
- «Reading reporting data requires the 'reporting.read' or 'modelapps.read' scope.» —
بيانات الاعتماد المستخدمة في مصدر البيانات لا تمنح صلاحية قراءة التقارير. استخدم
تسجيل تطبيق يملك النطاق
reporting.read(أوmodelapps.read)، أو أعِدّ التقرير من داخل القشرة. - الكيان غير موجود في قائمة الكيانات القابلة للربط. — الكيان غير موجود في هذه البيئة؛ الأرجح أنك وجّهت مصدر البيانات إلى بيئة مختلفة. وجّه مصدر البيانات إلى البيئة التي تحتوي الجدول، أو استورد الحل الذي يجلبه.
- رُفض عامل تصفية أو ترتيب بوصفه حقلًا غير معروف. — يشير عامل التصفية أو الترتيب إلى حقل غير مُعرَّف في الكيان. اختر عمودًا من قائمة حقول الكيان نفسه.
سيناريوهات ذات صلة
- ماذا يحدث عند حفظ جدول.
- تسجيل تطبيق خارجي.
- الاستعلام عن بيانات الكيانات لإعداد التقارير (المطوّر).