SAP CPI میں کسی message کو iFlow ڈیزائنر چھوڑے بغیر مرحلہ وار trace کریں

جب کوئی iFlow غلط نتیجہ دیتا ہے تو سوال تقریباً ہمیشہ ایک ہی ہوتا ہے: غلطی والے step سے عین پہلے message کیسا تھا؟ SAP Cloud Integration (SAP CPI) اس کا جواب دے سکتا ہے، لیکن صرف ان پیغامات کے لیے جو log level ‏TRACE کے ساتھ process ہوئے ہوں، اور جواب monitor میں ہوتا ہے، اس ڈایاگرام سے کئی screens دور جس میں آپ ترمیم کر رہے ہیں۔

یہ مضمون بتاتا ہے کہ trace کیا ریکارڈ کرتا ہے، اسے SAP کے اپنے monitor میں کیسے پڑھیں، اور Kitegra کے ساتھ اسی trace کو ڈایاگرام پر، step بہ step، کیسے دیکھیں۔

Trace کیا ریکارڈ کرتا ہے

ہر message ایک message processing log ‏(MPL) چھوڑتا ہے: اس کا status، اس کا آغاز اور اختتام، اور وہ steps جو اس نے چلائے۔ iFlow کا log level طے کرتا ہے کہ اس میں کتنی تفصیل جائے۔

Trace کا مواد تفتیش کے لیے ہے، archive کرنے کے لیے نہیں۔ SAP اسے تقریباً ایک گھنٹہ رکھتا ہے، اور TRACE level خود تقریباً 10 منٹ بعد واپس نیچے چلا جاتا ہے، اس لیے جس message کو آپ پڑھنا چاہتے ہیں اسے TRACE سیٹ ہونے کے کچھ ہی دیر بعد چلنا چاہیے۔ چونکہ یہ ٹیننٹ میں اصل payloads محفوظ کرتا ہے، جہاں ممکن ہو اسے test data پر استعمال کریں، اور production میں اپنی کمپنی کے قواعد پر عمل کریں۔ TRACE خود کیوں بند ہو جاتا ہے ان حدود کی وضاحت کرتا ہے۔

SAP کے monitor میں trace پڑھنا

1. Monitor میں Manage Integration Content کھولیں، ڈپلائے شدہ iFlow منتخب کریں اور اس کا log level ‏Trace پر سیٹ کریں۔
2. اگلے چند منٹوں میں message دوبارہ بھیجیں۔
3. Monitor Message Processing میں message کھولیں اور اس کے trace link سے message processing run تک جائیں۔
4. Run کے ڈایاگرام پر کوئی step منتخب کریں اور اس کا message content کھولیں: headers، properties اور payload۔

یہ کام کرتا ہے، لیکن ہر step دیکھنے میں چند کلک لگتے ہیں، run کا ڈایاگرام وہ نہیں جس میں آپ ترمیم کر رہے ہیں، اور 10 منٹ بعد log level دوبارہ سیٹ کرنا پڑتا ہے۔

ڈیزائنر سے TRACE آن کریں

Kitegra کے ساتھ iFlow کو ڈیزائنر میں کھولیں، ڈایاگرام toolbar میں "Kitegra ٹولز" بٹن پر کلک کریں اور "پیغامات" چنیں (یا Alt+Shift+M دبائیں)۔ Panel آپ کے منتخب کردہ runtime پر iFlow کے آخری پیغامات دکھاتا ہے، دن کے حساب سے گروپ کیے ہوئے، status، آغاز کے وقت اور دورانیے کے ساتھ۔ Trace شدہ پیغامات پر TRACE کا نشان ہوتا ہے، اور نئے پیغامات آنے پر چمکتے ہیں۔

Panel کے سوئچ پر "Trace: بند" لکھا ہوتا ہے۔ ایک کلک iFlow کا log level ‏TRACE پر سیٹ کرتا ہے، اور سوئچ منٹوں کی گنتی کے ساتھ "Trace: آن" دکھاتا ہے۔ جب تک یہ آن ہے اور آپ iFlow میں کام کر رہے ہیں، ایکسٹینشن SAP کے ہٹانے سے پہلے TRACE دوبارہ سیٹ کر دیتی ہے؛ آپ کی آخری سرگرمی کے 20 منٹ بعد یہ تجدید روک دیتی ہے۔ بند کرنے سے وہ log level واپس آ جاتا ہے جو iFlow کا پہلے تھا۔

