AddColumns, , DropColumns, RenameColumnsऔर कार्य ShowColumns

इस पर लागू होता है: कैनवास ऐप्लिकेशन Copilot Studio Desktop flows मॉडल-चालित ऐप्लिकेशन Power Platform CLI Dataverse फ़ंक्शंस

किसी तालिका या रिकॉर्ड को जोड़कर, छोड़कर, उसका नाम बदलकर और उसके स्तंभों का चयन करके उसे आकार देता है.

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

ओवरव्यू

ये फ़ंक्शन अपने कॉलम को समायोजित करके एक तालिका या रिकॉर्ड को आकार देते हैं:

• एकल-स्तंभ फ़ंक्शंस , जैसे निम्न या Sqrt के साथ उपयोग के लिए एक ही स्तंभ तक एकाधिक स्तंभ वाले तालिका या रिकॉर्ड को कम करें.
• किसी तालिका या रिकॉर्ड में परिकलित स्तंभ जोड़ें (उदाहरण के लिए, एक कुल मूल्य स्तंभ जो मात्रा कोइकाई मूल्य से गुणा करने के परिणाम दिखाता है).
• उपयोगकर्ताओं को प्रदर्शित करने के लिए या सूत्रों में उपयोग के लिए, स्तंभ का नाम किसी सार्थक नाम में बदलें.

Power Apps में तालिका एक मान होती है, स्ट्रिंग या संख्या की तरह. आप एक सूत्र में एक तालिका को एक तर्क के रूप में निर्दिष्ट कर सकते हैं, और परिणामस्वरूप फ़ंक्शन एक तालिका को वापस लौटा सकते हैं.

नोट

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

आप इन फ़ंक्शन का उपयोग करके किसी डेटा स्रोत के स्तंभों को संशोधित नहीं कर सकते हैं. आपको डेटा को इसके स्रोत पर संशोधित करना होगा. आप Collect फ़ंक्शन के साथ संग्रह में स्तंभ जोड़ सकते हैं. अधिक जानकारी के लिए, डेटा स्रोतों के साथ कार्य करना देखें।

विवरण

AddColumns फ़ंक्शन किसी तालिका या रिकॉर्ड में एक स्तंभ जोड़ता है, और एक सूत्र उस स्तंभ में मानों को परिभाषित करता है. मौजूदा कॉलम असंशोधित रहते हैं.

सूत्र का मूल्यांकन प्रदान किए गए रिकॉर्ड के लिए, या प्रदान की गई तालिका के प्रत्येक रिकॉर्ड के लिए किया जाता है।

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

DropColumns फ़ंक्शन किसी तालिका या रिकॉर्ड से स्तंभों को बाहर करता है. सभी अन्य कॉलम असंशोधित रहते हैं. DropColumns कॉलम को शामिल नहीं करता है, और ShowColumns कॉलम शामिल करता है।

किसी तालिका या रिकॉर्ड के एक या अधिक स्तंभों का नाम बदलने के लिए फ़ंक्शन का उपयोग कम RenameColumns से कम एक तर्क जोड़ी प्रदान करके करें जो तालिका या रिकॉर्ड में शामिल स्तंभ का नाम निर्दिष्ट करता है (पुराना नाम, जिसे आप बदलना चाहते हैं) और उस स्तंभ का नाम निर्दिष्ट करता है जिसमें तालिका या रिकॉर्ड में नहीं है (नया नाम, जिसे आप उपयोग करना चाहते हैं)। पुराना नाम तालिका या रिकॉर्ड में पहले से मौजूद होना चाहिए, और नया नाम मौजूद नहीं होना चाहिए. प्रत्येक स्तंभ नाम तर्क सूची में केवल एक बार या तो पुराने स्तंभ नाम या नए स्तंभ नाम के रूप में प्रकट हो सकता है. किसी स्तंभ का नाम किसी मौजूदा स्तंभ नाम से पुनर्नाम करने के लिए, पहले मौजूदा स्तंभ को इसके साथ छोड़ें DropColumns, या एक फ़ंक्शन RenameColumns को दूसरे फ़ंक्शन में नेस्ट करके मौजूदा स्तंभ का नाम बदलें.

फ़ंक्शन में ShowColumns किसी तालिका या रिकॉर्ड के स्तंभ शामिल होते हैं और अन्य सभी स्तंभों को छोड़ देते हैं। आप एकल-स्तंभ तालिका बनाने या किसी बहु-स्तंभ तालिका या रिकॉर्ड से रिकॉर्ड करने के लिए उपयोग ShowColumns कर सकते हैं. ShowColumns कॉलम शामिल हैं, और DropColumns कॉलम को शामिल नहीं करता है।

इन सभी कार्यों के लिए, परिणाम लागू किए गए ट्रांसफ़ॉर्म के साथ एक नई तालिका या रिकॉर्ड है। मूल तालिका या रिकॉर्ड संशोधित नहीं किया गया है. आप किसी मौजूदा तालिका या रिकॉर्ड को किसी सूत्र के साथ संशोधित नहीं कर सकते. SharePoint, Microsoft Dataverse, SQL Server और अन्य डेटा स्रोत सूचियों और तालिकाओं के स्तंभों को संशोधित करने के लिए उपकरण प्रदान करते हैं, जिन्हें अक्सर स्कीमा के रूप में जाना जाता है। इस विषय में कार्य केवल एक इनपुट तालिका या रिकॉर्ड को बदलते हैं, मूल को संशोधित किए बिना, आगे के उपयोग के लिए आउटपुट तालिका या रिकॉर्ड में।

