مصمم المعادلة في التقارير الإلكترونية

يشرح هذا الموضوع كيفية استخدام مصمم المعادلة في التقارير الإلكترونية. عندما تصمم تنسيقًا لمستند إلكتروني معين في التقارير الإلكترونية، يمكنك استخدام معادلات مماثلة لمعادلات Microsoft Excel لتحويل البيانات لتلبية متطلبات تنفيذ وتنسيق هذا المستند. هناك أنواع مختلفة من الدالات المعتمدة- النص والتاريخ والوقت ومنطق الرياضيات والمعلومات وتحويل أنواع البيانات وغير ذلك (دالات خاصة بمجال الأعمال).

نظرة عامة على مصمم المعادلة

تدعم التقارير الإلكترونية مصمم المعادلة. لذلك، في وقت التصميم، يمكنك تكوين التعبيرات التي يمكن استخدامها للمهام التالية في وقت التشغيل:

  • تحويل البيانات المستلمة من قاعدة بيانات Microsoft Dynamics 365 for Finance and Operations، والتي يجب أن تتم تعبئتها لنموذج بيانات التقارير الإلكترونية المصمم ليكون مصدر بيانات لتنسيقات التقارير الإلكترونية (التصفية، والتجميع، وتحويل أنواع البيانات، وغير ذلك).
  • تنسيق البيانات التي يجب إرسالها إلى مستند إلكتروني ناشئ وفقًا لتخطيط وشروط تنسيق تقرير إلكتروني محدد (وفقًا للغة أو الثقافة أو الترميز المطلوب، وغير ذلك).
  • التحكم في عملية إنشاء المستند الإلكتروني (تمكين/تعطيل إخراج عناصر معينة خاصة بالتنسيق، استنادًا إلى بيانات المعالجة ومقاطعة إنشاء المستند وطرح رسائل للمستخدمين النهائيين، وغير ذلك).

يمكن فتح صفحة مصمم المعادلة عند قيامك بأي مما يلي:

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

تصميم معادلات التقارير الإلكترونية

ربط البيانات

يمكن استخدام مصمم معادلة التقارير الإلكترونية لتعريف تعبير يقوم بتحويل البيانات التي يتم تلقيها من مصادر البيانات، بحيث يمكن تعبئة البيانات في مستهلك البيانات في وقت التشغيل:

  • من مصادر بيانات Finance and Operations ومعلمات وقت التشغيل إلى نموذج بيانات التقارير الإلكترونية.
  • من نموذج بيانات التقارير الإلكترونية إلى تنسيق التقارير الإلكترونية.
  • من مصادر بيانات Finance and Operations ومعلمات وقت التشغيل إلى نموذج التقارير الإلكترونية.

يبين الرسم التوضيحي التالي تصميم تعبير من هذا النوع. في هذا المثال، يرجع التعبير قيمة الحقل Intrastat.AmountMST لجدول Finance and Operations نظام جمع المعلومات التجارية بين دول الاتحاد الأوروبي، بعد أن تم تقريب القيمة إلى منزلتين عشريتين. picture-expression-binding يبين التوضيح التالي كيفية استخدام تعبير من هذا النوع. في هذا المثال، يتم نشر نتيجة التعبير المُصمم في المكون Transaction.InvoicedAmount لنموذج بيانات نموذج الإبلاغ الضريبي. picture-expression-binding2 في وقت التشغيل، ستقوم المعادلة التي تم تصميمها ROUND (Intrastat.AmountMST, 2)بتقريب قيمة الحقل AmountMST لكل سجل في جدول نظام جمع المعلومات التجارية بين دول الاتحاد الأوروبي إلى منزلتين عشريتين، وستقوم بتعبئة القيمة المُقرّبة إلى المكون Transaction.InvoicedAmount لنموذج البيانات إعداد التقارير الضريبية.

تنسيق البيانات

يمكن استخدام مصمم معادلة التقارير الإلكترونية لتعريف تعبير يقوم بتنسيق البيانات التي يتم تلقيها من مصادر البيانات، بحيث يمكن إرسال البيانات كجزء من المستند الإلكتروني الناشئ. إذا كان لديك تنسيق يجب تطبيقه كقاعدة نموذجية يجب إعادة استخدامها لتنسيق ما، فيمكن تقديم هذا التنسيق مرة واحدة في تكوين تنسيق كتحويل مسمى يحتوي على تعبير تنسيق. عندئذٍ، يمكن ربط هذا التحويل المسمى بالعديد من مكونات التنسيق التي يجب تنسيق إخراجها وفقًا للتعبير الذي تم إنشاؤه. يبين الرسم التوضيحي التالي تصميم تحويل من هذا النوع. في هذا المثال، تأخذ عملية التحويل TrimmedString البيانات الواردة من نوع البيانات سلسلة وتقتطع المسافات البادئة والزائدة عندما تقوم بإرجاع قيمة السلسلة. picture-transformation-design يبين الرسم التوضيحي التالي كيف يمكن استخدام عملية التحويل من هذا النوع. في هذا المثال، يشير الكثير من مكونات التنسيق التي ترسل النص كإخراج لإنشاء المستند الإلكتروني في وقت التشغيل إلى عملية التحويل TrimmedString حسب الاسم. picture-transformation-usage عندما تشير مكونات التنسيق إلى تحويل TrimmedStringtransformation (على سبيل المثال المكون partyName في الرسم التوضيحي السابق) يؤدي ذلك إلى إرسال نص كإخراج إلى المستند الناشئ. لا يتضمن النص مسافات بادئة وزائدة. إذا كان لديك تنسيق يجب أن يُطبق بشكل فردي، فيمكنك إدخال ذلك التنسيق كتعبير فردي لربط خاص بمكون تنسيق محدد. يبين الرسم التوضيحي التالي تعبيرًا من هذا النوع. في هذا المثال، يرتبط مكون التنسيق partyType بمصدر البيانات عبر تعبير يقوم بتحويل البيانات الواردة من الحقل Model.Company.RegistrationType في مصدر البيانات إلى نص بأحرف كبيرة ويرسل النص كإخراج إلى المستند الإلكتروني. picture-binding-with-formula

التحكم في تدفق العملية

يمكن استخدام مصمم معادلة التقارير الإلكترونية‬ لتحديد التعبيرات التي تتحكم في تدفق العملية للمستندات الناشئة. يمكنك:

  • تعريف الظروف التي تحدد متى يجب إيقاف عملية إنشاء المستند.
  • تحديد التعبيرات التي تنشئ رسائل للمستخدم النهائي فيما يتعلق بالعملية المتوقفة أو تطرح رسائل سجل تنفيذ فيما يتعلق بالعملية المستمرة لإنشاء التقارير.
  • تحديد أسماء ملفات للمستندات الناشئة والتحكم في ظروف إنشائها.

يتم تصميم كل قاعدة للتحكم في تدفق العملية كعملية تحقق من الصحة واحدة. يبين الرسم التوضيحي التالي عملية تحقق من هذا النوع. فيما يلي شرح للتكوين في هذا المثال:

  • يتم تقييم عملية التحقق من الصحة عند إنشاء عقدة INSTAT في ملف XML الناشئ.
  • إذا كانت قائمة الحركات فارغة، فستوقف عملية التحقق من الصحة العملية وترجع FALSE.
  • ترجع عملية التحقق من الصحة رسالة خطأ تتضمن نص التسمية SYS70894 باللغة المفضلة للمستخدم.

