اس مضمون کا ماڈیول: iFlow Docs
SAP CPI میں Deploy کے بعد: ڈپلائے نگرانی، پیکج کی دستاویزات، لینڈ اسکیپ اور Excel میں Value Mapping
دیکھیں کہ iFlow کب Started ہوا یا کیوں ناکام رہا، Cloud یا Edge رن ٹائم چنیں، نئے ڈیزائن چیکس چلائیں، پورے پیکج کی اس کے landscape کے ساتھ دستاویز بنائیں، Value Mappings کو Excel میں export کریں اور کوئی بھی ٹول بند کریں۔
SAP Cloud Integration (SAP CPI) میں Deploy دبانے سے انتظار شروع ہو جاتا ہے: Monitor پر جائیں، iFlow ڈھونڈیں، تب تک refresh کرتے رہیں جب تک Started یا Error نہ آ جائے، پھر سمجھیں کہ خرابی کا مطلب کیا ہے۔ اور جب کوئی interface مکمل ہو جائے تو بھی کوئی نہ کوئی دستاویز، landscape کی تصویر اور spreadsheet میں Value Mapping مانگتا ہے۔
Kitegra اب SAP Integration Suite ڈیزائنر کے ساتھ کام کا یہ حصہ بھی سنبھالتا ہے: ٹیسٹ کال کے ساتھ ڈپلائے نگرانی، Edge Integration Cell والے ٹیننٹس کے لیے رن ٹائم کا انتخاب، نئے ڈیزائن چیکس، landscape ڈایاگرام اور دستاویزات کی تیاری کے ساتھ پیکج کی دستاویز، Excel میں Value Mapping شیٹ، اور Groovy scripts کی آسان الفاظ میں وضاحت۔ ہر ٹول کو الگ سے بند کیا جا سکتا ہے۔ یہ مضمون ان سب کا جائزہ لیتا ہے۔
ڈپلائے نگرانی: iFlow چھوڑے بغیر Started یا Error
ڈیزائنر میں ہمیشہ کی طرح Deploy دبائیں اور SAP کے dialog کی تصدیق کریں۔ ایک ڈیپلائمنٹ اطلاع "ڈیپلائے ہو رہا ہے…" اور گزرے وقت کے ساتھ نظر آتی ہے، اور آپ کام جاری رکھتے ہیں۔ Kitegra تین سیکنڈ بعد SAP سے state پوچھتا ہے، پھر وقفے بڑھاتا جاتا ہے، زیادہ سے زیادہ ہر 20 سیکنڈ بعد۔ SAP کے جواب دینے پر اطلاع یہ بن جاتی ہے:
- Started، deploy شدہ ورژن کے ساتھ۔ اگر iFlow کا HTTP endpoint ہو تو ٹیسٹ کال بھیجیں تیار request کے ساتھ HTTP Runner کھولتا ہے، اور تازہ ترین پیغام دکھائیں پیغامات کا پینل تازہ کھولتا ہے۔
- خرابی، SAP کے error text کے ساتھ، اور جب یہ کوئی معلوم صورت ہو تو اس کا عام مطلب بھی: کوئی دوسرا deploy شدہ iFlow پہلے سے یہ sender address استعمال کر رہا ہے، کوئی script compile نہیں ہو رہا، کسی externalized parameter کی کوئی قدر نہیں، یا SAP، iFlow کو build نہیں کر سکا۔ SAP میں ڈیپلائے شدہ مواد کھولیں آپ کو تفصیلات تک لے جاتا ہے۔
- دس منٹ بعد ابھی بھی ڈیپلائے ہو رہا ہے، SAP میں deploy شدہ مواد کی طرف اشارے کے ساتھ۔
اگر آپ SAP کا Deploy dialog منسوخ کر دیں تو کسی چیز کی نگرانی نہیں ہوتی۔ نگرانی صرف deployment state پڑھتی ہے؛ deploy کرنا SAP کا کام ہے، جو آپ کے اپنے کلک سے شروع ہوتا ہے۔ اس کے بعد iFlow میں کسی message کو مرحلہ وار دیکھنا message کو مرحلہ وار trace کرنا میں بیان ہے، اور خود call service key سے HTTPS iFlow کی جانچ میں۔
رن ٹائم کا انتخاب: Cloud یا Edge
Edge Integration Cell والا ٹیننٹ iFlows کو ایک سے زیادہ رن ٹائم پر چلاتا ہے۔ صرف ایسے ٹیننٹ پر Kitegra باکس میں رن ٹائم: Cloud (یا Edge رن ٹائم کا نام) دکھتا ہے۔ وہاں رن ٹائم چنیں، اور Message Monitor اس iFlow کے messages اسی رن ٹائم سے پڑھتا ہے اور log level بھی وہیں set کرتا ہے۔ انتخاب یہ بھی دکھاتا ہے کہ ہر رن ٹائم پر iFlow deploy ہے یا نہیں، اور کون سا ورژن۔ ایک رن ٹائم والے ٹیننٹس پر یہ کبھی نظر نہیں آتا۔
iFlow Inspector میں نئے ڈیزائن چیکس
iFlow review checklist میں پانچ نئے چیکس شامل ہوئے ہیں، ایک نئی Documentation category کے ساتھ:
| چیک | یہ کیوں اہم ہے |
|---|---|
| بغیر address کا receiver (error) | iFlow deploy ہو جاتا ہے، لیکن اس receiver کو ہر call رن ٹائم پر fail ہو جاتی ہے۔ |
| ڈیفالٹ address والا HTTPS sender (warning) | خالی، / یا /test جیسا placeholder address، callers کو کچھ نہیں بتاتا، اور دو iFlows اس پر ٹکرا سکتے ہیں۔ |
| HTTPS sender کو CSRF token درکار ہے (info) | ہر caller کو پہلے X-CSRF-Token لینا ہوگا، ورنہ اس کی POST کو 403 ملتا ہے۔ |
| receiver address، iFlow میں لکھا ہوا (info) | DEV، QA اور PROD کے درمیان منتقلی کا مطلب iFlow میں ترمیم ہے؛ Externalize Parameters اسے ایک قدم میں ٹھیک کرتا ہے۔ |
| participant کا نام ابھی بھی ڈیفالٹ ہے (info، Documentation) | "Sender" اور "Receiver" monitoring میں بھی دکھتے ہیں، اس لیے کوئی نہیں بتا سکتا کہ کون سا سسٹم مراد ہے۔ |
دوسرے چیکس کی طرح یہ بھی score میں گنے جاتے ہیں اور ایک ایک کر کے بند کیے جا سکتے ہیں۔ انہیں دیکھنا مفت ہے؛ رپورٹ export کرنا Pro کا حصہ ہے۔ Externalize Parameters اور Helper کے دوسرے نئے ٹولز Externalize Parameters، اسٹیپ کاپی اور Hub امپورٹ میں بیان کیے گئے ہیں۔
پورے پیکج کے لیے ایک دستاویز
اس iFlow کی دستاویز بنائیں کے ساتھ اب Kitegra مینو میں پیکج کی دستاویز بھی ہے۔ یہ کھلے iFlow کے پیکج کا ہر iFlow ایک ایک کر کے پڑھتا ہے ("5 میں سے iFlow نمبر 2 پڑھا جا رہا ہے…")، اور آپ اسے روک کر اب تک پڑھا گیا مواد کھول سکتے ہیں۔ جو iFlows پڑھے نہ جا سکے ان کی فہرست دی جاتی ہے۔ دستاویز نئے ٹیب میں کھلتی ہے، Word، PDF یا HTML میں، یا آپ کے اپنے Word ٹیمپلیٹ میں بھری ہوئی، بالکل ایک iFlow کی technical design document کی طرح۔ اس میں پیکج کا ورژن، وینڈر، ٹیگز اور iFlows کی تعداد ہوتی ہے، پھر ہر iFlow، اور دو نئے حصے:
- سسٹم لینڈ اسکیپ: ایک ڈایاگرام جس میں بائیں طرف senders، درمیان میں پیکج کے iFlows اور دائیں طرف receivers ہیں۔ ایک جیسے نام والے participants ایک باکس بن جاتے ہیں، اور ہر لکیر پر اس کے اڈاپٹر کی اقسام لکھی ہوتی ہیں۔
- دستاویزات کی تیاری: قاری کو جو چاہیے، ایک ایک کر کے جانچا گیا: پیکج کی تفصیل اور ٹیگز، ہر iFlow کی تفصیل، Sender اور Receiver سے بدلے گئے participants کے نام، اور externalized receiver addresses۔ یہ دکھاتا ہے کہ کتنے چیکس کامیاب رہے اور کیا کمی ہے، تاکہ حوالے کرنے سے پہلے آپ خلا پُر کر سکیں۔
Excel میں Value Mapping
iFlow Docs صفحے پر Value Mappings کے تحت Value Mapping کی ZIP (SAP میں اس کے پیکج سے ڈاؤن لوڈ کریں) یا اس کی value_mapping.xml اپ لوڈ کریں۔ Kitegra قدروں کی فہرست بناتا ہے اور ایک Excel workbook لکھتا ہے جس میں ہر agency اور identifier جوڑے کے لیے ایک شیٹ ہوتی ہے: سورس agency، identifier اور قدر، پھر ٹارگٹ agency، identifier اور قدر۔ فائل آپ کے براؤزر میں پڑھی جاتی ہے؛ SAP سے کچھ نہیں پڑھا جاتا اور کچھ کہیں نہیں بھیجا جاتا۔ mappings کے لیے Message Mapping شیٹ بھی اسی طرح کام کرتی ہے۔
Scripts کی آسان الفاظ میں وضاحت
Kitegra مینو میں اسکرپٹس کی وضاحت، iFlow کے ہر Groovy script اسٹیپ کی فہرست دیتا ہے۔ ہر ایک کے لیے یہ دکھاتا ہے: مصنف کا خلاصہ تبصرہ، اس میں define کیے گئے functions، یہ کیا پڑھتا ہے (body، headers، exchange properties، attachments)، کیا set کرتا اور بدلتا ہے، اس کی بنیادی logic (XML یا JSON کو parse کرنا یا بنانا، loops، فیصلے، HTTP calls، تاریخیں)، اس میں استعمال ہونے والے SAP APIs، جیسے Security Material، Value Mapping یا Partner Directory، اور نوٹس اور خطرات۔ کسی اسٹیپ کے نام پر کلک کریں تو وہ ڈایاگرام پر منتخب ہو جاتا ہے۔ وضاحت script کے text سے آپ کے براؤزر میں تیار کی جاتی ہے؛ script کبھی کہیں نہیں بھیجا جاتا۔
جو ٹول آپ استعمال نہیں کرتے اسے بند کریں
"اختیارات" کے صفحے پر اب ایک ٹولز سیکشن ہے جس میں ہر ٹول کا اپنا سوئچ ہے، اس کے ماڈیول کے تحت ترتیب سے: Helper میں XPath جانچ، ترتیب، Security Material، Externalize، اسٹیپ کاپی اور Hub امپورٹ سے لے کر، پیغامات، رن ٹائم کا انتخاب، لاگ ویور اور ڈپلائے نگرانی، iFlow info، Inspector اور تلاش، دستاویزات اور اسکرپٹس کی وضاحت، اور Toolbox میں نوٹس، Snippets، Compare، Convert، Generate اور HTTP Runner تک۔ بند کیا گیا ٹول فوراً ڈیزائنر اور popup سے ہٹ جاتا ہے؛ آپ کا ڈیٹا محفوظ رہتا ہے، اور سب آن کریں سب کچھ واپس لے آتا ہے۔ پورا ماڈیول بند کرنے کے لیے اسی صفحے پر ماڈیولز استعمال کریں؛ دیکھیں اختیارات کا صفحہ۔
ڈپلائے نگرانی، رن ٹائم کا انتخاب، اسکرپٹس کی وضاحت اور ڈیزائن چیکس دیکھنا مفت ہیں۔ پیکج کی دستاویز، سسٹم لینڈ اسکیپ اور Value Mapping شیٹ، iFlow Docs کا حصہ ہیں، Free اور Starter پر چند بار استعمال کے ساتھ۔ Kitegra کے لانچ کے دوران، سائن اِن کرنے والے ہر شخص کے لیے ہر ٹول کھلا ہے۔ پلانز کا موازنہ کریں۔
اپنے اگلے iFlow میں آزمائیں
پڑھیں کہ Kitegra، SAP Integration Suite ڈیزائنر کے ارد گرد کیا اضافہ کرتا ہے، یا iFlows لکھنے کے نئے ٹولز دیکھیں۔
اکثر پوچھے جانے والے سوالات
کیا Kitegra میرا iFlow deploy کرتا ہے؟
نہیں۔ Deploy آپ SAP میں دباتے ہیں؛ ڈپلائے نگرانی صرف deployment state پڑھتی ہے اور بتاتی ہے کہ iFlow کب Started ہوا یا ناکام رہا۔
میں SAP CPI کے پورے پیکج کی دستاویز کیسے بناؤں؟
پیکج کا کوئی بھی iFlow کھولیں اور Kitegra مینو میں پیکج کی دستاویز چنیں۔ یہ ہر iFlow پڑھتا ہے اور landscape ڈایاگرام اور دستاویزات کی تیاری کے ساتھ ایک دستاویز کھولتا ہے، Word، PDF یا HTML میں۔
کیا میں Value Mapping کو Excel میں export کر سکتا ہوں؟
جی ہاں۔ SAP میں Value Mapping کے پیکج سے اس کی ZIP ڈاؤن لوڈ کریں اور iFlow Docs صفحے پر اپ لوڈ کریں۔ آپ کو ہر agency اور identifier جوڑے کے لیے ایک شیٹ ملتی ہے؛ فائل کبھی آپ کے براؤزر سے باہر نہیں جاتی۔
مجھے رن ٹائم کا انتخاب کیوں نظر نہیں آتا؟
یہ صرف ایک سے زیادہ رن ٹائم والے ٹیننٹس پر ظاہر ہوتا ہے، جیسے Cloud کے ساتھ Edge Integration Cell۔
اگر میں کوئی ٹول بند کر دوں تو کیا میرا ڈیٹا حذف ہو جاتا ہے؟
نہیں۔ ٹول ڈیزائنر اور popup سے ہٹ جاتا ہے، اور اس کا ڈیٹا محفوظ رہتا ہے۔ اسے "اختیارات" کے صفحے کے ٹولز سیکشن میں دوبارہ آن کریں۔