الوحدة في هذا المقال: iFlow Docs
بعد Deploy في SAP CPI: متابعة النشر وتوثيق الحزم والمشهد العام للأنظمة وValue Mapping في Excel
اعرف متى يصبح الـ iFlow في حالة Started أو لماذا فشل، واختر الـ runtime السحابي أو Edge، وشغّل فحوص تصميم جديدة، ووثّق حزمة كاملة مع مشهدها العام، وصدّر Value Mappings إلى Excel، وأوقف أي أداة.
الضغط على Deploy في SAP Cloud Integration (SAP CPI) يبدأ فترة انتظار: تنتقل إلى Monitor، وتبحث عن الـ iFlow، وتحدّث الصفحة حتى تظهر Started أو Error، ثم تحاول فهم معنى الخطأ. وحين تكتمل الواجهة، يبقى من يطلب المستند، وصورة المشهد العام للأنظمة، وValue Mapping في جدول بيانات.
يغطي Kitegra الآن هذا الجزء من العمل بجوار مصمم SAP Integration Suite: متابعة للنشر مع استدعاء تجريبي، واختيار الـ runtime في المستأجرين الذين لديهم Edge Integration Cell، وفحوص تصميم جديدة، وتوثيق للحزمة مع رسم للمشهد العام وجاهزية التوثيق، وورقة Value Mapping في Excel، وشرح لسكربتات Groovy بكلمات بسيطة. ويمكن إيقاف كل أداة وحدها. يستعرضها هذا المقال واحدة تلو الأخرى.
متابعة النشر: Started أو Error دون مغادرة الـ iFlow
اضغط Deploy في المصمم كالمعتاد وأكّد مربع حوار SAP. يظهر إشعار النشر (Deploy) مع "جارٍ النشر…" والوقت المنقضي، وتواصل عملك. يسأل Kitegra عن الحالة من SAP بعد ثلاث ثوانٍ، ثم على فترات تتباعد تدريجيًا، بحد أقصى كل 20 ثانية. وعندما يجيب SAP، يتحول الإشعار إلى:
- Started، مع الإصدار المنشور. وإذا كان للـ iFlow نقطة وصول HTTP، يفتح إرسال استدعاء تجريبي أداة HTTP Runner والطلب جاهز، ويفتح عرض أحدث رسالة لوحة الرسائل محدَّثة.
- خطأ، مع نص الخطأ من SAP، وعندما تكون حالة معروفة، ما تعنيه عادةً: iFlow آخر منشور يستخدم عنوان المرسل نفسه، أو سكربت لا يمكن ترجمته، أو معامل خارجي بلا قيمة، أو تعذّر على SAP بناء الـ iFlow. ويأخذك فتح المحتوى المنشور في SAP إلى التفاصيل.
- ما زال النشر جاريًا بعد عشر دقائق، مع إشارة إلى المحتوى المنشور في SAP.
وإذا ألغيت مربع حوار Deploy في SAP، فلا تُتابَع أي عملية. فالمتابعة تقرأ حالة النشر فقط؛ أما النشر نفسه فيقوم به SAP، وقد بدأ بنقرتك أنت. وتتبّع رسالة عبر الـ iFlow بعد ذلك مشروح في تتبّع رسالة خطوة بخطوة، والاستدعاء نفسه في اختبار iFlow عبر HTTPS بمفتاح خدمة.
اختيار الـ runtime: السحابة أو Edge
المستأجر الذي لديه Edge Integration Cell يشغّل iFlows على أكثر من runtime. وفي مثل هذا المستأجر وحده، يعرض مربع Kitegra Runtime: Cloud (أو اسم الـ runtime الخاص بـ Edge). اختر الـ runtime من هناك، فيقرأ Message Monitor رسائل هذا الـ iFlow ويضبط مستوى السجل له على ذلك الـ runtime. ويعرض المُختار أيضًا هل الـ iFlow منشور على كل runtime، وبأي إصدار. أما المستأجرون الذين لديهم runtime واحد فلا يرونه أبدًا.
فحوص تصميم جديدة في iFlow Inspector
أُضيفت إلى قائمة مراجعة الـ iFlow خمسة فحوص، مع فئة جديدة باسم "التوثيق":
| الفحص | لماذا يهم |
|---|---|
| مستقبِل بلا عنوان (خطأ) | يُنشر الـ iFlow، لكن كل استدعاء لهذا المستقبِل يفشل وقت التشغيل. |
| مرسل HTTPS بعنوان افتراضي (تحذير) | العنوان الفارغ، أو /، أو العنوان المؤقت مثل /test لا يقول شيئًا للجهات المستدعية، وقد يتعارض عليه iFlowان. |
| مرسل HTTPS يتطلب رمز CSRF (معلومة) | على كل جهة مستدعية أن تجلب X-CSRF-Token أولًا، وإلا تلقّى طلب POST منها الرمز 403. |
| عنوان المستقبِل مكتوب داخل الـ iFlow (معلومة) | الانتقال بين DEV وQA وPROD يعني تعديل الـ iFlow؛ وتعالج Externalize Parameters ذلك في خطوة واحدة. |
| مشارك يحتفظ باسمه الافتراضي (معلومة، التوثيق) | يظهر "Sender" و"Receiver" في المراقبة أيضًا، فلا يعرف أحد أي نظام هو المقصود. |
وكسائر الفحوص، تُحتسب في النتيجة ويمكن إيقافها واحدًا واحدًا. وعرضها مجاني؛ أما تصدير التقرير فجزء من خطة Pro. وتُشرح Externalize Parameters وأدوات Helper الجديدة الأخرى في Externalize Parameters ونسخ الخطوات والاستيراد من Hub.
مستند للحزمة كاملة
بجوار توثيق هذا الـ iFlow، صارت قائمة Kitegra تضم توثيق الحزمة. فهو يقرأ كل iFlows في حزمة الـ iFlow المفتوح واحدًا تلو الآخر ("جارٍ قراءة الـ iFlow رقم 2 من 5…")، ويمكنك إيقافه وفتح ما قُرئ حتى تلك اللحظة. وتُسرد iFlows التي تعذّرت قراءتها. ويُفتح المستند في تبويب جديد، بصيغة Word أو PDF أو HTML، أو معبّأً في قالب Word الخاص بك، مثل مستند التصميم التقني لـ iFlow واحد. ويضم إصدار الحزمة ومورّدها ووسومها وعدد iFlows فيها، ثم كل iFlow، وجزأين جديدين:
- المشهد العام للأنظمة: رسم يضع المرسلين على اليسار، وiFlows الحزمة في الوسط، والمستقبِلين على اليمين. ويصبح المشاركون الذين يحملون الاسم نفسه مربعًا واحدًا، ويحمل كل خط أنواع المحوّلات (adapters) الخاصة به.
- جاهزية التوثيق: ما يحتاجه القارئ، مفحوصًا بندًا بندًا: وصف الحزمة ووسومها، ووصف لكل iFlow، ومشاركون أُعيدت تسميتهم بدل Sender وReceiver، وعناوين مستقبِلين محوّلة إلى معاملات خارجية. ويُظهر عدد الفحوص الناجحة وما ينقص، لتسد الثغرات قبل التسليم.
Value Mapping في Excel
في صفحة iFlow Docs، تحت جداول Value Mapping، ارفع ملف ZIP لـ Value Mapping (نزّله من حزمته في SAP) أو ملف value_mapping.xml الخاص به. يسرد Kitegra القيم ويكتب مصنّف Excel فيه ورقة لكل زوج من الوكالة والمعرّف: الوكالة المصدر والمعرّف والقيمة، ثم الوكالة الهدف والمعرّف والقيمة. ويُقرأ الملف في متصفحك؛ فلا يُقرأ شيء من SAP ولا يُرسل شيء إلى أي مكان. وتعمل ورقة Message Mapping بالطريقة نفسها مع الـ mappings.
شرح السكربتات بكلمات بسيطة
يسرد شرح السكربتات في قائمة Kitegra كل خطوات سكربت Groovy في الـ iFlow. ويعرض لكل منها تعليق الملخص الذي كتبه المؤلف، والدوال التي يعرّفها، وما يقرؤه (الجسم، والترويسات، وخصائص التبادل، والمرفقات)، وما يضبطه ويغيّره، ومنطقه الرئيسي (تحليل XML أو JSON أو بناؤهما، والحلقات، والقرارات، واستدعاءات HTTP، والتواريخ)، وواجهات SAP البرمجية التي يستخدمها، مثل Security Material أو Value Mapping أو Partner Directory، والملاحظات والمخاطر. انقر اسم الخطوة لتحديدها على الرسم. ويُستخلص الشرح من نص السكربت داخل متصفحك؛ ولا يُرسل السكربت إلى أي مكان أبدًا.
أوقف أي أداة لا تستخدمها
صارت صفحة الخيارات تضم قسم الأدوات مع مفتاح لكل أداة، مطويًّا تحت وحدتها: من فحص XPath والترتيب وSecurity Material وExternalize ونسخ إعدادات الخطوات والاستيراد من Hub في Helper، مرورًا بالرسائل واختيار الـ runtime وعارض السجلات ومتابعة النشر، ومعلومات الـ iFlow وInspector والبحث، والمستندات وشرح السكربتات، وصولًا إلى الملاحظات والمقتطفات والمقارنة والتحويل والتوليد وHTTP Runner في Toolbox. وتختفي الأداة الموقوفة من المصمم ومن النافذة المنبثقة فورًا؛ وتبقى بياناتك، ويعيد تشغيل الكل كل شيء. ولإيقاف وحدة كاملة، استخدم "الوحدات" في الصفحة نفسها؛ اطّلع على صفحة الخيارات.
متابعة النشر، واختيار الـ runtime، وشرح السكربتات، وعرض فحوص التصميم مجانية. أما توثيق الحزمة والمشهد العام وورقة Value Mapping فتنتمي إلى iFlow Docs، مع عدد محدود من الاستخدامات في خطتي Free وStarter. وطوال فترة إطلاق Kitegra، تتاح كل الأدوات لكل من سجّل الدخول. قارن بين الخطط.
جرّبها في الـ iFlow التالي
تعرّف على ما يضيفه Kitegra حول مصمم SAP Integration Suite، أو على الأدوات الجديدة لكتابة iFlows.
الأسئلة الشائعة
هل ينشر Kitegra الـ iFlow الخاص بي؟
لا. أنت من يضغط Deploy في SAP؛ ومتابعة النشر تقرأ حالة النشر فقط وتخبرك عندما يصبح Started أو يفشل.
كيف أوثّق حزمة SAP CPI كاملة؟
افتح أي iFlow من الحزمة واختر "توثيق الحزمة" من قائمة Kitegra. فيقرأ كل iFlow ويفتح مستندًا واحدًا يضم رسم المشهد العام وجاهزية التوثيق، بصيغة Word أو PDF أو HTML.
هل يمكنني تصدير Value Mapping إلى Excel؟
نعم. نزّل ملف ZIP لـ Value Mapping من حزمته في SAP وارفعه في صفحة iFlow Docs. فتحصل على ورقة لكل زوج من الوكالة والمعرّف؛ ولا يغادر الملف متصفحك أبدًا.
لماذا لا أرى اختيار الـ runtime؟
لا يظهر إلا في المستأجرين الذين لديهم أكثر من runtime، مثل السحابة مع Edge Integration Cell.
إذا أوقفت أداة، هل تُحذف بياناتي؟
لا. تختفي الأداة من المصمم ومن النافذة المنبثقة، وتبقى بياناتها. أعد تشغيلها من قسم "الأدوات" في صفحة الخيارات.