picture-validation يمكن استخدام مصمم معادلة التقارير الإلكترونية أيضًا لتحديد اسم ملف للملف الإلكتروني الناشئ والتحكم في عملية إنشاء الملف. يبين الرسم التوضيحي التالي تصميم التحكم بانسياب العملية‬ من هذا النوع. فيما يلي شرح للتكوين في هذا المثال:

  • يتم تقسيم قائمة السجلات من مصدر البيانات model.Intrastat إلى دُفعات تحتوي كل واحدة منها على 1000 سجل كحدٍ أقصى.
  • ينشئ الإخراج ملف zip يحتوي على ملف واحد بتنسيق XML لكل دُفعة تم إنشاؤها.
  • يُرجع التعبير اسم ملف للمستندات الإلكترونية الناشئة عن طريق وصل اسم الملف وملحقه. للدُفعة الثانية وكافة الدُفعات اللاحقة، يحتوي اسم الملف على معرف دُفعة كلاحقة.
  • يمكّن التعبير (من خلال إرجاع TRUE) عملية إنشاء ملف للدُفعات التي تحتوي على سجل واحد على الأقل.

picture-file-control

البنية الأساسية

يمكن أن تحتوي تعبيرات التقارير الإلكترونية أي من العناصر التالية أو كلها:

  • الثوابت
  • عوامل التشغيل
  • المراجع
  • المسارات
  • الدالات

الثوابت

يمكن استخدام الثوابت النصية والرقمية (القيم التي لم تُحتسب) عند تصميم التعبيرات. على سبيل المثال، يستخدم التعبير VALUE ("100") + 20 الثابت الرقمي 20 وثابت السلسلة "100"، ويُرجع القيمة الرقمية 120. يدعم مصمم معادلة التقارير الإلكترونية تسلسلات الهروب، مما يعني أنه يمكنك تحديد سلسلة التعبير التي يجب معالجتها بشكل مختلف. على سبيل المثال، يقوم التعبير "ليو تولستوي ""الحرب والسلم"" المجلد 1" بإرجاع السلسلة النصية ليو تولستوي "الحرب والسلم" المجلد 1.

عوامل التشغيل

يعرض الجدول التالي عوامل التشغيل الحسابية التي يمكن استخدامها لإجراء عمليات حسابية أساسية مثل الجمع والطرح والقسمة والضرب.

المعامل المعنى مثال
+ الجمع 1+2
- الطرح السالب 5-2 -1
* الضرب 7*8
/ القسم 9/3

يعرض الجدول التالي عوامل تشغيل المقارنة المعتمدة، والتي يمكن استخدامها لمقارنة قيمتين.

المعامل المعنى مثال
= متساو X=Y
> أكبر من X>Y
< أقل من X<Y
>= أكبر من أو يساوي X>=Y
<= أقل من أو يساوي X<=Y
<> لا يساوي X<>Y

بالإضافة إلى ذلك، يمكنك استخدام علامة العطف (&) كعامل تشغيل سَلسَلة نصية لوصل أو سَلسَلة سلسة نصية أو أكثر في قطعة نص واحدى.

المعامل المعنى مثال
& تسلسل "لا شيء للطباعة" & ": " & "لم يتم العثور على سجلات"

أسبقية عامل التشغيل

يُعد الترتيب الذي يتم بموجبه تقييم أجزاء تعبير مركب عنصرًا هامًا. على سبيل المثال، تختلف نتيجة التعبير 1 + 4 / 2، تبعًا للعملية التي تم تنفيذها أولاً، سواء كانت عملية جمع أم قسمة. يمكنك استخدام الأقواس لتعريف كيفية تقييم تعبير بوضوح. على سبيل المثال، للإشارة إلى وجوب إنجازه عملية الجمع أولاً، يمكنك تعديل التعبير السابق إلى (1 + 4)/2. إذا لم يكن ترتيب العمليات التي يجب إنجازها في التعبير معرّفًا بشكل واضح، فإن الترتيب يستند إلى الأسبقية الافتراضية المعيّنة إلى عوامل التشغيل المعتمدة. تظهر الجداول التالية عوامل التشغيل والأولوية المعينة لكل واحد منها. يتم تقييم عوامل التشغيل التي لها أسبقية أعلى (على سبيل المثال، 7) قبل عوامل التشغيل التي لها أولوية أقل (على سبيل المثال، 1).

الأسبقية عوامل التشغيل بناء الجملة
7 تجميع ( … )
6 وصول العضو … . …
5 استدعاء دالة … ( … )
4 تضاعفي … * … … / …
3 شيء مضاف … + … … - …
2 مقارنة … < … … <= … … => … … > … … = … … <> …
1 الفصل … , …

تتسم عوامل التشغيل على السطر نفسه بأسبقية متساوية. إذا تضمن التعبير أكثر من واحد من عوامل التشغيل هذه، فسيتم تقييم التعبير من اليسار إلى اليمين. على سبيل المثال، يُرجع التعبير 1 + 6 / 2 * 3 >5 القيمة true. نوصي باستخدام الأقواس للإشارة بوضوح إلى الترتيب المطلوب لتقييم التعبيرات، ولتسهيل قراءة التعبيرات والمحافظة عليها.

المراجع

