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

Келесілерге қолданылады: Кенеп бағдарламалары Copilot Studio Жұмыс үстелі ағындары Модельге негізделген бағдарламалар 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 )
)

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

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

Ескертпе

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

Синтаксис

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

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

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

TableOrRecord - Міндетті. Жұмыс істеу үшін кесте немесе жазба.
Баған атаулары - Міндетті. Түсірілетін бағандардың атаулары.

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

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

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

TableOrRecord - Міндетті. Жұмыс істеу үшін кесте немесе жазба.
Баған атаулары - Міндетті. Қосылатын бағандардың атаулары.

Мысалдар

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

Icecream мысалы.

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

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

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

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

Кері байланыс

Бет пайдалы болды ма?

Last updated on 2025-10-04