أنواع البيانات المركبة المدعومة لمعادلات التقارير الإلكترونية
توفر هذه المقالة معلومات عن أنواع البيانات المركبة المعتمدة في تعبيرات التقارير الإلكترونية (ER). أنواع البيانات المركبة هي الفئة و الحاوية و السجل و قائمة السجل و الكائن.
الدرجة
يشير نوع البيانات الفئة إلى فئة التطبيق العامة. في التقارير الإلكترونية، يتم تمثيله على أنه سجل يحتوي على حقل منفصل لكل أسلوب عام للفئة المشار إليها. عند تعيين معلمات استدعاء الأسلوب، يجب أيضًا تحديد الوسيطات المطلوبة من الأنواع المناسبة في تعبير التقارير الإلكترونية الذي يتم تكوينه لاستدعاء الأسلوب.
في تعيين التقارير الإلكترونية و تنسيق المكونات، يمكنك إضافة مصدر البيانات الفئة الذي يتم تقديمه كمصدر بيانات وإرجاع قيمة لنوع الفئة. يكشف مصدر البيانات هذا الأساليب العامة للفئة التي يمكن استدعاؤها في وقت التشغيل.
إشعار
يمكن استدعاء الأساليب التي ترجع قيمة من تعبيرات التقارير الإلكترونية فقط.
يمكن استدعاء الأساليب التي تحتوي على نطاق من صفر إلى ثمان وسيطات من تعبيرات التقارير الإلكترونية.
القيمة الافتراضية لـ فئةفارغة.
يوضح الرسم التوضيحي التالي كيفية إضافة مصدر البيانات System information(xInfo) لنوع الفئة لإجراء مثيل فئة التطبيق xInfo واستدعاء الأسلوب productName() لتلقي اسم التطبيق الحالي. يتم إحضار اسم التطبيق الحالي في وقت التشغيل عن طريق تنفيذ ربط xInfo.productName الذي يتم تكوينه للحقل Software name(SoftwareName) لنموذج بيانات التقارير الإلكترونية. يستدعي هذا الربط أسلوب productName() لفئة التطبيق xInfo التي يتم تمثيلها في تعيين النموذج الحالي كمصدر بيانات System information(xInfo).
يوضح الرسم التوضيحي التالي كيفية تكوين تنسيق التقارير الإلكترونية لوضع اسم التطبيق المقدم في المستندات التي تم إنشاؤها. تم ربط الحقل Software name(SoftwareName) لنموذج البيانات المستخدم بمكون السلسلة المتداخل ضمن عنصر softwareUsed XML من تنسيق التقارير الإلكترونية. لذلك، يتم وضع اسم التطبيق الحالي في وقت التشغيل إلى لعنصر softwareUsed XML للمستند الذي تم إنشاؤه بتنسيق XML.
الحاوية
يحتوي نوع بيانات الحاوية على محتوى ثنائي. يمكن استخدام قيمة الحاوية لتمرير معلومات معينة من التخزين إلى مستند تم إنشاؤه. في إطار عمل التقارير الإلكترونية، يتم استخدام نوع البيانات هذا بشكل متكرر لوضع محتوى الوسائط مثل شعار الشركة في المستندات التي تم إنشاؤها.
إشعار
على الرغم من أنه يمكن تمثيل كل عنصر وسائط كقيمة حاوية، لا تمثل كل قيمة حاوية عنصر وسائط. لذلك، إذا قمت بتكوين تنسيق التقارير الإلكترونية بحيث يستخدم حاوية لوضع صورة في مستندات تم إنشاءها، ولكن لا ترجع الحاوية المشار إليها، محتوى الوسائط، قد يتم طرح استثناء مشابه للمثال التالي: "خطأ في تنفيذ التعليمات البرمجية: ثنائي (كائن)، تم استدعاء الأسلوب constructFromContainer بمعلمات غير صالحة."
القيمة الافتراضية لـ حاويةفارغة.
يبين الرسم التوضيحي التالي كيفية ربط الحقل Bitmap(Image) للنوع الحاوية بحقل نموذج البيانات الشعار لنوع الحاوية في تعيين النموذج فاتورة المبيعات. يجعل هذا الربط شعار الشركة متوفرًا لأي تنسيق تقارير إلكترونية تم تصميمه لتعريف جذر SalesInvoice ويستخدم تعيين نموذج هذا في وقت التشغيل.
السجل
يُعد السجل مجموعة الحقول المسماة، يرتبط كل منها بقيمة إما بنوع بيانات أساسية أو بنوع بيانات مركبة. عادة، يتم استخدام سجل لتمثيل سجل مفرد من قائمة السجلات. في هذه الحالة، يمثل كل صنف الحقول والأساليب والعلاقات الفردية.
القيمة الافتراضية لـ سجلفارغة.
إشعار
عند الحصول على قيمة حقل سجل فارغة، فإنه يتم إرجاع القيمة الافتراضية لنوع البيانات المناسب.
يمكن الحصول على السجل باستخدام الوظائف التالية:
لمزيد من المعلومات حول تحويل قيم السجل، راجع قائمة وظائف التقارير الإلكترونية في فئة القائمة.
قائمة السجلات
تعتبر قائمة السجلات قائمة بالأصناف الخاصة بنوع السجل. عادةً، يتم استخدام قائمة السجل لتمثيل قائمة السجلات التي تم إحضارها من جدول قاعدة بيانات.
افتراضيًا، يتم الوصول إلى سجلات قائمة السجلات بشكل تسلسلي. للوصول إلى سجل محدد، يمكنك استخدام الوظيفة INDEX وتحديد الفهرس عدد صحيح:
القيمة الافتراضية لـ قائمة السجلاتفارغة. يمكنك استخدام الوظيفة ISEMPTY لتقييم ما إذا كانت قائمة السجلات فارغة أم لا.
إشعار
إذا كانت قائمة السجلات فارغة، فإن أية محاولة للحصول على قيمة حقل لـ سجل فيها تؤدي إلى طرح استثناء في وقت التشغيل. لمعرفة كيف يمكنك المساعدة في منع استثناءات وقت التشغيل لهذا النوع، راجع اعتبار حالات القائمة الفارغة.
يمكن بدء قائمة السجلات باستخدام الوظائف التالية:
لمزيد من المعلومات حول تحويل قيم قائمة السجلات، راجع قائمة وظائف التقارير الإلكترونية في فئة القائمة. لمعرفة كيفية تقديم أصناف قائمة السجلات، قم بملئها باستخدام بيانات التطبيق، ثم استخدم البيانات لإنشاء مستندات الأعمال، راجع تصميم حل تقارير إلكترونية جديد لطباعة تقرير مخصص.
كائن
يشير كائن إلى مثيل مناسب لـ فئة. عادةً، يتم بدء كائن في كود المصدر. ثم يتم تمريره إلى تعيين نموذج التقارير الإلكترونية ويوفر تفاصيل عن سياق التنفيذ.
القيمة الافتراضية لـ كائنفارغة.
يبين الرسم التوضيحي التالي كيفية إضافة مصدر بيانات ReportDataContract لنوع كائن لتمرير معلومات حول فاتورة تم إنشائها من كود المصدر إلى تعيين نموذج فاتورة المشروع. على سبيل المثال، يتم تمرير نص مثيل الفاتورة كجزء من سياق التنفيذ. يتم الحصول على هذا النص من كود المصدر عن طريق تنفيذ ربط ReportDataContract.parmInvoiceInstanceText الذي تم تكوينه للحقل ملاحظة لنموذج بيانات التقارير الإلكترونية. يستدعي هذا الربط أسلوب parmInvoiceInstanceText() لفئة التطبيق PSAProjInvoiceContract التي يتم تمثيلها في تعيين النموذج الحالي كمصدر بيانات ReportDataContract.
لمعرفة كيفية تمرير تفاصيل سياق التنفيذ من كود المصدر إلى الحل التقارير الإلكترونية الذي يتم تشغيله، راجع تطوير بيانات اصطناعية للتطبيق لاستدعاء التقرير المصمّم.