يمكن استخدام جميع مصادر البيانات في مكون التقارير الإلكترونية الحالي (نموذج أو تنسيق) التي تتوفر أثناء تصميم تعبير كمراجع مسماة. على سبيل المثال، يحتوي نموذج بيانات التقارير الإلكترونية الحالي على مصدر البيانات ReportingDate، الذي يُرجع قيمة نوع البيانات DATETIME. للحصول على قيمة منسقة بشكل صحيح في المستند الناشئ، يمكنك الرجوع إلى مصدر البيانات في التعبير التالي: DATETIMEFORMAT (تاريخ الإبلاغ، "dd-MM-yyyy") يجب أن تُسبق كافة أحرف اسم مصدر البيانات المرجعي التي لا تمثل الحرف الأبجدي على علامة اقتباس مفردة ("). إذا كان اسم مصدر البيانات المرجعي يحتوي على رمز واحد على الأقل لا يمثل حرفًا من الحروف الأبجدية (على سبيل المثال، علامات الترقيم أو أي رموز مكتوب أخرى)، فمن ثم يجب أن يضمن الاسم في علامة اقتباس مفردة. فيما يلي بعض الأمثلة:

  • يجب الإشارة إلى مصدر البيانات Today's date & time في تعبير التقارير الإلكترونية على الشكل التالي: Today''s date & time'
  • يجب الإشارة إلى الأسلوب name() في مصدر البيانات Customers في تعبير التقارير الإلكترونية على الشكل التالي: Customers.'name()'

لاحظ أنه يتم استخدام بناء الجملة التالي لأساليب الاستدعاء لمصادر بيانات Dynamics 365 for Operation باستخدام معلمات:

  • يجب أن تتم الإشارة إلى الأسلوب isLanguageRTL الخاص بمصدر بيانات "النظام" مع المعلمة EN-US من نوع بيانات السلسلة في تعبير التقارير الإلكترونية على الشكل التالي: System.’isLanguageRTL’(“EN-US”).
  • لن تكون علامات الاقتباس إلزامية عندما يحتوي اسم الأسلوب على رموز أبجدية رقمية فقط. وتكون إلزامية بالنسبة إلى أسلوب جدول عندما يتضمن الاسم أقواسًا.

عندما تتم إضافة مصدر بيانات "النظام" إلى تعيين التقارير الإلكترونية الذي يشير إلى فئة "عمومي" لتطبيق Dynamics 365 for Operation، يرجع التعبير القيمة المنطقية، FALSE. التعبير المعدّل، النظام.’ isLanguageRTL’(“AR”) يُرجع القيمة المنطقية، TRUE.

لاحظ أنه يمكن تعريف المرور إلى معلمات الأساليب هذه بواسطة بالقيود التالية:

  • يمكن تمرير الثوابت فقط إلى هذه الأساليب، ويتم تعريف فيمتها في وقت التصميم.
  • يتم دعم أنواع البيانات الأولية (الأساسية) فقط لهذه المعلمات (عدد صحيح، قيمة حقيقية، قيمة منطقية، سلسلة، إلخ.).

المسار

عندما يشير تعبير إلى مصدر بيانات مصنف، يمكنك استخدام تعريف المسار لتحديد عنصر أساسي معينة من مصدر البيانات هذا. يتم استخدام حرف النقطة (.) لفصل العناصر الفردية في مصدر بيانات مصنف. على سبيل المثال، يحتوي نموذج بيانات التقارير الإلكترونية الحالي على مصدر البيانات InvoiceTransactions، الذي يقوم بإرجاع قائمة السجلات. تحتوي بنية السجل InvoiceTransactions على الحقلين AmountDebit وAmountCredit، اللذين يرجعان قيمًا رقمية. وبالتالي، يمكنك تصميم التعبير التالي لحساب المبلغ المفوتر: InvoiceTransactions.AmountDebit - InvoiceTransactions.AmountCredit

الدالات

يصف القسم التالي الدالات التي يمكنك استخدامها في تعبيرات التقارير الإلكترونية. ويمكن استخدام كافة مصادر بيانات سياق التعبير (نموذج بيانات التقارير الإلكترونية الحالي أو تنسيق التقارير الإلكترونية)، بالإضافة إلى الثوابت، كمحددات لدالات الاستدعاء وفقًا لقائمة وسيطات دالات الاستدعاء. على سبيل المثال، يحتوي نموذج بيانات التقارير الإلكترونية الحالي على مصدر البيانات InvoiceTransactions، الذي يقوم بإرجاع قائمة السجلات. تحتوي بنية السجل InvoiceTransactions على الحقلين AmountDebit وAmountCredit، اللذين يرجعان قيمًا رقمية. وبالتالي، لحساب المبلغ المفوتر، يمكنك تصميم التعبير التالي الذي يستخدم دالة التقريب المضمنة للتقارير الإلكترونية: ROUND (InvoiceTransactions.AmountDebit - InvoiceTransactions.AmountCredit, 2)

الدالات المدعومة

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

دلات التاريخ والوقت

الدالة الوصف مثال
ADDDAYS (التاريخ والوقت، الأيام) إضافة عدد محدد من الأيام إلى قيمة التاريخ والوقت المحددة. ADDDAYS (now ()، 7) ترجع التاريخ والوقت سبعة أيام في المستقبل.
DATETODATETIME (التاريخ) تحويل القيمة المحددة إلى قيمة تاريخ ووقت. DATETODATETIME (CompInfo. 'getCurrentDate()') ترجع تاريخ جلسة عمل Finance and Operations الحالية، 12/24/2015 على الشكل التالي، 12/24/2015 12:00:00 ص. في هذا المثال، CompInfo عبارة عن مصدر بيانات تقارير إلكترونية من النوع Finance and Operations/جدول يشير إلى جدول CompanyInfo.
NOW () تُرجع تاريخ ووقت خادم تطبيق Finance and Operations الحالي كقيمة تاريخ ووقت.
TODAY () تُرجع تاريخ خادم تطبيق Finance and Operations الحالي كقيمة تاريخ.
NULLDATE () إرجاع قيمة تاريخ فارغة.
NULLDATETIME () إرجاع قيمة وقت وتاريخ فارغة.
DATETIMEFORMAT (التاريخ والوقت، التنسيق) تحويل قيمة التاريخ والوقت المحددة إلى سلسلة بالتنسيق المحدد. (لمزيد من المعلومات حول التنسيقات المعتمدة، راجع قياسي ومخصص.) DATETIMEFORMAT (NOW(), "dd-MM-yyyy") ترجع المعادلة تاريخ خادم تطبيق Finance and Operations الحالي، وهو 12/24/2015، على الشكل التالي "24-12-2015"، وفقًا للتنسيق المخصص المحدد.
DATETIMEFORMAT (التاريخ والوقت، التنسيق، الثقافة) تحويل قيمة التاريخ والوقت المحددة إلى سلسلة بالتنسيق والثقافة المحددة. (لمزيد من المعلومات حول التنسيقات المعتمدة، راجع قياسي ومخصص). تُرجع المعادلة DATETIMEFORMAT (NOW(), "d", "de") تاريخ خادم تطبيق Finance and Operations الحالي، 12/24/2015، على الشكل "24.12.2015"، وفقًا للثقافة الألمانية المحددة.
SESSIONTODAY () تُرجع تاريخ جلسة عمل Dynamics 365 for Finance and Operations الحالية كقيمة تاريخ.
SESSIONNOW () تُرجع تاريخ ووقت جلسة عمل Dynamics 365 for Finance and Operations الحالية كقيمة تاريخ ووقت.
DATEFORMAT (التاريخ، التنسيق) إرجاع تمثيل سلسلة التاريخ باستخدام التنسيق المحدد. تُرجع المعادلة DATEFORMAT (SESSIONTODAY (), "dd-MM-yyyy") تاريخ جلسة Dynamics 365 for Finance and Operations الحالية، 12/24/2015، على الشكل “24-12-2015”، وفقًا للتنسيق المخصص المحدد.
DATEFORMAT (التاريخ، التنسيق، الثقافة) تحويل قيمة التاريخ المحددة إلى سلسلة بالتنسيق والثقافة المحددة. (لمزيد من المعلومات حول التنسيقات المعتمدة، راجع قياسي ومخصص). تُرجع المعادلة DATETIMEFORMAT (SESSIONNOW (), "d", "de") تاريخ جلسة Finance and Operations الحالية 12/24/2015 على الشكل “24.12.2015” وفقًا للثقافة الألمانية المحددة.
DAYOFYEAR (التاريخ) تُرجع تمثيل عدد صحيح لعدد الأيام من 1 يناير إلى التاريخ المحدد. تُرجع المعادلة DAYOFYEAR (DATEVALUE ("01-03-2016", "dd-MM-yyyy")) القيمة 61. تُرجع المعادلة DAYOFYEAR (DATEVALUE ("01-01-2016", "dd-MM-yyyy")) القيمة 1.

دالات تحويل البيانات

الوظيفة ‏‏الوصف مثال
DATETODATETIME (التاريخ) تحويل القيمة المحددة إلى قيمة تاريخ ووقت. DATETODATETIME (CompInfo. 'getCurrentDate()') ترجع تاريخ جلسة عمل Finance and Operations الحالية، 12/24/2015 على الشكل التالي، 12/24/2015 12:00:00 ص. في هذا المثال، CompInfo عبارة عن مصدر بيانات تقارير إلكترونية من النوع Finance and Operations/جدول‏‎ يشير إلى جدول CompanyInfo.
DATEVALUE (سلسلة، تنسيق) تُرجع تمثيل التاريخ لسلسلة باستخدام التنسيق المحدد. تُرجع المعادلة DATEVALUE ("21-Dec-2016", "dd-MMM-yyyy") التاريخ 12/21/2016 وفقًا للتنسيق المخصص المحدد وثقافة التطبيق الافتراضية EN-US.
DATEVALUE (سلسلة، تنسيق، ثقافة) تُرجع تمثيل التاريخ لسلسة باستخدام التنسيق والثقافة المحددين. تُرجع المعادلة DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", “IT”) التاريخ 01/21/2016 وفقًا للتنسيق والثقافة المخصصين المحددين. يتم طرح استثناء لاستدعاء هذه الدالة، DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", “EN-US”) يفيد بأنه لم يتم التعرف على سلسلة معينة كتاريخ صالح.
DATETIMEVALUE (سلسلة، تنسيق) تُرجع تمثيل التاريخ والوقت لسلسلة باستخدام تنسيق محدد. تُرجع المعادلة DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") الوقت 2:55:00 ص لتاريخ 21 ديسمبر 2016 وفقًا للتنسيق المخصص المحدد وثقافة التطبيق الافتراضية EN-US.
DATETIMEVALUE (سلسلة، تنسيق، ثقافة) تُرجع تمثيل التاريخ والوقت لسلسلة باستخدام التنسيق والثقافة المحددين. تُرجع المعادلة DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", “IT”) الوقت 2:55:00 ص لتاريخ 21 ديسمبر 2016 وفقًا للتنسيق والثقافة المخصصين والمحددين. يتم طرح استثناء لاستدعاء هذه الدالة، DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", “EN-US”) يفيد بأنه لم يتم التعرف على سلسلة معينة كتاريخ ووقت صالحين.

