DataSourceInfo फ़ंक्शन
इस पर लागू होता है:
कैनवास ऐप्स मॉडल-संचालित ऐप्स
डेटा स्रोत के बारे में जानकारी प्रदान करते हैं.
ओवरव्यू
उपयोगकर्ता अनुभव को अनुकूलित करने के लिए डेटा स्रोत जानकारी का खजाना प्रदान कर सकते हैं.
आप उपयोगकर्ता को सत्यापित करने के लिए स्तंभ-जानकारी का उपयोग कर सकते हैं और Patch फ़ंक्शन का उपयोग करने से पहले उपयोगकर्ता को तुरंत प्रतिक्रिया प्रदान कर सकते हैं. Validate फ़ंक्शन इसी जानकारी का उपयोग करता है.
आप डेटा-स्रोत स्तर पर जानकारी का उपयोग कर सकते हैं, उदाहरण के लिए, उन उपयोगकर्ताओं के लिए संपादित करें और नया बटन अक्षम करने या छिपाने हेतु, जिनके पास रिकॉर्ड को संपादित करने और बनाने की अनुमति नहीं है.
डेटा स्रोत इस बात में भिन्न होते हैं कि वे कितनी जानकारी प्रदान करते हैं, इसमें कोई भी जानकारी नहीं प्रदान करना शामिल है. संग्रह कोई जानकारी नहीं प्रदान करते हैं. यदि जानकारी नहीं प्रदान की जाती है, तो एक डिफ़ॉल्ट का उपयोग किया जाता है या रिक्त दिखाया जाता है.
नोट
फिलहाल, Microsoft Lists में DataSourceInfo फ़ंक्शन समर्थित नहीं है.
विवरण
कॉलम की जानकारी
आप डेटा स्रोत के किसी खास स्तंभ के बारे में जानकारी प्राप्त करने के लिए DataSourceInfo का उपयोग कर सकते हैं:
| जानकारी तर्क | परिणाम प्रकार | वर्णन |
|---|---|---|
| DataSourceInfo.DisplayName | स्ट्रिंग | स्तंभ के लिए प्रदर्शन नाम. यदि कोई प्रदर्शन नाम परिभाषित नहीं है, तो स्तंभ नाम दिखाया जाता है. |
| DataSourceInfo.MaxLength | संख्या | वर्णों की वह अधिकतम संख्या, जो स्तंभ में हो सकते हैं. केवल उन स्तंभों पर लागू होता है, जिनमें स्ट्रिंग होते हैं. यदि अधिकतम सेट नहीं किया गया होता है, तो रिक्त दिखाता है. |
| DataSourceInfo.MaxValue | संख्या | वह अधिकतम संख्यात्मक मान, जो एक स्तंभ में हो सकते हैं. केवल उन स्तंभों पर लागू होता है, जिनमें संख्याएँ होती हैं. यदि अधिकतम सेट नहीं किया गया होता है, तो रिक्त दिखाता है. |
| DataSourceInfo.MinValue | संख्या | वह न्यूनतम संख्यात्मक मान, जो एक स्तंभ में हो सकते हैं. केवल उन स्तंभों पर लागू होता है, जिनमें संख्याएँ होती हैं. यदि न्यूनतम सेट नहीं किया गया होता है, तो रिक्त दिखाता है. |
| DataSourceInfo.Required | बूलियन | क्या इस स्तंभ के लिए एक मान आवश्यक है? यदि डेटा स्रोत द्वारा सेट नहीं किया गया है, तो गलत दिखाता है. |
तीसरा तर्क एक स्ट्रिंग के रूप में एक स्तंभ का नाम है. उदाहरण के लिए, संग्रह People में स्तंभ Phone दोहरे उद्धरण चिह्नों के साथ "Phone" के रूप में पास किया जाएगा.
डेटा-स्रोत संबंधी जानकारी
आप डेटा स्रोत के बारे में संपूर्ण रूप से जानकारी प्राप्त करने के लिए भी DataSourceInfo का उपयोग कर सकते हैं:
| जानकारी तर्क | परिणाम प्रकार | वर्णन |
|---|---|---|
| DataSourceInfo.AllowedValues | बूलियन | इस डेटा स्रोत के लिए उपयोगकर्ताओं को किस प्रकार की अनुमतियाँ दी जा सकती हैं? यदि डेटा स्रोत द्वारा सेट नहीं किया गया है, तो रिक्त दिखाता है. |
| DataSourceInfo.CreatePermission | बूलियन | क्या वर्तमान उपयोगकर्ता के पास इस डेटा स्रोत में रिकॉर्ड बनाने की अनुमति है? यदि डेटा स्रोत द्वारा सेट नहीं किया गया है, तो सही दिखाता है. |
| DataSourceInfo.DeletePermission | बूलियन | क्या वर्तमान उपयोगकर्ता के पास इस डेटा स्रोत में रिकॉर्ड हटाने की अनुमति है? यदि डेटा स्रोत द्वारा सेट नहीं किया गया है, तो सही दिखाता है. |
| DataSourceInfo.EditPermission | बूलियन | क्या वर्तमान उपयोगकर्ता के पास इस डेटा स्रोत में रिकॉर्ड संपादित करने की अनुमति है? यदि डेटा स्रोत द्वारा सेट नहीं किया गया है, तो सही दिखाता है. |
| DataSourceInfo.ReadPermission | बूलियन | क्या वर्तमान उपयोगकर्ता के पास इस डेटा स्रोत में रिकॉर्ड पढ़ने की अनुमति है? यदि डेटा स्रोत द्वारा सेट नहीं किया गया है, तो सही दिखाता है. |
नोट
यदि यह निर्धारित नहीं कर सकता है कि वर्तमान उपयोगकर्ता के पास अनुरोधित अनुमति है या नहीं, तो DataSourceInfo सही को लौटाता है. अनुमतियों की सर्वर द्वारा फिर से जांच की जाएगी जब वास्तविक ऑपरेशन किया जाता है और अगर इसे अनुमति नहीं दी गई थी तो एक त्रुटि प्रदर्शित की जाती है. इस समय, DataSourceInfo के साथ अनुमतियों की जाँच केवल Microsoft Dataverse का उपयोग करते समय ही संभव है.
सिंटैक्स
डेटा स्रोत जानकारी( डेटा स्रोत, सूचना [, कॉलम नाम] )
- DataSource – आवश्यक है. उपयोग किए जाने वाला डेटा स्रोत.
- Information – आवश्यक. वह जानकारी प्रकार, जिसे आप पुनर्प्राप्त करना चाहते हैं.
- ColumnName – वैकल्पिक. वह स्तंभ नाम जिसके लिए स्तंभ-स्तरीय जानकारी प्राप्त करनी है. डेटा-स्रोत स्तर पर जानकारी के लिए, ColumnName तर्क का उपयोग नहीं किया जा सकता है.
नोट
संस्करण 3.24042 से पहले, स्तंभ नामों को दोहरे उद्धरण चिह्नों का उपयोग करके एक टेक्स्ट स्ट्रिंग के साथ निर्दिष्ट किया जाता था, और यदि उन्हें डेटा स्रोत से जोड़ा जाता था तो उन्हें तार्किक नाम भी होना चाहिए था। Power Apps उदाहरण के लिए, उद्धरण चिह्नों के बिना प्रदर्शन नाम नाम के स्थान पर दोहरे उद्धरण चिह्नों के साथ तार्किक नाम "cr43e_name" का उपयोग किया गया था। SharePoint और Excel डेटा स्रोतों के लिए जिनमें रिक्त स्थान के साथ स्तंभ नाम होते हैं, प्रत्येक रिक्त स्थान को "_x0020_" के साथ निर्दिष्ट किया गया था, उदाहरण के लिए "स्तंभ नाम" के रूप में "स्तंभ_x0020_नाम". इस संस्करण के बाद, सभी ऐप्स स्वचालित रूप से इस आलेख में वर्णित नए सिंटैक्स में अपडेट हो गए।
उदाहरण
इस सेक्शन में उदाहरण IceCream नामक इस डेटा स्रोत का उपयोग करते हैं:
डेटा स्रोत ने भी यह जानकारी प्रदान की है:
- Quantity के लिए प्रदर्शन नाम "Quantity on Hand" है.
- Flavor में अधिकतम 30 वर्ण हो सकते हैं.
- Flavor स्तंभ में एक मान होना आवश्यक है. Quantity स्तंभ आवश्यक नहीं है.
- न्यूनतम Quantity 0 है.
- अधिकतम Quantity 100 है.
- वर्तमान उपयोगकर्ता IceCream डेटा स्रोत के रिकॉर्ड को पढ़ और संपादित कर सकता है, लेकिन रिकॉर्ड बना या हटा नहीं सकता.
| सूत्र | वर्णन | परिणाम |
|---|---|---|
| DataSourceInfo( आइसक्रीम, DataSourceInfo.DisplayName, मात्रा ) | IceCream डेटा स्रोत के Quantity स्तंभ के लिए प्रदर्शन नाम दिखाता है. | "Quantity on Hand" |
| DataSourceInfo( आइसक्रीम, DataSourceInfo.MaxLength, स्वाद ) | IceCream डेटा स्रोत के Flavor स्तंभ के लिए स्ट्रिंग की अधिकतम लंबाई दिखाता है. | 30 |
| DataSourceInfo( आइसक्रीम, DataSourceInfo.Required, स्वाद ) | क्या IceCream डेटा स्रोत का Flavor स्तंभ आवश्यक है? | सही |
| DataSourceInfo( आइसक्रीम, DataSourceInfo.Required, मात्रा ) | क्या IceCream डेटा स्रोत का Quantity स्तंभ आवश्यक है? | false |
| DataSourceInfo( आइसक्रीम, DataSourceInfo.MaxValue, मात्रा ) | IceCream डेटा स्रोत के Quantity स्तंभ का अधिकतम संख्यात्मक मान दिखाता है. | 100 |
| DataSourceInfo( आइसक्रीम, DataSourceInfo.MinValue, मात्रा ) | IceCream डेटा स्रोत के Quantity स्तंभ का न्यूनतम संख्यात्मक मान दिखाता है. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | क्या वर्तमान उपयोगकर्ता IceCream डेटा स्रोत में रिकॉर्ड पढ़ सकता है? | सही |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | क्या वर्तमान उपयोगकर्ता IceCream डेटा स्रोत में रिकॉर्ड संपादित कर सकता है? | सही |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | क्या वर्तमान उपयोगकर्ता IceCream डेटा स्रोत में रिकॉर्ड बना सकता है? | गलत |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | क्या वर्तमान उपयोगकर्ता IceCream डेटा स्रोत में रिकॉर्ड हटा सकता है? | गलत |
प्रतिक्रिया
जल्द आ रहा है: 2024 के दौरान हम सामग्री के लिए फीडबैक तंत्र के रूप में GitHub मुद्दों को चरणबद्ध तरीके से समाप्त कर देंगे और इसे एक नई फीडबैक प्रणाली से बदल देंगे. अधिक जानकारी के लिए, देखें: https://aka.ms/ContentUserFeedback.
के लिए प्रतिक्रिया सबमिट करें और देखें