SAP CPI Message Mapping کی دستاویزات: ایک کلک میں Excel میپنگ شیٹ

Mapping specification عموماً کسی interface کی پہلی دستاویز ہوتی ہے اور سب سے پہلے پرانی ہونے والی بھی۔ SAP Cloud Integration (SAP CPI) میں Message Mapping، build اور tests کے دوران بدلتی رہتی ہے، اور اسے بیان کرنے والی spreadsheet وہیں کی وہیں رہتی ہے۔

یہ مضمون بتاتا ہے کہ میپنگ شیٹ کو کن columns کی ضرورت ہے، functions، contexts اور value mappings کو کیسے بیان کریں تاکہ پڑھنے والا انہیں سمجھ سکے، اور شیٹ کو خود mapping سے کیسے export کریں۔

Mapping specifications اصل سے دور کیوں ہو جاتی ہیں

Mapping specification، mapping کے وجود سے پہلے، کسی ایسے شخص کے ہاتھوں لکھی جاتی ہے جو business fields جانتا ہے۔ پھر developer کو پتا چلتا ہے کہ کسی field کو context change چاہیے، کسی تاریخ کو دوسرا format، اور کسی code کو value mapping۔ ان میں سے ہر فیصلہ mapping editor کے graphical view میں رہتا ہے، اور ان میں سے کم ہی شیٹ تک واپس پہنچتے ہیں۔

میپنگ شیٹ کو کن columns کی ضرورت ہے

Functions، contexts اور value mappings کو بیان کرنا

• قاعدے کو جملے کی صورت میں لکھیں: "FirstName اور LastName کو درمیان میں space کے ساتھ جوڑتا ہے" functions کے ناموں کی فہرست سے زیادہ آسانی سے جانچا جا سکتا ہے۔
• جب context بدلے تو اس کا نام لیں۔ جو field ہر item کے لیے ایک بار بھرا جائے وہ ہر document کے لیے ایک بار بھرے جانے والے field سے مختلف برتاؤ کرتا ہے، اور mapping کی زیادہ تر غلطیاں وہیں چھپی ہوتی ہیں۔
• Value mappings کے لیے agencies اور identifiers کے نام لکھیں، تاکہ tester جانے کہ کون سی table دیکھنی ہے۔
• User-defined function کے لیے بتائیں کہ یہ کیا اور کب واپس کرتا ہے، یہ نہیں کہ اسے کیسے لکھا گیا ہے۔

شیٹ کو mapping سے export کریں

1. ڈیزائنر میں iFlow کھولیں، "Kitegra ٹولز" بٹن پر کلک کریں اور "اس iFlow کی دستاویز بنائیں" چنیں۔
2. "iFlow دستاویز" صفحے پر "میپنگ شیٹ" کھولیں۔ یہ iFlow کی Message Mappings کی فہرست دیتی ہے، ہر ٹارگٹ فیلڈ کے لیے ایک row، اوپر والے columns کے ساتھ۔
3. اسے Excel workbook کے طور پر ڈاؤن لوڈ کریں، ہر mapping کے لیے ایک شیٹ۔
4. ڈیزائنر کے بغیر اس کی جگہ "میپنگ اپلوڈ کریں (.mmap یا ZIP)" چنیں۔ اپ لوڈ کی گئی فائل آپ کے پلان کے iFlows میں نہیں گنی جاتی۔

شیٹ mapping فائل سے بنتی ہے، اس لیے یہ دکھاتی ہے کہ mapping آج کیا کرتی ہے۔ اسے اسی iFlow سے بنی technical design document کے ساتھ پڑھیں۔

حوالے کرنے سے پہلے شیٹ چیک کریں

1. چند rows کا کسی test message سے موازنہ کریں: source value، قاعدہ، target value۔
2. iFlow کو TRACE کے ساتھ چلائیں اور mapping step سے پہلے اور بعد کی body پڑھیں، جیسا کہ message کو مرحلہ وار trace کرنا میں بتایا گیا ہے۔
3. جہاں پڑھنے والے کو قاعدے سے زیادہ کی ضرورت ہو وہاں "نوٹس" column بھریں: کوئی field مقررہ کیوں ہے، کوئی code list کس سسٹم کی ہے۔

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

میپنگ شیٹ، Kitegra کے iFlow Docs حصے کا حصہ ہے۔ یہ آپ کے براؤزر میں بنتی ہے؛ mappings کبھی 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 ایکسٹینشنز کے ساتھ دیکھیں۔

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