कार्यप्रवाह

कार्यप्रवाह दोबारा उपयोग योग्य स्वचालन पाइपलाइन हैं जो कैप्चर किए गए ट्रैफ़िक को संसाधित करती हैं, सक्रिय चरण चलाती हैं या डेटा बदलती हैं। इनके लिए अलग स्क्रिप्ट लिखना आवश्यक नहीं है।

कार्यप्रवाह प्रकार

प्रकार	किससे शुरू होता है	सामान्य उपयोग
पैसिव	नया कैप्चर किया गया ट्रैफ़िक	उपयोगी पैटर्न चिह्नित करना, अनुरोध टैग करना और अपने आप निष्कर्ष बनाना।
सक्रिय	मैन्युअल रन	फ़ॉलो-अप अनुरोध भेजना, कार्रवाइयाँ जोड़ना और कई चरणों वाले परीक्षण चलाना।
रूपांतरण	परीक्षण इनपुट, रूपांतरण कार्रवाइयाँ या मिलान और प्रतिस्थापन	टेक्स्ट या बाइट बदलना, जैसे JavaScript फ़ॉर्मैट करना या JSON सामान्यीकृत करना।

पैसिव कार्यप्रवाह पृष्ठभूमि में लगातार चलते हैं। सक्रिय कार्यप्रवाह अनुरोधों के चुने हुए समूह पर ज़रूरत के अनुसार चलते हैं।

कार्यप्रवाह कैनवास

कार्यप्रवाह खोलें और उसका कैनवास खोलने के लिए कोई कार्यप्रवाह चुनें।

• नोड मध्य पैनल में दिखते हैं। हर नोड में प्रकार-विशिष्ट इनपुट और आउटपुट पोर्ट होते हैं।
• क्लिक करके और खींचकर आउटपुट पोर्ट को इनपुट पोर्ट से जोड़ें।
• दाएँ कॉन्फ़िगरेशन पैनल खोलने के लिए नोड पर क्लिक करें।
• शीर्ष टूलबार में रन, सक्षम या अक्षम करने और आयात या निर्यात के नियंत्रण हैं।

नोड प्रकार

नोड	विवरण
शुरू / अंत	पैसिव, सक्रिय या रूपांतरण कार्यप्रवाह प्रकार के अनुरूप प्रवेश और निकास नोड।
शर्तें	यदि / अन्यथा, यदि / अन्यथा JS, HTTPQL मिलान, दायरा मिलान, स्ट्रिंग समावेश और रेगुलर एक्सप्रेशन मिलान।
एन्कोडिंग	Base64, URL, हेक्स और HTML एन्कोड या डिकोड करना।
फ़ॉर्मैटिंग और हैश	JSON मिनिफ़ाई या फ़ॉर्मैट करना, MD5, SHA-1 और SHA-256।
टेक्स्ट ऑपरेशन	किनारे के स्पेस हटाना, जोड़ना, बाँटना, मिलान और प्रतिस्थापन, JQ ट्रांसफ़ॉर्म और Grep निष्कर्षण।
JavaScript	कार्यप्रवाह SDK से कस्टम लॉजिक; ट्रैफ़िक पढ़ सकता है, फ़ाइलों पर काम कर सकता है और निष्कर्ष बना सकता है।
एकीकरण	लॉग, Webhook, कार्यप्रवाह बुलाना, अनुरोध भेजना और मिलान और प्रतिस्थापन नियम।

वास्तविक पोर्ट और कॉन्फ़िगरेशन के लिए नोड पैलेट उपयोग करें। ग्राफ़ दोबारा जोड़ने के लिए नोड हटाने के बजाय कनेक्शन पर क्लिक करके उस लिंक पर काम करें। सहेजें या Ctrl+S से सहेजें; macOS पर Command+S।

साझा करना और दायरा

कार्यप्रवाह डिफ़ॉल्ट रूप से एक ही कार्यक्षेत्र के प्रोजेक्टों में साझा होते हैं। परिभाषा को उसके प्रोजेक्ट के साथ रखने के लिए केवल इस परियोजना के लिए सक्षम करें। साझा परिभाषाओं का अर्थ यह नहीं कि हर प्रोजेक्ट का ट्रैफ़िक, परिणाम या नोट्स साझा हो जाते हैं। दूसरे कार्यक्षेत्र या इंस्टॉलेशन में जाते समय कार्यप्रवाह JSON निर्यात और आयात करें।

लाइव उपयोग से पहले परीक्षण

पैसिव और सक्रिय कार्यप्रवाह में HTTP परीक्षण अनुभाग होता है, जिसमें URL, रॉ अनुरोध और रॉ प्रतिक्रिया के परीक्षण नमूने होते हैं। कार्यप्रवाह सक्षम करें, फ़ील्ड भरें और कार्यप्रवाह का परीक्षण करें पर क्लिक करें। परीक्षण निष्पादन से पहले संपादन सहेजता है। पृष्ठ छोड़कर वापस आने पर परीक्षण नमूने प्रत्येक कार्यप्रवाह के लिए बने रहते हैं।

रूपांतरण कार्यप्रवाह में इसके बजाय परीक्षण इनपुट और आउटपुट होता है। छोटा प्रतिनिधि इनपुट लेकर शुरू करें, फिर वास्तविक आकार के एसेट पर परीक्षण करें। परीक्षण नमूना मनमाने JavaScript या अनुरोध भेजने वाले नोड को हानिरहित नहीं बनाता: कार्यप्रवाह कोड अब भी कॉन्फ़िगर की गई कार्रवाइयाँ कर सकता है।