دالات القائمة

الوظيفة ‏‏الوصف مثال
SPLIT (إدخال، طول) تقسيم سلسلة الإدخال المحددة إلى سلاسل فرعية، لكل منها الطول المحدد. إرجاع النتيجة كقائمة جديدة. SPLIT ("abcd", 3) ترجع قائمة جديدة تتألف من سجلين لديهما الحقل STRING . يحتوي الحقل في السجل الأول على النص "abc"، ويحتوي الحقل في السجل الثاني على النص "d".
SPLITLIST (قائمة، رقم) تقسيم القائمة المحددة إلى دُفعات تحتوي كل واحدة منها على العدد المحدد من السجلات. إرجاع النتيجة كقائمة جديدة من الدُفعات التي تحتوي على العناصر التالية:
  • الدُفعات كقوائم منتظمة (المكون قيمة)
  • رقم الدُفعة الحالية (المكون BatchNumber)
في المثال التالي، يتم إنشاء مصدر البيانات Lines كقائمة سجلات من ثلاثة سجلات، وقد تم تقسيمه إلى دُفعات تحتوي كل واحدة منها على سجلين كحد أقصى. Data source that is divided into batches يُظهر هذا تخطيط التنسيق الذي تم تصميمه، حيث يتم إنشاء الروابط إلى مصدر البيانات Lines لتوليد إخراج بتنسيق XML يقدم العقد الفردية لكل دُفعة والسجلات فيها. Format layout that has bindings to a data source التالي هو نتيجة لتشغيل التنسيق الذي تم تصميمه. Result of running the format
LIST (سجل 1 [، سجل 2، ...]) إرجاع قائمة جديدة تم إنشاؤها من وسيطات محددة. LIST (model.MainData, model.OtherData) ترجع سجلاً فارغًا، حيث تحتوي قائمة الحقول على كل الحقول من قائمة سجلات MainData وOtherData.
LISTJOIN (قائمة 1، قائمة 2، ...) إرجاع قائمة مرتبطة تم إنشاؤها من قوائم وسيطات محددة. LISTJOIN (SPLIT ("abc", 1), SPLIT ("def", 1)) تُرجع قائمة السجلات الستة، حيث يحتوي حقل واحد من نوع البيانات STRING على أحرف فردية.
ISEMPTY (قائمة) إرجاع TRUE إذا لم تتضمن القائمة المحددة أية عناصر. وإلا، يتم إرجاع FALSE.
EMPTYLIST (قائمة) إرجاع قائمة فارغة باستخدام القائمة المحددة كمصدر لبنية القائمة. EMPTYLIST (SPLIT ("abc", 1)) تُرجع قائمة فارغة جديدة لها نفس بنية القائمة المرتجعة بواسطة الدالة SPLIT.
FIRST (قائمة) إرجاع السجل الأول من القائمة المحددة، إذا لم يكن هذا السجل فارغًا. وإلا، يتم طرح استثناء.
FIRSTORNULL (قائمة) إرجاع السجل الأول من القائمة المحددة، إذا لم يكن هذا السجل فارغًا. وإلا يتم إرجاع سجل فارغ.
LISTOFFIRSTITEM (قائمة) إرجاع قائمة تحتوي على العنصر الأول فقط من القائمة المحددة.
ALLITEMS (مسار) إرجاع قائمة مدمجة جديدة تمثل كل العناصر التي تطابق المسار المحدد. يجب تحديد المسار كمسار مصدر بيانات صالح إلى عنصر مصدر بيانات لنوع بيانات قائمة السجلات. المسار إلى السلسلة والتاريخ وغير ذلك. يجب أن ترفع عناصر البيانات رسالة خطأ في وقت التصميم في منشئ تعبير التقارير الإلكترونية. إذا أدخلت SPLIT("abcdef" , 2) كمصدر بيانات (DS)، فسترجع COUNT( ALLITEMS (DS.Value)) العدد 3.
ORDERBY (قائمة [, تعبير 1، تعبير 2، …]) إرجاع القائمة المحددة، التي يتم فرزها وفقًا للوسيطات المحددة التي يمكن تعريفها على أنها تعبيرات. عند تكوين Vendor كمصدر بيانات تقارير إلكترونية يشير إلى جدول VendTable، ترجع ORDERBY (Vendors, Vendors.'name()') قائمة مورّدين تم فرزها حسب الاسم بترتيب تصاعدي.
REVERSE (قائمة) إرجاع القائمة المحددة بترتيب فرز معكوس. عند تكوين Vendor كمصدر بيانات تقارير إلكترونية يشير إلى جدول VendTable، ترجع REVERSE (ORDERBY (Vendors, Vendors.'name()')) ) قائمة مورّدين تم فرزها حسب الاسم بترتيب تنازلي.
WHERE (قائمة، شرط) إرجاع القائمة المحددة التي تمت تصفيتها وفقًا للشرط المحدد. بخلاف الدالة FILTER، يتم تطبيق الشرط المحدد على القائمة في الذاكرة. عند تكوين Vendor كمصدر بيانات تقارير إلكترونية يشير إلى جدول VendTable ترجع (Vendors, Vendors.VendGroup = "40") قائمة المورّدين التي تنتمي إلى مجموعة الموردين 40.
ENUMERATE (قائمة) إرجاع قائمة جديدة تتكون من السجلات التي تم تعدادها للقائمة المحددة، والتي تعرض العناصر التالية:
  • سجلات قائمة محددة كقوائم عادية (المكونقيمة)
  • فهرس السجلات الحالية (المكون Number)
في المثال التالي، يتم إنشاء مصدر البيانات Enumerated كقائمة تم تعدادها لسجلات المورّدين من مصدر البيانات Vendors الذي يشير إلى الجدول VendTable. Enumerated data source هذا هو التنسيق، حيث يتم إنشاء روابط البيانات لتوليد إخراج بتنسيق XML يقدم مورّدين فرديين كعقد تم تعدادها. Format that has data bindings هذه هي نتيجة تشغيل التنسيق الذي تم تصميمه. Result of running the format
COUNT (قائمة) إرجاع عدد السجلات في القائمة المحددة، إذا لم تكن القائمة فارغة. وإلا، يتم إرجاع 0 (صفر) COUNT (SPLIT("abcd" , 3)) ترجع 2، لأن الدلة SPLIT تنشئ قائمة مكونة من سجلين.
LISTOFFIELDS (مسار) إرجاع قائمة سجلات تم إنشاؤها من وسيطة من أحد الأنواع التالية:
  • تعداد النموذج
  • تعداد التنسيق
  • الحاوية
تتكون القائمة التي تم إنشاؤها من الحقول التالية:
  • الاسم
  • التسمية
  • ‏‏الوصف
سيقوم حقل "التسمية" وحقل "الوصف" بإرجاع قيم في وقت التشغيل استنادًا إلى إعدادات لغة للتنسيق.
يوضح المثال التالي التعداد المقدم في نموذج بيانات. GER LISTOFFIELDS function - model enumeration يوضح المثال التالي:
  • إدراج تعداد النموذج في تقرير كمصدر بيانات.
  • تصميم تعبير التقرير الإلكتروني لاستخدام تعداد نموذج كمحددة لهذه الدالة.
  • إدراج مصدر بيانات نوع قائمة السجلات في تقرير باستخدام تعبير التقرير الإلكتروني المنشأ.
