Kitegra 2.0: SAP CPI کے لیے آٹو کمپلیٹ، میسج ٹریس، iFlow Inspector اور دستاویزات

SAP Integration Suite ڈیزائنر میں iFlow بنانے کا مطلب ہے اسے بار بار چھوڑنا: monitor پر جا کر دیکھنا کہ کسی message نے کیا کیا، mapping specification کے لیے spreadsheet کھولنا، endpoint کو call کرنے کے لیے کوئی اور ٹول، اور کسی ساتھی سے پوچھنا کہ نام رکھنے کا کون سا قاعدہ لاگو ہوتا ہے۔ Kitegra ایک Chrome اور Edge ایکسٹینشن ہے جو یہ کام اسی ڈایاگرام کے ساتھ لے آتی ہے جس میں آپ ترمیم کر رہے ہیں۔

ورژن 2.0 ایک ماڈیول سے بڑھ کر پانچ حصوں تک پہنچ گیا ہے۔ یہ مضمون بتاتا ہے کہ ہر حصہ کیا کرتا ہے، ایکسٹینشن آپ کے ٹیننٹ میں کیا اور کب تبدیل کرتی ہے، کیا محفوظ رکھتی اور sync کرتی ہے، اور ہر پلان کتنے iFlows کا احاطہ کرتا ہے۔ یہ Kitegra کی Chrome ایکسٹینشنز میں سے ایک ہے۔

iFlow ڈیزائنر کے گرد پانچ حصے

کوئی iFlow کھولیں تو ڈایاگرام toolbar میں Kitegra کا ایک باکس نظر آتا ہے، view اور edit دونوں modes میں۔ اس میں "پیغامات"، "لاگز" اور "iFlow معلومات" کا اپنا اپنا بٹن ہے؛ باقی ہر ٹول آخری بٹن کے پیچھے والے مینو میں ہے، اور Alt+Shift+P وہ مینو کی بورڈ سے کھولتا ہے۔ ہر ٹول ایک panel کھولتا ہے جسے آپ صفحے پر ادھر ادھر لے جا سکتے ہیں۔ یہ ٹولز پانچ حصوں سے تعلق رکھتے ہیں:

• Helper ‏(Integration Flow Helper): ڈیزائنر کے اپنے fields میں تجاویز اور جانچ کے ساتھ iFlows تیزی سے لکھیں۔
• Message Monitor: کھلے iFlow کے پیغامات، trace اور لاگز، ڈیزائنر کے اندر۔
• iFlow Inspector: ڈیپلائے شدہ iFlow کی تفصیلات، نام اور ڈیزائن کی جانچ، اور تلاش۔
• iFlow Docs: iFlow یا Message Mapping سے بننے والی دستاویزات۔
• Toolbox: payloads کا موازنہ، تبدیلی اور تیاری، snippets، نوٹس اور HTTP درخواستوں کے لیے مفت ٹولز۔

ہر حصہ "اختیارات" کے صفحے پر "ماڈیولز" کے تحت بند کیا جا سکتا ہے۔ ان کے ساتھ ورک اسپیس کی چند اضافی سہولتیں ٹیننٹ پر روزمرہ کام آسان بناتی ہیں: انوائرمنٹ بار، ٹیب برانڈنگ، monitoring links اور کی بورڈ شارٹ کٹس۔

Helper: iFlows تیزی سے لکھیں

