संग्रह, साफ़ करें, और ClearCollect फ़ंक्शन

संग्रह बनाता और हटाता है और किसी डेटा स्रोत में रिकॉर्ड जोड़ता है.

Collect

इस पर लागू होता है: कैनवास ऐप्स कार्ड Dataverse लो-कोड प्लग-इन Power Platform CLI डेस्कटॉप प्रवाह

Collect फ़ंक्शन डेटा स्रोत में रिकॉर्ड जोड़ता है. जोड़े जाने वाले आइटम निम्न हो सकते हैं:

• एकल मान: मान को Value फ़ील्ड के नए रिकॉर्ड में रखा जाता है. अन्य सभी गुण blank छोड़ दिए गए हैं.
• रिकॉर्ड: प्रत्येक नामित गुण को नए रिकॉर्ड के संबंधित गुण में रखा गया है. अन्य सभी गुण रिक्त छोड़ दिए गए हैं.
• तालिका: तालिका का प्रत्येक रिकॉर्ड ऊपर वर्णित डेटा स्रोत के अलग रिकॉर्ड के रूप में जोड़ा जाता है. तालिका को नेस्टेड तालिका के रूप में रिकॉर्ड में नहीं जोड़ा गया है. ऐसा करने के लिए, तालिका को पहले रिकॉर्ड में सम्मिलित कर लें.

जब संग्रह के साथ उपयोग किया जाता है, तो अतिरिक्त स्तंभ आवश्यकतानुसार बनाया जाएगा. अन्य डेटा स्रोतों के लिए स्तंभ डेटा स्रोत तय करते हैं और नए स्तंभ नहीं जोड़े जा सकते हैं.

यदि डेटा स्रोत में पहले से मौजूद नहीं है, तो संग्रह बनाया जाता है.

संग्रह का उपयोग कभी-कभी वैश्विक चर रखने या डेटा स्रोत की अस्थायी प्रतिलिपि बनाने के लिए किया जाता है. कैनवस ऐप ऐसे फॉर्मूलों पर आधारित हैं जो उपयोगकर्ता द्वारा किसी ऐप के साथ अंत:क्रिया करने पर स्वचालित रूप से पुनर्गणना करते हैं. संग्रह इस लाभ का उपयोग नहीं करते हैं और उनका उपयोग आपके ऐप को बनाने और समझने में कठिन बना सकता है. इस तरीके से संग्रह का उपयोग करने से पहले, चर के साथ काम करना पर पुनर्विचार करें.

आप डेटा स्रोत में रिकॉर्ड बनाने के लिए Patch फ़ंक्शन का भी उपयोग कर सकते हैं.

Collect संशोधित डेटा स्रोत को तालिका के रूप में लौटाता है। संग्रह का उपयोग केवल a व्यवहार सूत्र में किया जा सकता है।

साफ करें

इस पर लागू होता है: कैनवास ऐप्स

Clear फंक्शन संग्रह के सभी रिकॉर्ड को हटा देता है. संग्रह के स्तंभ बने रहेंगे.

ध्यान दें कि हटाएं केवल संग्रह पर काम करता है न कि अन्य डेटा स्रोतों पर. आप इस उद्देश्य के लिए RemoveIf( DataSource, true ) उपयोग कर सकते है. सावधानी बरतें क्योंकि यह डेटा स्रोत के संग्रह से सभी रिकॉर्ड को हटा देगा और अन्य उपयोगकर्ताओं को प्रभावित कर सकता है.

आप रिकॉर्ड को हटाने के लिए Remove फ़ंक्शन का उपयोग कर सकते हैं.

Clear का कोई रिटर्न मान नहीं है. इसका उपयोग केवल व्यवहार फॉर्मूले में किया जा सकता है.

ClearCollect

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

ClearCollect फ़ंक्शन संग्रह से सभी रिकॉर्ड हटा देता है. और फिर समान संग्रह में रिकॉर्ड का अलग सेट जोड़ता है. एकल फ़ंक्शन के साथ, ClearCollect, Clear और फिर Collect का संयोजन प्रदान करता है.

ClearCollect संशोधित संग्रह को तालिका के रूप में लौटाता है. ClearCollect का उपयोग केवल व्यवहार सूत्र में किया जा सकता है.

प्रत्यायोजन

डेटा स्रोत के साथ उपयोग किए जाने पर, यह फ़ंक्शन प्रत्यायुक्त नहीं किए जा सकते. डेटा स्रोत का केवल पहला भाग पुनर्प्राप्त किया जाएगा और फिर फ़ंक्शन लागू होगा. हो सकता है कि परिणाम पूर्ण कहानी प्रस्तुत न करे. इस सीमा के बारे में आपको याद दिलाने के लिए और संभवतः प्रत्यायोजन योग्य विकल्पों पर स्विच करने का सुझाव देने के लिए लेखांकन समय पर एक चेतावनी दिखाई दे सकती है. अधिक जानकारी के लिए, प्रत्यायोजन ओवरव्यू देखें.

