মূল কনটেন্টে যান
← ব্লগে ফিরে যান

এই নিবন্ধের মডিউল: iFlow Docs

SAP CPI Message Mapping documentation: এক ক্লিকে Excel mapping sheet

SAP CPI Message Mapping কীভাবে mapping sheet হিসেবে ডকুমেন্ট করবেন: দরকারি columns, functions ও contexts কীভাবে বর্ণনা করবেন, এবং sheet কীভাবে Excel-এ export করবেন।

SAP CPI Message Mapping documentation: এক ক্লিকে Excel mapping sheet

Mapping specification সাধারণত একটি interface-এর প্রথম ডকুমেন্ট, আর সবার আগে পুরোনোও হয় সেটিই। SAP Cloud Integration (SAP CPI)-এর Message Mapping build ও tests-এর সময় বদলায়, আর যে spreadsheet সেটি বর্ণনা করেছিল তা যেখানে ছিল সেখানেই থেকে যায়।

এই নিবন্ধে আছে একটি mapping sheet-এর কোন columns দরকার, functions, contexts ও value mappings কীভাবে বর্ণনা করবেন যাতে পাঠক অনুসরণ করতে পারেন, এবং mapping থেকেই কীভাবে sheet export করবেন।

Mapping specification কেন পিছিয়ে পড়ে

Mapping specification লেখা হয় mapping তৈরির আগে, এমন কারও হাতে যিনি business fields জানেন। তারপর developer দেখেন যে একটি field-এর context change দরকার, একটি date-এর অন্য format দরকার, আর একটি code-এর value mapping দরকার। এসব সিদ্ধান্তের প্রতিটি থাকে mapping editor-এর graphical view-এ, আর তার অল্পই sheet-এ ফিরে আসে।

একটি mapping sheet-এর দরকারি columns

Columnএতে কী থাকে
টার্গেট ফিল্ডTarget message-এ field-এর পুরো path
অকারেন্সএটি কতবার আসতে পারে, যেমন 0..1 বা 1..unbounded
সোর্স ফিল্ডযে source paths থেকে value আসে
নিয়মLogic, সহজ ভাষায়
ফাংশনব্যবহৃত standard functions, যেমন concat, if বা formatByExample
কনস্ট্যান্টMapping-এ লেখা fixed values
UDFUser-defined functions এবং সেগুলো কী করে
Value MappingValue mapping দিয়ে অনুবাদ করা codes
নোটContext changes এবং tester-এর যা জানা দরকার

Functions, contexts ও value mappings বর্ণনা করা

  • নিয়মটি একটি বাক্য হিসেবে লিখুন: "FirstName ও LastName একটি space দিয়ে জোড়া দেয়" যাচাই করা function-এর নামের তালিকার চেয়ে সহজ।
  • Context বদলালে তা উল্লেখ করুন। প্রতি item-এ একবার পূরণ হওয়া field আর প্রতি ডকুমেন্টে একবার পূরণ হওয়া field আলাদা আচরণ করে, আর বেশিরভাগ mapping error সেখানেই লুকিয়ে থাকে।
  • Value mappings-এর জন্য agencies ও identifiers-এর নাম লিখুন, যাতে tester জানেন কোন table দেখতে হবে।
  • একটি user-defined function-এর জন্য লিখুন সেটি কী ফেরত দেয় ও কখন, কীভাবে লেখা হয়েছে তা নয়।

Mapping থেকে sheet export করুন

  1. ডিজাইনারে iFlow খুলুন, "Kitegra টুল" বোতামে ক্লিক করে "এই iFlow-এর ডকুমেন্ট তৈরি করুন" বেছে নিন।
  2. "iFlow ডকুমেন্ট" পেজে "ম্যাপিং শিট" খুলুন। এটি iFlow-এর Message Mapping-গুলোর তালিকা দেয়, প্রতিটি target field-এর জন্য একটি row, ওপরের columns-সহ।
  3. এটি একটি Excel workbook হিসেবে ডাউনলোড করুন, প্রতিটি mapping-এর জন্য একটি sheet-সহ।
  4. ডিজাইনার ছাড়া, এর বদলে "ম্যাপিং আপলোড (.mmap বা ZIP)" বেছে নিন। আপলোড করা ফাইল আপনার প্ল্যানের iFlow-এ গোনা হয় না।

