مرسِل الرسالة - السياق

يمكن أن يحتاج المرسِل إلى معلومات سياق لتحديد المعلومات الإضافية التي يتطلبها النظام لإرسال الرسائل الصادرة بنجاح. افتح الإشراف > التكامل > مرسِل الرسالة، ثم تنقل إلى صفحة السياق.

وصف الصفحة

حدد نوع السياق وقيمة السياق اللذين يتضمنان معلمات المرسلين إذا تعين إدخال مزيد من المعلومات. انظر أدناه للتعرف على قيم السياق المدعومة للأنواع المختلفة من المرسِلات.

سياق مرسِل البريد الإلكتروني

يتم استخدام مرسِل البريد الإلكتروني بواسطة خدمة الأعمال التي ترسل رسائل بريد إلكتروني في الوقت الفعلي.

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

نوع السياق الوصف
اسم مضيف SMTP اسم مضيف ملقم SMTP.
اسم مستخدم SMTP معرف المستخدم الذي يتم استخدامه للوصول إلى ملقم SMTP.
كلمة مرور SMTP كلمة المرور المستخدمة للوصول إلى ملقم SMTP.
مهلة الاستجابة المدة الزمنية التي يجب أن ينتظرها النظام للاستجابة في الوقت الفعلي.

مرسِل HTTP

يعد مرسِل HTTP هو ذلك المرسِل الذي يقوم بإرسال الرسائل إلى ملقم HTTP باستخدام بروتوكول HTTP. يجب أن تشير مرسِلات HTTP إلى فئة الرسالة RTHTTPSNDR أو RTJSONSNDR أو SOAPSNDR.

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

قبل تحديد مرسِل HTTP، أنت بحاجة إلى معرفة كيفية توقع ملقم HTTP الموجود على الجانب الآخر لاستلام الطلب وخاصةً للإجابة على الأسئلة التالية:

  • ما هو عنوان ملقم HTTP؟
  • هل يستخدم ملقم HTTP طريقة إرسال أو إحضار HTTP؟
  • إذا كان الخادم يستخدم POST، كيف يتم تمرير محتويات الرسالة؟ هل يستخدم نموذج HTTP أم يقوم بتمرير البيانات في شكل رسالة XML؟
نوع السياق الوصف القيم
HTTP URL1 - URL9

يتم استخدامه لإنشاء عنوان URL لملقم HTTP الهدف.

نظرًا لأن عنوان URL قد يكون طويلاً ومعقدًا، يمكنك تقسيمه إلى أجزاء أصغر، يحدد كل جزء منها سجل قياس منفصل. يتم إنشاء عنوان URL الكامل بتعاقب القيم من URL1 إلى URL9.

يمكنك استخدام متغيرات الاستبدال عند إدخال قيم لأجزاء عنوان URL. لاحظ أنه يمكن استخدام سلسلة الاستبدال @XMLMSG@ لعمليات الاستدعاء GET، وذلك في حالة تطبيق XSL لتحويل الرسالة إلى معلمات GET الخاصة ببروتوكول HTTP. يعد ذلك مفيدًا إذا كان "نموذج HTTP" غير قابل للتطبيق على نوع الرسالة.

ارجع إلى دعم عناوين URL الديناميكية لمعرفة التكوين المطلوب لدعم عناوين URL الديناميكية عند إرسال رسالة صادرة.

طريقة HTTP طريقة HTTP المستخدمة لإرسال الرسالة.
ملاحظة: تدعم فئة رسالة مُرسِل SOAP SOAPSNDR طريقة POST فقط.
POST أو GET
طريقة نقل HTTP تتيح تحديد نوع الرسالة. يمكنك إما إرسال الرسالة أو إرسال استجابة وانتظارها. Send أو sendReceive
بيانات نموذج HTTP

يتم استخدامه عندما تكون الرسالة بتنسيق "نموذج HTML" (Content-Type: application/x-www-form-urlencoded).

يحدد هذا السياق معلمات (بيانات) النموذج التي يجب تمريرها في رسالة HTTP. وبما أنه من الممكن أن يكون للنموذج معلمات متعددة، يجب إضافة سجل سياق لكل معلمة نموذج.

