Remove және RemoveIf функциялары

Мақала
03/22/2024

Қолданылады: Canvas қолданбалары Үлгіге негізделген қолданбалар Power Platform CLI

Ескертпе

PAC CLI pac power-fx пәрмендеріRemoveIf функциясына қолдау көрсетпейді.

Сипаттама

Remove функциясы

Remove функциясын деректер көзінен белгілі бір жазбаны немесе жазбаларды жою үшін пайдаланыңыз.

Жинақтар үшін бүкіл жазба сәйкес болуы керек. Жазбаның барлық көшірмелерін жою үшін RemoveFlags.All аргументін пайдалануға болады; әйтпесе жазбаның бір ғана көшірмесі жойылады.

RemoveIf функциясы

RemoveIf функциясын жазбаны немесе жазбаларды шарт немесе шарттар жиыны негізінде жою үшін пайдаланыңыз. Әр шарт true немесе false мәніне әкелетін кез келген формула болуы мүмкін және деректер көзінің бағандарына атауы бойынша сілтеме жасауы мүмкін. Әр шарт әр жазба үшін жеке есептеледі және барлық шарттар есептегеннен кейін true мәнін қайтарса, жазба жойылады.

Remove және RemoveIf функцияларына өзгертілген деректер көзін кесте түрінде қайтарады. Функциялардың екеуін де тек мінез-құлық формулаларында пайдалануға болады.

Сондай-ақ жинақтағы барлық жазбаларды жою үшін Clear функциясын пайдалануға болады.

Өкіл

деректер көзі файлымен пайдаланылғанда, бұл функцияларды өкілеттік беру мүмкін емес. Деректер көзінің бірінші бөлімі ғана алынып, функция қолданылады. Бұл толық оқиғаны көрсетпеуі мүмкін. Бұл шектеуді еске түсіру үшін авторлық уақытта ескерту пайда болуы мүмкін.

Делегацияны қолдау (эксперименттік)

RemoveIf үшін өкілдік қолдау қазір оны қолдайтын деректер көздері үшін Эксперименттік алдын ала қарау режимінде (әдепкі ӨШІРУЛІ). Егер деректер көзі бұл мүмкіндікті қолдамаса, Power Apps серверге сұрау жібереді және сүзгі өрнегі 500, 2000 немесе деректер беті өлшеміне сәйкес келетін барлық деректерді шығарады. Содан кейін ол серверге жеке қоңыраулармен сол жазбалардың әрқайсысында жою әрекетін орындайды.

Синтаксис

Жою( DataSource, Жазба1 [, Жазба2 , ... ] [, RemoveFlags.All ] )

DataSource – Міндетті. Жойғыңыз келетін жазбаны немесе жазбаларды қамтитын деректер көзі.
Record(s) – Міндетті. Жоятын жазба немесе жазбалар.
RemoveFlags.All – Қосымша. Жинақта бір жазба бірнеше рет көрінуі мүмкін. Жазбаның барлық көшірмелерін жою үшін RemoveFlags.All аргументін қосуға болады.

Жою( DataSource, Кесте [, RemoveFlags .Барлығы ] )

DataSource – Міндетті. Жойғыңыз келетін жазбаларды қамтитын деректер көзі.
Table - Міндетті. Жоятын жазбалар кестесі.
RemoveFlags.All – Қосымша. Жинақта бір жазба бірнеше рет көрінуі мүмкін. Жазбаның барлық көшірмелерін жою үшін RemoveFlags.All аргументін қосуға болады.

RemoveIf( DataSource, Condition [, ... ] )

DataSource – Міндетті. Жойғыңыз келетін жазбаны немесе жазбаларды қамтитын деректер көзі.
Condition(s) - Міндетті. Жоятын жазба немесе жазбалар үшін есептегенде true мәнін қайтаратын формула. DataSource баған атауларын формулада пайдалануға болады. Бірнеше Шарттар көрсетсеңіз, жоятын жазба немесе жазбалар үшін барлығы есептегенде true мәнін қайтаруы керек.

Мысалдар - жалғыз формулалар

Бұл мысалдарда, сіз IceCream атты және мына кестедегі деректермен басталатын деректер көзіндегі жазбаны немесе жазбаларды жоясыз:

