كتلة الوظيفة MSG_BOX

تدير كتلة الوظيفة MSG_BOX الإشعارات في واجهة من نوع RAW.

يتم توصيل كتلة الوظيفة عبر RAW_IN وRAW_OUT مع نفس متغير الواجهة. على سبيل المثال، in.RAW وout.RAW. لا يمكن التبديل بين الصناديق باستخدام نفس كتلة الوظيفة.

ملاحظة: قد لا يتم دعم جميع المخرجات للتواصل. وهذا يختلف حسب الواجهة.

مدخل RAW_IN

يستقبل البيانات من الواجهة. يمكن التمييز بين ردود الفعل العملية، مما يتيح نقل البيانات إلى عدة كتل وظيفية. ومع ذلك، قد يؤدي الإرسال المتزامن إلى فقدان البيانات.

مدخل GET_POSITION

عند تغيير القيمة، يتم استرجاع الموضع المقابل. تبدأ المواضع من 0 وتنتهي عند TOTAL-1. يتم تحديد القيم تلقائيًا. يتم تجاهل القيمة NULL في المدخل.

نصيحة: لاظهار آخر إشعار، يمكن توصيل المخرج TOTAL بالمدخل. كما يجب استخدام SEL لإطلاق نبضة لضمان عرض الإشعار حتى عند ملء الصندوق بالكامل.

مدخل GET_ID

عند تغيير القيمة، يتم البحث عن المعرف المقابل، وإذا تم العثور على إشعار، يتم عرضه. يتم تجاهل القيمة NULL في المدخل.

مدخل GET_NEXT

عند وجود حافة إيجابية، يتم استدعاء الإشعار التالي.

مدخل GET_PREV

عند وجود حافة إيجابية، يتم استدعاء الإشعار السابق.

مدخل DELETE

عند وجود حافة إيجابية، يتم حذف الإشعار.

مدخل READ

عند وجود حافة إيجابية، يتم وضع علامة على الإشعار بأنه قد تم قراءته.

مخرج RAW_OUT

يتواصل مع الواجهة باستخدام تنسيق JSON. المخرج ليس مساويًا لـ NULL إلا عند الإرسال.

مخرج TOTAL

يرجع عدد الإشعارات في هذه الصندوق.

مخرج POSITION

يرجع الموضع الحالي للإشعار. يتم إضافة آخر إشعار في النهاية.

مخرج ID

مخرج FROM

يرجع المرسل للإشعار.

مخرج TO

يرجع واحد أو أكثر من المستلمين للإشعار. يتم فصل عدة مستلمين بفاصلة ";".

مخرج SUBJECT

يرجع عنوان الإشعار.

مخرج TEXT

يرجع النص أو الجسم الإشعار.

مخرج PRIORITY

يرجع أولوية الإشعار. كيفية تقييم هذه الأولويات تعتمد على الواجهة المستخدمة. القيم المحتملة هي: 1, 0, -1 أو أيضًا "high", "low"

مخرج TYPE

يرجع نوع الإشعار.

مخرج STATUS

يرجع حالة الإشعار.

مخرج TIME

يرجع Timestamp في تنسيق DT# للإشعار.

مخرج READED

يرجع حالة القراءة للإشعار.