تتبّع رسالة SAP CPI خطوة بخطوة دون مغادرة مصمم iFlow

عندما يُرجع iFlow نتيجة خاطئة، يكون السؤال نفسه تقريبًا في كل مرة: كيف كانت الرسالة قبل الخطوة التي أخطأت مباشرة؟ يستطيع SAP Cloud Integration (SAP CPI) الإجابة، لكن فقط عن الرسائل التي عولجت بمستوى السجل TRACE، والإجابة موجودة في شاشة المراقبة، على بُعد عدة شاشات من الرسم الذي تعدّله.

يشرح هذا المقال ما يسجّله التتبّع (trace)، وكيف تقرؤه في شاشة المراقبة الخاصة بـ SAP، وكيف تتابع التتبّع نفسه على الرسم، خطوة بخطوة، باستخدام Kitegra.

ما الذي يسجّله التتبّع

تترك كل رسالة سجل معالجة الرسالة (MPL): حالتها، وبدايتها ونهايتها، والخطوات التي نفّذتها. ويحدد مستوى السجل في الـ iFlow مقدار التفاصيل التي تدخل فيه.

محتوى التتبّع مخصص للتحقيق، لا للأرشفة. يحتفظ به SAP لمدة ساعة تقريبًا، ويعود مستوى TRACE نفسه إلى مستوى أدنى بعد نحو 10 دقائق، لذا يجب أن تُنفَّذ الرسالة التي تريد قراءتها بعد ضبط TRACE بوقت قصير. ولأنه يخزّن حمولات حقيقية في المستأجر، فاستخدمه على بيانات اختبار حيثما أمكن، والتزم بقواعد شركتك في بيئة الإنتاج. ويشرح مقال لماذا يتوقف TRACE من تلقاء نفسه هذه الحدود.

قراءة التتبّع في شاشة المراقبة الخاصة بـ SAP

1. في شاشة المراقبة، افتح Manage Integration Content، واختر الـ iFlow المنشور، واضبط مستوى السجل فيه على Trace.
2. أرسل الرسالة مرة أخرى خلال الدقائق القليلة التالية.
3. افتح الرسالة في Monitor Message Processing واتبع رابط التتبّع الخاص بها إلى تشغيل معالجة الرسالة.
4. اختر خطوة على رسم التشغيل وافتح محتوى الرسالة فيها: الترويسات والخصائص والحمولة.

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

شغّل TRACE من المصمم

باستخدام Kitegra، افتح الـ iFlow في المصمم، وانقر زر "Kitegra" في شريط أدوات الرسم واختر "الرسائل" (أو اضغط Alt+Shift+M). تسرد اللوحة آخر رسائل الـ iFlow على بيئة التشغيل التي تختارها، مجمّعة حسب اليوم، مع الحالة ووقت البدء والمدة. وتحمل الرسائل المتتبَّعة علامة TRACE، وتومض الرسائل الجديدة عند وصولها.

يظهر المفتاح في اللوحة بعبارة "Trace: متوقف". نقرة واحدة تضبط مستوى السجل في الـ iFlow على TRACE، فيعرض المفتاح "Trace: يعمل" مع عدد الدقائق. وما دام يعمل وأنت تعمل في الـ iFlow، تعيد الإضافة ضبط TRACE قبل أن يُسقطه SAP؛ وتتوقف عن التجديد بعد 20 دقيقة من آخر نشاط لك. والإيقاف يعيد مستوى السجل الذي كان عليه الـ iFlow من قبل.

Trace واحد من الإجراءات الأربعة التي تغيّر المستأجر، ومثل البقية لا يُنفَّذ إلا عندما تنقره.

تابع الرسالة على الرسم

1. أرسل الرسالة، أو انتظر الرسالة التالية. ستظهر في أعلى لوحة "الرسائل".
2. على رسالة متتبَّعة، اختر "على الرسم". تُلوَّن الخطوات التي مرّت بها، وتُعلَّم الخطوة الفاشلة، وتُعتَّم الخطوات التي لم تصل إليها.
3. انقر خطوة ملوّنة. تعرض لوحة "المحتوى قبل الخطوة" كلًّا من Body و"الـ Headers" و"الـ Exchange properties" كما كانت قبل تلك الخطوة، و"السجل" الخاص بالخطوة، و"الخطأ" عندما تفشل الخطوة.
4. استخدم "السابق" و"التالي" للتنقل بين الخطوات بالترتيب الذي نُفّذت به. والخطوة التي نُفّذت أكثر من مرة، في Splitter أو في حلقة، تعرض كل تشغيل، مثل "التشغيل 2 من 3 لهذه الخطوة".
5. عند الانتهاء، اختر "مسح علامات الرسم".

إذا نُفّذت الرسالة دون TRACE، تخبرك اللوحة بذلك: يحتفظ SAP بجسم الرسالة وترويساتها فقط عندما تُنفَّذ بمستوى TRACE، ولمدة ساعة تقريبًا فقط.

اعمل بما تجده

• يعرض عارض الحمولة الجسم "منسّق" أو في "سطر واحد"، ويتيح "التفاف الأسطر" و"بحث"، و"نسخ" أو "تنزيل".
• يفتح "قارن مع الخطوة التالية" جسمين جنبًا إلى جنب في "مقارنة الرسائل"، فترى بالضبط ما غيّرته الخطوة.
• يلوّن "التوقيت" الخطوات حسب مدتها، من الأسرع (الأخضر) إلى الأبطأ (الأحمر)؛ مرّر المؤشر فوق خطوة لترى وقتها.
• في التشغيل الطويل، يحدد "الخطوات المقروءة" عدد الخطوات التي تُقرأ لذلك الـ iFlow، أو "الكل".
• للرسالة الفاشلة، يذكر تبويب "الملخص" مكان الفشل، وللأخطاء المعروفة "ما يعنيه عادةً:".

لفتح رسالة تعرف معرّفها، من هذا الـ iFlow أو من أي iFlow آخر في المستأجر، اطّلع على العثور على رسالة SAP CPI بـ Message ID أو Correlation ID.

كيف يساعدك Kitegra

Message Monitor أحد المجالات الخمسة في Kitegra. ومحتوى التتبّع بيانات خاصة بالعميل: تعرضه الإضافة في الصفحة وتتيح لك تنزيل الجسم، لكنها لا تخزّنه ولا تزامنه ولا ترسله إلى Kitegra أبدًا.

تحتسب كلٌّ من Helper وMessage Monitor وiFlow Inspector وiFlow Docs عدد iFlows التي تستخدمها عليها: 5 لكل وحدة بلا حساب، و50 في خطة Free، و100 في خطة Starter، و300 في خطة Pro، أما خطة Business فبلا حد. ويأتي Toolbox وميزات مساحة العمل الإضافية مجانًا. قارن بين الخطط.

جرّبها في الـ iFlow التالي

تعرّف على ما يضيفه Kitegra حول مصمم SAP Integration Suite، أو اطّلع عليه مع بقية وحدات Kitegra.

الأسئلة الشائعة