Icecream мысалы.

Үлгі жазбалар бар жинақты жасау

Осы деректері бар жинақты жасау үшін:

Түйме басқару элементін кірістіріңіз.

Түймешік басқару элементінің OnSelect сипатын төмендегі формулаға орнатыңыз:

ClearCollect( IceCream,
              { ID: 1, Flavor: "Chocolate",  Quantity: 100 },
              { ID: 2, Flavor: "Vanilla",    Quantity: 200 },
              { ID: 3, Flavor: "Strawberry", Quantity: 300 }
)

Alt пернесін басып тұрып, түймешікті таңдаңыз:

Формуланы пайдаланып жинақтан үлгі жазбаларды жою

Формула	Сипаттама	Нәтиже
Remove( IceCream, Іздеу( балмұздақ, дәм = "Шоколад"))	Деректер көзінен Chocolate жазбасын жояды.	IceCream деректер көзі өзгертілді.
Remove( IceCream, LookUp( IceCream, Flavor="Шоколад" ), LookUp( IceCream, Flavor="Құлпынай" ) )	Екі жазбаны деректер көзінен жояды.	IceCream деректер көзі өзгертілді.
RemoveIf( IceCream, Quantity > 150 )	Quantity мәні 150-ден үлкенірек жазбаларды жояды.	IceCream деректер көзі өзгертілді.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" )	Quantity мәні 150-ден үлкенірек және Flavor опциясы S деп басталатын жазбаларды жояды.	IceCream деректер көзі өзгертілді.
RemoveIf( IceCream, true )	Барлық жазбаларды деректер көзінен жояды.	IceCream деректер көзі өзгертілді.

Мысалдар - галереядан тыс түймешікті жою

Бұл мысалда, сіз кестедегі жазбаларды тізу үшін Галерея басқару элементін пайдаланасыз. Содан кейін элементті таңдау бойынша жою үшін Remove функциясын пайдаланыңыз.

Үлгі деректерді дайындау

Бұл мысалда үлгі бағдарламалармен және деректермен Microsoft Dataverse жүйесінде қолжетімді Контактілер кестесін пайдаланады. Үлгі бағдарламалар мен деректердіортаны жасағанда орналастыруға болады. Сондай-ақ оның орнына кез келген басқа URL мекенжайын пайдалана аласыз.

Галереядан тыс түймешікті жою

Бұл мысалда, сіз галереядан тыс түймешікті пайдалана отырып элементті жоясыз.

"Телефон" орналасуын пайдаланып жаңа бос кенеп бағдарламасын жасаңыз.
Сол жақ тақтадан Кірістіру пәрменін таңдаңыз.
Тік галерея опциясын таңдаңыз.
Экраныңызға Галерея басқару элементі қосылады.
Сізден деректер көзін таңдау сұралады, ұмнда сіз қолжетімді деректер көздерінен деректер көзін таңдай аласыз.
Мысалы, үлгі деректерін пайдалану үшін Контактілер кестесін таңдаңыз:

Галереяда осы кестедегі элементтері көрсетіледі:
Сол жақ тақтадан Түймешік басқару элементін кірістіріңіз:
Қосылған түймешікті галерея элементтерінің астына жылжытыңыз:
Түймешіктің мәтін сипатын Жазбаны жою деп жаңартыңыз. Сондай-ақ өзіңіз таңдаған мәтінді пайдалана аласыз:
Осы түймешік басқару элементі үшін OnSelect сипатын келесі формулаға орнатыңыз:
```
Remove( Contacts, Gallery1.Selected )
```
Галерея басқару элементі Таңдалған сипатын пайдаланып қазіргі уақытта таңдалған жазбаны қолжетімді етеді. Remove функциясы жою үшін осы таңдалған жазбаға сілтеме жасайды.
Жоғарғы оң жақтағы Play түймешігін пайдаланып немесе пернетақтада F5 пернесін басып бағдарламаны алдын ала қараңыз:
Жоятын жазбаны таңдаңыз, мысалы, осы мысалда Нэнси жазбасын:
Жазбаны жою пәрменін таңдаңыз:

Түймешікті таңдау таңдалған жазбаны жояды (мысалы, "Нэнси" жазбасын).
Бағдарламаны алдын ала қарауды жабыңыз.

