#वेरिएबल्स का उपयोग करना

#मुख्य अवधारणाएँ

प्रोग्रामिंग भाषाओं में वेरिएबल्स की तरह ही, वर्कफ़्लो में वेरिएबल्स प्रक्रियाओं को जोड़ने और व्यवस्थित करने के लिए एक महत्वपूर्ण उपकरण हैं।

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

• ट्रिगर संदर्भ डेटा: एक्शन ट्रिगर्स या संग्रह ट्रिगर्स जैसे मामलों में, एक सिंगल-रो डेटा ऑब्जेक्ट को सभी नोड्स द्वारा वेरिएबल के रूप में उपयोग किया जा सकता है। इसकी विशिष्टताएँ हर ट्रिगर के कार्यान्वयन के आधार पर भिन्न होती हैं।
• अपस्ट्रीम नोड डेटा: जब प्रक्रिया किसी भी नोड तक पहुँचती है, तो यह पहले से पूर्ण किए गए नोड्स का परिणामी डेटा होता है।
• लोकल वेरिएबल्स: जब कोई नोड कुछ विशेष ब्रांच संरचनाओं के भीतर होता है, तो वह उस ब्रांच के भीतर विशिष्ट लोकल वेरिएबल्स का उपयोग कर सकता है। उदाहरण के लिए, एक लूप संरचना में, प्रत्येक पुनरावृति (iteration) के डेटा ऑब्जेक्ट का उपयोग किया जा सकता है।
• सिस्टम वेरिएबल्स: कुछ बिल्ट-इन सिस्टम पैरामीटर्स, जैसे कि वर्तमान समय।

हमने शुरुआत करें में वेरिएबल फ़ीचर का कई बार उपयोग किया है। उदाहरण के लिए, एक गणना नोड में, हम गणना के लिए ट्रिगर संदर्भ डेटा को संदर्भित करने के लिए वेरिएबल्स का उपयोग कर सकते हैं:

एक अपडेट नोड में, फ़िल्टर शर्त के लिए ट्रिगर संदर्भ डेटा को एक वेरिएबल के रूप में उपयोग करें, और अपडेट किए जाने वाले फ़ील्ड मान के लिए एक वेरिएबल के रूप में गणना नोड के परिणाम को संदर्भित करें:

#डेटा संरचना

एक वेरिएबल आंतरिक रूप से एक JSON संरचना होता है, और आप आमतौर पर इसके JSON पाथ द्वारा डेटा के एक विशिष्ट हिस्से का उपयोग कर सकते हैं। चूंकि कई वेरिएबल्स NocoBase के संग्रह संरचना पर आधारित होते हैं, संबंध डेटा को ऑब्जेक्ट गुणों के रूप में पदानुक्रमित रूप से संरचित किया जाएगा, जिससे एक ट्री-जैसी संरचना बनेगी। उदाहरण के लिए, हम क्वेरी किए गए डेटा के संबंध डेटा से एक विशिष्ट फ़ील्ड का मान चुन सकते हैं। इसके अतिरिक्त, जब संबंध डेटा में "टू-मेनी" (कई से कई) संरचना होती है, तो वेरिएबल एक ऐरे हो सकता है।

वेरिएबल चुनते समय, आपको अक्सर अंतिम-स्तर के मान विशेषता (value attribute) का चयन करना होगा, जो आमतौर पर एक साधारण डेटा प्रकार होता है, जैसे कि संख्या या स्ट्रिंग। हालाँकि, जब वेरिएबल पदानुक्रम में एक ऐरे होता है, तो अंतिम-स्तर की विशेषता भी एक ऐरे में मैप हो जाएगी। ऐरे डेटा को तभी सही ढंग से संसाधित किया जा सकता है जब संबंधित नोड ऐरे का समर्थन करता हो। उदाहरण के लिए, एक गणना नोड में, कुछ गणना इंजनों में ऐरे को संभालने के लिए विशेष फ़ंक्शन होते हैं। एक और उदाहरण लूप नोड में है, जहाँ लूप ऑब्जेक्ट भी एक ऐरे हो सकता है।

उदाहरण के लिए, जब एक क्वेरी नोड कई डेटा को क्वेरी करता है, तो नोड का परिणाम समरूप डेटा की कई पंक्तियों वाला एक ऐरे होगा:

[
  {
    "id": 1,
    "title": "标题1"
  },
  {
    "id": 2,
    "title": "标题2"
  }
]

हालाँकि, जब इसे बाद के नोड्स में एक वेरिएबल के रूप में उपयोग किया जाता है, यदि चयनित वेरिएबल नोड डेटा/क्वेरी नोड/शीर्षक के रूप में है, तो आपको संबंधित फ़ील्ड मानों में मैप किया गया एक ऐरे मिलेगा:

["标题1", "标题2"]

यदि यह एक बहु-आयामी ऐरे है (जैसे कई-से-कई संबंध फ़ील्ड), तो आपको संबंधित फ़ील्ड को समतल (flatten) करने के बाद एक-आयामी ऐरे मिलेगा।

#सिस्टम बिल्ट-इन वेरिएबल्स

#सिस्टम समय

निष्पादित किए गए नोड के अनुसार, निष्पादन के समय का सिस्टम समय प्राप्त होता है। इस समय का टाइम ज़ोन सर्वर पर सेट किया गया टाइम ज़ोन होता है।

#दिनांक सीमा पैरामीटर्स

क्वेरी, अपडेट और डिलीट नोड्स में दिनांक फ़ील्ड फ़िल्टर शर्तों को कॉन्फ़िगर करते समय इसका उपयोग किया जा सकता है। यह केवल "बराबर है" (equals) तुलनाओं के लिए समर्थित है। दिनांक सीमा के प्रारंभ और समाप्ति बिंदु दोनों सर्वर पर सेट किए गए टाइम ज़ोन पर आधारित होते हैं।