كيفية استخدام المتغيرات العامة
يمكن أن تشير بعض الخطوات الواضحة إلى حقول تسمى القيم المحددة مسبقًا. بالإضافة إلى الإشارة إلى قيمة ثابتة مخصصة (مثل الحرف Y)، يمكنك أيضًا الإشارة إلى متغير عام في قيمة الحقل هذه. يتم استخدام متغير عام إذا أردت الإشارة إلى بيانات النظام.
لاحظ أنه عند استخدام نوع خطوة تحرير البيانات، يختلف المتغير المتاح اختلافًا طفيفًا. للحصول على التفاصيل، ارجع إلى صياغة تحرير البيانات.
المتغيرات العامة التالية موجودة لسكريبتات مساعد عمليات الأعمال (BPA):
| اسم المتغير | تعليقات |
|---|---|
| %PARM-<name> | هذه هي قيمة معلمة ذلك الاسم الذي يتم إدخاله إلى التطبيق عند بدء تشغيله عن طريق عنوان URL للنظام القياسي. ارجع إلى بدء تشغيل سكريبت عند بدء النظام لمزيد من المعلومات حول هذه المعلمات. |
| %PARM-NOT-SET | يتم استخدامه في المقارنة مقابل معلمات %PARM-< > للتحقق مما إذا كان قد تم إعداد المعلمة أم لا عند بدء تشغيل التطبيق. سيتم اعتبار المعلمة التي لم يتم إعدادها مساويةً لهذا المتغير العام. يوصى بمقارنة المعلمات مقابل هذا المتغير العام قبل استخدامها للمرة الأولى. |
| %BLANK | قيمة ثابتة تحتوي على قيمة خالية (لا توجد قيمة). |
| %SPACE | قيمة ثابتة تحتوي على قيمة مسافة واحدة. |
| %CURRENT-DATE | التاريخ الحالي بالنسبة للمستعرض، وليس الملقم. |
| %SYSTEM-DATE | تاريخ الملقم. لاحظ أن هذا التاريخ يتأثر بمنطق تجاوز تاريخ النظام) |
| %SAVE-REQUIRED | علامة تحتوي على إشارة توضح ما إذا كان قد تم تغيير البيانات على الصفحة أم لا (وهذا يتطلب الحفظ). يمكنك جعل هذه العلامة تجبر المستخدم على حفظ العمل قبل تنفيذ الخطوات التالية. تحتوي هذه العلامة على القيمة TRUE (صواب) أو FALSE (خطأ). |
| %NEWLINE | قيمة ثابتة تحتوي على حرف سطر جديد (رجوع إلى أول السطر). وعند الاستبدال، يتم إدراج فاصل أسطر في النص الناتج. ملاحظة: لا تحتوي هذه القيمة الثابتة على التأثير المطلوب عندما يكون النص الناتج بتنسيق HTML. على سبيل المثال، في نص الخطوة وسلاسل المطالبة. وهذا لأن لغة HTML تتجاهل الأحرف الخاصة مثل السطور الجديدة. لتتعلم كيفية عمل فاصل أسطر في نص بلغة HTML، ارجع إلى كيفية استخدام العلامات وعلامات التنسيق الخاصة بلغة HTML في النص.
|
للرجوع إلى متغير السياق العام، استخدم %FIELD_NAME. على سبيل المثال، إذا كان الحقل SP_ID موجود في السياق العام، يمكنك الإشارة إلى %SP_ID للإشارة إلى معرف نقطة الخدمة الموجود حاليًا في السياق. بالإضافة إلى ذلك، يتم دعم القيم الخاصة التالية:
| اسم المتغير | تعليقات |
|---|---|
| %CONTEXT-PERSONID | قيمة ثابتة تحتوي على معرف الشخص الحالي. |
| %CONTEXT-ACCOUNTID | قيمة ثابتة تحتوي على معرف الحساب الحالي. |
| %CONTEXT-PREMISEID | قيمة ثابتة تحتوي على معرف العقار الحالي. |
بالإضافة إلى ذلك، إذا قام السكريبت باستدعاء شيء آخر عن طريق أحد أنواع الخطوات "استدعاء" وتم عرض خطأ، تحتوي المتغيرات العامة التالية على معلومات حول الخطأ:
| اسم المتغير | تعليقات |
|---|---|
| %ERRMSG-CATEGORY %ERRMSG-NUMBER | المعرف الفريد لرقم رسالة الخطأ. |
| %ERRMSG-TEXT | الوصف الموجز للخطأ. |
| %ERRMSG-LONG | الوصف الكامل للخطأ. |