Шайпұл

Сондай-ақ Ойнату түймешігі немесе F5 арқылы бағдарламаны алдын ала қарауды пайдаланудың орнына Alt пернесі арқылы баламалы мінез-құлықты пайдалануға болады.

Мысалдар - галерея ішіндегі себет белгішесі

Бұл мысалда, сіз элементті галерея ішінде орналастырылған белгішені пайдалана отырып жоясыз.

Үлгі деректер бар жинақты жасау

Үлгі деректерді дайындап қойған болсаңыз, осы қадамды өткізіп жіберіңіз және галерея ішіндегі себет белгішесіне жылжыңыз.

Экраныңызға Түймешік басқару элементін қосыңыз.

OnSelect сипатын келесі формулаға орнатыңыз:

ClearCollect( SampleContacts,
      { 'Full Name': "Yvonne McKay (sample)",      'Primary Email': "someone_a@example.com" },
      { 'Full Name': "Susanna Stubberod (sample)", 'Primary Email': "someone_b@example.com" },
      { 'Full Name': "Nancy Anderson (sample)",    'Primary Email': "someone_c@example.com" },
      { 'Full Name': "Maria Campbell (sample)",    'Primary Email': "someone_d@example.com" },
      { 'Full Name': "Robert Lyon (sample)",       'Primary Email': "someone_e@example.com" },
      { 'Full Name': "Paul Cannon (sample)",       'Primary Email': "someone_f@example.com" },
      { 'Full Name': "Rene Valdes (sample)",       'Primary Email': "someone_g@example.com" }
)

Alt пернесін басып тұрып түймешікті таңдаңыз.

Келесі мысалда пайдалануға болатын үлгі жинақ жасалады.

Галерея ішіндегі себет белгішесі

"Телефон" орналасуын пайдаланып жаңа бос кенеп бағдарламасын жасаңыз.
Сол жақ тақтадан Кірістіру пәрменін таңдаңыз.
Тік галерея опциясын таңдаңыз.
Экраныңызға Галерея басқару элементі қосылады.
Сізден деректер көзін таңдау сұралады, ұмнда сіз қолжетімді деректер көздерінен деректер көзін таңдай аласыз.
Мысалы, үлгі деректерін пайдалану үшін Контактілер кестесін таңдаңыз:

Жинақты жасасаңыз, оның орнына жинағыңызды таңдаңыз:
Галереядағы жоғарғы элемент ішіндегі басқару элементін таңдаңыз.

Келесі қадамның элементті галереядан тыс емес, галерея үлгісіне кірістіруін қамтамасыз ету үшін, келесі қадамға өтпей тұрып осы қадамды орындаңыз.
Сол жақ тақтадан Белгіше қосу пәрменін таңдаңыз.

Ескертпе

Белгіше қосу пәрмені галереяның сол жағында галереядағы әр элемент үшін репликаланатын + белгішесін кірістіреді.
Жоғағы элементте белгішені экранның оң жағына жылжытыңыз.
Белгішенің Белгіше сипатын таңдаңыз және белгіше кескінін себет белгішесі ретінде жаңарту үшін келесі формулаға орнатыңыз:
```
Icon.Trash
```
Ескертпе

Icon. префиксі сіз формуланы белсенді түрде өңдеп жатқанда ғана көрсетіледі.
OnSelect сипатын келесі формулаға орнатыңыз:
```
Remove( [@Contacts], ThisItem )
```
Ескертпе

Біреуі көпке қатынасымен қайшылықты болдырмау үшін осы мысалдағы глобалдық ажырату операторын[@...]Контактілер кестесін пайдаланатын үлгі деректермен пайдалану керек. Тізім немесе SQL Server кестесі сияқты деректер көздерін пайдалансаңыз, глобалдық көп мәнділікті жою операторын пайдалану қажет емес.
Жоғарғы оң жақтағы Play түймешігін пайдаланып немесе пернетақтада F5 пернесін басып бағдарламаны алдын ала қараңыз.
Жазба, мысалы, Мария жазбасының жанындағы себет белгішесін таңдаңыз:

Жазба жойылды:
Бағдарламаны алдын ала қарауды жабыңыз.