ڈیزائنر کے کسی field میں ${ یا $ لکھیں تو ان ناموں کی فہرست کھلتی ہے جو iFlow کے اس مقام پر موزوں ہیں۔ Helper کا باقی حصہ آپ کے iFlow کے اسی ماڈل پر بنا ہے:

• تجاویز: وہ headers اور exchange properties جو آپ کا iFlow سیٹ کرتا ہے، SAP اور Camel کے standard headers، {{…}} parameters، variables، Data Stores، اور credential fields میں Security Material اور Keystore کے نام۔
• Expression کی جانچ: بند نہ کیے گئے expressions، فالتو spaces، ایسے headers جنہیں موجودہ step سے پہلے کچھ بھی سیٹ نہیں کرتا، اور OData کے وہ نام جو EDMX میں نہیں ہیں۔
• ذرائع: sample payload سے XPath paths، OpenAPI، Swagger یا Postman فائل سے URLs اور bodies، اور ProcessDirect اور JMS کے ذریعے بھیجے گئے headers۔
• ڈایاگرام ترتیب دیں: edit mode میں ایک کلک سے ڈایاگرام کو ترتیب دیتا ہے؛ Save اسے رکھتا ہے، اور ساتھ والا Undo بٹن اسے پہلے جیسا کر دیتا ہے۔

پچھلے چھ مضامین ان میں گہرائی سے جاتے ہیں، جن کا آغاز SAP CPI میں Camel Simple expressions سے ہوتا ہے۔

Message Monitor: دیکھیں کیا ہوا

• پیغامات: کھلے iFlow کے آخری پیغامات ڈایاگرام کے ساتھ ایک panel میں، status، وقت اور دورانیے کے ساتھ، اور SAP کا error "عام طور پر اس کا مطلب:" کے تحت سمجھایا گیا۔
• Trace: ایک سوئچ iFlow کا log level ‏TRACE پر سیٹ کرتا ہے اور آپ کے کام کے دوران اسے آن رکھتا ہے۔
• ڈایاگرام پر: trace شدہ message جن steps سے گزرا وہ ڈایاگرام پر رنگین ہو جاتے ہیں، اور کسی step پر کلک کرنے سے اس سے پہلے کی body، headers اور exchange properties نظر آتی ہیں۔
• پیغامات کے لاگز: Message ID یا Correlation ID سے تلاش والا log viewer، متعلقہ پیغامات کی ٹائم لائن، اور ڈایاگرام پر steps کا وقت۔

کسی message کو مرحلہ وار trace کرنا پورا flow دکھاتا ہے۔

iFlow Inspector اور iFlow Docs: ریویو اور دستاویزات

• نام رکھنا: آپ کی ٹیم کے طے کردہ قواعد، ہر step پر جانچے جاتے ہیں، تجویز کردہ نام اور "نام بدلیں" بٹن کے ساتھ۔
• ڈیزائن چیکس: error handling، سادہ متن میں خفیہ معلومات، غیر محفوظ protocols، script کے خطرات اور مزید، 0 سے 100 تک اسکور، بیس لائن، اور HTML، PDF یا Excel میں رپورٹ کے ساتھ۔ iFlow ریویو چیک لسٹ ان کی فہرست دیتی ہے۔
• iFlow معلومات: ڈیپلائمنٹ، اینڈپوائنٹس، Data Store اندراجات، ویری ایبلز اور ایڈٹ لاک، ضرورت پڑنے پر Undeploy، Unlock اور "حذف کریں" کے ساتھ۔
• iFlow میں، یا اس کے پورے package میں تلاش کریں۔
• iFlow سے بنی ڈیزائن دستاویز، Word، PDF یا HTML میں، ڈایاگرام اور ہر process کے بیانیے کے ساتھ، یا آپ کے اپنے Word ٹیمپلیٹ میں بھری ہوئی۔ ٹیکنیکل ڈیزائن دستاویز بنانا دیکھیں۔
• Message Mappings کے لیے Excel میں میپنگ شیٹ، اور scripts کی وضاحت۔

Toolbox اور ورک اسپیس

• پے لوڈ کا موازنہ، فارمیٹ کنورٹر، faults کے ساتھ ٹیسٹ پے لوڈ جنریٹر، Groovy snippets اور چیٹ شیٹ، اور ہر iFlow، ہر ٹیننٹ یا ہر جگہ کے لیے نوٹس۔
• آپ کے iFlow endpoints کے لیے HTTP Runner، Process Integration Runtime کی service key سے OAuth کے ساتھ۔
• ہر ٹیننٹ کے لیے انوائرمنٹ بار (PROD، TEST، DEV) اور ٹیب برانڈنگ، monitoring links، کی بورڈ شارٹ کٹس اور property pane کا سائز۔

انٹرفیس 15 زبانوں میں، light اور dark mode میں دستیاب ہے۔

شروع کیسے کریں، مرحلہ وار

1. Kitegra کو Chrome یا Microsoft Edge میں شامل کریں۔
2. اپنے ٹیننٹ پر SAP Integration Suite ڈیزائنر میں کوئی iFlow کھولیں (*.hana.ondemand.com والا address)۔
3. Content Modifier کی value جیسے کسی field میں کلک کریں اور ${ یا $ لکھیں؛ فہرست سے کوئی نام چنیں۔
4. ڈایاگرام toolbar کے Kitegra باکس میں "پیغامات"، "لاگز" یا "iFlow معلومات" پر کلک کریں، یا "انسپکٹر" اور باقی ٹولز کے لیے اس کا مینو کھولیں۔
5. اپنے ٹیننٹس، packages اور iFlows کے لیے، اور Toolbox کے صفحات والے "ٹولز" view کے لیے ایکسٹینشن کا popup کھولیں۔

اکاؤنٹ کے بغیر آپ ہر ماڈیول 5 iFlows پر استعمال کر سکتے ہیں۔ زیادہ پر استعمال کرنے کے لیے ایکسٹینشن میں Kitegra سے سائن اِن کریں چنیں۔

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

Kitegra کو Kitegra کی دوسری Chrome ایکسٹینشنز کے ساتھ دیکھیں، اور موازنہ کریں کہ ہر پلان میں کیا شامل ہے۔

یہ آپ کے ٹیننٹ میں کیا تبدیل کرتی ہے، اور کب

ایکسٹینشن کھلا iFlow، اس کے پیغامات اور لاگز آپ کے اپنے SAP session سے پڑھتی ہے۔ یہ کبھی کسی iFlow کا مواد محفوظ، ڈپلائے یا ایڈٹ نہیں کرتی: نام بدلنا اور snippets صرف ڈیزائنر کے fields میں لکھتے ہیں، اور محفوظ آپ کرتے ہیں۔ یہ آپ کا ٹیننٹ صرف تب تبدیل کرتی ہے جب آپ چار نامزد اقدامات میں سے کسی ایک پر کلک کریں:

"اختیارات" کے صفحے پر ایک سوئچ، "tenant بدلنے والے اقدامات کی اجازت دیں"، چاروں کو بند کر دیتا ہے: ان کے بٹن غائب ہو جاتے ہیں، اور ایکسٹینشن انہیں چلانے سے انکار کرتی ہے۔ HTTP Runner صرف وہی requests بھیجتا ہے جو آپ خود لکھتے اور بھیجتے ہیں۔

یہ کیا رکھتی ہے، اور کیا sync ہوتا ہے

• Message کا مواد (bodies، headers، properties، attachments اور لاگز) صفحے میں دکھایا جاتا ہے، کبھی محفوظ نہیں ہوتا اور نہ کہیں بھیجا جاتا ہے۔
• Kitegra اکاؤنٹ کے بغیر آپ کے براؤزر سے کچھ باہر نہیں جاتا۔
• سائن اِن ہونے پر Kitegra آپ کے کھولے گئے ہر iFlow کے لیے اس کا نام اور ID، اس کا package، ڈیزائنر کا link، استعمال شدہ ماڈیولز، تاریخیں اور آپ کے SAP اکاؤنٹ کا one-way hash رکھتا ہے، تاکہ آپ کے پلان کے iFlows گنے جا سکیں۔
• سائن اِن ہونے پر آپ کا لکھا ہوا ہر کمپیوٹر پر آپ کے ساتھ جاتا ہے: سیٹنگز اور شارٹ کٹس، نوٹس، نام رکھنے کے قواعد، ڈیزائن چیک کی سیٹنگز اور بیس لائنز، ٹیننٹ برانڈنگ، snippets، اور HTTP Runner کے collections، ہر auth value اور خفیہ variable ہٹا کر۔ "اختیارات" کے صفحے پر Kitegra ڈیش بورڈ کا سوئچ آن ہو (جو پہلے سے آن ہوتا ہے) تو آپ کے packages اور iFlows کے نام اور IDs بھی بھیجے جاتے ہیں، اور ٹیم پلان پر ٹیم کا مالک انہیں اور آپ کے نوٹس دیکھ سکتا ہے۔
• کبھی نہیں بھیجا جاتا: message کا مواد، scripts، mappings، sample payloads، API specifications، credentials اور secrets۔ اختیارات › ہم آہنگی میں "ہم آہنگ ڈیٹا حذف کریں" وہ سب Kitegra سے ہٹا دیتا ہے جو sync ہوا تھا۔

ہر پلان کتنے iFlows کا احاطہ کرتا ہے

حد منفرد iFlows کو، ہر ماڈیول کے لیے، ہمیشہ کے لیے گنتی ہے: جو iFlow آپ پہلے استعمال کر چکے ہیں اسے دوبارہ کھولنا دوبارہ نہیں گنا جاتا، اور ایک ماڈیول کا استعمال کیا گیا iFlow دوسرا ماڈیول تبھی گنتا ہے جب آپ وہ ماڈیول اس پر استعمال کریں۔

Helper، Message Monitor، iFlow Inspector اور iFlow Docs، iFlows گنتے ہیں؛ Toolbox اور ورک اسپیس کی اضافی سہولتیں کچھ نہیں گنتیں۔ جو iFlow آپ کے پلان کی حد سے باہر ہو، اس پر ڈیزائنر اور popup میں تالے کا نشان دکھتا ہے۔ Kitegra کے لانچ کے دوران، سائن اِن کرنے والے ہر شخص کے لیے ہر ٹول کھلا ہے، Free پلان پر بھی۔ جب آپ Kitegra سے سائن اِن کرتے ہیں تو اکاؤنٹ کے بغیر استعمال کیے گئے iFlows آپ کے اکاؤنٹ میں منتقل ہو جاتے ہیں۔ پلانز کا موازنہ کریں۔

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