इन फ़ंक्शन के तर्क प्रत्यायोजन का समर्थन करते हैं. उदाहरण के लिए, तर्क के रूप में Filter फ़ंक्शन का उपयोग किया गया ताकि सभी सूचियों से संबंधित रिकॉर्ड्स खोज को निकाला जा सके, भले ही '[dbo]. [AllListings]' डेटा स्रोत में एक लाख पंक्तियाँ हों:

AddColumns( RealEstateAgents,
   Listings,
   Filter(  '[dbo].[AllListings]', ListingAgentName = AgentName )
)

हालाँकि, इन फ़ंक्शन का आउटपुट गैर-प्रत्यायोजन रिकॉर्ड सीमा के अधीन है. इस उदाहरण में, केवल 500 रिकॉर्ड वापस लौटाए जाते हैं भले ही RealEstateAgents डेटा स्रोत के पास 501 या उससे अधिक रिकॉर्ड हों.

यदि आप इस तरीके से उपयोग करते AddColumns हैं, तो फ़िल्टर को RealEstateAgents में उन पहले रिकॉर्ड में से प्रत्येक के लिए डेटा स्रोत के लिए अलग-अलग कॉल करना होगा, जो बहुत सारे नेटवर्क बकबक का कारण बनता है। यदि [dbo](.[AllListings] काफी छोटा है और अक्सर नहीं बदलता है। जब आपका ऐप शुरू होता है तो उसमें डेटा स्रोत को कैश करने के लिए आप OnStart में Collect फ़ंक्शन को कॉल कर सकते हैं। एक विकल्प के रूप में, आप अपने ऐप का पुनर्निर्माण कर सकते हैं ताकि उपयोगकर्ता द्वारा पूछे जाने पर आप संबंधित रिकॉर्ड पुल कर सकें.

नोट

संस्करण 3.24042 से पहले, स्तंभ नामों को दोहरे उद्धरण चिह्नों का उपयोग करके एक टेक्स्ट स्ट्रिंग के साथ निर्दिष्ट किया जाता था, और यदि उन्हें डेटा स्रोत से जोड़ा जाता था तो उन्हें तार्किक नाम भी होना चाहिए था। Power Apps उदाहरण के लिए, उद्धरण चिह्नों के बिना प्रदर्शन नाम नाम के स्थान पर तार्किक नाम "cr43e_name" दोहरे उद्धरण चिह्नों के साथ" का उपयोग किया गया था। SharePoint और Excel डेटा स्रोतों के लिए जिनमें रिक्त स्थान के साथ स्तंभ नाम होते हैं, प्रत्येक रिक्त स्थान को "_x0020_" के साथ निर्दिष्ट किया गया था, उदाहरण के लिए "स्तंभ नाम" के रूप में "स्तंभ_x0020_नाम". इस संस्करण के बाद, सभी ऐप्स स्वचालित रूप से इस आलेख में वर्णित नए सिंटैक्स में अपडेट हो गए।

सिंटैक्स

AddColumns( TableOrRecord, ColumnName1,Formula1 [, ColumnName2,Formula2, ...] )

• TableOrRecord - आवश्यक। संचालित करने के लिए टेबल या रिकॉर्ड।
• ColumnNames - आवश्यक. जोड़े जाने वाले स्तंभों के नाम.
• सूत्र - आवश्यक. प्रत्येक रिकॉर्ड के मूल्यांकन हेतु सूत्र. परिणाम को संबंधित नए स्तंभ के मान के रूप में जोड़ा जाता है. आप तालिका के अन्य स्तंभों को संदर्भित कर सकते हैं या इस सूत्र में रिकॉर्ड कर सकते हैं.

DropColumns( TableOrRecord, ColumnName1 [, ColumnName2, ...] )

• TableOrRecord - आवश्यक। संचालित करने के लिए टेबल या रिकॉर्ड।
• ColumnNames - आवश्यक. हटाए जाने वाले स्तंभों के नाम.

RenameColumns( TableOrRecord, OldColumnName1,NewColumnName1 [, OldColumnName2,NewColumnName2, ...] )

• TableOrRecord - आवश्यक। संचालित करने के लिए टेबल या रिकॉर्ड।
• OldColumnNames - आवश्यक. मूल तालिका या रिकॉर्ड से नाम बदलने के लिए स्तंभों के नाम. यह तत्व पहले तर्क जोड़ी में दिखाई देता है (या प्रत्येक तर्क जोड़ी में पहली बार अगर सूत्र में एक से अधिक जोड़ी शामिल है).
• NewColumnNames - आवश्यक. प्रतिस्थापन नाम. यह तत्व तर्क जोड़ी में आखिर में दिखाई देता है (या प्रत्येक तर्क जोड़ी में आखिर में अगर सूत्र में एक से अधिक जोड़ी शामिल है).

ShowColumns( TableOrRecord, ColumnName1 [, ColumnName2, ...] )

• TableOrRecord - आवश्यक। संचालित करने के लिए टेबल या रिकॉर्ड।
• ColumnNames - आवश्यक. सम्मिलित किये जाने वाले स्तंभों के नाम.

उदाहरण

इस सेक्शन के उदाहरण IceCreamSales डेटा स्रोत का उपयोग करते हैं जिसमें डेटा इस तालिका में शामिल है:

इनमें से कोई भी उदाहरण IceCreamSales डेटा स्रोत को संशोधित नहीं करते है. प्रत्येक फ़ंक्शन डेटा स्रोत के मान को तालिका के रूप में परिवर्तित करता है और परिणाम के रूप में उस मान को लौटाता है.

सूत्र	विवरण	परिणाम
AddColumns(आइसक्रीमबिक्री, राजस्व, इकाईमूल्य * मात्राबेचा गया)	परिणाम में Revenue स्तंभ जोड़ता है. प्रत्येक रिकॉर्ड के लिए, UnitPrice * QuantitySold का मूल्यांकन किया जाता है, और परिणाम को नए स्तंभ में रखा जाता है.
DropColumns( IceCreamSales, UnitPrice )	परिणाम में UnitPrice स्तंभ को शामिल नहीं करता है. स्तंभों को बाहर करने के लिए इस फ़ंक्शन का उपयोग करें, और उन्हें शामिल करने के लिए उपयोग करें ShowColumns ।
ShowColumns(आइसक्रीम सेल्स, फ्लेवर)	परिणाम में केवल Flavor स्तंभ शामिल करता है. इस फ़ंक्शन का उपयोग करें कॉलम शामिल करें, और उन्हें बाहर करने के लिए उपयोग करें DropColumns ।
RenameColumns(आइसक्रीम सेल्स, यूनिट प्राइस, कीमत)	परिणाम में UnitPrice स्तंभ को पुनर्नामित करता है.
RenameColumns(आइसक्रीम सेल्स, यूनिट प्राइस, कीमत, मात्रा, बेचा गया, संख्या)	परिणाम में UnitPrice और QuantitySold स्तंभों को पुनर्नामित करता है.
DropColumns( RenameColumns( AddColumns(आइसक्रीम बिक्री, राजस्व, UnitPrice * QuantitySold ), इकाईमूल्य, कीमत ), मात्रा )	सूत्र के अंदर से शुरू करते हुए, निम्न तालिका को क्रम से रूपांतरित करता है: UnitPrice * मात्रा की प्रति रिकॉर्ड गणना के आधार पर राजस्व कॉलम जोड़ता है. UnitPrice को Price में पुनर्नामित करता है. Quantity स्तंभ को शामिल नहीं करता है. क्रम महत्वपूर्ण है, उदाहरण के लिए नाम बदलने के बाद हम UnitPrice के साथ गणना नहीं कर सकते।

चरण दर चरण

आइये इस लेख में पहले दिए गए कुछ उदाहरणों को आज़माएँ।

1. एक बटन नियंत्रण जोड़कर और इसके OnSelect गुण को इस सूत्र पर सेट करके एक संग्रह बनाएँ:

   ClearCollect( IceCreamSales,
      Table(
          { Flavor: "Strawberry", UnitPrice: 1.99, QuantitySold: 20 },
          { Flavor: "Chocolate", UnitPrice: 2.99, QuantitySold: 45 },
          { Flavor: "Vanilla", UnitPrice: 1.50, QuantitySold: 35 }
      )
   )
   

2. Alt कुंजी को दबाए रखते हुए बटन का चयन करके सूत्र चलाएँ.

3. एक दूसरा बटन नियंत्रण जोड़ें, इसके OnSelect गुण को इस सूत्र पर सेट करें, और फिर इसे चलाएं:

   ClearCollect( FirstExample,
      AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
   )
   

4. फ़ाइल मेनू पर, संग्रह का चयन करें और फिर उस संग्रह को दिखाने के लिए IceCreamSales का चयन करें.

   जैसा कि इस ग्राफ़िक में दिखाया गया है, दूसरे सूत्र ने इस संग्रह को संशोधित नहीं किया. फ़ंक्शन ने AddColumnsIceCreamSales को केवल-पढ़ने के लिए तर्क के रूप में उपयोग किया; फ़ंक्शन ने उस तालिका को संशोधित नहीं किया जिससे वह तर्क संदर्भित करता है।

   

5. FirstExample चुनें.

   जैसा कि इस ग्राफ़िक में दिखाया गया है, दूसरे सूत्र ने कॉलम जोड़ कर एक नई तालिका लौटाई है. ClearCollect फ़ंक्शन ने FirstExample संग्रह में नई तालिका को कैप्चर किया, मूल तालिका में कुछ जोड़ते हुए जैसे यह फ़ंक्शन में बिना स्रोत को प्रभावित किए प्रवाहित हुआ.

   

एक घटक में मानचित्र स्तंभ

मानचित्र स्तंभ देखें।