GER LISTOFFIELDS function - in format expression يوضح المثال التالي عناصر تنسيق التقارير الإلكترونية المرتبطة بمصدر البيانات من نوع قائمة السجلات الذي تم إنشاؤها باستخدام الدالة LISTOFFIELDS. GER LISTOFFIELDS function - format design هذه هي نتيجة تنفيذ التنسيق الذي تم تصميمه. GER LISTOFFIELDS function - format output ملاحظة: يتم تعبئة النص المترجم للتسميات والوصف في إخراج تنسيق التقارير الإلكترونية وفقًا لإعدادات اللغة التي تم تكوينها لعناصر تنسيق الملف والمجلد لأصل.
STRINGJOIN (قائمة، اسم الحقل، محدد) إرجاع سلسلة القيم المتصلة لحقل من قائمة مفصولة بمحدد محدد. إذا قمت بإدخال SPLIT(“abc” , 1) كمصدر بيانات DS، فإن STRINGJOIN (DS, DS.Value, “:”) للتعبير ترجع “a🅱️c”
SPLITLISTBYLIMIT (قائمة، قيمة الحد، مصدر الحد) تقسيم القائمة المعينة إلى قائمة جديدة من القوائم الفرعية وإرجاع النتيجة في محتوى قائمة السجلات. تعين محددة قيمة الحد قيمة الحد لتقسيم القائمة الأصل. وتعين محددة مصدر الحد الخطوة التي يزداد عندها المجموع إجمالي. لا يتم تطبيق الحد على صنف واحد من القائمة المعينة عندما يقوم مصدر الحد بتجاوز الحد المعرّف. يوضح المثال التالي نموذج تنسيق باستخدام مصادر البيانات. GER SPLITLISTBYLIMIT - formatGER SPLITLISTBYLIMIT - datasources فيما يلي تنفيذ تنسيق النتيجة الذي يمثل قائمة ثابتة بأصناف السلع. GER SPLITLISTBYLIMIT - output يبين المثال التالي التنسيق نفسه الذي تم ضبطه لتقديم قائمة أصناف السلع في دُفعات عندما يجب أن تتضمن دُفعة واحدة سلعًا مع وزن إجمالي يجب ألا يتجاوز الحد 9. GER SPLITLISTBYLIMIT - format 1GER SPLITLISTBYLIMIT - datasources 1 هذه هي نتيجة تنفيذ التنسيق الذي تم ضبطه. GER SPLITLISTBYLIMIT - output 1 ملاحظة: لا يتم تطبيق الحد على الصنف الأخير من القائمة الأصلية لأن القيمة (11) لمصدر الحد (الوزن) تتجاوز الحد المُعرف (9). استخدم الدالة WHERE أو التعبير ممكّن لعنصر التنسيق المناظر لتجاهل (تخطي) القوائم الفرعية أثناء إنشاء التقرير (عند الحاجة).
FILTER (قائمة، شرط) إرجاع القائمة المحددة وقد تمت تصفيتها للشرط المحدد عن طريق تعديل الاستعلام. بعكس الدالة WHERE، يتم تطبيق الشرط المحدد على مستوى قاعدة البيانات لأي من مصادر بيانات التقارير الإلكترونية لنوع السجلات "جدول". ترجع الدالة FILTER (Vendors, Vendors.VendGroup "40") قائمة تتضمن فقط الموردين الذين ينتمون إلى مجموعة الموردين "40" عند تكوين المورد كمصدر بيانات تقارير إلكترونية يشير إلى الجدول VendTable.

الوظائف المنطقية

الوظيفة ‏‏الوصف مثال
CASE (تعبير، الخيار 1، النتيجة1 [, الخيار 2، النتيجة 2] ... [النتيجة الافتراضية]) تقييم قيمة التعبير المحدد مقابل الخيارات البديلة المحددة. ويتم إرجاع نتيجة الخيار المساوية لقيمة التعبير. وإلا، سيتم إرجاع النتيجة الافتراضية التي تم إدخالها بشكل اختياري (المعلمة الأخيرة التي لا يسبقها أي خيار). CASE( DATETIMEFORMAT( NOW(), "MM"), "10", "WINTER", "11", "WINTER", "12", "WINTER", "") ترجع السلسلة "WINTER" عندما يقع تاريخ جلسة عمل Finance and Operations الحالية بين شهري أكتوبر وديسمبر. وإلا، تقوم بإرجاع سلسلة فارغة.
IF (شرط, القيمة 1، القيمة 2) إرجاع القيمة المحددة 1 عند تلبية الشرط المحدد. وإلا، يتم إرجاع القيمة 2. إذا كانت القيمة 1 والقيمة 2 عبارة عن سجلات أو قوائم سجلات، فستتضمن النتيجة فقط الحقول الموجودة في القائمتين. IF (1=2, "condition is met", "condition is not met") ترجع السلسلة "condition is not met".
NOT (شرط) إرجاع القيمة المنطقية المعكوسة للشرط المحدد. NOT (TRUE) ترجع FALSE.
AND (الشرط 1[، الشرط 2، ...]) إرجاع TRUE إذا كانت جميع الشروط المحددة صحيحة. وإلا، يتم إرجاع FALSE. AND (1=1, "a"="a") ترجع TRUE. AND (1=2, "a"="a") ترجع FALSE.
OR (الشرط 1[، الشرط 2، ...]) إرجاع FALSE إذا كانت جميع الشروط المحددة خاطئة. إرجاع TRUE إذا كان أي واحد من الشروط المحددة صحيحًا. OR (1=2, "a"="a") ترجع TRUE.

الدالات الحسابية

الدالة الوصف مثال
ABS (رقم) إرجاع القيمة المطلقة للرقم المحدد (الرقم بدون علامته). ABS (-1) ترجع 1.
POWER (رقم، أس) إرجاع نتيجة رفع الرقم الموجب المحدد إلى الأس المحدد. POWER (10, 2) ترجع 100.
NUMBERVALUE (سلسلة، فاصل عشري، فاصل مجموعة أرقام) تحويل السلسلة المحددة إلى رقم. يتم استخدام الرمز المحدد لفصل العدد الصحيح والأجزاء الكسرية لرقم عشري، ويتم أيضًا استخدام فاصل الآلاف المحدد. NUMBERVALUE("1 234,56", ",", " ") ترجع القيمة 1234.56.
VALUE (سلسلة) تحويل السلسلة المحددة إلى رقم. يتم اعتبار الفواصل وأحرف النقطة (.) فواصل العشرية، ويتم استخدام الواصلة البادئة (-) كعلامة سالب. يمكنك طرح استثناء في حال مصادفة أحرف غير رقمية أخرى في السلسلة المحددة. VALUE ("1 234,56") تقوم بطرح استثناء.
ROUND (رقم، منازل عشرية) إرجاع الرقم المحدد، الذي يتم تقريبه إلى عدد المنازل العشرية المحدد:
  • إذا كانت قيمة المنازل العشرية المحددة أكبر من 0 (صفر)، فيتم تقريب الرقم المحدد إلى عدد المنازل العشرية المحدد.
  • إذا كانت قيمة المنازل العشرية المحددة تساوي 0 (صفر)، فيتم تقريب الرقم المحدد إلى أقرب عدد صحيح.
  • إذا كانت قيمة المنازل العشرية المحددة أقل من 0 (صفر)، فيتم تقريب الرقم المحدد إلى يسار الفاصلة العشرية.
ROUND (1200.767, 2) تقرّب إلى منزلتين عشريتين وترجع 1200.77. ROUND (1200.767, -3) تقرّب إلى أقرب مضاعف من 1,000 وترجع 1000.
ROUNDDOWN (رقم، منازل عشرية) إرجاع الرقم المحدد، الذي يتم تقريبه لأسفل (نحو الصفر) إلى عدد المنازل العشرية المحدد. ملاحظة: تعمل هذه الدالة مثل الدالة ROUND، إلا أنها تقرّب دائمًا الرقم المحدد لأسفل. ROUNDDOWN (1200.767, 2) تقرّب لأسفل إلى منزلتين عشريتين وترجع 1200.76. ROUNDDOWN (1700.767, -3) تقرّب لأسفل إلى أقرب مضاعف من 1,000 وترجع 1000.
ROUNDUP (رقم، منازل عشرية) إرجاع الرقم المحدد، الذي يتم تقريبه لأعلى (بعيدًا عن الصفر) إلى عدد المنازل العشرية المحدد. ملاحظة: تعمل هذه الدالة مثل الدالة ROUND، إلا أنها تقرّب دائمًا الرقم المحدد لأعلى. ROUNDUP (1200.763, 2) تقرّب لأعلى إلى منزلتين عشريتين وترجع 1200.77. ROUNDUP (1200.767, -3) تقرّب لأعلى إلى أقرب مضاعف من 1,000 وترجع 2000.

