SAP CPI में Deploy के बाद: डिप्लॉय निगरानी, पैकेज दस्तावेज़, लैंडस्केप और Excel में Value Mapping
देखें कि iFlow कब Started हुआ या क्यों fail हुआ, Cloud या Edge runtime चुनें, नई डिज़ाइन जाँचें चलाएँ, 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 के डिज़ाइनर के बगल में संभालता है: टेस्ट कॉल के साथ डिप्लॉय निगरानी, Edge Integration Cell वाले tenants के लिए रनटाइम चयन, नई डिज़ाइन जाँचें, landscape diagram और दस्तावेज़ीकरण की तैयारी के साथ पैकेज दस्तावेज़, Excel में Value Mapping शीट, और Groovy scripts की आसान शब्दों में व्याख्या। हर टूल को अलग से बंद किया जा सकता है। यह लेख इन सबको एक-एक करके समझाता है।
डिप्लॉय निगरानी: iFlow छोड़े बिना Started या Error
हमेशा की तरह डिज़ाइनर में Deploy दबाएँ और SAP के dialog की पुष्टि करें। "डिप्लॉय हो रहा है…" और बीते समय के साथ एक डिप्लॉयमेंट सूचना दिखती है, और आप काम जारी रखते हैं। Kitegra तीन सेकंड बाद SAP से स्थिति पूछता है, फिर धीरे-धीरे कम बार, ज़्यादा से ज़्यादा हर 20 सेकंड में। जब SAP जवाब देता है, तो सूचना इनमें से एक बन जाती है:
- Started, deploy किए गए version के साथ। अगर iFlow का HTTP endpoint है, तो टेस्ट कॉल भेजें तैयार request के साथ HTTP Runner खोलता है, और नवीनतम मैसेज दिखाएँ मैसेज पैनल को ताज़ा करके खोलता है।
- त्रुटि, SAP के error text के साथ और, जब यह कोई जाना-पहचाना मामला हो, तो इसका आमतौर पर क्या मतलब होता है: कोई दूसरा deploy किया गया iFlow पहले से यह sender address इस्तेमाल कर रहा है, कोई script compile नहीं हो रही, किसी externalized parameter का कोई मान नहीं है, या SAP iFlow को build नहीं कर सका। SAP में डिप्लॉय किया गया कंटेंट खोलें आपको विवरण तक ले जाता है।
- दस मिनट बाद अभी भी डिप्लॉय हो रहा है, SAP में deploy किए गए content के link के साथ।
अगर आप SAP का Deploy dialog रद्द करते हैं, तो किसी चीज़ की निगरानी नहीं होती। निगरानी सिर्फ़ deployment की स्थिति पढ़ती है; deploy करना SAP का काम है, जो आपके अपने क्लिक से शुरू होता है। इसके बाद iFlow में किसी message का पीछा करना message को step by step trace करना में बताया गया है, और call ख़ुद service key से HTTPS iFlow की जाँच में।
रनटाइम चयन: Cloud या Edge
Edge Integration Cell वाला tenant iFlows को एक से ज़्यादा runtime पर चलाता है। सिर्फ़ ऐसे tenant पर Kitegra box रनटाइम: Cloud (या Edge runtime का नाम) दिखाता है। वहाँ runtime चुनें, और Message Monitor इस iFlow के messages उसी runtime से पढ़ता है और उसका log level वहीं सेट करता है। चयन यह भी दिखाता है कि हर runtime पर iFlow deploy है या नहीं, और कौन-सा version। एक runtime वाले tenants पर यह कभी नहीं दिखता।
iFlow Inspector में नई डिज़ाइन जाँचें
iFlow review checklist में पाँच नई जाँचें जुड़ी हैं, एक नई Documentation श्रेणी के साथ:
| जाँच | यह क्यों मायने रखती है |
|---|---|
| बिना address का receiver (error) | iFlow deploy हो जाता है, लेकिन इस receiver की हर call runtime पर fail होती है। |
| डिफ़ॉल्ट address वाला HTTPS sender (warning) | ख़ाली, / या /test जैसा placeholder address callers को कुछ नहीं बताता, और दो iFlows उस पर टकरा सकते हैं। |
| HTTPS sender CSRF token की उम्मीद करता है (info) | हर caller को पहले X-CSRF-Token लेना होगा, वरना उसके POST को 403 मिलता है। |
| iFlow में लिखा receiver address (info) | DEV, QA और PROD के बीच ले जाने का मतलब iFlow को edit करना है; Externalize Parameters इसे एक कदम में ठीक करता है। |
| Participant का नाम डिफ़ॉल्ट ही है (info, Documentation) | "Sender" और "Receiver" monitoring में भी दिखते हैं, इसलिए कोई नहीं बता सकता कि कौन-सा system मतलब है। |
बाक़ी जाँचों की तरह, ये भी score में गिनी जाती हैं और एक-एक करके बंद की जा सकती हैं। इन्हें देखना मुफ़्त है; report export करना Pro का हिस्सा है। Externalize Parameters और Helper के दूसरे नए टूल Externalize Parameters, स्टेप कॉपी और Hub इम्पोर्ट में बताए गए हैं।
पूरे package के लिए एक दस्तावेज़
इस iFlow का दस्तावेज़ बनाएँ के बगल में, Kitegra मेनू में अब पैकेज दस्तावेज़ भी है। यह खुले iFlow के package के हर iFlow को एक-एक करके पढ़ता है ("5 में से iFlow 2 पढ़ा जा रहा है…"), और आप इसे रोककर अब तक पढ़ा गया हिस्सा खोल सकते हैं। जो 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 का विवरण और tags, हर iFlow का विवरण, Sender और Receiver से बदले गए participant नाम, और externalized receiver addresses। यह दिखाता है कि कितनी जाँचें पास हुईं और क्या कमी है, ताकि आप सौंपने से पहले कमियाँ पूरी कर सकें।
Excel में Value Mapping
iFlow Docs पेज पर, Value Mappings के अंदर, Value Mapping का ZIP (SAP में उसके package से डाउनलोड करें) या उसका value_mapping.xml अपलोड करें। Kitegra मानों की सूची बनाता है और एक Excel workbook लिखता है जिसमें हर agency और identifier जोड़ी की एक शीट होती है: स्रोत एजेंसी, identifier और मान, फिर लक्ष्य एजेंसी, identifier और मान। फ़ाइल आपके ब्राउज़र में पढ़ी जाती है; SAP से कुछ नहीं पढ़ा जाता और कुछ भी कहीं नहीं भेजा जाता। mappings के लिए Message Mapping शीट भी इसी तरह काम करती है।
आसान शब्दों में scripts की व्याख्या
Kitegra मेनू में स्क्रिप्ट समझाएँ iFlow के हर Groovy script step की सूची दिखाता है। हर एक के लिए यह दिखाता है: लेखक की सारांश टिप्पणी, उसमें परिभाषित functions, वह क्या पढ़ता है (body, headers, exchange properties, attachments), क्या सेट करता और बदलता है, उसका मुख्य logic (XML या JSON को parse करना या बनाना, loops, निर्णय, HTTP calls, तारीख़ें), वह कौन-से SAP APIs इस्तेमाल करता है, जैसे Security Material, Value Mapping या Partner Directory, और नोट्स और जोखिम। किसी step के नाम पर क्लिक करके उसे diagram पर चुनें। व्याख्या आपके ब्राउज़र में script के text से तैयार की जाती है; script कभी कहीं नहीं भेजी जाती।
जो टूल आप इस्तेमाल नहीं करते, उसे बंद करें
Options पेज पर अब एक टूल section है, जिसमें हर टूल के लिए एक switch है, उसके मॉड्यूल के अंदर समूहित: Helper में XPath जाँच, Arrange, Security Material, Externalize, स्टेप कॉपी और Hub इम्पोर्ट से लेकर, मैसेज, रनटाइम चयन, लॉग व्यूअर और डिप्लॉय निगरानी, iFlow जानकारी, Inspector और खोज, दस्तावेज़ और स्क्रिप्ट व्याख्या होते हुए, Toolbox में नोट्स, Snippets, Compare, Convert, Generate और HTTP Runner तक। बंद किया गया टूल तुरंत डिज़ाइनर और popup से हट जाता है; आपका डेटा बना रहता है, और सभी चालू करें सब कुछ वापस ले आता है। पूरा मॉड्यूल बंद करने के लिए उसी पेज पर मॉड्यूल का इस्तेमाल करें; देखें options पेज।
डिप्लॉय निगरानी, रनटाइम चयन, स्क्रिप्ट व्याख्या और डिज़ाइन जाँचें देखना मुफ़्त है। पैकेज दस्तावेज़, लैंडस्केप और Value Mapping शीट iFlow Docs का हिस्सा हैं, Free और Starter पर कुछ उपयोगों के साथ। Kitegra के लॉन्च के दौरान, साइन इन किए हर व्यक्ति के लिए हर टूल खुला है। प्लान की तुलना करें।
अपने अगले iFlow में आज़माएँ
पढ़ें कि Kitegra, SAP Integration Suite के डिज़ाइनर के आसपास क्या-क्या जोड़ता है, या iFlows लिखने के नए टूल देखें।
अक्सर पूछे जाने वाले प्रश्न
क्या Kitegra मेरा iFlow deploy करता है?
नहीं। Deploy आप SAP में दबाते हैं; डिप्लॉय निगरानी सिर्फ़ deployment की स्थिति पढ़ती है और बताती है कि iFlow कब Started हुआ या fail हुआ।
पूरे SAP CPI package का दस्तावेज़ कैसे बनाऊँ?
Package का कोई भी iFlow खोलें और Kitegra मेनू में पैकेज दस्तावेज़ चुनें। यह हर iFlow पढ़ता है और landscape diagram और दस्तावेज़ीकरण की तैयारी के साथ एक दस्तावेज़ खोलता है, Word, PDF या HTML में।
क्या मैं Value Mapping को Excel में export कर सकता हूँ?
हाँ। SAP में उसके package से Value Mapping का ZIP डाउनलोड करें और उसे iFlow Docs पेज पर अपलोड करें। आपको हर agency और identifier जोड़ी की एक शीट मिलती है; फ़ाइल कभी आपके ब्राउज़र से बाहर नहीं जाती।
मुझे रनटाइम चयन क्यों नहीं दिखता?
यह सिर्फ़ उन tenants पर दिखता है जिनमें एक से ज़्यादा runtime हैं, जैसे Cloud के साथ Edge Integration Cell।
अगर मैं कोई टूल बंद करूँ, तो क्या मेरा डेटा मिट जाता है?
नहीं। टूल डिज़ाइनर और popup से हट जाता है, और उसका डेटा बना रहता है। उसे options पेज के टूल section में फिर से चालू करें।