JavaScript और फ़ाइलें

कार्यप्रवाह JavaScript, Ogma SDK और संगत fs/path आयात का समर्थन करता है। फ़ाइल ऑपरेशन के लिए sdk.fs.readFile, writeFile, appendFile, exists, readDir, mkdir और unlink, तथा प्लेटफ़ॉर्म-अनुकूल पथ के लिए sdk.path उपयोग करें। ये Ogma सहायक हैं, पूरी Node.js मानक लाइब्रेरी नहीं।

एसेट निर्यात करने के लिए response.getBody().toText() पढ़ें, sdk.path.join से गंतव्य चुनें, उसकी पैरेंट डायरेक्टरी बनाएँ और मौजूदा फ़ाइल पर लिखना न चाहते हों तो sdk.fs.exists जाँचें। निष्पादन से पहले फ़ाइल सिस्टम पथ जाँचें: कार्यप्रवाह फ़ाइल सिस्टम सहायक Ogma होस्ट पर चलते हैं, प्लगइन की निजी डायरेक्टरी वाले sdk.fs की तरह नहीं। उस अलग रनटाइम के लिए प्लगइन SDK देखें।

कार्यप्रवाह आयात करना

1. कार्यप्रवाह टूलबार में आयात करें पर क्लिक करें।
2. JSON कार्यप्रवाह फ़ाइल चुनें।
3. कार्यप्रवाह कैनवास में खुलता है। सक्षम करने से पहले नोड कॉन्फ़िगरेशन जाँचें।
4. कार्यप्रवाह सहेजें।

निर्यात की गई कार्यप्रवाह JSON फ़ाइलें Ogma इंस्टॉलेशन के बीच साझा की जा सकती हैं या संस्करण नियंत्रण में रखी जा सकती हैं।

कैप्चर किए गए इतिहास पर कार्यप्रवाह चलाना

सक्रिय कार्यप्रवाह पहले कैप्चर किए गए अनुरोधों पर दोबारा चलाए जा सकते हैं।

1. कार्यप्रवाह खोलें।
2. इतिहास पर चलाएँ पर क्लिक करें।
3. इतिहास स्कैन संवाद में वैकल्पिक HTTPQL फ़िल्टर डालें ताकि संसाधित होने वाले अनुरोध सीमित हों।
4. चलाएँ पर क्लिक करें।

मेल खाने वाली संख्या जाँचें और कार्य शुरू करें। प्रगति और त्रुटियाँ स्कैन कार्य में तथा लॉगिंग सक्षम होने पर उसके रन इतिहास में दिखती हैं। पैसिव कार्यप्रवाह पुराने डेटा के प्रसंस्करण के लिए इतिहास स्कैन करें और अनुरोध पर फिर चलाएँ देते हैं।

कुछ उपयोगी एसेट के लिए HTTP इतिहास की एक या अधिक पंक्तियाँ चुनें, राइट-क्लिक करें, कार्यप्रवाह में भेजें चुनें और सक्षम सक्रिय कार्यप्रवाह चुनें। इससे परिभाषा बदले बिना या पूरा इतिहास संसाधित किए बिना चुनी गई प्रविष्टियाँ उसे दी जाती हैं।

इतिहास स्कैन फ़िल्टर इनपुट के पास AI बटन साधारण भाषा के विवरण से HTTPQL अभिव्यक्ति बनाता है।

कार्यप्रवाह रन और परिणाम

निष्पादन विवरण चाहिए तो कार्यप्रवाह कॉन्फ़िगरेशन में लॉग लिखना चालू करें चालू करें। यह पैसिव, सक्रिय और रूपांतरण कार्यप्रवाहों पर लागू होता है, जिसमें मिलान और प्रतिस्थापन रूपांतरण भी हैं। अक्षम होने पर प्रसंस्करण चलता रहता है लेकिन रन या चरण लॉग नहीं जुड़ते; समस्या जाँचने के लिए फिर सक्षम करें और परीक्षण दोहराएँ।

• प्रत्येक नोड के चरण का आउटपुट देखने के लिए रन पर क्लिक करें।
• त्रुटि देने वाले नोड हाइलाइट किए जाते हैं।
• रन में बने निष्कर्ष निष्कर्ष दृश्य में दिखते हैं।
• रन में निकाले गए वैरिएबल चरण विवरण पैनल में दिखते हैं।

सभी साफ़ करें चुने गए कार्यप्रवाह का संग्रहीत रन इतिहास हटाता है। डिबगिंग प्रमाण रखना हो तो साफ़ करने से पहले लॉग डाउनलोड करें। लॉगिंग पूरी स्क्रिप्ट बॉडी जैसे बड़े आउटपुट सहेज सकती है, इसलिए बहुत अधिक रूपांतरणों के लिए इसे बंद रखें जब तक ज़रूरत न हो।

पैसिव कार्यप्रवाह सक्षम करना

1. कार्यप्रवाह खोलें।
2. पुष्टि करें कि कैनवास कॉन्फ़िगरेशन पूरा है और कोई आवश्यक पोर्ट बिना कनेक्शन के नहीं है।
3. टूलबार में चालू करें स्विच बदलें।

सक्षम पैसिव कार्यप्रवाह नया ट्रैफ़िक अपने आप संसाधित करते हैं। कार्यप्रवाह हटाए बिना रोकने के लिए उसे अक्षम करें।

संबंधित पृष्ठ

• निष्कर्ष
• परिवेश
• HTTPQL और StreamQL