تكوين رسائل الوقت الفعلي

يتم توجيه الرسائل إلى نظام خارجي بالوقت الفعلي باستخدام موزع مهام الرسالة الصادرة أو باستخدام خدمة أعمال إرسال البريد الإلكتروني بالوقت الفعلي. فإن النظام يدعم توجيه الرسائل باستخدام HTTP وتوجيه الرسائل باستخدام JMS. بالإضافة لذلك، يوجد نوع خاص من مُرسِل الرسالة المُستخدم لإرسال رسائل البريد الإلكتروني. توضح الأقسام التالية اتصال الوقت الفعلي المدعم والتكوين المطلوب لكل اتصال.

رسائل البريد الإلكتروني

لإرسال رسائل بريد إلكتروني، يستلزم إعداد التكوين التالي:

  • تحديد مرسِل رسالة مكوّنًا للبريد الإلكتروني. ويجب تكوين بيانات المرسلين من هذا النوع بالفئة RTEMAILSNDR. ويتم استخدام سياق المرسِل لتكوين معلومات الاتصال من أجل الاتصال بملقم SMTP.

  • يمكن تحديد هذا المرسِل باعتباره مرسِل البريد الإلكتروني الافتراضي في جدول خيار الرسالة. أو يمكن بدلاً من ذلك توفير مرسل الرسالة لخدمة الأعمال كأحد المدخلات. ارجع إلى إرسال بريد إلكتروني للحصول على مزيد من المعلومات.

الرسائل الصادرة

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

حدد آلية الاتصال قبل تكوين المُرسِل.

  • عند توجيه الرسالة باستخدام JMS، يجب تحديد التكوين التالي

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

    • في حالة اختيار طريقة تحويل JSON الأساسي، فإنه إذا كان يلزم تطبيق تحويل XSL قبل التحويل إلى JSON، فيجب تحديد "مخطط طلب XML" الهدف (باستخدام منطقة بيانات) حتى يتعرف منطق التحويل على تنسيق XML الذي يتم تحويله. يتم تطبيق تنسيق XSL على "مصدر XML" للرسالة الصادرة، مما ينتج عنه "مخطط طلب XML" المحدد، والذي يتم تحويله بعد ذلك إلى JSON. إذا لم يكن تحويل XSL مطلوبًا، يتم تحويل مصدر XML للرسالة الصادرة إلى تنسيق JSON.

    • في حالة اختيار طريقة تحويل JSON بلا جذر، تتم إزالة عنصر المجموعة المرتبط بحقل مصدر XML بواسطة التحويل، مما ينتج عنه مستند طلب JSON بلا جذر.

    • إذا كان يمكن تحويل مصدر XML في الرسالة الصادرة إلى تنسيق JSON باستخدام لغة XSL، فيجب اختيار طريقة تحويل XSL.

    • يمكن أيضًا اختيار تحويل مصدر XML إلى تنسيق JSON من خلال الطريقة تحويل بواجهة برمجة التطبيقات القياسية (باستخدام إحدى مكتبات Jettison). ومع هذه الطريقة، يمكن توفير XSL اختياريًا. وسوف يتم إجراء التحويل على XML المحول.

    • بالنسبة للاستجابة، إذا كان كائن عمل الرسالة الصادرة يحدد عناصر تفصيلية لحقل "استجابة XML"، فيجب عندئذ تحويل تنسيق JSON إلى هذا التنسيق.
      • وإذا كانت طريقة التحويل هي تحويل JSON الأساسي، فإنه إذا تعذر تحويل استجابة JSON مباشرةً إلى عناصر "استجابة XML" في كائن عمل الرسالة الصادرة، قم عندئذ بتحديد "مخطط استجابة" (منطقة بيانات) يعرض نتائج تحويل JSON الأساسي. بالإضافة لذلك، حدد XSL يمكن من خلاله تحويل الاستجابة من XML المحول إلى تنسيق XML المتوقع في كائن العمل.

      • إذا كانت طريقة التحويل الخاصة بك هي تحويل JSON بلا جذر، يفترض أن يكون مستند الاستجابة بلا جذر. تتم إضافة عنصر المجموعة المرتبط بحقل استجابة XML بواسطة عملية التحويل، مما يؤدي إلى تكوين مستند استجابة XML بشكل صحيح.

      • إذا كانت طريقة التحويل هي تحويل الواجهة البرمجية للتطبيق القياسية أو تحويل XSL، فإنه يتم استخدام واجهة برمجة التطبيقات القياسية لتحويل تنسيق JSON إلى XML. يمكن تحديد XSL لتحويل الاستجابة إلى "استجابة XML"، إذا اقتضت الحاجة.

    • إذا كان كائن عمل الرسالة الصادرة يحدد عنصرًا "أوليًا" لتسجيل الاستجابة، فلا توجد حاجة إلى مخطط استجابة وXSL. وفي هذه الحالة، يقوم النظام بتحويل تنسيق JSON إلى XML من خلال الطريقة تحويل الواجهة البرمجية للتطبيق القياسية (بغض النظر عن طريقة التحويل المحددة) ويتم تسجيل النتيجة في استجابة XML.

  • بالنسبة لمرسلو HTTP، بما في ذلك مرسلي JSON، يوفر النظام الدعم التالي لإرسال الرسائل المؤمنة بواسطة مصادقة OAuth:
    • استخدام مدير خدمات الويب من أوراكل (OWSM). يوفر النظام مجموعة من السياسات المكونة بصورة مسبقة والتي تخص OAuth (F1-OAUTH) باستخدام بحث خاص قابل للتوسيع. لاحظ أن قيم مجموعة السياسات المذكورة تحدد مستودع مفاتيح CSF معين والذي يجب أن تستخدمه النسخة المعدلة لتسجيل مفاتيح CSF الخاصة بها. بالإضافة إلى ذلك، توجد قيمة استبدال معرفة للرمز المميز URI: @F1_​OAUTH2_​URI@. قم بتكوين عنوان URI المناسب كما هو موضح في استبدال عنوان URI. وفقًا للإعدادات الافتراضية، لا يدعم النظام تعريف مجموعات السياسات الإضافية. إذا كانت النسخة المعدلة لا تتطلب مجموعة سياسات مختلفة، فاتصل بالدعم.

    • يمكنك إدخال الإعدادات التي تخص OAuth كجزء من تكوين مرسِل الرسالة للواجهة البرمجية للتطبيقات لخدمة REST.