Sheet-টি mapping ফাইল থেকে তৈরি হয়, তাই এটি দেখায় mapping আজ কী করে। একই iFlow থেকে তৈরি technical design document-এর পাশে এটি পড়ুন।

হস্তান্তরের আগে sheet যাচাই করুন

  1. কয়েকটি row একটি test message-এর সঙ্গে মিলিয়ে দেখুন: source value, নিয়ম, target value।
  2. iFlow TRACE-এ চালান এবং mapping step-এর আগে ও পরে body পড়ুন, যেমন message step by step trace করা-তে দেখানো হয়েছে।
  3. যেখানে পাঠকের নিয়মের চেয়ে বেশি কিছু জানা দরকার, সেখানে "নোট" column পূরণ করুন: একটি field কেন constant, কোন system একটি code list-এর মালিক।

Kitegra কীভাবে সাহায্য করে

Mapping sheet হলো Kitegra-এর iFlow Docs area-র অংশ। এটি আপনার browser-এ তৈরি হয়; mappings কখনো Kitegra-এ পাঠানো হয় না।

Helper, Message Monitor, iFlow Inspector ও iFlow Docs প্রত্যেকে সেই iFlow-গুলো গণনা করে যেগুলোতে আপনি এগুলো ব্যবহার করেন: Kitegra অ্যাকাউন্ট ছাড়া প্রতি মডিউলে 5টি, Free প্ল্যানে 50, Starter-এ 100 এবং Pro-তে 300; Business-এ কোনো সীমা নেই। Toolbox ও workspace-এর বাড়তি সুবিধাগুলো ফ্রি। প্ল্যানগুলো তুলনা করুন।

আপনার পরবর্তী iFlow-এ চেষ্টা করুন

Kitegra, SAP Integration Suite ডিজাইনারের চারপাশে কী কী যোগ করে তা পড়ুন, অথবা Kitegra-এর অন্য Chrome এক্সটেনশনগুলোর পাশে এটি দেখুন।

সাধারণ জিজ্ঞাসা

SAP CPI Message Mapping কীভাবে ডকুমেন্ট করব?

প্রতিটি target field-এর জন্য একটি row-সহ একটি mapping sheet হিসেবে: target path, occurrence, source fields, ভাষায় নিয়ম, functions, constants, UDFs, value mappings ও notes।

আমি কি Message Mapping Excel-এ export করতে পারি?

হ্যাঁ। "iFlow ডকুমেন্ট" পেজে "ম্যাপিং শিট" প্রতিটি mapping-এর জন্য একটি sheet-সহ Excel workbook হিসেবে ডাউনলোড হয়।

ডিজাইনার ছাড়া কি mapping ডকুমেন্ট করা যায়?

হ্যাঁ। একটি .mmap ফাইল বা mappings-সহ একটি ZIP আপলোড করুন; আপলোড আপনার প্ল্যানের iFlow-এ গোনা হয় না।

Sheet কি user-defined functions ব্যাখ্যা করে?

এটি প্রতিটি field যে UDFs ব্যবহার করে তার তালিকা দেয়। একটি UDF business-এর ভাষায় কী করে, তা "নোট" column-এ এক লাইনে লিখে রাখার মতো।

আমার mappings কি Kitegra-এ পাঠানো হয়?

না। Sheet আপনার browser-এ তৈরি হয় এবং mappings কখনো পাঠানো হয় না।

ডিজাইনার না ছেড়েই iFlows-এ কাজ করুন

Kitegra Chrome বা Microsoft Edge-এ যোগ করুন। ফ্রিতে শুরু করুন, কোনো অ্যাকাউন্ট লাগবে না।