دالات تحويل البيانات

الوظيفة ‏‏الوصف مثال
VALUE (سلسلة) تحويل السلسلة المحددة إلى رقم. يتم اعتبار الفواصل وأحرف النقطة (.) كفواصل عشرية، ويتم استخدام الواصلة البادئة (-) كعلامة سالب. في حال مصادفة أحرف غير رقمية أخرى في السلسلة المحددة، يحدث خطأ. VALUE ("1 234,56") تقوم بطرح استثناء.
NUMBERVALUE (سلسلة، فاصل عشري، فاصل مجموعة أرقام) تحويل السلسلة المحددة إلى رقم. يتم استخدام الرمز المحدد لفصل العدد الصحيح والأجزاء الكسرية لرقم عشري، ويتم أيضًا استخدام فاصل الآلاف المحدد. NUMBERVALUE("1 234,56", ",", " ") ترجع القيمة 1234.56.
INTVALUE (سلسلة) تُرجع تمثيل عدد صحيح لسلسلة. سيتم اقتطاع أي أجزاء عشرية متوفرة. تُرجع INTVALUE (“100.77”) القيمة 100.
INTVALUE (رقم) تُرجع تمثيل عدد صحيح لرقم. سيتم اقتطاع أي أجزاء عشرية متوفرة. تُرجع INTVALUE (-100.77) القيمة -100.
INT64VALUE (سلسلة) تُرجع تمثيل int64 لسلسلة. سيتم اقتطاع أي أجزاء عشرية متوفرة. تُرجع INT64VALUE (“22565422744”) القيمة 22565422744.
INT64VALUE (رقم) تُرجع تمثيل int64 لرقم. سيتم اقتطاع أي أجزاء عشرية متوفرة. تُرجع INT64VALUE (22565422744.00) القيمة 22565422744.

وظائف السجلات

الوظيفة ‏‏الوصف مثال
NULLCONTAINER (قائمة) إرجاع سجل فارغ له نفس بنية قائمة السجلات المحددة أو السجل المحدد. ملاحظة:هذه الدالة قديمة. استخدم الدالة EMPTYRECORD بدلاً منها. NULLCONTAINER (SPLIT ("abc", 1)) ترجع سجلاً فارغًا جديدًا له نفس بنية القائمة المرتجعة بواسطة الدالة SPLIT.
EMPTYRECORD (سجل) إرجاع سجل فارغ له نفس بنية قائمة السجلات المحددة أو السجل المحدد. ملاحظة: السجل الفارغ هو سجل تحتوي جميع الحقول فيه على قيمة فارغة (0 [صفر] للأرقام وسلسلة فارغة للسلاسل، وهكذا). EMPTYRECORD (SPLIT ("abc", 1)) ترجع سجلاً فارغًا جديدًا له نفس بنية القائمة المرتجعة بواسطة الدالة SPLIT.

الدالات النصية

الدالة الوصف مثال
UPPER (سلسلة) إرجاع السلسلة المحددة، والتي يتم تحويلها إلى أحرف كبيرة. UPPER("Sample") ترجع "SAMPLE".
LOWER (سلسلة) إرجاع السلسلة المحددة، والتي يتم تحويلها إلى أحرف صغيرة. LOWER ("Sample") ترجع "sample".
LEFT (سلسلة، عدد الأحرف) إرجاع عدد الأحرف المحدد من بداية السلسلة المحددة. LEFT ("Sample", 3) تُرجع "Sam".
RIGHT (سلسلة، عدد الأحرف) إرجاع عدد الأحرف المحدد من نهاية السلسلة المحددة. RIGHT ("Sample", 3) تُرجع "ple".
MID (سلسلة، موضع البدء، عدد الأحرف) إرجاع عدد الأحرف المحدد من بداية السلسلة المحددة وحتى الموضع المحدد. MID ("Sample", 2, 3) تُرجع "amp".
LEN (سلسلة) إرجاع عدد الأحرف في السلسلة المحددة. LEN ("Sample") تُرجع 6.
CHAR (رقم) إرجاع سلسلة الأحرف المشار إليها بواسطة رقم Unicode المحدد. CHAR (255) تُرجع "ÿ". ملاحظة: تتوقف السلسلة المرتجعة على الترميز المحدد في عنصر تنسيق الملف الأصلي. يمكن العثور على قائمة الترميزات المدعومة في الموضوع فئة الترميز.
CONCATENATE (سلسلة 1 [، سلسلة 2، …]) إرجاع كافة السلاسل النصية المحددة، المنضمة في سلسلة واحدة. CONCATENATE ("abc", "def") تُرجع "abcdef". ملاحظة: يرجع التعبير "abc" & "def" التعبير "abcdef"أيضًا.
TRANSLATE (سلسلة، نمط، استبدال) إرجاع السلسلة المحددة، حيث يتم استبدال كافة حالات تواجد الأحرف في سلسلة النمط المحددة بالأحرف في الموضع المقابل من السلسلة البديلة المحددة. TRANSLATE ("abcdef", "cd", "GH") تستبدل النمط "cd" بالسلسلة "GH" وترجع "abGHef".
REPLACE (سلسلة، نمط، استبدال، علامة تعبير عادي) عندما تكون علامة التعبير العادي المحدد ‎true، يتم إرجاع السلسلة المحددة التي يتم تعديلها عن طريق تطبيق التعبير العادي المحدد كوسيطة نمط لهذه الدالة. يتم استخدام هذا التعبير للبحث عن الأحرف التي يجب أن يتم استبدالها. تستخدم أحرف الوسيطة البديلة المحددة لاستبدال الأحرف التي يتم العثور عليها. عندما تكون علامة التعبير العادي المحدد false، تعمل هذه الدالة مثل الدالة TRANSLATE. REPLACE ("+1 923 456 4971", "[^0-9]", "", true) تطبق تعبيرًا عاديًا يقوم بإزالة كافة الرموز غير الرقمية، وترجع "19234564971". REPLACE ("abcdef", "cd", "GH", false) تستبدل النمط "cd" بالسلسلة "GH" وترجع "abGHef".
TEXT (إدخال) تُرجع الإدخال المحدد، الذي يتم تحويله إلى سلسلة نصية يتم تنسيقها وفقًا لإعدادات الخادم المحلية لمثيل Finance and Operations الحالي. بالنسبة إلى القيم من النوع الحقيقي، تتحدد سلسلة التحويل بمنزلتين عشريتين. إذا كانت إعدادات الخادم المحلية لمثيل Finance and Operations معرّفة على الشكل EN-US، تُرجع TEXT (NOW ()) تاريخ جلسة عمل Finance and Operations الحالية، 12/17/2015، على شكل سلسلة نصية "12/17/2015 07:59:23 ص". TEXT (1/3) ترجع "0.33".
FORMAT (السلسلة 1، السلسلة 2[، السلسلة 3، ...]) إرجاع السلسلة المحددة المنسقة باستبدال تواجد %N بالوسيطة n. الوسيطات عبارة عن سلاسل. إذا لم يتم توفير وسيطة لمعلمة، فسيتم إرجاع المعلمة على الشكل "%N" في السلسلة. بالنسبة إلى القيم من النوع الحقيقي، تتحدد سلسلة التحويل بمنزلتين عشريتين. في هذا المثال، يرجع مصدر البيانات PaymentModel قائمة سجلات العملاء عبر المكون Customer وقيمة بيانات المعالجة عبر الحقل ProcessingDate. PaymentModel data source في تنسيق التقارير الإلكترونية المصمم لإنشاء ملف إلكتروني لعملاء معينين، يتم تحديد PaymentModel كمصدر بيانات ويتحكم بسير العملية. يتم طرح استثناء للمستخدمين النهائيين عند إيقاف عميل محدد للتاريخ عندما تتم معالجة التقرير. باستطاعة المعادلة المصممة لنوع التحكم بالمعالجة هذا استخدام الموارد التالية:
  • التسمية SYS70894 لـ Finance and Operations، التي تتضمن النص التالي:
    • للغة الإنجليزية- الولايات المتحدة: "‏‫لا توجد عناصر لطباعتها‬"
    • للغة الألمانية: "Nichts zu drucken"
  • التسمية SYS18389 لـ Finance and Operations، التي تتضمن النص التالي:
    • للغة الإنجليزية- الولايات المتحدة: "العميل %1 موقوف لـ %2."
    • للغة الألمانية: "Debitor '%1' wird für %2 gesperrt."
