फ़ंक्शन मान्य करें

इन पर लागू होता है: कैनवास ऐप्स मॉडल-संचालित ऐप्स

Validate फ़ंक्शन जाँचता है कि एकल कॉलम या पूर्ण रिकॉर्ड का मान किसी डेटा स्रोत के लिए मान्य है अथवा नहीं.

वर्णन

उपयोगकर्ता द्वारा डेटा परिवर्तन सबमिट करने से पहले, आप उस सबमिशन की मान्यता पर तत्काल प्रतिक्रिया प्रदान कर सकते हैं, जिसके परिणामस्वरूप बेहतर उपयोगकर्ता अनुभव मिलता है.

डेटा स्रोत इस बात की जानकारी प्रदान कर सकते हैं कि रिकॉर्ड के भीतर मान्य मान क्या हैं. इस जानकारी में कई बाधाएँ शामिल हो सकती हैं, जैसे निम्न उदाहरण देखें:

• कॉलम को मान की आवश्यकता है अथवा नहीं
• पाठ की स्ट्रिंग की लंबाई कितनी हो सकती है
• संख्या कितनी बड़ी या छोटी हो सकती है
• दिनांक कितनी जल्दी और विलंब वाला हो सकता है

Validate फ़ंक्शन इस जानकारी का उपयोग यह निर्धारित करने के लिए, कि मान मान्य है अथवा नहीं, और यदि नहीं, तो उचित त्रुटि संदेश देने के लिए करता है. जिस जानकारी का Validate उपयोग करता है, उसी को देखने के लिए आप DataSourceInfo फ़ंक्शन का उपयोग कर सकते हैं.

डेटा स्रोत इस बात में भिन्न होते हैं कि वे कितनी मान्यता जानकारी प्रदान करते हैं, इसमें कोई भी जानकारी न प्रदान करना भी शामिल है. Validate इस जानकारी के आधार पर केवल मानों को सत्यापित कर सकता है. भले ही मान्य करें को कोई समस्या न मिले, फिर भी डेटा परिवर्तन लागू करना विफल हो सकता है. आप विफलता के बारे में जानकारी प्राप्त करने के लिए Errors फ़ंक्शन का उपयोग कर सकते हैं.

यदि Validate को कोई समस्या पता चलती है, तो फ़ंक्शन एक त्रुटि संदेश देता है जिसे आप ऐप के उपयोगकर्ता को दिखा सकते हैं. यदि सभी मान मान्य हैं, तो Validateblank देता है. जब आप एक ऐसे संग्रह के साथ कार्य करते हैं, जिसकी कोई सत्यापन जानकारी नहीं होती, तो मान हमेशा मान्य होते हैं.

सिंटैक्स

Validate( DataSource, कॉलम, मान )

• DataSource – आवश्यक है. डेटा स्रोत, जिसके साथ मान्य करना है.
• कॉलम – आवश्यक है. मान्य किया जाने वाला कॉलम.
• मान – आवश्यक है. चयनित कॉलम के लिए का मान, जिसे मान्य किया जाना है.

Validate( DataSource, OriginalRecord, अपडेट )

• DataSource – आवश्यक है. डेटा स्रोत, जिसके साथ मान्य करना है.
• OriginalRecord - आवश्यक. रिकॉर्ड, जिसके अद्यतनों को मान्य किया जाना है.
• अपडेट - आवश्यक. वे परिवर्तन, जो मूल रिकॉर्ड पर लागू होंगे.

उदाहरण

इन उदाहरणों के लिए, Scores डेटा स्रोत के Percentage कॉलम में मान 0 और 100, समावेशी, के बीच होना चाहिए. यदि डेटा सत्यापन पास करता है, तो फ़ंक्शन रिक्त देता है. अन्यथा, फ़ंक्शन एक त्रुटि संदेश देता है.

एक एकल कॉलम के साथ मान्य करें

सूत्र	वर्णन	परिणाम
वैलिडेट( Scores, Percentage, 10 )	जाँच करता है कि Score डेटा स्रोत में Percentage कॉलम के लिए 10 एक मान्य मान है अथवा नहीं.	रिक्त
वैलिडेट( Scores, Percentage, 120 )	जाँच करता है कि Score डेटा स्रोत में Percentage कॉलम के लिए 120 एक मान्य मान है अथवा नहीं.	"मान 0 और 100 के बीच होने चाहिए."

एक संपूर्ण रिकॉर्ड के साथ मान्य करें

सूत्र	वर्णन	परिणाम
वैलिडेट( Scores, EditRecord, Gallery.Updates )	जाँचता है कि सभी कॉलमों में मान Score डेटा स्रोत के लिए मान्य हैं अथवा नहीं. इस उदाहरण में, Percentage कॉलम में मान 10 है.	रिक्त
वैलिडेट( Scores, EditRecord, Gallery.Updates )	जाँचता है कि सभी कॉलमों में मान Score डेटा स्रोत के लिए मान्य हैं अथवा नहीं. इस उदाहरण में, Percentage कॉलम में मान 120 है.	"मान 0 और 100 के बीच होने चाहिए."