إضافة الصيغ والوظائف في InfoPath 2010
ينطبق على
تمكنك الصيغ من الحصول على المزيد من القواعد التي تقوم بإنشائها بدلا من استخدام القواعد الأساسية المعرفة مسبقا. على سبيل المثال، يتم استخدام الصيغ لأشياء مثل حساب التاريخ الحالي أو المستقبلي أو حتى تسلسل النص.
في هذه المقالة
نظرة عامة
الصيغة هي تعبير XPath (لغة مسار XML) يتكون من قيم وحقول أو مجموعات ووظائف وعوامل تشغيل تستخدم لحساب القيم الأخرى وعرضها. يمكنك استخدام صيغة لإنشاء قيمة جديدة لحقل وعرض هذه القيمة في عنصر تحكم مرتبط بهذا الحقل. يمكن استخدام الصيغ كما يلي:
حساب قيمة رياضية استنادا إلى القيم التي حددتها عند تصميم القالب أو استنادا إلى القيم التي يدخلها المستخدم عند ملء قالب النموذج.
قم بتشغيل قاعدة استنادا إلى قيمة يتم حسابها باستخدام صيغة.
عرض نص للقراءة فقط يتم حسابه من عناصر تحكم أخرى أو عرض قيمة عنصر تحكم آخر.
الدالة هي تعبير يرجع قيمة استنادا إلى نتائج عملية حسابية. تسمى القيم المستخدمة في الدالات الوسيطات. يمكنك استخدام دالات XPath 1.0 القياسية المضمنة في InfoPath، بالإضافة إلى بعض الدالات الخاصة ب InfoPath. تتكون الدالات من الأجزاء الثلاثة التالية:
- اسم عادة ما يوفر اسم الدالة تلميحا حول الإجراء الذي ستقوم الدالة بتنفيذه.
- القيمة المرجعة نتيجة الدالة.
- الحجج القيم المستخدمة من قبل الدالة لإجراء العملية الحسابية.
قد تتطلب الدالة وسيطات لإرجاع قيمة. إذا كانت الدالة تتطلب وسيطات، فستحتاج إلى معرفة عدد الوسيطات المطلوبة ونوع البيانات لكل وسيطة. لن تعمل الدالة إذا قمت بتوفير عدد أو نوع الوسيطات المطلوبة الخطأ.
يوضح الرسم التوضيحي التالي العلاقة بين الدالات والتعبيرات والصيغ.
إضافة عنصر تحكم قيمة محسوب
يمكنك استخدام عنصر تحكم قيمة محسوب لعرض نص للقراءة فقط، وعرض قيمة عنصر تحكم آخر في النموذج، وإنشاء صيغ تستند إلى تعبيرات XPath. على سبيل المثال، إذا كنت تقوم بتطوير قالب نموذج تعقب النفقات، يمكنك إضافة عنصر تحكم قيمة محسوب لعرض إجمالي المصروفات التي تم إدخالها.
ملاحظة
يعرض عنصر تحكم القيمة المحسوبة البيانات فقط ولا يخزنها، لذلك يجب عليك استخدام عنصر تحكم قيمة محسوب فقط إذا كنت لا تريد حفظ قيمته أو الرجوع إليها في صيغة أخرى.
على قالب النموذج، ضع المؤشر في المكان حيث تريد إدراج عنصر التحكم.
على علامة التبويب الصفحة الرئيسية ، في المجموعة عناصر التحكم ، انقر فوق عنصر تحكم القيمة المحسوب .
في مربع الحوار إدراج قيمة محسوبة ، قم بأحد الإجراءات التالية:
لكتابة نص أو تعبير XPath مباشرة في عنصر تحكم القيمة المحسوب، اكتب في مربع XPath .
لإدراج صيغة، انقر فوق تحرير الصيغة
، ثم أدخل الصيغة المطلوبة في مربع النص الصيغة ، مع الاستفادة مما يلي، حسب الضرورة:- لإدراج حقل أو مجموعة في الصيغة، انقر فوق إدراج حقل أو مجموعة، وانقر فوق الحقل أو المجموعة في مربع الحوار تحديد حقل أو مجموعة ، ثم انقر فوق موافق.
- لإدراج دالة في الصيغة، انقر فوق إدراج دالة، وحدد الدالة في مربع الحوار إدراج دالة ، ثم انقر فوق موافق.
إذا كانت الدالة تتطلب معلمات، فحدد الدالة في مربع الحوار إدراج دالة ، وانقر فوق موافق، ثم في نص الصيغة، انقر نقرا مزدوجا فوق المكان المشار إليه وحدد المعلمة المطلوبة قبل النقر فوق موافق. - لإدراج قيمة أو عامل تشغيل رياضي في الصيغة، اكتب القيمة أو الرمز للعملية الرياضية في المربع صيغة .
تتضمن عوامل التشغيل الرياضية إضافة (+) وطرح (-) والضرب (*) والقسمة (/).
تعتمد الصيغ الرياضية عادة على قيم عدد صحيح أو عشري كوسيطات. لتجنب القيم الفارغة في الصيغة، على علامة التبويب ملف ، انقر فوق خيارات النموذج ثم حدد خيارات متقدمة وتأكد من تحديد معاملة القيم الفارغة كصفر .
إضافة صيغة إلى عنصر تحكم
بينما يمكنك استخدام عنصر تحكم قيمة محسوب لعرض نتائج الصيغة، لا تقتصر على استخدام عنصر تحكم قيمة محسوب. يمكنك أيضا استخدام صيغة لتعيين القيمة الافتراضية لعناصر التحكم الأخرى، مثل مربعات النص. هناك طريقتان يمكنك من خلالهما تعيين القيمة الافتراضية لعنصر تحكم. يمكنك إما استخدام قيمة افتراضية ثابتة، بمجرد إدخال القيمة المطلوبة في حقل القيمة في مربع الحوار خصائص الحقل أو المجموعة ، أو يمكنك استخدام صيغة لتعيين القيمة الافتراضية لحقل استنادا إلى قيم أخرى في النموذج. قم بما يلي لتعيين القيمة الافتراضية لحقل استنادا إلى صيغة:
حدد عنصر التحكم الذي تريد إضافة الصيغة إليه بعد ذلك، ضمن أدوات التحكم، ضمن علامة التبويب خصائص ، في المجموعة خصائص ، انقر فوق القيمة الافتراضية.
انقر فوق إدراج الصيغة
بجوار مربع القيمة .أدخل الصيغة المطلوبة في مربع النص الصيغة ، مع الاستفادة مما يلي، حسب الضرورة:
لإدراج حقل أو مجموعة في الصيغة، انقر فوق إدراج حقل أو مجموعة، وانقر فوق الحقل أو المجموعة في مربع الحوار تحديد حقل أو مجموعة ، ثم انقر فوق موافق.
لإدراج دالة في الصيغة، انقر فوق إدراج دالة، وحدد الدالة في مربع الحوار إدراج دالة ، ثم انقر فوق موافق.
إذا كانت الدالة تتطلب معلمات، فحدد الدالة في مربع الحوار إدراج دالة ، وانقر فوق موافق، ثم في نص الصيغة، انقر نقرا مزدوجا فوق المكان المشار إليه وحدد المعلمة المطلوبة قبل النقر فوق موافق.لإدراج قيمة أو عامل تشغيل رياضي في الصيغة، اكتب القيمة أو الرمز للعملية الرياضية في مربع الصيغة .
تتضمن عوامل التشغيل الرياضية إضافة (+) وطرح (-) والضرب (*) والقسمة (/).تلميح
تعتمد الصيغ الرياضية عادة على قيم عدد صحيح أو عشري كوسيطات. لتجنب القيم الفارغة في الصيغة، على علامة التبويب ملف ، انقر فوق خيارات النموذج، ثم حدد خيارات متقدمة. تأكد من تحديد معاملة القيم الفارغة على أنها صفر .
لتحرير الصيغة كصيغة XPath، حدد خانة الاختيار تحرير XPath (متقدم)، والتي ستغير الصيغة إلى إصدار تعبير XPath للصيغة.
للتحقق من الصيغة للحصول على بناء الجملة الصحيح، انقر فوق الزر التحقق من الصيغة . إذا كانت الصيغة تحتوي على أخطاء:
انقر فوق إظهار التفاصيل في مربع الحوار Microsoft InfoPath للاطلاع على الأخطاء في الصيغة. فيما يلي بعض الاقتراحات لحل هذه الأخطاء:
- إذا كنت تستخدم دالة في الصيغة، فتحقق من أنك تستخدم الوسيطات الصحيحة للدالة. تتطلب بعض الدالات حقولا أو مجموعات بينما تتطلب الدالات الأخرى قيما محددة كوسيطات.
- إذا لزم الأمر، فاحذف الصيغة وأعد كتابتها للتأكد من كتابتها بشكل صحيح.
- انقر فوق موافق.
- إذا كنت تريد تحديث القيمة الافتراضية للحقل عند تغيير القيم التي يستند إليها، فحدد خانة الاختيار تحديث القيمة عند إعادة حساب الصيغة . إذا قمت بذلك، فانقر فوق موافق، وضمن أدوات التحكم، على علامة التبويب خصائص ، في المجموعة خصائص ، انقر فوق خصائص التحكم. انقر فوق علامة التبويب عرض ، ثم حدد خانة الاختيار للقراءة فقط .
استخدام صيغة في قاعدة
من الممكن، عند تحديد الشروط في قواعد التحقق من الصحة أو التنسيق أو الإجراء ، استخدام صيغة للتحكم في الشرط. يمكنك القيام بذلك عن طريق تحديد استخدام صيغة من القائمة المنسدلة الثالثة في مربع الحوار شرط عند تعيين قاعدة لعنصر تحكم أو قالب النموذج.
دالات التاريخ والوقت
أيام الإضافة
إضافة أيام إلى تاريخ أو تاريخ ووقت.
بناء الجملة
addDays(date, days)
| الوسيطة | الوصف |
|---|---|
| تاريخ | تتم إضافة عدد الأيام في الوسيطة الثانية إلى التاريخ في هذه الوسيطة. يمكن أن تكون هذه الوسيطة نوع بيانات التاريخ (التاريخ) أو التاريخ والوقت (التاريخ والوقت). |
| أيام | عدد الأيام التي تريد إضافتها إلى التاريخ في الوسيطة الأولى. يجب أن تكون هذه المعلمة نوع بيانات عدد صحيح (عدد صحيح). إذا كنت تستخدم رقما سالبا في هذه الوسيطة، فإن القيمة المرجعة هي تاريخ سابق. |
مثال
تريد أن يحتوي حقل في قالب النموذج على تاريخ 60 يوما من تاريخ اليوم. يحتوي قالب النموذج على حقل يسمى fldToday، مع تاريخ اليوم كقيمة افتراضية. لحساب التاريخ الجديد باستخدام هذه الدالة، استخدم الصيغة التالية في حقل التاريخ الجديد:
addDays(fldToday, 60)
addSeconds
إضافة ثوان إلى وقت أو تاريخ ووقت.
بناء الجملة
addSeconds(time, seconds)
| الوسيطة | الوصف |
|---|---|
| وقت | قيمة تاريخ ووقت أو قيمة وقت إما مرجع لحقل آخر في قالب النموذج أو نتيجة دالة تاريخ أو وقت، مثل now() أو Today(). تتم إضافة عدد الثوان في الوسيطة الثانية إلى الوقت في هذه الوسيطة. يمكن أن تكون هذه الوسيطة نوع بيانات التاريخ (التاريخ) أو التاريخ والوقت (التاريخ والوقت). إذا كان نوع بيانات الوقت، فسيتم إرجاع نوع بيانات الوقت. إذا كان نوع بيانات التاريخ، فسيتم إرجاع نوع بيانات التاريخ والوقت. |
| ثانيه | عدد الثوان التي تريد إضافتها إلى قيمة التاريخ والوقت أو قيمة الوقت في الوسيطة الأولى. يجب أن يكون الحقل في هذه المعلمة نوع بيانات عدد صحيح (عدد صحيح). إذا كنت تستخدم رقما سالبا في هذه الوسيطة، فإن القيمة المرجعة إما تاريخ ووقت سابقين أو وقت سابق. |
مثال
يحتوي قالب النموذج على حقل يسمى fldCurrentTime يستخدم الوقت الحالي كقيمة افتراضية وحقل ثان يستخدم الدالة addSeconds في صيغة لعرض الوقت 120 ثانية من الوقت الحالي. لحساب قيمة الوقت الجديدة باستخدام هذه الدالة، أدخل الصيغة التالية في الحقل الثاني:
addSeconds(fldCurrentTime, 120)
جمعيه البحث العلمي الهولنديه
إرجاع تاريخ النظام الحالي ووقته.
إذا كنت تريد إرجاع التاريخ الحالي فقط، فاستخدم الدالة اليوم.
بناء الجملة
الآن()
لا تستخدم هذه الدالة الوسيطات.
مثال
للحصول على التاريخ والوقت الذي تم فيه إنشاء نموذج يستند إلى قالب النموذج، استخدم الصيغة التالية في حقل:
الآن()
اليوم
إرجاع تاريخ النظام الحالي. بالنسبة لحقول تاريخ قائمة SharePoint، استخدم الدالة now().
إذا كنت تريد إرجاع كل من التاريخ والوقت، فاستخدم الدالة Now.
بناء الجملة
اليوم()
لا تستخدم هذه الدالة الوسيطات.
مثال
للحصول على التاريخ الذي تم فيه إنشاء نموذج يستند إلى قالب النموذج، استخدم الصيغة التالية في حقل:
اليوم()
دالات الحقل
العدد
حساب عدد مثيلات حقل أو مجموعة.
بناء الجملة
عدد (حقل)
| الوسيطة | الوصف |
|---|---|
| حقل | اسم الحقل المكرر أو المجموعة المكررة المراد حسابها في النموذج. |
مثال
تقوم بتصميم قالب نموذج يستخدم الموردون نماذجه للإبلاغ عن منتجاتهم ومخزونهم. يحتوي قالب النموذج على مجموعة متكررة تسمى grpProduct للمنتجات التي يتم إرسالها من قبل المورد. تحتوي كل مجموعة على معلومات حول المنتج ومستوى المخزون الخاص به. عندما يضيف المورد منتجا في نموذج يستند إلى قالب النموذج هذا، ينشئ InfoPath مثيلا جديدا للمجموعة المتكررة.
يحتوي قالب النموذج الخاص بك على حقل في مصدر البيانات يحتوي على عدد المنتجات التي يتم إرسالها من قبل المورد. لحساب عدد المنتجات المرسلة من قبل المورد تلقائيا، وهو عدد مثيلات المجموعة المتكررة grpProduct، استخدم الصيغة التالية في حقل عدد المنتجات:
count(grpProduct)
الماضي
إرجاع آخر تكرار لحقل أو مجموعة مكررة.
ملاحظة
إذا كنت تقوم بتصميم قالب نموذج متوافق مع المستعرض، فلن تظهر هذه الدالة في قائمة الوظائف في مربع الحوار إدراج دالة..
بناء الجملة
field_name[last()]
على الرغم من أن الدالة نفسها لا تحتوي على أي معلمات مطلوبة، يمكنك استخدام هذه الدالة كمسند لاسم حقل محدد.
مثال
تقوم بتصميم قالب نموذج سيقوم الموردون بتعبئته للإبلاغ عن جرد منتجاتهم. يحتوي قالب النموذج على اتصال بيانات بخدمة ويب تحتوي على طريقة تتحقق مما إذا كانت معلومات المنتج لجميع المنتجات من مورد قد اكتملت. تحتاج الطريقة إلى المنتج الأخير في قائمة المنتجات التي قدمها المورد.
يتم تخزين معلومات المنتج في حقول مختلفة من مجموعة مكررة تسمى grpProduct. عندما يضيف المورد منتجا إلى النموذج، يضيف InfoPath مجموعة متكررة جديدة تسمى grpProduct. إذا أبلغ المورد عن عدة منتجات، فسيحتوي مصدر بيانات النموذج على مثيلات متعددة لمجموعة grpProduct المتكررة.
للتأكد من إرسال المعلومات الصحيحة إلى خدمة ويب، يمكنك إضافة حقل يحتوي على معلومات حول المنتج الأخير في مجموعة المنتجات من المورد. لتكوين هذا الحقل لاسترداد المنتج الأخير تلقائيا، استخدم الصيغة التالية كقيمة افتراضية لحقل المنتج الأخير:
grpProduct[last()]
الاسم المحلي
إرجاع الاسم المحلي لحقل أو مجموعة.
ملاحظة
- إذا كانت الوسيطة عبارة عن حقل مكرر أو مجموعة مكررة، ترجع الدالة قيمة الحقل المكرر الأول أو المجموعة المكررة.
- عندما يقوم مستخدم بتعبئة نموذج مستعرض ويب، ترسل الصيغة التي تستخدم هذه الدالة بيانات النموذج إلى الخادم للحصول على القيمة المرجعة لهذه الدالة.
بناء الجملة
اسم محلي (حقل)
| الوسيطة | الوصف |
|---|---|
| حقل | اسم الحقل الذي تريد إرجاع سمة الاسم المحلي الخاص به. |
مثال
تقوم بتصميم قالب نموذج يستخدم لتطبيقات التصاريح. يحتوي قالب النموذج على اتصال بيانات بطريقة في خدمة ويب. يتطلب هذا الأسلوب قيمة سمة الاسم المحلي للحقل لرقم ترخيص المقاول. اسم حقل رقم الترخيص هو fldLicenseNumber.
لديك حقل يحتوي على قيمة سمة الاسم المحلي. لاسترداد قيمة سمة الاسم المحلي لحقل رقم الترخيص تلقائيا، استخدم الصيغة التالية كقيمة افتراضية للحقل الذي سيحتوي على قيمة سمة الاسم المحلي:
local-name(fldLicenseNumber)
اسم
إرجاع بادئة الاسم ومساحة الاسم لحقل أو مجموعة.
ملاحظة
- إذا كانت الوسيطة عبارة عن حقل مكرر أو مجموعة مكررة، ترجع الدالة اسم وبادئة الحقل المكرر الأول أو المجموعة المكررة في النموذج.
- عندما يقوم مستخدم بتعبئة نموذج استنادا إلى قالب نموذج ممكن للمستعرض، ترسل الصيغة التي تستخدم هذه الدالة بيانات النموذج إلى الخادم للحصول على القيمة المرجعة لهذه الدالة.
بناء الجملة
الاسم (الحقل)
| الوسيطة | الوصف |
|---|---|
| حقل | اسم الحقل الذي تريد إرجاع بادئة مساحة الاسم والاسم الذي تريد إرجاعه. |
مثال
تقوم بتصميم قالب نموذج يستخدم لتطبيقات التصاريح. يحتوي قالب النموذج على اتصال بيانات بطريقة في خدمة ويب. يتطلب هذا الأسلوب سمة اسم الحقل لرقم ترخيص المقاول. اسم حقل رقم الترخيص هو fldLicenseNumber.
لديك حقل يحتوي على قيمة سمة الاسم. لاسترداد قيمة سمة الاسم تلقائيا، استخدم الصيغة التالية كقيمة افتراضية للحقل:
name(fldLicenseNumber)
namespace-uri
إرجاع مساحة الاسم الكاملة لحقل أو مجموعة.
ملاحظة
- إذا كانت الوسيطة عبارة عن مجموعة من الحقول أو المجموعات، ترجع الدالة مساحة اسم الحقل أو المجموعة الأولى في النموذج.
- عندما يقوم مستخدم بتعبئة نموذج مستعرض ويب، ترسل الصيغة التي تستخدم هذه الدالة بيانات النموذج إلى الخادم للحصول على القيمة المرجعة لهذه الدالة.
بناء الجملة
namespace-uri(field)
| الوسيطة | الوصف |
|---|---|
| حقل | اسم الحقل الذي تريد استرداد عنوان URI لمساحة الاسم الخاص به. |
مثال
تقوم بتصميم قالب نموذج يستخدم لتطبيقات التصاريح. يرسل قالب النموذج البيانات إلى خدمة ويب. لمعالجة البيانات من نموذج استنادا إلى قالب النموذج الخاص بك، تتطلب خدمة ويب عنوان URI لمساحة الاسم من حقل عنصر معين في مصدر البيانات. الحقل في قالب النموذج الذي يحتوي على بيانات URI لمساحة الاسم يسمى fldComplete.
لديك حقل يحتوي على عنوان URI لمساحة الاسم لحقل العنصر. لاسترداد URI لمساحة الاسم تلقائيا، استخدم الصيغة التالية كقيمة افتراضية للحقل الذي سيحتوي على URI لمساحة الاسم:
namespace-uri(fldComplete)
موقف
إرجاع فهرس (أو موضع) حقل أو مجموعة فيما يتعلق بالحقول أو المجموعات الأخرى في نفس المجموعة الأصل.
ملاحظة
هذه الدالة غير متوفرة في قوالب نماذج مستعرض ويب.
بناء الجملة
position()
مثال
تقوم بتصميم قالب نموذج سيقوم الموردون بتعبئته للإبلاغ عن جرد منتجاتهم. يتم تخزين معلومات المنتج في حقول في مجموعة مكررة. ترتبط المجموعة المتكررة بجدول مكرر، والذي يسمح للمورد بإضافة معلومات منتج جديدة أو مراجعة معلومات المنتج الموجودة.
في العمود الأول من الجدول المتكرر، تريد عرض رقم الصف في مربع نص. لعرض رقم الصف تلقائيا عندما يضيف المورد منتجا جديدا إلى الجدول المتكرر، استخدم الصيغة التالية كقيمة افتراضية لمربع النص:
position()
دالات رياضية
عادة ما تتطلب الصيغ التي تحتوي على دالات رياضية وسيطات هي أعداد صحيحة أو قيم عشرية. للتأكد من أن الوسيطات عبارة عن قيم عدد صحيح أو عشري بدلا من القيم الخالية، انقر فوقخيارات> نموذج الملف>خيارات متقدمة، ثم تأكد من تحديد خانة الاختيار معالجة القيم الفارغة كقيم صفرية.
متوسط
حساب متوسط القيم الرقمية في حقل موجود في مجموعة مكررة.
ملاحظة
يجب أن يكون الحقل المتكرر نوع بيانات رقميا وأن يتم تضمينه في مجموعة.
بناء الجملة
متوسط (حقل)
| الوسيطة | الوصف |
|---|---|
| حقل | أسماء الحقل المكرر في المجموعة التي تريد حساب متوسط القيمة لها. |
مثال
تقوم بتصميم قالب نموذج يستخدم الموردون نماذجه للإبلاغ عن منتجاتهم ومخزوناتهم. يحتوي قالب النموذج على حقل مكرر يسمى fldPrice، وهو في مجموعة مكررة تحتوي على بيانات حول كل منتج يباعه المورد. ترتبط المجموعة بعنصر تحكم جدول مكرر.
لديك حقل في قالب النموذج يحتوي على متوسط سعر جميع المنتجات التي يباعها هذا المورد. لحساب متوسط السعر، استخدم الصيغة التالية في الحقل لمتوسط السعر:
avg(fldPrice)
منطقيه
إرجاع true إذا كان هناك حقل أو مجموعة موجودة. وإلا، قم بإرجاع false.
سيؤدي ذلك إلى إرجاع true حتى إذا تم حذف عنصر تحكم مقترن بالحقل، ولكن الحقل لا يزال موجودا.
بناء الجملة
منطقي (حقل)
| الوسيطة | الوصف |
|---|---|
| حقل | حقل مكرر أو مجموعة مكررة ليتم التحقق منها بواسطة هذه الدالة. |
مثال
تقوم بتصميم قالب نموذج سيستخدمه الموردون للإبلاغ عن جرد منتجاتهم. يتم تخزين معلومات المنتج في حقول مختلفة في مجموعة متكررة تسمى grpProduct. تحتوي كل مجموعة مكررة على حقول تحتوي على معلومات حول كل منتج. إذا كان المورد يوفر معلومات حول سبعة منتجات، فسيحتوي النموذج على سبع مجموعات متكررة.
ترتبط المجموعة المتكررة بعنصر تحكم جدول مكرر، والذي يمكن المورد من إضافة معلومات جديدة أو مراجعة معلومات المنتج الموجودة. يمكن للمورد إضافة صفوف أو حذفها من الجدول المتكرر.
تريد عرض مربع حوار إذا أزل المستخدم كافة الصفوف في الجدول المتكرر. يمكنك إضافة حقل إلى مصدر البيانات الذي يحتوي على الكلمة "صحيح" إذا كان عنصر تحكم الجدول المكرر يحتوي على صف واحد على الأقل والكلمة "خطأ" إذا لم يكن لعنصر تحكم الجدول المكرر أي صفوف.
يمكنك تكوين قاعدة في عنصر تحكم الجدول المتكرر لعرض مربع حوار إذا كانت القيمة الموجودة في الحقل خاطئة. لتحديد ما إذا كان الجدول المكرر يحتوي على صف واحد على الأقل، استخدم الصيغة التالية كقيمة افتراضية للحقل تحتوي على الكلمة "صواب" أو "خطأ":
منطقي (grpProduct)
السقف
تقريب رقم إلى أقرب عدد صحيح.
بناء الجملة
السقف (رقم)
| الوسيطة | الوصف |
|---|---|
| number | اسم الحقل، الذي يحتوي على قيمة رقمية. |
مثال
تقوم بتصميم قالب نموذج تقرير المصروفات لشركتك. يتم إرسال المصروفات إلى خدمة ويب تحتوي على معلمة تقبل أرقاما صحيحة فقط. يجب تقريب مبلغ المصروفات الذي تم إرساله إلى هذه المعلمة إلى قيمة العدد الصحيح الأعلى. يتم تخزين مبلغ المصروفات في حقل يسمى fldExpenseAmount، ويتم تخزين قيمة العدد الصحيح في حقل آخر. لحساب قيمة العدد الصحيح الأعلى، استخدم الصيغة التالية كقيمة افتراضية للحقل الآخر:
السقف (fldExpenseAmount)
إذا أنشأ مستخدم نموذجا استنادا إلى قالب النموذج وأدخل 145.87 في حقل fldExpenseAmount، ستكون القيمة في الحقل الذي يحتوي على الصيغة 146.
Eval
إرجاع قيم حقل أو مجموعة. تحدد الوسيطة الثانية التعبير المراد حسابه للحقل أو المجموعة. عادة ما تتداخل دالة التقييم داخل دالة تعمل على حقل أو مجموعة، مثل المجموع أو المتوسط.
بناء الجملة
eval(field, expression)
| الوسيطة | الوصف |
|---|---|
| حقل | اسم الحقل أو المجموعة التي سيتم تقييم قيمها بواسطة التعبير في الوسيطة الثانية. |
| تعبير | التعبير الذي سيتم تطبيقه على الوسيطة الأولى. يمكن أن يكون التعبير إما دالة XPath أو تعبيرا محاطا بعلامات اقتباس مزدوجة (" "). |
مثال
تقوم بتصميم قالب نموذج تقرير المصروفات لشركتك. يحتوي قالب النموذج على حقل يسمى fldTotal يحتوي على مبلغ مصروفات. الحقل fldTotal هو جزء من مجموعة متكررة تسمى grpExpenses. حقل آخر مرتبط بمربع نص يحتوي على مجموع جميع النفقات. لعرض مجموع جميع المصروفات أثناء إدخال المستخدم لمبلغ المصروفات، استخدم الصيغة التالية في حقل إجمالي المصروفات:
eval(grpExpenses,sum(fldTotal))
خطأ
إرجاع خطأ.
بناء الجملة
false()
لا تستخدم هذه الدالة الوسيطات.
مثال
تقوم بتصميم قالب نموذج يستخدم المتعاقدون نماذجه لتقديم طلبات للحصول على تصاريح البناء. يحتوي قالب النموذج على قسمين: قسم واحد لمعلومات جهة الاتصال وقسم آخر للمعلومات المتعلقة بتصريح البناء. عند ملء هذا النموذج، سيحتاج المقاولون إلى ملء قسم معلومات الاتصال بالكامل قبل أن يتمكنوا من ملء قسم تصريح البناء.
لإنجاز ذلك، يمكنك إنشاء قاعدة لتعيين قيمة حقل منطقي إلى خطأ إذا كان أي من الحقول في قسم معلومات جهة الاتصال فارغا. يمكن أن يحتوي حقل القيمة المنطقية على قيمة منطقية صحيحة أو قيمة منطقية خاطئة. يمكنك أيضا تكوين التنسيق الشرطي لإخفاء عنصر تحكم المقطع الذي يحتوي على معلومات تصريح البناء إذا كانت قيمة الحقل المنطقي خاطئة.
لإخفاء عنصر تحكم المقطع الذي يحتوي على حقول معلومات تصريح البناء، قم بتكوين قاعدة لتشغيل هذه الدالة في الحقل المنطقي إذا كان أي من الحقول في قسم معلومات جهة الاتصال فارغا.
الكلمه
تقريب رقم إلى أقرب عدد صحيح أصغر منه.
بناء الجملة
الطابق (رقم)
| الوسيطة | الوصف |
|---|---|
| number | اسم الحقل، الذي يحتوي على قيمة رقمية. |
مثال
تقوم بتصميم قالب نموذج تقرير المصروفات لشركتك. يتم إرسال المصروفات إلى خدمة ويب تستخدم معلمة تقبل أرقاما صحيحة فقط. يجب تقريب مبلغ المصروفات المرسل إلى هذه المعلمة إلى قيمة العدد الصحيح الأدنى. يتم تخزين مبلغ المصروفات في حقل يسمى fldExpenseAmount، ويتم تخزين قيمة العدد الصحيح في حقل آخر. لحساب قيمة العدد الصحيح الأدنى، استخدم الصيغة التالية كقيمة افتراضية للحقل الآخر:
floor(fldExpenseAmount)
ماكس
إرجاع أكبر رقم في حقل أو مجموعة.
بناء الجملة
الحد الأقصى (الحقل)
| الوسيطة | الوصف |
|---|---|
| حقل | حقل مكرر في مجموعة أو حقل في مجموعة مكررة تريد العثور على أعلى قيمة لها. |
مثال
تقوم بتصميم قالب نموذج يستخدم الموردون نماذجه للإبلاغ عن قوائم جرد المنتجات الخاصة بهم. يحتوي قالب النموذج على مجموعة متكررة تتضمن العديد من الحقول التي تحتوي على بيانات حول منتجات الموردين. يحتوي حقل يسمى fldPrice في المجموعة المتكررة على سعر المنتج.
سيحتوي حقل آخر في مصدر البيانات لقالب النموذج على أعلى سعر لجميع المنتجات التي يباعها هذا المورد. لإرجاع أعلى سعر، استخدم الصيغة التالية في حقل السعر الأعلى:
max(fldPrice)
دقيقه
إرجاع أصغر رقم في حقل أو مجموعة.
بناء الجملة
الحد الأدنى (الحقل)
| الوسيطة | الوصف |
|---|---|
| حقل | حقل مكرر في مجموعة أو حقل في مجموعة مكررة تريد العثور على أعلى قيمة لها. |
مثال
تقوم بتصميم قالب نموذج يستخدم الموردون نماذجه للإبلاغ عن قوائم جرد المنتجات الخاصة بهم. يحتوي قالب النموذج على مجموعة متكررة تتضمن العديد من الحقول التي تحتوي على بيانات حول منتجات الموردين. يحتوي حقل يسمى fldPrice في المجموعة المتكررة على سعر المنتج.
سيحتوي حقل آخر في مصدر البيانات لقالب النموذج على أقل سعر لجميع المنتجات التي يباعها هذا المورد. لإرجاع أقل سعر، استخدم الصيغة التالية في حقل أقل سعر:
min(fldPrice)
ليس
إرجاع true إذا كانت القيمة المنطقية خاطئة أو خالية. إرجاع خطأ إذا كانت القيمة المنطقية صحيحة أو غير خالية.
بناء الجملة
لا (boolean_value)
| الوسيطة | الوصف |
|---|---|
| boolean_value | حقل بنوع بيانات منطقي. |
مثال
تقوم بتصميم قالب نموذج يستخدم المتعاقدون نماذجه لتقديم طلبات للحصول على تصاريح البناء. يحتوي قالب النموذج على قسم واحد لمعلومات جهة الاتصال وقسم آخر للحصول على معلومات تتعلق بتصريح البناء. عند ملء هذا النموذج، سيحتاج المقاولون إلى ملء قسم معلومات الاتصال بالكامل قبل أن يتمكنوا من ملء قسم تصريح البناء.
لإنجاز ذلك، يمكنك إنشاء قاعدة تعين قيمة حقل منطقي إلى خطأ إذا ترك أي من الحقول في قسم معلومات جهة الاتصال فارغا. يمكن أن يحتوي حقل القيمة المنطقية على القيمة المنطقية true أو القيمة المنطقية false. يمكنك بعد ذلك استخدام نفس الصيغة لإخفاء عنصر تحكم المقطع الذي يحتوي على معلومات تصريح الإنشاء إذا كانت قيمة الحقل المنطقي خاطئة. لتعيين هذه القاعدة، يمكنك استخدام الصيغة التالية لتعيين الحقل المنطقي إلى خطأ:
not(true())
number
تحويل قيمة إلى رقم.
ترجع الدالة NaN إذا تعذر تحويل القيمة الموجودة في الوسيطة إلى رقم.
بناء الجملة
number(value)
وصف الوسيطة
valueThe field with a value to convert to a number.
مثال
تقوم بتصميم قالب نموذج يستخدم المتعاقدون نماذجه لتقديم طلبات للحصول على تصاريح البناء. يحتوي قالب النموذج على قسم حيث يمكن للمقاول إدخال عنوان عمله. للتحقق من أن المقاول يدخل عنوانا صالحا، يمكنك استخدام اتصال بيانات بخدمة ويب يمكنها التحقق من العنوان. إذا تم التحقق من العنوان، يمكن للمقاول إرسال النموذج إلى قاعدة بيانات SQL. تستخدم قاعدة بيانات SQL حقلا نصيا لكل من رقم العنوان واسم الشارع. تتطلب خدمة ويب أن يكون رقم العنوان نوع بيانات رقميا وأن يكون اسم الشارع نوع بيانات نصيا.
لإرسال البيانات إلى كل من خدمة الويب وقاعدة بيانات SQL، يجب تخزين العنوان كنوعين مختلفين من البيانات:
- لإرسال العنوان إلى خدمة ويب، يجب أن يكون رقم العنوان نوع بيانات رقميا ويجب أن يكون اسم الشارع نوع بيانات نصي.
- لإرسال العنوان إلى قاعدة بيانات SQL، يجب أن يكون كل من رقم العنوان واسم الشارع نوع بيانات نصي.
تريد أيضا أن يدخل المقاول عنوانه مرة واحدة فقط. لتحويل العنوان إلى أنواع البيانات الصحيحة والمساعدة في التأكد من أن المقاول يدخل عنوانه مرة واحدة فقط، يحتوي قالب النموذج على حقل يسمى fldAddressNumber لإدخال رقم العنوان وحقل آخر لإدخال اسم الشارع. يتم تكوين كلا الحقلين كنوع من البيانات النصية.
لإرسال رقم العنوان إلى خدمة ويب، تحتاج إلى تحويل البيانات في الحقل fldAddressNumber (المخزن كنوع بيانات نصي) إلى نوع بيانات رقمي. يتم تخزين قيمة رقم العنوان الذي تم تحويله إلى نوع بيانات رقمي في حقل آخر تم تكوينه لتخزين أنواع البيانات الرقمية.
لتحويل رقم العنوان من نوع بيانات نصية إلى نوع بيانات رقمي، استخدم الصيغة التالية كقيمة افتراضية لحقل fldAddressNumber:
number(fldAddressNumber)
nz
إرجاع حقل أو مجموعة مع استبدال كافة الحقول الفارغة ب صفر (0).
بناء الجملة
nz (حقل)
| الوسيطة | الوصف |
|---|---|
| حقل | الحقل الذي تريد التحقق من وجود قيمة له. |
مثال
تقوم بتصميم قالب نموذج سيقوم الموردون بتعبئته للإبلاغ عن جرد منتجاتهم. سيرسل المورد جرد منتجاته إلى خدمة ويب من خلال نموذج يستند إلى قالب النموذج الخاص بك. يتطلب أسلوب خدمة الويب أن يكون لجميع العناصر التي تحتوي على بيانات رقمية قيمة رقمية. ترفض خدمة ويب نموذجا يحتوي على عنصر رقمي فارغ.
يحتوي قالب النموذج الخاص بك على حقل يسمى fldAvailability يحتوي على رقم يتوافق مع قدرة المورد على توفير هذا المنتج. يمكن للمورد إدخال رقم في هذا الحقل. للمساعدة في التأكد من أن المورد يمكنه إرسال نموذجه استنادا إلى قالب النموذج الخاص بك إلى خدمة ويب، وتعيين قيمة الحقل تلقائيا إلى صفر إذا لم يدخل المورد رقما، استخدم الصيغة التالية كقيمة افتراضية لهذا الحقل:
nz(fldAvailability)
جوله
تقريب رقم إلى أقرب عدد صحيح.
إذا كانت القيمة غير الصحيحة في منتصف الطريق بالضبط بين قيمتي عدد صحيح مستديرتين، فإن القيمة المرجعة هي أكبر قيمة عدد صحيح تالية.
بناء الجملة
round(number)
| الوسيطة | الوصف |
|---|---|
| number | الحقل الذي يحتوي على الرقم الذي سيتم تقريبه باستخدام هذه الصيغة. |
مثال
تقوم بتصميم قالب نموذج يستخدم الموردون نماذجه للإبلاغ عن قوائم جرد المنتجات الخاصة بهم. يحتوي قالب النموذج على مجموعة متكررة تتضمن عدة حقول تحتوي على بيانات حول منتجات الموردين. يحتوي أحد الحقول، المسمى fldPrice، في المجموعة المتكررة على سعر المنتج.
يحتوي قالب النموذج على اتصال بيانات إرسال إلى خدمة ويب. يتطلب أسلوب خدمة الويب تقريب كل سعر إلى قيمة عدد صحيح. لإرسال القيمة المناسبة إلى أسلوب خدمة ويب، يمكنك إضافة حقل مكرر إلى مصدر البيانات. يستخدم هذا الحقل الصيغة التالية لتقريب السعر في حقل fldPrice إلى قيمة عدد صحيح:
round(fldPrice)
مجموع
إرجاع مجموع كافة الحقول في حقل أو مجموعة. يتم تحويل كل حقل أولا إلى قيمة رقمية.
بناء الجملة
sum(field)
| الوسيطة | الوصف |
|---|---|
| حقل | اسم حقل في مجموعة مكررة أو حقل مكرر في مجموعة ستتم إضافة قيمها. لإضافة حقول من مجموعتين مختلفتين، استخدم عامل التشغيل الموحد (|) لفصل الوسيطات. على سبيل المثال: sum( اسم الحقل 1 | اسم الحقل 2). |
مثال
تقوم بتصميم قالب نموذج تقرير المصروفات. يحتوي قالب النموذج على مجموعة تحتوي على عناصر المصروفات. يتم تخزين مقدار كل عنصر في حقل يسمى fldExpenseAmount. ترتبط المجموعة بجدول مكرر يعرض كل عنصر مصروفات كصف. يحتوي قالب النموذج على عنصر تحكم مربع نص يعرض إجمالي النفقات. لإظهار إجمالي المصروفات، يحتوي عنصر تحكم مربع النص على الصيغة التالية:
sum(fldExpenseAmount)
true
إرجاع صحيح.
بناء الجملة
true()
لا تستخدم هذه الدالة الوسيطات.
مثال
تقوم بتصميم قالب نموذج يستخدم المتعاقدون نماذجه لتقديم طلبات للحصول على تصاريح البناء. يحتوي قالب النموذج على قسم واحد لمعلومات جهة الاتصال وقسم آخر للحصول على معلومات تتعلق بتصريح البناء. عند ملء هذا النموذج، سيحتاج المقاولون إلى ملء قسم معلومات الاتصال بالكامل قبل أن يتمكنوا من ملء قسم تصريح البناء.
لإنجاز ذلك، يمكنك إنشاء قاعدة تعين قيمة حقل منطقي إلى true إذا كانت جميع الحقول في قسم معلومات جهة الاتصال تحتوي على بيانات. يمكن أن يحتوي حقل القيمة المنطقية على القيمة المنطقية true أو false. إذا كانت قيمة الحقل المنطقي صحيحة، يتم عرض عنصر تحكم القسم الذي يحتوي على معلومات تصريح البناء.
لإظهار عنصر تحكم المقطع الذي يحتوي على معلومات تصريح الإنشاء، يمكنك تكوين قاعدة لتشغيل هذه الدالة في الحقل المنطقي إذا كانت جميع الحقول في قسم معلومات جهة الاتصال تحتوي على بيانات.
دالات نصية
Concat
يجمع بين حقلين أو أكثر من السلاسل النصية في سلسلة نصية واحدة.
بناء الجملة
concat(text1, text2, ...)
| الوسيطة | الوصف |
|---|---|
| text1 | حقل يحتوي على نص ليتم دمجه في سطر واحد من النص مع النص في الوسيطة 2. |
| text2, ... | أو أكثر من الحقول الإضافية التي تحتوي على نص ليتم دمجه مع الحقل السابق. فصل الحقول النصية بفاوصلة. |
مثال
تقوم بتصميم قالب نموذج يحتوي على حقل يسمى fldFirstName وحقل يسمى fldLastName. أضف الصيغة التالية إلى حقل ثالث لتتسبب في احتوائه على النص "تم ملء هذا النموذج باسم <العائلة> الأول><.":
concat("تم تعبئة هذا النموذج بواسطة ", fldFirstName, " ", fldLastName, ".")
ملاحظة
يجب إدراج أي نص فعلي تم إدخاله كوسيطة نصية، بما في ذلك المسافات أو علامات الترقيم، في علامات الاقتباس (").
يحتوي
إرجاع true إذا كان الحقل الأول أو السلسلة النصية الأولى تحتوي على الثاني. وإلا، قم بإرجاع false.
بناء الجملة
يحتوي على (within_text، find_text)
| الوسيطة | الوصف |
|---|---|
| within_text | الحقل الذي يحتوي على النص المطلوب البحث فيه. |
| find_text | الحقل الذي يحتوي على النص أو النص المضمن في علامات اقتباس مزدوجة (" ") للبحث عنه في الوسيطة الأولى. |
مثال
تقوم بتصميم قالب نموذج بثلاثة حقول نصية. سيسمح الأول للمستخدم بإدخال كمية طويلة من النص في عنصر تحكم النص الأول، المسمى fldText. سيسمح الثاني للمستخدم بإدخال مقطع قصير من النص ويسمى fldFindText. سيقارن مربع النص الثالث مربع النص الثاني بالمربع الأول ويشير إلى ما إذا كانت القيمة الموجودة في الحقل الثاني موجودة في الحقل الأول وتعرض النتيجة. سيكون لها الصيغة التالية كقيمة افتراضية:
contains(fldText,fldFindText)
تسوية المساحة
إزالة المسافة البيضاء من سلسلة نصية.
ملاحظة
سيؤدي ذلك إلى إزالة أي مسافات فارغة بادئة ولاحقة ومكررة من حقل بنوع بيانات نصي.
بناء الجملة
تسوية المسافة (نص)
| الوسيطة | الوصف |
|---|---|
| النص | النص الذي يحتوي على المسافات الفارغة البادئة أو اللاحقة أو المتكررة التي تريد إزالتها. قم بإحاطة النص بعلامات اقتباس مزدوجة (" "). |
مثال
يمكنك تصميم قالب نموذج يحتوي على حقل يسمى fldText (مرتبط بعنصر تحكم مربع نص). لتطبيع أي نص تم إدخاله في الحقل الأول، وعرض القيمة الموجودة في الحقل الأول دون أي مسافة بيضاء زائدة، أضف حقلا ثانيا مع الصيغة التالية كقيمة افتراضية:
normalize-space(fldText)
يبدأ ب
إرجاع true إذا كان الحقل الأول أو السلسلة النصية الأولى تبدأ بالثانية. وإلا، فإنه يرجع false.
بناء الجملة
يبدأ ب(نص، start_text)
| الوسيطة | الوصف |
|---|---|
| النص | اسم الحقل الذي يحتوي على النص المطلوب البحث فيه. فصل الوسيطات بفاوصلة. |
| start_text | النص المطلوب البحث فيه في بداية الحقل المحدد في الوسيطة الأولى. يمكن أن تكون هذه الوسيطة إما حقلا أو نصا محاطا بعلامات اقتباس مزدوجة (" "). |
مثال
تقوم بتصميم قالب نموذج بثلاثة حقول نصية. سيسمح الأول للمستخدم بإدخال كمية طويلة من النص في عنصر تحكم النص الأول، المسمى fldText. سيسمح الثاني للمستخدم بإدخال مقطع قصير من النص ويسمى fldFindText. سيقارن مربع النص الثالث مربع النص الثاني بالأول ويشير إلى ما إذا كانت القيمة في الحقل الأول تبدأ بالقيمة في الحقل الثاني وتعرض النتيجة. سيكون لها الصيغة التالية كقيمة افتراضية:
يبدأ ب(fldText, fldFindText)
سلسلة
تحويل قيمة إلى سلسلة نصية.
بناء الجملة
سلسلة (قيمة)
| الوسيطة | الوصف |
|---|---|
| القيمة | الحقل الذي يحتوي على القيمة المراد تحويلها إلى نص. |
مثال
تقوم بتصميم قالب نموذج يستخدم المتعاقدون نماذجه لتقديم طلبات للحصول على تصاريح البناء. يحتوي قالب النموذج على قسم يمكن للمقاول إدخال عنوان عمله فيه. للتحقق من أن المقاول يدخل عنوانا صالحا، يحتوي قالب النموذج على اتصال بيانات بخدمة ويب يمكنها التحقق من العنوان. إذا تم التحقق من العنوان، يمكن للمقاول إرسال النموذج إلى قاعدة بيانات SQL. تستخدم قاعدة بيانات SQL حقل نص لعنوان الشارع. تتطلب خدمة ويب أن يكون رقم العنوان نوع بيانات رقميا وأن يكون اسم الشارع نوع بيانات نصيا.
لإرسال البيانات إلى كل من خدمة الويب وقاعدة بيانات SQL، يجب تخزين العنوان في نوعين مختلفين من البيانات:
- لإرسال العنوان إلى خدمة ويب، يجب أن يكون رقم العنوان نوع بيانات رقميا.
- لإرسال العنوان إلى قاعدة بيانات SQL، يجب أن يكون كل من رقم العنوان واسم الشارع نوع بيانات نصي.
تريد أيضا أن يدخل المقاول عنوانه مرة واحدة فقط. لتحويل العنوان إلى أنواع البيانات الصحيحة والمساعدة في التأكد من أن المقاول يدخل عنوانه مرة واحدة فقط، يحتوي النموذج على حقل لإدخال رقم العنوان المسمى fldAddressNumber وحقل آخر لإدخال اسم الشارع. الحقل fldAddressNumber هو نوع بيانات رقمي وحقل اسم الشارع هو نوع بيانات نصي.
لإرسال العنوان الكامل (كل من رقم العنوان واسم الشارع) إلى قاعدة بيانات SQL، تحتاج إلى دمج القيم في الحقل fldAddressNumber وحقل اسم الشارع في قيمة واحدة هي نوع بيانات نصية. تحتاج أولا إلى تحويل البيانات الرقمية في الحقل fldAddressNumber، الذي يخزن البيانات كنوع بيانات رقمي، إلى نوع بيانات نصي. يمكنك إضافة حقل إلى مصدر البيانات الذي سيحتوي على العنوان الكامل كنوع بيانات نصي.
لتحويل البيانات النصية في الحقل fldAddressNumber إلى نوع بيانات نصي بحيث يمكنك استخدام خدمة ويب، يمكنك تكوين حقل آخر يحتوي على رقم العنوان كنوع بيانات نصي. لتحويل رقم العنوان من نوع بيانات رقمي إلى نوع بيانات نصي، استخدم الصيغة التالية كقيمة افتراضية لهذا الحقل:
string(fldAddressNumber)
طول السلسلة
إرجاع عدد الأحرف في سلسلة نصية.
بناء الجملة
طول السلسلة (نص)
| الوسيطة | الوصف |
|---|---|
| النص | الحقل الذي تكون قيمته هي النص الذي تريد حسابه. |
مثال
تقوم بتصميم قالب نموذج يحتوي على حقل يسمى fldText، مرتبط بعنصر تحكم مربع نص. يتضمن قالب النموذج حقلا ثانيا يستخدم لحساب عدد الأحرف التي تم إدخالها في النموذج الأول. للقيام بذلك، سيحتوي الحقل الثاني على الصيغة التالية كقيمة افتراضية:
طول السلسلة (fldText)
فرعيه
إرجاع جزء معين من سلسلة نصية. تحدد الوسيطة الثانية موضع البداية وتحدد الوسيطة الثالثة عدد الأحرف المراد تضمينها.
بناء الجملة
سلسلة فرعية (نص، start_position، char_count)
| الوسيطة | الوصف |
|---|---|
| النص | حقل يتضمن نوع بيانات نصية أو نصا محاطا بعلامات اقتباس مزدوجة (" "). تبحث الدالة في هذا النص وتعيد كافة الأحرف من الموضع المحدد في الوسيطة الثانية حتى عدد الأحرف المحددة في الوسيطة الثالثة أو إلى نهاية النص، أيهما يحدث أولا. |
| start_position | موضع البداية للنص المراد استرداده من الوسيطة الأولى. يجب أن تكون هذه الوسيطة عددا صحيحا أو مرجعا لحقل تم تكوينه لتخزين أنواع بيانات العدد الكامل (عدد صحيح). |
| char_count | عدد الأحرف التي تريد استردادها، بدءا من موضع البداية المحدد في الوسيطة الثانية. يجب أن تكون هذه الوسيطة عددا صحيحا أو مرجعا لحقل تم تكوينه لتخزين أنواع بيانات العدد الكامل (عدد صحيح). |
مثال
تقوم بتصميم قالب نموذج يحتوي على الحقول وعناصر التحكم التالية:
- حقل يسمى fldText مرتبط بعنصر تحكم مربع نص. يحتوي هذا الحقل على النص الذي تبحث فيه الدالة.
- حقل يسمى fldStartingPosition مرتبط بعنصر تحكم مربع نص. تم تكوين هذا الحقل كنوع بيانات رقم كامل. يحتوي الحقل على موضع البداية للدالة.
- حقل يسمى fldNumberOfCharacters مرتبط بعنصر تحكم مربع نص. تم تكوين هذا الحقل كنوع بيانات رقم كامل. يحتوي الحقل على عدد الأحرف التي ترجعها الدالة.
- عنصر تحكم مربع نص يعرض نتائج الدالة. يحتوي عنصر تحكم مربع النص على الصيغة التالية:
السلسلة الفرعية (fldText، fldStartingPosition، fldNumberOfCharacters)
إذا أدخل مستخدم "تم إنشاء هذا النموذج من قالب نموذج InfoPath." في مربع النص الأول، متبوعا ب 4 في الثاني و16 في المربع الثالث، ثم سيحتوي مربع النص الرابع على "تم إنشاء النموذج".
سلسلة فرعية بعد
إرجاع النص في السلسلة النصية الأولى التي تلي التكرار الأول للسلسلة النصية الثانية.
بناء الجملة
substring-after(text, find_text)
| الوسيطة | الوصف |
|---|---|
| النص | حقل يتضمن نوع بيانات نصية أو نصا محاطا بعلامات اقتباس مزدوجة (" "). تبحث الدالة عن النص في هذه الوسيطة، ثم ترجع كافة الأحرف التي تتبع النص في الوسيطة الثانية. |
| find_text | النص المراد البحث فيه في نص الوسيطة الأولى. يمكن أن يكون النص إما القيمة الموجودة في الحقل مع نوع بيانات نص أو نص محاط بعلامات اقتباس مزدوجة (" "). تبحث الدالة عن النص في الوسيطة الأولى لهذا النص، ثم ترجع كافة الأحرف التي تتبع النص في هذه الوسيطة. |
مثال
تقوم بتصميم قالب نموذج يحتوي على الحقول وعناصر التحكم التالية:
- حقل يسمى fldText مرتبط بعنصر تحكم مربع نص. يحتوي هذا الحقل على النص الذي تبحث فيه الدالة.
- حقل يسمى fldSubstringText مرتبط بعنصر تحكم مربع نص. يحتوي هذا الحقل على النص الذي يمثل الوسيطة الثانية للدالة.
- عنصر تحكم مربع نص يعرض نتائج الدالة. يحتوي عنصر تحكم مربع النص على الصيغة التالية:
substring-after(fldText, fldSubstringText)
إذا أدخل مستخدم "تم إنشاء هذا النموذج من قالب نموذج InfoPath." في حقل fldText، و"InfoPath" في الثاني، سيحتوي عنصر تحكم مربع النص الثالث على "قالب النموذج".
سلسلة فرعية قبل
إرجاع النص في السلسلة النصية الأولى التي تسبق التكرار الأول للسلسلة النصية الثانية.
بناء الجملة
substring-before(text, find_text)
| الوسيطة | الوصف |
|---|---|
| النص | حقل يتضمن نوع بيانات نصية أو نصا محاطا بعلامات اقتباس مزدوجة (" "). تبحث الدالة عن النص في هذه الوسيطة ثم ترجع كافة الأحرف قبل النص في الوسيطة الثانية، find_text. |
| find_text | القيمة التي يجب البحث عنها في الوسيطة النصية. يمكن أن تكون هذه القيمة إما القيمة في حقل بنوع بيانات نص أو نص محاط بعلامات اقتباس مزدوجة (" "). تبحث الدالة في النص في الوسيطة الأولى (نص) عن هذا النص ثم ترجع كافة الأحرف قبل النص في هذه الوسيطة. |
مثال
تقوم بتصميم قالب نموذج بالحقول وعناصر التحكم التالية:
- حقل يسمى fldText مرتبط بعنصر تحكم مربع نص. يحتوي هذا الحقل على النص الذي تبحث فيه الدالة.
- حقل يسمى fldSubstringText مرتبط بعنصر تحكم مربع نص. يحتوي هذا الحقل على النص الذي يمثل الوسيطة الثانية للدالة.
- عنصر تحكم مربع نص Aa الذي يعرض نتائج الدالة. يحتوي عنصر تحكم مربع النص على الصيغة التالية:
substring-before(fldText, fldSubstringText)
إذا أدخل مستخدم "تم إنشاء هذا النموذج من قالب نموذج InfoPath." في حقل fldText، و"تم إنشاؤه" في الثاني، سيحتوي عنصر تحكم مربع النص الثالث على "تم هذا النموذج".
الترجمة
إرجاع السلسلة النصية الأولى مع استبدال كل حرف في السلسلة النصية الثانية بالحرف في الموضع المقابل في السلسلة النصية الثالثة.
بناء الجملة
ترجمة(نص، find_chars، replace_chars)
| الوسيطة | الوصف |
|---|---|
| النص | اسم الحقل الذي يحتوي على النص الذي سيتم استبدال أحرفه. فصل الوسيطات بفاوصلة. |
| find_chars | حرف أو قيمة حقل بنوع بيانات نصي سيتم استبداله بالأحرف الموجودة في الوسيطة الثالثة. فصل الوسيطات بفاوصلة. |
| replace_chars | حرف أو قيمة حقل بنوع بيانات نصي سيحل محل كل مثيل للحرف في الوسيطة الثانية. |
مثال
تقوم بتصميم قالب نموذج يستخدم المتعاقدون نماذجه لتقديم طلبات للحصول على تصاريح البناء. يحتوي قالب النموذج على قسم يمكن للمقاول إدخال عنوان عمله فيه. يحتوي القسم على حقل يسمى fldStreetAddress مرتبط بعنصر تحكم مربع نص حيث يمكن للمقاول إدخال عنوان الشارع الخاص به.
للتحقق من أن المقاول يدخل عنوانا صالحا، لديك اتصال بيانات بخدمة ويب يمكنها التحقق من العنوان. تتطلب خدمة ويب أحرفا صغيرة في العنوان.
لتحويل أي حرف أحرف كبيرة في عنوان الشارع إلى أحرف صغيرة، يمكنك إضافة حقل آخر إلى مصدر البيانات لاحتواء عنوان الشارع الذي تم تحويله إلى أحرف صغيرة. تحتوي القيمة الافتراضية لهذا الحقل على الصيغة التالية:
translate(fldStreetAddress, ABCDEFGHIJKLMNOPQRSTUVWXYZ, abcdefghijklmnopqrstuvwxyz)
وظائف URL
SharePointListUrl
إرجاع عنوان قائمة SharePoint أو مكتبة النماذج حيث تتم استضافة النموذج (InfoPath 2010 فقط).
بناء الجملة
SharePointListUrl()
لا تستخدم هذه الدالة الوسيطات.
مثال
تقوم بتصميم قالب نموذج لقائمة SharePoint وتريد إضافة ارتباط إلى الموقع الذي تتم فيه استضافة القائمة، مثل "http://sharepointserver/site/list/". للقيام بذلك، أضف عنصر تحكم ارتباط تشعبي وقم بتعيينه إلى للقراءة فقط، ثم قم بتعيين القيمة الافتراضية للحقل الذي يرتبط به عنصر التحكم على النحو التالي:
SharePointListUrl()
ملاحظة
إذا لم تتم استضافة قالب النموذج على خادم SharePoint، فسترجع الدالة SharePointListUrl() فقط "http://sharepointserver/site/list/".
SharePointServerRootUrl
إرجاع عنوان خادم SharePoint حيث تتم استضافة النموذج (InfoPath 2010 فقط).
بناء الجملة
SharePointServerRootUrl()
لا تستخدم هذه الدالة الوسيطات.
مثال
تقوم بتصميم قالب نموذج لقائمة SharePoint وتريد إضافة ارتباط إلى جذر خادم SharePoint الذي تتم استضافة القائمة فيه، مثل "http://sharepointserver/site/list/". للقيام بذلك، أضف عنصر تحكم ارتباط تشعبي وقم بتعيينه إلى للقراءة فقط، ثم قم بتعيين القيمة الافتراضية للحقل الذي يرتبط به عنصر التحكم على النحو التالي:
SharePointServerRootUrl()
ملاحظة
إذا لم تتم استضافة قالب النموذج على خادم SharePoint، فسترجع الدالة SharePointListUrl() فقط "http://sharepointserver/site/list/".
SharePointCollectionUrl
إرجاع عنوان مجموعة مواقع SharePoint المشتركة حيث تتم استضافة النموذج (InfoPath 2010 فقط).
بناء الجملة
SharePointCollectionUrl()
لا تستخدم هذه الدالة الوسيطات.
مثال
تقوم بتصميم قالب نموذج لقائمة SharePoint وتريد إضافة ارتباط إلى مجموعة المواقع المشتركة لخادم SharePoint حيث تتم استضافة القائمة، مثل "http://sharepointserver/sitecollection/". للقيام بذلك، أضف عنصر تحكم ارتباط تشعبي وقم بتعيينه إلى للقراءة فقط، ثم قم بتعيين القيمة الافتراضية للحقل الذي يرتبط به عنصر التحكم على النحو التالي:
SharePointCollectionUrl()
ملاحظة
إذا لم تتم استضافة قالب النموذج على خادم SharePoint، فسترجع الدالة SharePointListUrl() فقط "http://sharepointserver/sitecollection/".
SharePointSiteUrl
إرجاع عنوان موقع SharePoint حيث تتم استضافة النموذج (InfoPath 2010 فقط).
بناء الجملة
SharePointSiteUrl()
لا تستخدم هذه الدالة الوسيطات.
مثال
تقوم بتصميم قالب نموذج لقائمة SharePoint وتريد إضافة ارتباط إلى موقع SharePoint حيث تتم استضافة القائمة، مثل "http://sharepointserver/site/". للقيام بذلك، أضف عنصر تحكم ارتباط تشعبي وقم بتعيينه إلى للقراءة فقط، ثم قم بتعيين القيمة الافتراضية للحقل الذي يرتبط به عنصر التحكم على النحو التالي:
SharePointSiteUrl()
ملاحظة
إذا لم تتم استضافة قالب النموذج على خادم SharePoint، فسترجع الدالة SharePointListUrl() فقط "http://sharepointserver/site/".
الدالة userName
المستخدم
إرجاع اسم المستخدم للشخص الذي يملأ النموذج (Microsoft InfoPath 2007 والإصدارات الأحدث).
ملاحظة
إذا كان المستخدم يملأ نموذجا في مستعرض ويب، يتم استرداد اسم المستخدم من Microsoft Windows SharePoint Services 3.0 أو إصدار أحدث.
بناء الجملة
اسم المستخدم()
لا تستخدم هذه الدالة الوسيطات.
مثال
تقوم بتصميم قالب نموذج تقرير المصروفات لشركتك. ترسل شركة بطاقة الائتمان الخاصة بك سجلات نفقات موظفيك إلكترونيا إلى قاعدة بيانات تحتفظ بها شركتك. لاسترداد سجلات المصروفات لموظف، تحتاج قاعدة البيانات إلى اسم المستخدم للموظف الذي يقوم بملء نموذج يستند إلى قالب النموذج الخاص بك.
يمكنك إضافة حقل إلى مصدر بيانات قالب النموذج لتخزين اسم المستخدم للموظف. يمكنك أيضا إنشاء اتصال بيانات استعلام يستخدم قيمة هذا الحقل في استعلام لاسترداد النفقات.
للتأكد من أن الموظف الذي يملأ تقرير المصروفات يستخدم اسم المستخدم الصحيح، يمكنك ربط الحقل بعنصر تحكم مربع نص. لعرض اسم المستخدم للمستخدم الذي ينشئ نموذجا استنادا إلى قالب النموذج هذا، استخدم الصيغة التالية كقيمة افتراضية لحقل مرتبط بعنصر تحكم مربع النص:
اسم المستخدم()