هذه هي المعادلة التي يمكن تصميمها: FORMAT (CONCATENATE (@"SYS70894", ". ", @"SYS18389"), model.Customer.Name, DATETIMEFORMAT (model.ProcessingDate, "d")) إذا تمت معالجة تقرير للعميل Litware Retail في 17ديسمبر 2015، بالثقافة الإنجليزية EN-US وباللغةEN-US فإن هذه المعادلة سترجع النص التالي الذي يمكن تقديمه كرسالة استثناء للمستخدم النهائي: "‏‫لا توجد عناصر لطباعتها‬. Customer Litware Retail is stopped for 12/17/2015." إذا تمت معالجة التقرير نفسه للعميل Litware Retail customer بتاريخ 17 ديسمبر 2015، في الثقافة DE وباللغة DE فإن هذه المعادلة ترجع النص التالي الذي يستخدم تنسيق تاريخ آخر: "Nichts zu drucken. Debitor 'Litware Retail' wird für 17.12.2015 gesperrt." Note: يتم تطبيق بناء الجملة التالي في معادلات التقارير الإلكترونية للتسميات:
  • بالنسبة إلى التسميات من موارد Finance and Operations: @"X"، حيث X هو معرف التسمية في شجرة مكونات البرنامج (AOT)
  • بالنسبة إلى التسميات المقيمة في تكوينات التقارير الإلكترونية: @"GER_LABEL:X"، حيث X هو معرف التسمية في تكوين التقارير الإلكترونية
NUMBERFORMAT (رقم، تنسيق) إرجاع تمثيل السلسلة للرقم المحدد بالتنسيق المحدد. (لمزيد من المعلومات حول التنسيقات المعتمدة، راجع القياسي و المخصص.) يحدد السياق الذي تُشغل فيه الوظيفة الثقافة التي يتم استخدامها لتنسيق الأرقام. لثقافة EN-US، ترجع NUMBERFORMAT (0.45, "p") النتيجة "45.00 %". NUMBERFORMAT (10.45, "#") ترجع "10".
NUMERALSTOTEXT (رقم، لغة، عملة، طباعة علامة اسم العملة‬، منازل عشرية) إرجاع الرقم المكتوب (المحوّل) إلى سلاسل نصية باللغة المحددة. كود اللغة اختياري: عند تعريفه كسلسلة فارغة، سيتم استخدام كود اللغة السياقية (معرف لمجلد أو ملف منشأ) بدلاً منه. كود العملة اختياري. عندما يتم تعريفه كسلسلة فارغة، يتم أخذ عملة الشركة. لاحظ أنه يتم تحليل محددة طباعة اسم العملة ومحددة المنازل العشرية لأكواد اللغات التالية فقط: CS وET وHU وLT وLV وPL وRU. لاحظ أنه يتم تحليل محددة طباعة اسم العملة فقط لشركات Finance and Operations ذات سياق بلد يدعم صرف العملة. NUMERALSTOTEXT (1234.56, "EN", "", false, 2) ترجع “One Thousand Two Hundred Thirty Four and 56” NUMERALSTOTEXT (120, "PL", "", false, 0) ترجع “Sto dwadzieścia” NUMERALSTOTEXT (120.21, "RU", "EUR", true, 2) returns “Сто двадцать евро 21 евроцент”
PADLEFT (سلسلة، طول، أحرف التعبئة) إرجاع سلسلة بطول محدد تمت فيه تعبئة بداية السلسلة الحالية بأحرف محددة. تُرجع PADLEFT (“1234”, 10, “ “) السلسلة النصية “ 1234”
TRIM (سلسلة) تُرجع نصًا محددًا بعد اقتطاع المسافات السابقة واللاحقة وتزيل المسافات المتعددة بين الكلمات. تُرجع TRIM (" Sample text ") القيمة "نص نموذجي".
GETENUMVALUEBYNAME (مسار مصدر بيانات تعداد، نص تسمية قيمة تعداد) تُرجع قيمة مصدر بيانات تعداد محدد بالنص المحدد لتسمية التعداد هذه. يوضح المثال التالي التعداد ReportDirection المقدم في نموذج بيانات. لاحظ أنه يتم تحديد التسميات لقيم التعداد. تبين الأمثلة التالية:
  • إدراج تعداد النموذج ReportDirection في تقرير كمصدر بيانات $Direction
  • تصميم تعبير التقرير الإلكتروني $IsArrivals لاستخدام تعداد نموذج كمحددة لهذه الدالة. قيمة هذا التعبير هي TRUE

دالات تحويل البيانات

الوظيفة ‏‏الوصف مثال
TEXT (إدخال) تُرجع الإدخال المحدد، الذي يتم تحويله إلى سلسلة نصية يتم تنسيقها وفقًا لإعدادات الخادم المحلية لمثيل Finance and Operations الحالي.
بالنسبة إلى القيم من النوع الحقيقي، تتحدد سلسلة التحويل بمنزلتين عشريتين. إذا كانت إعدادات الخادم المحلية لمثيل Finance and Operations معرّفة على الشكل EN-US, TEXT (NOW ()), ، فسيتم إرجاع تاريخ جلسة Finance and Operations الحالية، 12/17/2015، كالسلسلة النصية "12/17/2015 07:59:23 ص".
تُرجع TEXT (1/3) القيمة "0.33".
QRCODE (سلسلة) إرجاع صورة الكود QR بالتنسيق الثنائي base64 لسلسلة محددة. تُرجع QRCODE (“نص نموذجي”) القيمة U2FtcGxlIHRleHQ=.

وظائف تجميع البيانات