تأخذ معلمة النموذج التنسيق x=y حيث تمثل x اسم معلمة النموذج وتمثل y قيمتها.

إذا تضمنت y السلسلة @XMLMSG@ (متحسسة لحالة الأحرف)، يتم استبدال هذه السلسلة بالتالي بمحتوى رسالة XML لاستجابة الخدمة. يمكن استخدام سلسلة @XMLMSG@ في بيانات نموذج HTTP أو في عنوان HTTP URL، ولكن ليس كليهما.

في حالة تعريف سجل سياق من هذا النوع للمرسِل، يستخدم المرسِل تنسيق رسالة نموذج HTML لإرسال الرسالة حتى في حالة عدم تحديد @XMLMSG@ في أحد سجلات السياق.

في حالة عدم تحديد سجل سياق من هذا النوع للمرسِل، يتم إرسال XML بالتنسيق نوع المحتوى: نص/عادي. وعند استخدام الطريقة إرسال، يتم وضعه في نص رسالة HTTP.

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

يمكنك استخدام متغيرات الاستبدال عند إدخال قيم لبيانات النموذج.

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

قد يتطلب ملقم HTTP على الجانب الآخر في بعض الأحيان إضافة عناوين HTTP إلى الرسالة.

لكل عنوان من عناوين HTTP التي يتعين تحديدها، يجب إضافة سجل سياق بقيمة لها التنسيق التالي x:y حيث تمثل x اسم العنوان وy قيمة العنوان

مهلة HTTP تشير إلى المدة الزمنية التي يجب انتظارها لإنشاء الاتصال بواسطة النظام عن بعد.
ترميز بالحروف تتيح الإشارة إلى ما إذا كان يجب ترميز الرسالة أم لا. سيقوم المرسِل بإضافة السلسلة ;charset=x إلى عنوان نوع محتوى HTTP حيث تمثل x قيمة هذا السياق وعند إرسال الرسالة، سيقوم بترميز البيانات بذلك الترميز. UTF-8 أو UTF-16
مهلة الاستجابة مقدار الوقت الذي يجب أن يستغرقه النظام لانتظار النظام البعيد حتى يقوم بإرسال استجابة.
نوع الحماية للمُرسِل حدد نوع الحماية المطلوب لتطبيقه. (لاحظ أن أنواع الحماية الإضافية لا تنطبق إلا على مرسل SOAP. لمزيد من المعلومات، راجع أدناه). BASIC (HTTP الأساسي)، TEXT (النص العادي لرمز اسم المستخدم المميز)، DIGEST - ملخص رمز اسم المستخدم المميز، OWSM - حماية OAuth عبرOWSM ،OAUTH - حماية OAuth.
مجموعة سياسات OWSM

قابل للتطبيق فقط إذا كان "نوع تأمين المستخدم" هو OWSM. تقوم بتحديد مجموعة السياسات التي سيتم تطبيقها.

أدخل اسمًا صالحًا للبحث القابل للتوسيع "مجموعة السياسات" (F1-SetOfPolicies). يوفر المنتج القيمة F1-OAUTH التي يمكن استخدامها هنا.
نوع منح OAuth

قابل للتطبيق فقط إذا كان "نوع حماية المرسل" هو OAUTH. تحديد طريقة مواصفات OAuth للحصول على رمز وصول مميز.

client_​credentials
عنوان URL للرمز المميز لوصول OAuth

يتم استخدامه لإنشاء عنوان URL لملقم الاعتماد الهدف. يمكنك استخدام متغيرات الاستبدال لإنشاء عنوان URL.

معرف عميل OAuth

المعرف الذي تم إنشاؤه للتطبيق الحالي في ملقم اعتماد النظام الخارجي.

كلمة سر عميل OAuth

كلمة السر المقترنة بمعرف عميل OAuth كما تم الإدخال بواسطة ملقم اعتماد النظام الخارجي.

مجموعة مفاتيح تشفير OAuth

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

مدى الواجهة البرمجية للتطبيقات لخدمة REST لأجل OAuth

