SAP CPI-তে Deploy-এর পরে: Deploy Watcher, প্যাকেজ ডকুমেন্ট, ল্যান্ডস্কেপ এবং Excel-এ Value Mapping
কখন একটি iFlow Started হলো বা কেন ব্যর্থ হলো দেখুন, Cloud বা Edge runtime বেছে নিন, নতুন design checks চালান, landscape-সহ পুরো একটি package-এর ডকুমেন্ট তৈরি করুন, Value Mappings Excel-এ export করুন এবং যেকোনো টুল বন্ধ করুন।
SAP Cloud Integration (SAP CPI)-এ Deploy চাপলেই শুরু হয় অপেক্ষা: Monitor-এ যান, iFlow খুঁজুন, Started বা Error না দেখানো পর্যন্ত refresh করতে থাকুন, তারপর error-টির মানে বের করুন। আর একটি interface শেষ হলেও কেউ না কেউ ডকুমেন্ট, landscape-এর ছবি এবং spreadsheet-এ Value Mapping চেয়ে বসেন।
Kitegra এখন SAP Integration Suite ডিজাইনারের পাশেই কাজের এই অংশটা সামলায়: টেস্ট কলসহ একটি deploy watcher, Edge Integration Cell থাকা tenant-এর জন্য একটি runtime picker, নতুন design checks, landscape diagram ও ডকুমেন্টেশনের প্রস্তুতিসহ একটি প্যাকেজ ডকুমেন্ট, Excel-এ একটি Value Mapping sheet, এবং সহজ ভাষায় Groovy scripts-এর ব্যাখ্যা। প্রতিটি টুল আলাদাভাবে বন্ধ করা যায়। এই লেখা একে একে সেগুলো দেখায়।
Deploy watcher: iFlow ছেড়ে না গিয়েই Started বা Error
ডিজাইনারে যথারীতি Deploy চাপুন এবং SAP-এর dialog নিশ্চিত করুন। "ডিপ্লয় হচ্ছে…" ও পেরোনো সময়সহ একটি ডিপ্লয়মেন্ট নোটিশ দেখা যায়, আর আপনি কাজ চালিয়ে যান। Kitegra তিন সেকেন্ড পরে SAP-এর কাছে state জানতে চায়, তারপর ক্রমশ কম ঘন ঘন, সর্বোচ্চ প্রতি 20 সেকেন্ডে একবার। SAP উত্তর দিলে নোটিশটি হয়ে যায়:
- Started, deploy করা version-সহ। iFlow-এর একটি HTTP endpoint থাকলে টেস্ট কল পাঠান request প্রস্তুত করে HTTP Runner খোলে, আর সর্বশেষ মেসেজ দেখুন নতুন করে বার্তা panel খোলে।
- Error, SAP-এর error text-সহ, আর পরিচিত ক্ষেত্র হলে সাধারণত এর মানে কী: অন্য একটি deploy করা iFlow ইতিমধ্যে sender ঠিকানাটি ব্যবহার করছে, একটি script compile হচ্ছে না, একটি externalized parameter-এর কোনো মান নেই, অথবা SAP iFlow build করতে পারেনি। SAP-এ ডিপ্লয় করা কনটেন্ট খুলুন আপনাকে বিস্তারিততে নিয়ে যায়।
- দশ মিনিট পরেও এখনও ডিপ্লয় হচ্ছে, SAP-এ deploy করা কনটেন্টের একটি link-সহ।
SAP-এর Deploy dialog বাতিল করলে কিছুই নজরে রাখা হয় না। watcher শুধু deployment-এর state পড়ে; deploy করে SAP, আপনার নিজের ক্লিকে শুরু হয়ে। এরপর iFlow-এর ভেতর দিয়ে একটি message অনুসরণ করা বর্ণনা করা হয়েছে ধাপে ধাপে একটি message trace করা-তে, আর কলটি নিজে service key দিয়ে একটি HTTPS iFlow টেস্ট করা-তে।
Runtime picker: Cloud না Edge
Edge Integration Cell থাকা একটি tenant একাধিক runtime-এ iFlows চালায়। শুধু এমন tenant-এই Kitegra box দেখায় রানটাইম: Cloud (অথবা Edge runtime-এর নাম)। সেখানে runtime বেছে নিন, আর Message Monitor সেই runtime-এ এই iFlow-এর messages পড়ে এবং এর log level সেট করে। picker এটাও দেখায় প্রতিটিতে deploy করা আছে কি না, এবং কোন version। এক runtime-এর tenant-এ এটি কখনো দেখা যায় না।
iFlow Inspector-এ নতুন design checks
iFlow review checklist-এ পাঁচটি check যোগ হয়েছে, একটি নতুন Documentation বিভাগসহ:
| Check | কেন গুরুত্বপূর্ণ |
|---|---|
| ঠিকানা ছাড়া receiver (error) | iFlow deploy হয়, কিন্তু এই receiver-এ প্রতিটি কল runtime-এ ব্যর্থ হয়। |
| ডিফল্ট ঠিকানাসহ HTTPS sender (warning) | খালি, / অথবা /test-এর মতো placeholder ঠিকানা callers-কে কিছুই বলে না, আর দুটি iFlow এতে সংঘাতে পড়তে পারে। |
| HTTPS sender একটি CSRF token আশা করে (info) | প্রতিটি caller-কে আগে একটি X-CSRF-Token আনতে হবে, নইলে তার POST একটি 403 পায়। |
| receiver ঠিকানা iFlow-এ লেখা (info) | DEV, QA ও PROD-এর মধ্যে সরানো মানে iFlow edit করা; Externalize Parameters এক ধাপে এটি ঠিক করে। |
| participant-এর ডিফল্ট নাম রয়ে গেছে (info, Documentation) | "Sender" ও "Receiver" monitoring-এও দেখায়, তাই কোন system বোঝানো হয়েছে কেউ বলতে পারে না। |
অন্য checks-এর মতো এগুলোও score-এ গোনা হয় এবং একটি একটি করে বন্ধ করা যায়। এগুলো দেখা বিনামূল্যে; report export করা Pro-র অংশ। Externalize Parameters ও Helper-এর অন্য নতুন টুলগুলো বর্ণনা করা হয়েছে Externalize Parameters, স্টেপ কপি ও Hub ইমপোর্ট-এ।
পুরো প্যাকেজের জন্য একটি ডকুমেন্ট
এই iFlow-এর ডকুমেন্ট তৈরি করুন-এর পাশে Kitegra menu-তে এখন আছে প্যাকেজ ডকুমেন্ট। এটি খোলা iFlow-এর package-এর প্রতিটি iFlow একে একে পড়ে ("5টির মধ্যে 2 নম্বর iFlow পড়া হচ্ছে…"), আর আপনি এটি থামিয়ে এখন পর্যন্ত যা পড়া হয়েছে তা খুলতে পারেন। যে iFlows পড়া যায়নি সেগুলোর তালিকা দেওয়া হয়। ডকুমেন্ট খোলে নতুন tab-এ, Word, PDF বা HTML-এ, অথবা আপনার নিজের Word template-এ ভরে, ঠিক একটি iFlow-এর technical design document-এর মতো। এতে থাকে package-এর version, vendor, tags ও iFlows-এর সংখ্যা, তারপর প্রতিটি iFlow, এবং দুটি নতুন অংশ:
- ল্যান্ডস্কেপ: একটি diagram, বাঁয়ে senders, মাঝখানে package-এর iFlows আর ডানে receivers। একই নামের participants একটি box হয়ে যায়, আর প্রতিটি রেখা তার adapter types বহন করে।
- ডকুমেন্টেশনের প্রস্তুতি: একজন পাঠকের যা দরকার, একে একে যাচাই করা: package-এর description ও tags, প্রতিটি iFlow-এর description, Sender ও Receiver থেকে নাম বদলানো participants, এবং externalize করা receiver ঠিকানা। এটি দেখায় কতগুলো check পাস করেছে এবং কী বাকি, যাতে হস্তান্তরের আগে আপনি ফাঁকগুলো পূরণ করতে পারেন।
Excel-এ Value Mapping
iFlow Docs পেজে Value Mapping-এর অধীনে একটি Value Mapping ZIP (SAP-এ এর package থেকে ডাউনলোড করুন) অথবা এর value_mapping.xml আপলোড করুন। Kitegra মানগুলোর তালিকা দেখায় এবং প্রতিটি agency ও identifier জোড়ার জন্য একটি sheet-সহ একটি Excel workbook লেখে: source agency, identifier ও value, তারপর target agency, identifier ও value। ফাইলটি আপনার ব্রাউজারেই পড়া হয়; SAP থেকে কিছু পড়া হয় না এবং কোথাও কিছু পাঠানো হয় না। mappings-এর জন্য Message Mapping sheet একইভাবে কাজ করে।
সহজ ভাষায় scripts-এর ব্যাখ্যা
Kitegra menu-র স্ক্রিপ্ট ব্যাখ্যা iFlow-এর প্রতিটি Groovy script স্টেপের তালিকা দেখায়। প্রতিটির জন্য এটি দেখায় লেখকের সারসংক্ষেপ comment, এতে সংজ্ঞায়িত functions, এটি কী পড়ে (body, headers, exchange properties, attachments), কী সেট করে ও বদলায়, এর মূল logic (XML বা JSON parse করা বা বানানো, loops, সিদ্ধান্ত, HTTP calls, তারিখ), এটি যে SAP APIs ব্যবহার করে, যেমন Security Material, Value Mapping বা Partner Directory, এবং নোট ও ঝুঁকি। diagram-এ কোনো স্টেপ নির্বাচন করতে তার নামে ক্লিক করুন। ব্যাখ্যাটি আপনার ব্রাউজারে script-এর text থেকে তৈরি হয়; script কখনো কোথাও পাঠানো হয় না।
যে টুল ব্যবহার করেন না তা বন্ধ করুন
options পেজে এখন একটি টুল বিভাগ আছে, প্রতিটি টুলের জন্য একটি switch-সহ, তার মডিউলের অধীনে গুছিয়ে রাখা: Helper-এ XPath যাচাই, সাজানো, Security Material, Externalize, স্টেপ কপি ও পেস্ট এবং Hub ইমপোর্ট থেকে শুরু করে বার্তা, runtime picker, লগ ভিউয়ার ও deploy watcher, iFlow info, Inspector ও Search, Documents ও স্ক্রিপ্ট ব্যাখ্যা হয়ে Toolbox-এর নোট, স্নিপেট, Compare, Convert, Generate ও HTTP Runner পর্যন্ত। বন্ধ করা টুল সঙ্গে সঙ্গে ডিজাইনার ও popup থেকে সরে যায়; আপনার ডেটা থেকে যায়, আর সব চালু করুন সবকিছু ফিরিয়ে আনে। পুরো একটি মডিউল বন্ধ করতে একই পেজের "মডিউল" ব্যবহার করুন; দেখুন options পেজ।
deploy watcher, runtime picker, স্ক্রিপ্ট ব্যাখ্যা এবং design checks দেখা বিনামূল্যে। প্যাকেজ ডকুমেন্ট, ল্যান্ডস্কেপ ও Value Mapping sheet iFlow Docs-এর অংশ, Free ও Starter-এ কয়েকবার ব্যবহারসহ। Kitegra লঞ্চের সময়টায় সাইন ইন করা সবার জন্য প্রতিটি টুল খোলা। প্ল্যানগুলো তুলনা করুন।
আপনার পরবর্তী iFlow-এ চেষ্টা করুন
Kitegra, SAP Integration Suite ডিজাইনারের চারপাশে কী কী যোগ করে তা পড়ুন, অথবা iFlows লেখার নতুন টুলগুলো দেখুন।
সাধারণ জিজ্ঞাসা
Kitegra কি আমার iFlow deploy করে?
না। আপনি SAP-এ Deploy চাপেন; deploy watcher শুধু deployment-এর state পড়ে এবং কখন Started হলো বা ব্যর্থ হলো তা জানায়।
পুরো একটি SAP CPI package-এর ডকুমেন্ট কীভাবে তৈরি করব?
package-এর যেকোনো iFlow খুলুন এবং Kitegra menu-তে "প্যাকেজ ডকুমেন্ট" বেছে নিন। এটি প্রতিটি iFlow পড়ে এবং landscape diagram ও ডকুমেন্টেশনের প্রস্তুতিসহ একটি ডকুমেন্ট খোলে, Word, PDF বা HTML-এ।
একটি Value Mapping কি Excel-এ export করা যায়?
হ্যাঁ। SAP-এ এর package থেকে Value Mapping ZIP ডাউনলোড করুন এবং iFlow Docs পেজে আপলোড করুন। প্রতিটি agency ও identifier জোড়ার জন্য একটি sheet পাবেন; ফাইলটি কখনো আপনার ব্রাউজার ছেড়ে যায় না।
আমি runtime picker দেখতে পাচ্ছি না কেন?
এটি শুধু একাধিক runtime থাকা tenant-এ দেখা যায়, যেমন Cloud-এর সাথে Edge Integration Cell।
একটি টুল বন্ধ করলে কি আমার ডেটা মুছে যায়?
না। টুলটি ডিজাইনার ও popup থেকে সরে যায়, আর এর ডেটা থেকে যায়। options পেজের "টুল" বিভাগে এটি আবার চালু করুন।