Trace ان چار اقدامات میں سے ایک ہے جو آپ کا ٹیننٹ تبدیل کرتے ہیں، اور باقیوں کی طرح صرف آپ کے کلک پر چلتا ہے۔

ڈایاگرام پر message کو follow کریں

1. Message بھیجیں، یا اگلے کا انتظار کریں۔ یہ "پیغامات" panel میں سب سے اوپر نظر آتا ہے۔
2. کسی trace شدہ message پر "ڈایاگرام پر" چنیں۔ جن steps سے یہ گزرا وہ رنگین ہو جاتے ہیں، ناکام step پر نشان لگتا ہے، اور جن steps تک یہ نہیں پہنچا وہ مدھم ہو جاتے ہیں۔
3. کسی رنگین step پر کلک کریں۔ "اسٹیپ سے پہلے کا مواد" panel اس step سے پہلے کی Body، Headers اور Exchange properties دکھاتا ہے، step کا "لاگ"، اور step ناکام ہونے پر "خرابی"۔
4. "پچھلا" اور "اگلا" سے steps کو اسی ترتیب میں دیکھیں جس میں وہ چلے۔ جو step ایک سے زیادہ بار چلا، Splitter یا loop میں، وہ ہر run دکھاتا ہے، مثلاً "اس اسٹیپ کا 3 میں سے 2 رن"۔
5. کام ختم ہونے پر "ڈایاگرام کے نشانات صاف کریں" چنیں۔

اگر message بغیر TRACE کے چلا تو panel یہ بتا دیتا ہے: SAP کسی message کی body اور headers صرف تب رکھتا ہے جب وہ TRACE کے ساتھ چلے، اور صرف تقریباً ایک گھنٹے کے لیے۔

جو ملے اس کے ساتھ کام کریں

• Payload viewer کسی body کو "منظم" یا "ایک سطر" میں دکھاتا ہے، "سطریں لپیٹیں" اور "تلاش" کی سہولت دیتا ہے، اور آپ اسے "کاپی" یا "ڈاؤن لوڈ" کر سکتے ہیں۔
• "اگلے اسٹیپ سے موازنہ کریں" دو bodies کو "پے لوڈ کا موازنہ" میں ساتھ ساتھ کھولتا ہے، تاکہ آپ بالکل دیکھ سکیں کہ کسی step نے کیا بدلا۔
• "وقت" steps کو ان کے دورانیے کے مطابق رنگتا ہے، تیز ترین (سبز) سے سست ترین (سرخ) تک؛ وقت دیکھنے کے لیے step پر ماؤس لے جائیں۔
• لمبے run پر "پڑھے گئے اسٹیپس" طے کرتا ہے کہ اس iFlow کے لیے کتنے steps پڑھے جائیں، یا "سب"۔
• ناکام message کے لیے "خلاصہ" ٹیب بتاتا ہے کہ وہ کہاں ناکام ہوا اور، معلوم errors کے لیے، "عام طور پر اس کا مطلب:"۔

کسی ایسے message کو کھولنے کے لیے جس کی ID آپ جانتے ہیں، اس یا ٹیننٹ کے کسی بھی دوسرے iFlow سے، Message ID یا Correlation ID سے SAP CPI message تلاش کرنا دیکھیں۔

Kitegra کیسے مدد کرتا ہے

Message Monitor، Kitegra کے پانچ حصوں میں سے ایک ہے۔ Trace کا مواد گاہک کا ڈیٹا ہے: ایکسٹینشن اسے صفحے میں دکھاتی ہے اور آپ کو body ڈاؤن لوڈ کرنے دیتی ہے، لیکن اسے کبھی محفوظ، sync یا Kitegra کو نہیں بھیجتی۔

Helper، Message Monitor، iFlow Inspector اور iFlow Docs میں سے ہر ایک ان iFlows کو گنتا ہے جن پر آپ اسے استعمال کرتے ہیں: Kitegra اکاؤنٹ کے بغیر ہر ماڈیول میں 5، Free پلان پر 50، Starter پر 100 اور Pro پر 300؛ Business میں کوئی حد نہیں۔ Toolbox اور ورک اسپیس کی اضافی سہولتیں مفت ہیں۔ پلانز کا موازنہ کریں۔

اپنے اگلے iFlow میں آزمائیں

پڑھیں کہ Kitegra، SAP Integration Suite ڈیزائنر کے ارد گرد کیا اضافہ کرتا ہے، یا اسے Kitegra کی دوسری Chrome ایکسٹینشنز کے ساتھ دیکھیں۔

اکثر پوچھے جانے والے سوالات