حدد مرسِل رسالة مكوّنًا لكل طريقة توجيه مناسبة. يجب إعداد نوع الاستدعاء على الوقت الفعلي. بالنسبة للتوجيه من خلال HTTP، استخدم RTHTTPSNDR - فئة المرسِل عبر HTTP. وبالنسبة للتوجيه عبر HTTP مع تطبيق تنسيق SOAP آليًا، استخدم SOAPSNDR - فئة المرسِل عبر HTTP باستخدام SOAP. وبالنسبة للتوجيه عبر HTTP باستخدام تنسيق JSON، استخدم RTJSONSNDR - فئة المرسِل بتنسيق JSON. أما بالنسبة للتوجيه عبر واجهة JMS، استخدم RTJMSQSNDR - فئة مرسِل قائمة انتظار JMS أو RTJMSTSNDR - فئة مرسِل موضوع JMS، وقم بتكوين "اتصال عبر JMS" و"قائمة انتظار JMS" أو "موضوع JMS". استخدم سياق المُرسل لتكوين القيم المطلوبة للاتصال بالوجهة المناسبة.

ملاحظة: ارجع إلى دعم عناوين URL الديناميكية لمعرفة التكوين المطلوب لدعم عناوين URL الديناميكية عند إرسال رسالة صادرة. هناك تكوين معين متوقع عند تعريف عنوان URL في "المرسل" من أجل دعم عناوين URL الديناميكية.

قم بتكوين مجموعة النظام الخارجي / نوع الرسالة الصادرة. يجب أن تكون طريقة المعالجة المحددة لنوع الرسالة الصادرة/النظام الخارجي هي الوقت الفعلي.