त्रुटियाँ फ़ंक्शन
इस पर लागू होता है:
कैनवास ऐप्स मॉडल-संचालित ऐप्स
पिछले परिवर्तनों के लिए त्रुटि जानकारी एक डेटा स्रोत को प्रदान करता है.
अवलोकन
जब डेटा स्रोत का कोई रिकॉर्ड परिवर्तित होता है, तो त्रुटियाँ हो सकती हैं. इसके कई कारण संभव हैं, जिसमें नेटवर्क आउटेज, अपर्याप्त अनुमति और संपादन विरोध शामिल हैं.
डेटा स्रोत में डेटा संशोधित करने वाले फ़ंक्शन, जैसे कि Patch, Collect, Remove, RemoveIf, Update, UpdateIf, and SubmitForm दो तरीकों में त्रुटियों की रिपोर्ट करते हैं:
- इनमें से प्रत्येक फ़ंक्शन ऑपरेशन के परिणाम के रूप में एक त्रुटि मान लौटाएगा. IsError के साथ त्रुटियों का पता लगाया जा सकता है और हमेशा की तरह IfError और App.OnError से प्रतिस्थापित किया या छुपाया जा सकता है. अधिक जानकारी के लिए त्रुटि संभालना देखें.
- कार्रवाई के बाद, Errors फ़ंक्शन भी पिछले कार्यों की त्रुटियाँ लौटाएगा. यह स्थिति वेरिएबल में त्रुटि को कैप्चर करने की आवश्यकता के बिना प्रपत्र स्क्रीन पर त्रुटि संदेश प्रदर्शित करने के लिए उपयोगी हो सकता है.
आप Validate और DataSourceInfo फ़ंक्शन के उपयोग द्वारा कुछ त्रुटियाँ होने से बच सकते हैं. त्रुटियों के साथ कार्य करने और इनसे बचने के तरीकों के बारे में अधिक सुझावों के लिए डेटा स्रोतों के साथ कार्य करना देखें.
वर्णन
Errors फ़ंक्शन त्रुटियों की एक तालिका देता है, जिसमें निम्न स्तंभ शामिल होते हैं:
- अभिलेख। डेटा स्रोत में रिकॉर्ड, जिसमें त्रुटि हुई थी. यदि रिकॉर्ड बनाने के दौरान त्रुटि हुई है, तो यह स्तंभ रिक्त होगा.
- स्तंभ। वह स्तंभ, जिसके कारण त्रुटि हुई, यदि त्रुटि को एकल स्तंभ में एट्रिब्यूट किया जा सकता है. यदि नहीं, तो यह रिक्त होगा.
- संदेश। त्रुटि का विवरण. यह त्रुटि स्ट्रिंग अंतिम उपयोगकर्ता के लिए प्रदर्शित की जा सकती है. ध्यान रखें कि यह संदेश डेटा स्रोत द्वारा जनरेट किया जा सकता है, हो सकता है कि यह लंबा हो और इसमें अपरिष्कृत स्तंभ नाम शामिल हों, जिनका उपयोगकर्ता के लिए कोई अर्थ न हो.
- गलती। त्रुटि कोड जिसका उपयोग त्रुटि का समाधान करने के लिए सूत्रों में किया जा सकता है:
| ErrorKind | वर्णन |
|---|---|
| ErrorKind.Conflict | समान रिकॉर्ड पर एक अन्य परिवर्तन किया गया, जिसके परिणामस्वरूप एक परिवर्तन विरोध हुआ. रिकॉर्ड को पुनः लोड करने के लिए Refresh फ़ंक्शन का उपयोग करें और परिवर्तन करने का पुनः प्रयास करें. |
| ErrorKind.ConstraintViolation | एक या अधिक बाधाओं का उल्लंघन किया गया है. |
| ErrorKind.CreatePermission | रिकॉर्ड बनाने का प्रयास किया गया था, और वर्तमान उपयोगकर्ता के पास रिकॉर्ड बनाने की अनुमति नहीं है. |
| ErrorKind.DeletePermission | रिकॉर्ड हटाने का प्रयास किया गया था, और वर्तमान उपयोगकर्ता के पास रिकॉर्ड हटाने की अनुमति नहीं है. |
| ErrorKind.EditPermission | रिकॉर्ड संपादित करने का प्रयास किया गया था, और वर्तमान उपयोगकर्ता के पास रिकॉर्ड संपादित करने की अनुमति नहीं है. |
| ErrorKind.GeneratedValue | उस स्तंभ को परिवर्तित करने का प्रयास किया गया था, जिसे डेटा स्रोत स्वचालित रूप से उत्पन्न करता है. |
| ErrorKind.MissingRequired | आवश्यक स्तंभ का मान रिकॉर्ड से गायब है. |
| ErrorKind.None | कोई त्रुटि नहीं है. |
| ErrorKind.NotFound | रिकॉर्ड को संपादित करने या हटाने का प्रयास किया गया था, परंतु रिकॉर्ड नहीं मिला. हो सकता है कि किसी अन्य उपयोगकर्ता ने रिकॉर्ड परिवर्तित कर दिया हो. |
| ErrorKind.ReadOnlyValue | उस स्तंभ को परिवर्तित करने का प्रयास किया गया था, जो केवल पठन के लिए है. |
| ErrorKind.Sync | डेटा स्रोत द्वारा एक त्रुटि रिपोर्ट की गई थी. अधिक जानकारी के लिए संदेश स्तंभ देखें. |
| ErrorKind.Unknown | एक त्रुटि थी, लेकिन एक अज्ञात प्रकार की थी. |
| ErrorKind.Validation | एक सामान्य सत्यापन समस्या का पता चला था, जो किसी अन्य प्रकार में फ़िट नहीं हुआ. |
त्रुटियाँ पूरे डेटा स्रोत के लिए, या केवल फ़ंक्शन पर रिकॉर्ड तर्क प्रदान कर चयनित पंक्ति के लिए मिल सकती हैं.
पैबंद या कोई अन्य डेटा फ़ंक्शन लौटा सकता है खाली मान, उदाहरण के लिए, यदि कोई रिकॉर्ड नहीं बनाया जा सका। आप रिक्त को Errors पर पास कर सकते हैं, और इससे इन मामलों में उचित त्रुटि जानकारी मिलेगी. समान डेटा स्रोत पर इसके बाद किए जाने वाले डेटा फ़ंक्शन के उपयोग से यह त्रुटि जानकारी साफ़ हो जाएगी.
यदि कोई त्रुटि नहीं है, Errors देने वाली तालिका रिक्त होगी और इसका परीक्षण IsEmpty फ़ंक्शन द्वारा किया जा सकता है.
सिंटैक्स
त्रुटियाँ ( डेटा स्रोत [, अभिलेख ] )
- डेटा स्रोत – आवश्यक. वह डेटा स्रोत, जिसके लिए आप त्रुटियाँ देना चाहते हैं.
- अभिलेख - वैकल्पिक। वह विशिष्ट रिकॉर्ड, जिसके लिए आप त्रुटियाँ देना चाहते हैं. यदि आप इस तर्क को निर्दिष्ट नहीं करते, तो यह फ़ंक्शन पूरे डेटा स्रोत के लिए त्रुटियाँ देता है.
उदाहरण
चरण दर चरण
इस उदाहरण के लिए, हम IceCream डेटा स्रोत के साथ कार्य करेंगे:
ऐप के माध्यम से, एक उपयोगकर्ता डेटा-प्रविष्टि प्रपत्र में Chocolate रिकॉर्ड लोड करता है और फिर Quantity को 90 पर परिवर्तित करता है. जिस रिकॉर्ड के साथ काम किया जाना है, वह संदर्भ वेरिएबलEditRecord में रखा जाता है:
- अपडेट संदर्भ( { EditRecord: LookUp( आइसक्रीम, स्वाद = "चॉकलेट") } )
डेटा स्रोत में यह परिवर्तन करने के लिए, Patch फ़ंक्शन का उपयोग किया जाता है:
- पैच( आइसक्रीम, EditRecord, गैलरी.अपडेट्स )
जहाँ Gallery.Updates { Quantity: 90 } पर मूल्यांकन करता है, चूँकि केवल Quantity गुण को संशोधित किया गया है.
दुर्भाग्य से, Patch फ़ंक्शन को इनवोक किए जाने से ठीक पहले, किसी अन्य व्यक्ति ने Chocolate के लिए Quantity को 80 पर संशोधित कर दिया. Power Apps इसका पता लगाएगा और विरोधी परिवर्तनों को होने की अनुमति नहीं देगा. आप इस स्थिति को निम्न सूत्र द्वारा जाँच सकते हैं:
- IsEmpty( त्रुटियाँ( आइसक्रीम, EditRecord ) )
जो गलत देता है, क्योंकि Errors फ़ंक्शन ने निम्न तालिका दी थी:
| रिकॉर्ड | स्तंभ | संदेश | त्रुटि |
|---|---|---|---|
| { Flavor: "Chocolate", Quantity: 100 } | खाली | "आप जिस रिकॉर्ड को संशोधित करने का प्रयास कर रहे हैं, उसे एक अन्य उपयोगकर्ता ने संशोधित कर दिया है. कृपया रिकॉर्ड को पुनः लोड करें और पुनः प्रयास करें." | ErrorKind.Conflict |
आप प्रपत्र पर एक लेबल रख सकते हैं ताकि उपयोगकर्ता को यह त्रुटि दिखाई जा सके.
- त्रुटि दिखाने के लिए, लेबल के Text गुण को इस सूत्र पर सेट करें:
लेबल.टेक्स्ट = प्रथम(त्रुटियाँ(आइसक्रीम, संपादनरिकॉर्ड)).संदेश
आप प्रपत्र पर एक पुनः लोड करें बटन भी जोड़ सकते हैं, ताकि उपयोगकर्ता कुशलता से विरोध का समाधान कर सके.
- बटन को केवल तब दिखाने के लिए, जब विरोध हो गया है, बटन के Visible गुण को इस सूत्र पर सेट करें:
!IsEmpty( लुकअप( त्रुटियाँ( आइसक्रीम, EditRecord ), त्रुटि = ErrorKind.Conflict ) ) - उपयोगकर्ता द्वारा बटन चयन करने किए गए परिवर्तनों को वापस करने के लिए, इसके OnSelect गुण को इस सूत्र पर सेट करें:
ReloadButton.OnSelect = रिवर्ट( आइसक्रीम, EditRecord )