وظيفة GETENUMVALUEBYNAME ER

مقالة
03/08/2023

تبحث وظيفة GETENUMVALUEBYNAME عن قيمة Enum مُحددة في مصدر بيانات التعداد المُحدد باستخدام اسم التعداد المُحدد كقيمة السلسلة . إذا تم العثور على قيمة تعداد ، تقوم الوظيفة بإرجاعها. وإلا، تقوم الوظيفة بإرجاع قيمه التعداد null.

بناء الجملة

GETENUMVALUEBYNAME (enumeration data source path, enumeration value text)

الوسائط

enumeration data source path: تعداد

مسار مرجع صالح لمصدر بيانات أحد أنواع التعداد التالية:

تعداد نموذج إعداد التقارير الإلكترونية (ER)
تعداد تنسيق إعداد التقارير الإلكترونية
تعداد Microsoft Dynamics 365‏ Finance

enumeration value text: سلسلة

قيمة سلسلة تمثل اسم قيمة تعداد مُفرد.

إرجاع القيم

‏‫قابل للإبطال Enum

قيمة التعداد الناتجة.

ملاحظات الاستخدام

لا يتم طرح أي استثناء إذا لم يتم العثور على قيمة Enum باستخدام اسم قيمة التعداد المحدد كقيمة سلسلة .

مثال1

في الرسم التوضيحي التالي، يتم تقديم تعداد ReportDirection في نموذج بيانات. لاحظ أنه يتم تحديد التسميات لقيم التعداد.

القيم المتوفرة لقائمة تعداد نموذج البيانات.

يبين الرسم التوضيحي التالي هذه التفاصيل:

يتم تكوين مصدر البيانات $Direction في تقرير التقارير الإلكترونية. يتم تكوين مصدر البيانات هذا استنادًا إلى تعداد نموذج ReportDirection.
تم تصميم التعبير $IsArrivals ليستخدم مصدر بيانات $Direction المستند إلى تعداد النموذج تعداد النموذج كمعلمة لهذه الوظيفة.
قيمة تعبير المقارنة هذا هي TRUE.

مثال عن تعداد نموذج بيانات.

مثال2

تسمح لك الدالتان GETENUMVALUEBYNAME وLISTOFFIELDS بإحضار قيم وتسميات التعدادات المعتمدة كقيم نصية. (التعدادات المعتمدة هي تعدادات التطبيق وتعدادات نموذج البيانات وتعدادات التنسيق.)

في الرسم التوضيحي التالي، يتم تقديم مصدر البيانات TransType في تعيين نموذج. يُشير مصدر البيانات هذا إلى تعداد تطبيق LedgerTransType.

مصدر بيانات لتعيين النموذج الذي يشير إلى تعداد التطبيق.

يبين الرسم التوضيحي التالي مصدر البيانات TransTypeList المكوّن في تعيين نموذج. يتم تكوين مصدر البيانات هذا استنادًا إلى تعداد تطبيق TransType. تُستخدم الدالة LISTOFFIELDS لإرجاع كافة قيم التعداد كقائمة سجلات تحتوي على حقول. بهذه الطريقة، يتم عرض تفاصيل كل قيمة من قيم التعداد.

إشعار

تم تكوين الحقل EnumValue لمصدر البيانات TransTypeList باستخدام التعبير GETENUMVALUEBYNAME(TransType, TransTypeList.Name). يرجع هذا الحقل قيمة التعداد لكل سجل في هذه القائمة.

مصدر بيانات لتعيين النموذج الذي يرجع كافة قيم التعداد لتعداد محدد كقائمة بالسجلات.

يبين الرسم التوضيحي التالي مصدر البيانات VendTrans المكوّن في تعيين نموذج. يقوم مصدر البيانات هذا بإرجاع سجلات حركات المورّد من جدول تطبيق VendTrans. يتم تحديد نوع دفتر الأستاذ لكل حركة بواسطة قيمة الحقل TransType.

إشعار

تم تكوين الحقل TransTypeTitle لمصدر البيانات VendTrans باستخدام التعبير FIRSTORNULL(WHERE(TransTypeList, TransTypeList.EnumValue = @.TransType)).Label. يقوم هذا الحقل بإرجاع تسمية قيمة التعداد الخاصة بالحركة الحالية كنص، إذا كانت قيمة التعداد هذه متوفرة. وإلا، فسيقوم بإرجاع قيمة سلسلة فارغة.

يرتبط الحقل TransTypeTitle بحقل LedgerType لنموذج بيانات يمكّن استخدام هذه المعلومات في كل تنسيقات التقارير الإلكترونية التي تستخدم نموذج البيانات كمصدر بيانات.

مصدر بيانات لتعيين النموذج الذي يُرجع حركات المورّد.

يبين الرسم التوضيحي التالي كيف يمكنك استخدام مصحح أخطاء مصدر البيانات لاختبار تعيين النموذج المكوّن.

استخدام مصحح أخطاء مصدر البيانات لاختبار تعيين النموذج المكوّن.

يعرض حقل LedgerType لنموذج بيانات تسمية أنواع الحركات كما هو متوقع.

إذا كنت تخطط لاستخدام هذه الطريقة كمية كبيره من بيانات الحركات، فيجب مراعاة أداء التنفيذ. لمزيد من المعلومات، راجع تتبع تنفيذ تنسيقات التقارير الإلكترونية لاستكشاف مشكلات الأداء وإصلاحها.