إجراءات مربع الرسائل

مكتمل

تمكن مربعات الرسائل من التفاعل في الوقت الحقيقي بين المستخدمين والتدفقات. يمكن استخدام إجراءات مربعات الرسائل لتوفير مدخلات للتدفقات وتقديم مخرجات للمستخدمين.

إجراءات الإخراج

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

ملاحظة

يجب أن يحتوي التدفق الفرعي Populate_Web_Form على جميع الوظائف اللازمة لملء بيانات Excel في مدخل الويب. في هذا المثال، يمكنك استخدام أي بوابة ويب تمتلك حقوق وصول لها.

لقطة شاشة لمساحة عمل وظيفة الإخراج.

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

لقطة شاشة لخصائص إجراء الرسالة

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

لقطة شاشة لمربع الرسالة تُظهر عدد المطالبات التي تمت معالجتها.

إجراءات الإدخال

الوظيفة الثانية لإجراءات مربعات الرسائل هي تمكين المستخدمين من توفير مدخلات للتدفق.

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

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

لقطة شاشة لمساحة عمل وظيفة الإدخال.

يعرض الإجراء مربع حوار عرض تحديد الملف التالي مربع حوار للمستخدم لتحديد ملف .txt.

لقطة شاشة لخصائص إجراء حوار تحديد مربع الحوار

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

لقطة شاشة لخصائص مربع حوار الإدخال

في لقطة الشاشة التالية، يمكنك رؤية مربع الحوار الناتج عن الإجراء مربع حوار إدخال العرض.

لقطة شاشة لمربع الرسالة النصية متعددة الأسطر.

النماذج المخصصة

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

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

لإنشاء نموذج مخصص، قم بتوزيع الإجراء نموذج العرض المخصص واضغط على الزر مصمم النماذج المخصص لفتح مصمم النماذج.

لقطة شاشة للزر

يوفر المصمم مجموعة متنوعة من عناصر الإدخال، مثل النص والتاريخ ومدخلات الملف، وبعض العناصر غير التفاعلية، مثل النصوص والصور.

للوصول إلى البيانات المقدمة لاحقاً في التدفق الخاص بك، يتم تحديد جميع عناصر الإدخال بواسطة معرف فريد يمكنك استخدامه. يتم تخزين البيانات في متغير الكائن المخصص CustomFormData ويمكنك استخدام الرموز التالية للوصول إليها: %CustomFormData['ElementID']%.

لقطة شاشة لعنصر إدخال نص محدد.

بصرف النظر عن هذه العناصر، يوفر مصمم النماذج المخصص إجراءات تمكنك من تنفيذ وظائف إضافية لنموذجك.

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

لقطة شاشة لتدفق التحقق من زر النموذج الذي تم الضغط عليه.