AddColumns, DropColumns, RenameColumns және ShowColumns функциялары

Мақала
04/22/2024

Қолданылады: Canvas қолданбалары Жұмыс үстелі ағындары Үлгіге негізделген қолданбалар Power Platform CLI

Бағандарын қосу, жою, қайта атау және таңдау арқылы кесте пішінін жасайды.

**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 )
)

Алайда, осы функциялардың нәтижесі өкілеттемеу жазбасы лимитіне байланысты. Бұл мысалда тіпті RealEstateAgents деректер көзінде 501 немесе көбірек жазба болса да, 500 жазба ғана қайтарылады.

Егер Бағандарды қосу осылай пайдалансаңыз, Сүзгі олардың әрқайсысы үшін деректер көзі жеке қоңырау шалу керек. RealEstateAgents жазбаларында, бұл көптеген желілік әңгімелерді тудырады. Егер [dbo](.[AllListings] жеткілікті аз болса және жиі өзгермейді. Сіз іске қосылған кезде қолданбаңыздағы деректер көзі кэштеу үшін OnStart ішіндегі Collect функциясына қоңырау шала аласыз. Балама ретінде, сіз пайдаланушы сұраған кезде ғана қатысты жазбаларды шығарып алу үшін бағдарламаңыздың құрылымын өзгерте аласыз.

Ескертпе

Power Apps 3.24042 нұсқасына дейін баған атаулары қос тырнақшаларды пайдаланып мәтін жолы арқылы көрсетілді және деректер көзі қосылған болса, олар да логикалық атаулар болуы керек еді. Мысалы, "cr43e_name" қос тырнақшасы бар логикалық атау Аты тырнақшасыз көрсетілу атауының орнына қолданылды. . Бос орындар бар баған атаулары бар SharePoint және Excel деректер көздері үшін әрбір бос орын "_x0020_" арқылы көрсетілді, мысалы "Баған атауы" а "Баған_x0020_Атауы". Осы нұсқадан кейін барлық қолданбалар осы мақалада сипатталған жаңа синтаксиске автоматты түрде жаңартылды.

Синтаксис

Бағандарды қосу( Кесте, Баған атауы1, Формула1 [, Баған атауы2, Формула2, ... ] )

Кесте - Міндетті. Әрекет орындайтын кесте.
Баған атаулары - Міндетті. Қосылатын бағандардың атаулары.
Формулалар - Міндетті. Әрбір жазба үшін бағаланатын формулалар. Нәтиже сәйкес жаңа бағанның мәні ретінде қосылады. Осы формулада кестенің басқа бағандарына сілтеме жасай аласыз.

DropColumns( Кесте, БағанАты1 [, БағанАты2 , ... ] )

Кесте - Міндетті. Әрекет орындайтын кесте.
Баған атаулары - Міндетті. Түсірілетін бағандардың атаулары.

Бағандардың атын өзгерту( Кесте, Ескі баған атауы1, Жаңа баған атауы1 [, Ескі баған атауы2, Жаңа баған атауы2, ... ] )

Кесте - Міндетті. Әрекет орындайтын кесте.
OldColumnNames - Міндетті. Бастапқы кестеден атын өзгерту үшін бағандардың атаулары. Бұл элемент аргумент жұбында бірінші (немесе егер формула бірнеше жұпты қамтыса, әр аргумент бірінші) болып көрінеді.
Жаңа баған атаулары - Міндетті. Ауыстырылатын атаулар. Бұл элемент аргумент жұбында соңғы (немесе егер формула бірнеше жұпты қамтыса, әр аргумент соңғы) болып көрінеді.

Бағандарды көрсету( Кесте, Баған атауы1 [, 2-баған атауы , ... ] )

Кесте - Міндетті. Әрекет орындайтын кесте.
Баған атаулары - Міндетті. Қосылатын бағандардың атаулары.

Мысалдар

Осы бөлімдегі мысалдарда IceCreamSales деректер көзі пайдаланылады, ол мына кестедегі деректерді қамтиды:

Icecream мысалы.

Бұл мысалдардың ешқайсысы IceCreamSales деректер көзін өзгертпейді. Әр функция кесте түріндегі деректер көзі мәнін түрлендіреді және сол мәнді нәтиже ретінде қайтарады.

Формула	Сипаттама	Нәтиже
*Бағандарды қосу( балмұздақ сатылымы, кіріс, бірліктің бағасы сатылған саны )**	Нәтижеге Табыс бағанын қосады. Әр жазба үшін *UnitPrice QuantitySold** есептеледі, ал нәтиже жаңа бағанға орналастырылады.
DropColumns( IceCreamSales, UnitPrice )	Нәтижеден UnitPrice бағанын шығарады. Бұл функцияны бағандарды шығару үшін пайдаланыңыз, ал ShowColumns функциясын оларды қосу үшін пайдаланыңыз.
Бағандарды көрсету( балмұздақ сату, дәм)	Нәтижеге тек Дәмі бағанын қосады. Бұл функцияны бағандарды қосу үшін пайдаланыңыз, ал DropColumns функциясын оларды шығару үшін пайдаланыңыз.
Бағандардың атын өзгерту (IceCreamSales, UnitPrice, баға)	Нәтижедегі UnitPrice бағанын қайта атайды.
Бағандардың атын өзгерту( балмұздақ сатылымы, бірліктің бағасы, бағасы, сатылған саны, саны)	Нәтижедегі UnitPrice және QuantitySold бағандарын қайта атайды.
DropColumns( RenameColumns( Бағандарды қосу(IceCreamSales, Табыс, UnitPrice * QuantitySold ), Бірлік бағасы, бағасы), Саны)	Формуланың ішінен бастап келесі кесте түрлендірулерін ретпен орындайды: Табыс бағанын *БірлікБағасы Саны әрбір жазба есебіне негізделген. UnitPrice бағанын Price деп қайта атайды. Quantity бағанын шығарады. Тапсырыс маңызды, мысалы, атауы өзгертілгеннен кейін UnitPrice** мен есептей алмаймыз.

Қадамдық

Осы мақаланың басында келтірілген мысалдардың кейбірін қолданып көрейік.

Button басқару элементін қосу және оның 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 }
   )
)

Alt пернесін басып тұрып, түймешікті таңдау арқылы формуланы іске қосыңыз.
Екінші Түймешік басқару элементін қосыңыз, оның OnSelect сипатын мына формулаға орнатыңыз, содан кейін оны іске қосыңыз:
```
ClearCollect( FirstExample,
   AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
)
```
Файл мәзірінде Жинақтар тармағын таңдаңыз, содан кейін сол жинақты көрсету үшін IceCreamSales сипатын таңдаңыз.

Осы суретте көрсетілгендей, екінші формула бұл жинақты өзгертпеді. AddColumns функциясы IceCreamSales бағанын тек оқуға арналған аргумент ретінде пайдаланды; функция сол аргумент сілтеме жасайтын кестені өзгертпеді.
FirstExample таңдаңыз.

Осы суретте көрсетілгендей, екінші формула баған қосылған жаңа кестені қайтарады. ClearCollect функциясы көзді өзгертпестен функция арқылы ағынды орындағанда бастапқы кестеге бірдеңе қосып, FirstExample жинағында жаңа кестені жазды:

Құрамдастағы бағандарды салыстыру

Бағандарды салыстыру бөлімін қараңыз.

Бөлісу құралы: