नियंत्रण संग्रह (क्लाइंट एपीआई संदर्भ)

स्तंभों से संबद्ध नियंत्रणों तक पहुँचने के लिए संग्रह का controls उपयोग करें.

जब आप किसी स्तंभ से जुड़े नियंत्रणों पर क्रियाएँ करते हैं, तो विचार करें कि नियंत्रण पृष्ठ पर एक से अधिक बार प्रकट हो सकता है. आम तौर पर, आपको स्तंभ के लिए प्रत्येक नियंत्रण के लिए समान क्रियाएँ करनी चाहिए. आप कॉलम नियंत्रण संग्रह के माध्यम से लूप कर सकते हैं और प्रत्येक नियंत्रण पर क्रियाएं कर सकते हैं।

उदाहरण के लिए, स्तंभ से बंधे name प्रत्येक नियंत्रण में कोई सूचना जोड़ने के लिए, निम्न कोड का उपयोग करें:

const notification = {
    messages: ['Sample Notification on Name Controls'],
    notificationLevel: 'RECOMMENDATION',
    uniqueId: 'my_unique_id'
 };
 
formContext.getAttribute("name").controls.forEach(control =>
    control.addNotification(notification)
 );

चूँकि प्रत्येक स्तंभ पृष्ठ पर एक से अधिक बार प्रकट हो सकता है, इसलिए नियंत्रण संग्रह उस स्तंभ का प्रतिनिधित्व करने वाले सभी नियंत्रणों तक पहुँच प्रदान करता है. यदि स्तंभ को पृष्ठ पर केवल एक नियंत्रण द्वारा दर्शाया जाता है, तो इस संग्रह की लंबाई 1 है।

जब आप नियंत्रण getName विधि का उपयोग करते हैं, तो पहले नियंत्रण का नाम स्तंभ के नाम से मेल खाता है। उस कॉलम के लिए नियंत्रण का दूसरा उदाहरण है <columnName>1। पैटर्न <columnName>+N किसी विशिष्ट स्तंभ के लिए प्रपत्र में जोड़े गए प्रत्येक अतिरिक्त नियंत्रण के लिए जारी रहता है.

जब कोई प्रपत्र शीर्ष लेख में व्यवसाय प्रक्रिया प्रवाह नियंत्रण प्रदर्शित करता है, तो यह व्यवसाय प्रक्रिया प्रवाह में प्रकट होने वाले प्रत्येक स्तंभ के लिए नियंत्रण जोड़ता है. इन नियंत्रणों का निम्न की तरह एक अद्वितीय नाम है: header_process_<column name>.

संबंधित आलेख

कॉलम (क्लाइंट एपीआई संदर्भ)