الوظيفة ‏‏الوصف مثال
FORMATELEMENTNAME () إرجاع اسم
ر التنسيق الحالي. إرجاع سلسلة فارغة عندما تكون العلامة تجميع تفاصيل المخرجات‬ للملفات الحالية متوقفة عن التشغيل. يمكنك مراجعة دليل المهام التقارير الإلكترونية - استخدام بيانات مخرجات التنسيق لعمليات الجرد والتجميع (جزء من عملية الأعمال اكتساب/تطوير خدمة تكنولوجيا المعلومات/مكونات الحلول) لمزيد من المعلومات حول استخدام هذه الدالات.
SUMIFS (سلسلة مفاتيح للتجميع، سلسلة النطاق 1 للمعايير، سلسلة القيمة 1 للمعايير، [، سلسلة النطاق 2 للمعايير، سلسلة القيمة 2 للمعايير…]) إرجاع مجموع قيم عقد (بالاسم المحدد كمفتاح) XML، التي تم جمعها أثناء تنفيذ هذا التنسيق، والتي تفي بالشروط التي تم إدخالها (أزواج من نطاق وقيمة). إرجاع القيمة صفر عندما تكون العلامة تجميع تفاصيل المخرجاتللملفات الحالية متوقفة عن التشغيل.
SUMIF (سلسلة مفاتيح للتجميع، سلسلة نطاق المعايير، سلسلة قيم المعايير) إرجاع مجموع قيم عقد (بالاسم المحدد كمفتاح) XML، التي تم جمعها أثناء تنفيذ هذا التنسيق، والتي تفي بالشرط الذي تم إدخاله (نطاق وقيمة). إرجاع القيمة صفر عندما تكون العلامة تجميع تفاصيل المخرجات للملفات الحالية متوقفة عن التشغيل.
COUNTIFS (سلسلة النطاق 1 للمعايير، سلسلة القيمة 1 للمعايير [سلسلة النطاق 2 للمعايير، سلسلة القيمة 2 للمعايير, …]) إرجاع عدد عقد XML، التي تم جمعها أثناء تنفيذ هذا التنسيق، والتي تفي بالشروط التي تم إدخالها (أزواج من نطاق وقيمة). إرجاع القيمة صفر عندما تكون العلامة تجميع تفاصيل المخرجات للملفات الحالية متوقفة عن التشغيل.
COUNTIF (سلسلة نطاق المعايير، سلسل قيمة المعايير) إرجاع عدد عقد XML، التي تم جمعها أثناء تنفيذ هذا التنسيق، والتي تفي بالشرط الذي تم إدخاله (نطاق وقيمة). إرجاع القيمة صفر عندما تكون العلامة تجميع تفاصيل المخرجات للملفات الحالية متوقفة عن التشغيل.
COLLECTEDLIST (سلسلة النطاق 1 للمعايير، سلسلة القيمة 1 للمعايير [سلسلة النطاق 2 للمعايير، سلسلة القيمة 2 للمعايير …]) إرجاع قائمة بقيم عقد XML، التي تم جمعها أثناء تنفيذ هذا التنسيق، والتي تفي بالشروط التي تم إدخالها (نطاق وقيمة). إرجاع قائمة فارغة عندما تكون العلامة تجميع تفاصيل المخرجاتللملفات الحالية متوقفة عن التشغيل.

دالات أخرى (خاصة بمجال الأعمال)

الوظيفة ‏‏الوصف مثال
CONVERTCURRENCY (المبلغ، العملة المصدر، العملة الهدف، التاريخ، الشركة) تحويل المبلغ المالي المحدد من العملة المصدر إلى العملة الهدف باستخدام إعدادات شركة Finance and Operations المحددة بالتاريخ المحدد. CONVERTCURRENCY (1, "EUR", "USD", TODAY(), "DEMF") ترجع مكافئ اليورو الواحد بالدولار الأمريكي بتاريخ الجلسة الحالية، استنادًا إلى إعدادات شركة DEMF.
ROUNDAMOUNT (رقم، منازل عشرية، قاعدة التقريب) تقريب المبلغ المحدد وفقًا لقاعدة التقريب المحددة وعدد المنازل العشرية المحدد. ملاحظة: يجب تحديد قاعدة التقريب كقيمة Finance and Operations للتعداد RoundOffType. إذا تم تعيين المعلمة model.RoundOff إلى *Downwardفسترجع **ROUNDAMOUNT (1000.787, 2, model.RoundOff)* القيمة 1000.78. إذا تم تعيين المعلمة model.RoundOff إلى Normal أو Rounding-up، فسترجع ROUNDAMOUNT (1000.787, 2, model.RoundOff) القيمة 1000.79.
CURCredRef (خانات رقمية) إرجاع مرجع دائن، استنادًا إلى الخانات الرقمية في رقم الفاتورة المحددة. CURCredRef ("VEND-200002") ترجع "2200002".
MOD_97 (خانات رقمية) إرجاع مرجع دائن كتعبير MOD97، استنادًا إلى الخانات الرقمية في رقم الفاتورة المحددة. MOD_97 ("VEND-200002") ترجع "20000285".
ISOCredRef (خانات رقمية) إرجاع مرجع دائن ISO، استنادًا إلى الخانات الرقمية والرموز الأبجدية في رقم الفاتورة المحددة. ملاحظة:لإزالة الرموز من الحروف الأبجدية غير المتوافقة مع ISO، يجب ترجمة معلمة الإدخال قبل أن يتم تمريرها إلى هذه الدالة. ISOCredRef ("VEND-200002") ترجع "RF23VEND-200002".
CN_GBT_AdditionalDimensionID (سلسلة، رقم) الحصول على معرف البُعد المالي. يتم تمثيل الأبعاد في هذه السلسلة كمعرّفات مفصولة بفواصل. وتحدد الأرقام كود تسلسل الأبعاد المطلوب في هذه السلسلة. CN_GBT_AdditionalDimensionID ("AA,BB,CC,DD,EE,FF,GG,HH",3) ترجع “CC”
GetCurrentCompany () إرجاع التمثيل النصي لرمز أحد الكيانات القانونية (الشركة) الذي يقوم مستخدم بتسجيل الدخول فيه حاليًا. تُرجع GETCURRENTCOMPANY () القيمة USMF لمستخدم سجل دخوله إلى Contoso Entertainment System USA وهي شركة Finance and Operations.
CH_BANK_MOD_10 (خانات رقمية) إرجاع مرجع دائن كتعبير MOD10 استنادًا إلى الخانات الرقمية في رقم الفاتورة المحددة. CH_BANK_MOD_10 ("VEND-200002") ترجع 3
FA_SUM (كود الأصل الثابت، كود نموذج القيمة، تاريخ البدء، تاريخ الانتهاء) إرجاع حاوية البيانات المعدّة لمبالغ الأصل الثابت لفترة ما. FA_SUM ("COMP-000001", “الحالي”, التاريخ1, التاريخ2) يُرجع حاوية البيانات المعدّة للأصل الثابت "COMP-000001" مع طراز القيمة "الحالي" لفترة من التاريخ1 إلى التاريخ2.
FA_BALANCE (كود الأصل الثابت، كود نموذج القيمة، سنة إعداد التقرير، تاريخ إعداد التقرير) إرجاع حاوية البيانات المعدّة لأرصدة الأصل الثابت. يجب تحديد سنة إعداد التقرير كقيمة لتعداد Finance and Operations AssetYear. تُرجع FA_SUM ("COMP-000001", “Current”, AxEnumAssetYear.ThisYear, SESSIONTODAY ()) حاوية البيانات المعدّة من أرصدة الأصل الثابت "COMP-000001" مع نموذج القيمة "الحالي" على تاريخ جلسة عمل 365 for Finance and Operations الحالية.
TABLENAME2ID (سلسلة) إرجاع تمثيل عدد صحيح لـ "معرف الجدول" لـ "اسم جدول" محدد. تُرجع TABLENAME2ID (“Intrastat”) القيمة 1510.
ISVALIDCHARACTERISO7064 (سلسلة) تُرجع القيمة المنطقية TRUE عندما تمثل سلسلة معينة رقم حساب مصرفي دولي (IBAN)‬ صالحًا. وإلا فستُرجع القيمة المنطقية FALSE. تُرجع ISVALIDCHARACTERISO7064 ("AT61 1904 3002 3457 3201") القيمة TRUE. تُرجع ISVALIDCHARACTERISO7064 ("AT61") القيمة FALSE.

ملحق قائمة الدالات

تسمح لك التقارير الإلكترونية بتوسيع قائمة الدالات التي يتم استخدامها في تعبيرات التقارير الإلكترونية. ثمة حاجة إلى بعض الجهود الهندسية. للحصول على معلومات مفصلة، راجع توسيع قائمة دالات التقارير الإلكترونية.

راجع أيضًا

نظرة عامة حول التقارير الإلكترونية

توسيع قائمة دالات التقارير الإلكترونية