यह दस्तावेज़ AI द्वारा अनुवादित किया गया है। किसी भी अशुद्धि के लिए, कृपया अंग्रेजी संस्करण देखें
इवेंट फ़्लो
परिचय
यदि आप चाहते हैं कि किसी फ़ॉर्म में बदलाव होने पर कुछ कस्टम ऑपरेशन ट्रिगर हों, तो आप इसे इवेंट फ़्लो का उपयोग करके प्राप्त कर सकते हैं। फ़ॉर्म के अलावा, पेज, ब्लॉक, बटन और फ़ील्ड सभी कस्टम ऑपरेशन कॉन्फ़िगर करने के लिए इवेंट फ़्लो का उपयोग कर सकते हैं।
कैसे उपयोग करें
आइए, इवेंट फ़्लो को कॉन्फ़िगर करने का तरीका समझने के लिए एक सरल उदाहरण देखें। हम दो तालिकाओं के बीच एक लिंकेज बनाएंगे, जहाँ बाईं तालिका में किसी पंक्ति पर क्लिक करने पर दाईं तालिका का डेटा स्वचालित रूप से फ़िल्टर हो जाएगा।
कॉन्फ़िगरेशन के चरण इस प्रकार हैं:
- बाईं तालिका ब्लॉक के ऊपरी-दाएँ कोने में "बिजली" आइकन पर क्लिक करें, जिससे इवेंट फ़्लो कॉन्फ़िगरेशन पैनल खुल जाएगा।
- "इवेंट फ़्लो जोड़ें (Add event flow)" पर क्लिक करें, "ट्रिगर इवेंट (Trigger event)" के रूप में "पंक्ति क्लिक (Row click)" चुनें, जिसका अर्थ है कि तालिका की पंक्ति पर क्लिक करने पर फ़्लो ट्रिगर होगा।
- "ट्रिगर कंडीशन (Trigger condition)" का उपयोग शर्तों को कॉन्फ़िगर करने के लिए किया जाता है। इवेंट फ़्लो तभी ट्रिगर होगा जब ये शर्तें पूरी होंगी। इस मामले में, हमें कोई शर्त कॉन्फ़िगर करने की आवश्यकता नहीं है, इसलिए किसी भी पंक्ति पर क्लिक करने पर फ़्लो ट्रिगर होगा।
- "स्टेप जोड़ें (Add step)" पर माउस ले जाएँ ताकि ऑपरेशन स्टेप्स जोड़ सकें। दाईं तालिका के लिए डेटा स्कोप कॉन्फ़िगर करने के लिए हम "डेटा स्कोप सेट करें (Set data scope)" का चयन करेंगे।
- दाईं तालिका का UID कॉपी करें और इसे "टारगेट ब्लॉक UID (Target block UID)" इनपुट फ़ील्ड में पेस्ट करें। इसके नीचे तुरंत एक कंडीशन कॉन्फ़िगरेशन पैनल दिखाई देगा, जहाँ आप दाईं तालिका के लिए डेटा स्कोप कॉन्फ़िगर कर सकते हैं।
- आइए, नीचे दिखाए अनुसार एक कंडीशन कॉन्फ़िगर करें:
- डेटा स्कोप कॉन्फ़िगर करने के बाद, फ़िल्टर किए गए परिणाम दिखाने के लिए आपको ब्लॉक को रीफ़्रेश करना होगा। अगला, आइए दाईं तालिका ब्लॉक को रीफ़्रेश करना कॉन्फ़िगर करें। "टारगेट ब्लॉक रीफ़्रेश करें (Refresh target blocks)" स्टेप जोड़ें और फिर दाईं तालिका का UID दर्ज करें।
- अंत में, कॉन्फ़िगरेशन पूरा करने के लिए निचले-दाएँ कोने में सेव बटन पर क्लिक करें।
इवेंट प्रकार
रेंडर होने से पहले (Before render)
यह एक सार्वभौमिक इवेंट है जिसका उपयोग पेज, ब्लॉक, बटन या फ़ील्ड में किया जा सकता है। इस इवेंट में, आप कुछ प्रारंभिक कार्य कर सकते हैं, जैसे विभिन्न शर्तों के आधार पर विभिन्न डेटा स्कोप कॉन्फ़िगर करना।
पंक्ति पर क्लिक (Row click)
यह तालिका ब्लॉक-विशिष्ट इवेंट है। तालिका की पंक्ति पर क्लिक करने पर ट्रिगर होता है। ट्रिगर होने पर, यह संदर्भ में एक "क्लिक की गई पंक्ति का रिकॉर्ड (Clicked row record)" जोड़ता है, जिसका उपयोग शर्तों और स्टेप्स में एक वेरिएबल के रूप में किया जा सकता है।
फ़ॉर्म मानों में बदलाव (Form values change)
यह फ़ॉर्म ब्लॉक-विशिष्ट इवेंट है। फ़ॉर्म फ़ील्ड के मानों में बदलाव होने पर ट्रिगर होता है। आप शर्तों और स्टेप्स में "वर्तमान फ़ॉर्म (Current form)" वेरिएबल के माध्यम से फ़ॉर्म के मानों तक पहुँच सकते हैं।
क्लिक करें (Click)
यह बटन-विशिष्ट इवेंट है। बटन पर क्लिक करने पर ट्रिगर होता है।
स्टेप प्रकार
कस्टम वेरिएबल (Custom variable)
संदर्भ के भीतर उपयोग करने के लिए एक कस्टम वेरिएबल बनाएँ।
स्कोप
कस्टम वेरिएबल्स का एक स्कोप होता है। उदाहरण के लिए, एक ब्लॉक के इवेंट फ़्लो में परिभाषित वेरिएबल का उपयोग केवल उसी ब्लॉक के भीतर किया जा सकता है। यदि आप चाहते हैं कि एक वेरिएबल वर्तमान पेज पर सभी ब्लॉकों में उपलब्ध हो, तो उसे पेज के इवेंट फ़्लो में कॉन्फ़िगर करें।
फ़ॉर्म वेरिएबल (Form variable)
एक फ़ॉर्म ब्लॉक के मानों को एक वेरिएबल के रूप में उपयोग करें। कॉन्फ़िगरेशन इस प्रकार है:
- Variable title: वेरिएबल शीर्षक
- Variable identifier: वेरिएबल पहचानकर्ता
- Form UID: फ़ॉर्म UID
अन्य वेरिएबल
भविष्य में और अधिक वेरिएबल प्रकारों का समर्थन किया जाएगा। कृपया प्रतीक्षा करें।
डेटा स्कोप सेट करें (Set data scope)
एक टारगेट ब्लॉक के लिए डेटा स्कोप सेट करें। कॉन्फ़िगरेशन इस प्रकार है:
- Target block UID: टारगेट ब्लॉक UID
- Condition: फ़िल्टर कंडीशन
टारगेट ब्लॉक रीफ़्रेश करें (Refresh target blocks)
टारगेट ब्लॉक रीफ़्रेश करें। कई ब्लॉकों को कॉन्फ़िगर किया जा सकता है। कॉन्फ़िगरेशन इस प्रकार है:
- Target block UID: टारगेट ब्लॉक UID
URL पर नेविगेट करें (Navigate to URL)
एक URL पर नेविगेट करें। कॉन्फ़िगरेशन इस प्रकार है:
- URL: टारगेट URL, वेरिएबल्स का उपयोग समर्थित है
- Search parameters: URL में क्वेरी पैरामीटर्स
- Open in new window: यदि चेक किया गया है, तो नेविगेट करते समय एक नया ब्राउज़र पेज खुलेगा
संदेश दिखाएँ (Show message)
वैश्विक स्तर पर ऑपरेशन फ़ीडबैक संदेश प्रदर्शित करें।
कब उपयोग करें
- सफलता, चेतावनी और त्रुटि जैसे फ़ीडबैक संदेश प्रदान कर सकता है।
- शीर्ष पर केंद्रित होकर प्रदर्शित होता है और स्वचालित रूप से गायब हो जाता है, जो उपयोगकर्ता के ऑपरेशन को बाधित किए बिना एक हल्का संकेत देने का तरीका है।
कॉन्फ़िगरेशन
- Message type: संदेश प्रकार
- Message content: संदेश सामग्री
- Duration: कितनी देर तक प्रदर्शित हो (सेकंड में)
सूचना दिखाएँ (Show notification)
वैश्विक स्तर पर सूचना अलर्ट प्रदर्शित करें।
कब उपयोग करें
सिस्टम के चारों कोनों में सूचना अलर्ट प्रदर्शित करें। आमतौर पर निम्नलिखित स्थितियों के लिए उपयोग किया जाता है:
- अपेक्षाकृत जटिल सूचना सामग्री।
- इंटरैक्टिव सूचनाएँ जो उपयोगकर्ताओं को अगले चरणों के लिए कार्रवाई बिंदु प्रदान करती हैं।
- सिस्टम द्वारा शुरू की गई सूचनाएँ।
कॉन्फ़िगरेशन
- Notification type: सूचना प्रकार
- Notification title: सूचना शीर्षक
- Notification description: सूचना विवरण
- Placement: स्थान, विकल्प हैं: ऊपर-बाएँ, ऊपर-दाएँ, नीचे-बाएँ, नीचे-दाएँ
जावास्क्रिप्ट निष्पादित करें (Execute JavaScript)
जावास्क्रिप्ट कोड निष्पादित करें।