सिंटैक्स

एकत्रित करें( डेटा स्रोत, आइटम, ... )

• डेटा स्रोत – आवश्यक. डेटा स्रोत जिससे आप डेटा को जोड़ना चाहते हैं. यदि यह पहले से मौजूद नहीं है, तो नया संग्रह बनाया जाता है.
• आइटम - आवश्यक. डेटा स्रोत में जोड़ने के लिए एक या अधिक रिकॉर्ड या तालिका.

साफ़ करें( संग्रह )

• संग्रह – आवश्यक. संग्रह जिसे आप हटाना चाहते हैं.

साफ़ करेंसंग्रह( संग्रह, आइटम, ... )

• संग्रह – आवश्यक. वह संग्रह जिसे आप हटाना चाहते हैं और फिर डेटा जोड़ें.
• आइटम - आवश्यक. डेटा स्रोत में जोड़ने के लिए एक या अधिक रिकॉर्ड या तालिका.

उदाहरण

डेटा स्रोत से रिकॉर्ड हटाना और जोड़ना

इन उदाहरणों में, आप एक संग्रह से जिसका नाम IceCream है, मिटा देंगे और जोड़ देंगे. डेटा स्रोत इन सामग्रियों से शुरू होता है:

सूत्र	विवरण	परिणाम
ClearCollect( आइसक्रीम, { स्वाद: "स्ट्रॉबेरी", मात्रा: 300 } )	IceCream संग्रह से पूरे डेटा को हटा देता है और फिर एक रिकॉर्ड जोड़ता है जिसमें स्ट्रॉबेरी आइसक्रीम की मात्रा शामिल होती है.	IceCream संग्रह को भी संशोधित किया गया है.
एकत्रित करें( आइसक्रीम, { स्वाद: "पिस्ता", मात्रा: 40 }, { स्वाद: "नारंगी", मात्रा: 200 } )	IceCream संग्रह में दो रिकॉर्ड जोड़ता है जिसमें पिस्ता और ऑरेंज आइसक्रीम की मात्राएं शामिल हैं.	IceCream संग्रह को भी संशोधित किया गया है.
साफ़( आइसक्रीम )	IceCream संग्रह से सभी रिकॉर्ड हटाता है.	IceCream संग्रह को भी संशोधित किया गया है.

संग्रह बनाने के तरीके के चरण-दर-चरण उदाहरणों के लिए, संग्रह बनाएं और अद्यतन करें देखें.

रिकार्ड और तालिकाएं

ये उदाहरण जांचते हैं कि संग्रह करें और ClearCollect के रिकॉर्ड और तालिका के तर्क कैसे प्रबंधित होते हैं.

सूत्र	वर्णन	परिणाम
ClearCollect( आइसक्रीम, { स्वाद: "चॉकलेट", मात्रा: 100 }, { स्वाद: "वेनिला", मात्रा: 200 } )	सभी डेटा हटाएं और फिर IceCream संग्रह से दो रिकॉर्ड जोड़े जिसमें चॉकलेट और वेनिला आइसक्रीम की मात्राएं शामिल हैं. जोड़े जाने वाले रिकॉर्ड को फ़ंक्शन के लिए व्यक्तिगत तर्क के रूप में प्रदान किया जाता है.	IceCream संग्रह को भी संशोधित किया गया है.
ClearCollect( आइसक्रीम, तालिका( { स्वाद: "चॉकलेट", मात्रा: 100 }, { स्वाद: "वेनिला", मात्रा: 200 } ) )	पिछले उदाहरण के समान ही, सिवाय इसके कि रिकॉर्ड्स को एक तालिका में जोड़ा गया है और एकल तर्क के माध्यम से पारित किया गया है. तालिका की सामग्री को IceCream संग्रह में जोड़े जाने से पहले रिकॉर्ड दर रिकॉर्ड निकाला जाता है.	IceCream संग्रह को भी संशोधित किया गया है.
क्लियरकलेक्ट( आइसक्रीम, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	पिछले उदाहरण के समान ही सिवाय इसके कि तालिका को रिकॉर्ड में सम्मिलित किया गया है. तालिका के रिकॉर्ड नहीं निकाले गए हैं और इसके बजाय पूरी तालिका को रिकॉर्ड के सेल के रूप में जोड़ा गया है.	IceCream संग्रह को भी संशोधित किया गया है.