مستوى الاعتماد الذي تم منحه بواسطة نقطة النهاية.

تفاصيل طلب رمز OAuth المميز في النص

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

قم بتعيين هذه القيمة على "نعم" لإرسال معلومات معرف العميل والمفتاح السري كجزء من نص طلب الرمز المميز للاعتماد.

مرسِل HTTP بالوقت الفعلي

ينطبق نوع السياق التالي فقط على المُرسِلات التي لها فئة الرسالة RTHTTPSNDR.

نوع السياق الوصف
نوع المحتوى قم بملء قيمة هنا لتجاوز سمة نوع المحتوى Content-Type في عنوان HTTP، والتي يتم إعدادها بشكل افتراضي على text/xml.

مرسِل SOAP

مرسِل SOAP هو مرسِل HTTP يقوم آليًا بإضافة دعم لتنسيق SOAP. بالنسبة لهذا النوع من المُرسِلات (فئة الرسالة SOAPSNDR)، إلى جانب قيم السياق المعروضة أعلاه، فإنه يمكن إدخال قيود السياق التالية أيضًا.

نوع السياق الوصف القيم
عنوان URI لمساحة اسم الرسالة يتم استخدامه لتوضيح مساحة اسم معينة يتم تضمينها في الرسائل الخاصة بهذا المُرسل. لاحظ أن هذه القيمة يتم استخدامها فقط عند تكوين رابط "الرسالة الخارجية" إلى هذا المُرسل باستخدام خيار مساحة الاسم الذي يخص التكوين في المرسل.
إدراج طابع زمني لـ SOAP حدد ما إذا كان يجب إضافة طابع زمني أم لا. القيمة الافتراضية هي "لا". نعم أو لا
مهلة انتهاء صلاحية SOAP (بالثواني) حدد مهلة انتهاء صلاحية لإضافتها إلى الطابع الزمني. القيمة الافتراضية هي 60.
نوع الحماية للمُرسِل يتم دعم أنواع الحماية الإضافية لمرسلي SOAP لعمليات تكامل أطراف ثالثة محددة. نموذج المعلومات الشائعة - استخدام مساحة اسم مناسبة وإضافة معلومات التأمين في عنوان SOAP الخاص بـ Landis+Gyr، MS_​V30 - استخدام مساحة اسم مناسبة وإضافة معلومات التأمين في عنوان SOAP الخاص بـ MultiSpeak v3.0، MS_​V41R - استخدام مساحة اسم مناسبة وإضافة معلومات التأمين في عنوان SOAP الخاص بـ MultiSpeak v4.1.ITRON - استخدام معلومات تأمين معلومات عنوان SOAP المناسبة في عنوان SOAP الخاص بـ Itron.
ملاحظة: ارجع إلى إضافة معلمات عنوان SOAP في الوقت الفعلي لمعرفة معلومات عن معلمات عناوين SOAP المدرجة بطريقة ديناميكية عند إرسال إحدى الرسائل.

مرسِل JMS

مرسِل JMS هو مرسِل يقوم بإرسال الرسائل إلى قائمة انتظار JMS أو إلى موضوع JMS. يجب أن تشير مُرسِلات JMS إلى فئة الرسالة RTJMSQSNDR أو RTJMSTSNDR، بالترتيب.

يتم استخدام المعلمات التالية للاتصال بمورد JMS.

نوع السياق الوصف القيم
نوع رسالة JMS (Bytes(Y)/Text(N)) يشير إلى ما إذا كان يتم إرسال البيانات كرسالة بوحدات البايت أم رسالة نصية. نعم أو لا
اسم مستخدم JMS أدخل اسم المستخدم للاتصال بمورد JMS.
كلمة مرور مستخدم JMS أدخل كلمة المرور المطلوب استخدامها للاتصال بمورد JMS.
عنوان JMS

إذا كانت قيم عناوين JMS مطلوبة للرسالة، فاستخدم نوع السياق هذا.

لكل عنوان من عناوين JMS التي يستلزم تحديدها، يجب إضافة سجل سياق بقيمة لها الصيغة التالية x:y، حيث تمثل x اسم العنوان وتمثل y القيمة.