Filter, Searchжәне LookUp функциялары

Келесілерге қолданылады: Кенеп бағдарламалары Copilot Studio Жұмыс үстелі ағындары Модельге негізделген бағдарламалар Power Platform CLI Dataverse функциялары Power Pages

Кестедегі бір немесе бірнеше жазбаны табады.

Осы бейнені қараңыз , Filterфункцияларды Search және функцияларды қалай пайдалану LookUpкеректігін біліңіз:

Ескертпе

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

Сипаттама

Filter Функция формуланы қанағаттандыратын кестедегі жазбаларды табады. Бір немесе бірнеше шартқа сәйкес келетін жазбалар жиынтығын табу және сәйкес келмейтін жазбаларды жою үшін пайдаланыңыз Filter .

LookUp Функция формуланы қанағаттандыратын кестедегі бірінші жазбаны табады. Бір немесе бірнеше шарттарға сәйкес келетін бір жазбаны табу үшін пайдаланыңыз LookUp .

Екеуі де үшін формула кестенің әрбір жазбасы үшін есептеледі. true мәніне әкелетін жазбалар нәтижеге қосылады. Кәдімгі формула операторларына қоса, ішкі жол сәйкестіктерін алу үшін in және exactin операторларын пайдалануға болады.

Қазіргі уақытта өңделетін жазбаның өрістері формула бойынша қолжетімді. ThisRecord операторын пайдаланыңыз немесе жай ғана өрістерді аты әрі басқа кез келген мәні бойынша көрсетіңіз. Сонымен қатар формуланы оңайырақ түсінуге және кірістірілген жазбаларды қолжетімді етуге көмектесу үшін өңделетін жазбаға ат беру үшін As операторын пайдалануға болады. Қосымша ақпарат алу үшін төмендегі мысалдарды қараңыз және жазба ауқымымен жұмыс істеңіз.

Search Функция бағандарының бірінде жол бар кестедегі жазбаларды табады. Жол бағананың кез келген жерінде кездесуі мүмкін; Мысалы, "rob" немесе "bert" деп іздегенде, бағанда "Robert" бар сәйкестік табады. Іздеуде регистр ескерілмейді. Және Filterфункциясынан LookUp айырмашылығы Search , функция формуланың орнына сәйкестендіру үшін бір жолды пайдаланады.

Filter және Search бастапқы кестемен бірдей бағандар мен шарттарға сәйкес келетін жазбаларды қамтитын кестені қайтарыңыз. LookUp Жазбаны бір мәнге азайту үшін формуланы қолданғаннан кейін ғана табылған алғашқы жазбаны қайтарады. Егер жазбалар табылмаса, FilterSearch кестені қайтарыңыз және LookUpбос қайтарады.

Кестелер жол немесе сан сияқты Power Apps ішіндегі мән. Оларды функцияларға өткізуге және олардан қайтаруға болады. Filter, Searchжәне LookUp кестені өзгертпеңіз. Оның орнына, олар аргумент ретінде кестені қабылдайды және одан кестені, жазбаны немесе бір мәнді қайтарады. Қосымша мәліметтерді кестелермен жұмыс істеу бөлімінен қараңыз.

Өкілеттеу

Мүмкін болса, Power Apps сүзгілеу және сұрыптау әрекеттерін деректер көзіне және сұраныспен нәтижелер бойынша бетке жібереді. Мысалы, іске қосқанда бағдарлама келесіні көрсетеді Галерея деректермен толтырылған бақылау, алдымен құрылғыға бірінші жазбалар жиынтығы беріледі. Пайдаланушы айналдырулары ретінде қосымша ақпарат деректер көзінен алынған. Нәтиже-ең үлкен деректер орнатулары үшін бағдарлама мен қатынасудың жылдам бастау уақыты.

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

Егер тапсыру мүмкін болмаса, Power Apps жергілікті түрде жұмыс істеу үшін жазбалардың кішкене жиынтығын ғана төмендетеді. Filter Сұрыптау функциялары қысқартылған жазбалар жиынтығы бойынша жұмыс істейді. Галереяда қолжетімдісі пайдаланушыларды шатастыратын толық тарих болмауы мүмкін.

Қосымша ақпарат алу үшін, Өкілдік шолуы бөлімін қараңыз.

Синтаксис

Filter(Кесте*, Формула1 [, *Формула2*, ... ] )

  • Кесте - Міндетті. Іздейтін кесте.
  • Формулалар - Міндетті. Кестенің әрбір жазбасы есептелетін формула. Функция true мәніне әкелетін барлық жазбаны қайтарады. Сіз кестедегі бағандарға сілтеме жасай аласыз. Dataverse деректер көздері үшін формула Dataverse көрінісінің атауы болуы мүмкін. Бірнеше формуланы көрсетсеңіз, барлық формулалардың нәтижелері And функциясымен біріктіріледі.

Ескертпе

Dataverse көріністері жасалуы мүмкін, олар байланысты кестелерден қосымша бағандар қайтарылады. Алайда, Power Apps тек белгіленген Dataverse деректер көзінің бөлігі ретінде белгілі бағандарды қайтарады.

Search(Кесте*, SearchString, Column1 [, *Column2*, ... ] )

  • Кесте - Міндетті. Іздейтін кесте.
  • SearchString - Міндетті. Іздейтін жол. Бос мән немесе бос жол болса, барлық жазбалар қайтарылады.
  • Бағандар - Міндетті. Кесте ішіндегі іздейтін баған атаулары. SearchString осы бағандардың кез келгенінің деректерінің ішінде ішінара сәйкестік ретінде табылса, толық жазба қайтарылады.

Ескертпе

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

LookUp(Кесте*, формула [, *РедукцияФормула* ] )

  • Кесте - Міндетті. Іздейтін кесте. Пайдаланушы интерфейсінде синтаксис функция жолағының үстінде source ретінде көрсетіледі.
  • Формула - Міндетті. Кестенің әрбір жазбасы есептелетін формула. Функция true мәніне әкелетін бірінші жазбаны қайтарады. Сіз кестедегі бағандарға сілтеме жасай аласыз. Пайдаланушылық интерфейсте синтаксис функция жолағының үстінде condition ретінде көрсетіледі.
  • Редукция формуласы - Қосымша. Бұл формулада табылған формулада есептеледі, содан кейін жазбаны бір мәнге азайтады. Сіз кестедегі бағандарға сілтеме жасай аласыз. Егер сіз бұл параметрді пайдаланбасаңыз, функция кестеден толық жазбаны қайтарады. Пайдаланушылық интерфейсте синтаксис функция жолағының үстінде result ретінде көрсетіледі.

Мысалдар

Келесі мысалдарда IceCreamдеректер көзі пайдаланылады:

Балмұздақ деректер көзі.

Формула Сипаттама Нәтиже
Filter(IceCream, OnOrder > 0) OnOrder нөлден үлкенірек жазбаларды қайтарады. Filter Тапсырыс бойынша.
Filter(IceCream, Quantity + OnOrder > 225) Quantity және OnOrder бағандарының қосындысы 225-тен үлкенірек жазбаларды қайтарады. Filter Саны мен тәртібі.
Filter(IceCream, "chocolate" in Lower(Flavor )) chocolate атауында "" сөзі кездесетін жазбаларды қайтарады, үлкен немесе кіші әріптерге қарамастан. Filter төменгі жағында.
Filter(IceCream, Quantity < 10 && OnOrder < 20) Quantity 10-нан азырақ және OnOrder 20-дан азырақ жазбаларды қайтарады. Бұл шарттарға ешбір жазбалар сәйкес келмейді, сондықтан бос кесте қайтарылады. Filter саны бойынша.
Search(IceCream, "choc", Flavor) choc атауында "" жолы бар жазбаларды қайтарады, үлкен немесе кіші әріптерге қарамастан. Search элементтер. Ð�
Search(IceCream, "", Flavor) Іздеу шарты бос болғандықтан, барлық жазбалар қайтарылады. Search Барлық элементтер.
LookUp(IceCream, Flavor = "Chocolate", Quantity) Flavor әрпі "Chocolate" әрпіне тең жазба іздейді, оның біреуі бар. Табылған бірінші жазба үшін сол жазбаның Quantity қайтарады. 100-көше
LookUp(IceCream, Quantity > 150, Quantity + OnOrder) Quantity 150-ден үлкенірек жазбаны іздейді, мұндай бірнеше жазба бар. Бірінші табылған жазба, яғни "Vanilla" Flavor, Quantity және OnOrder бағандарының қосындысын қайтарады. 250
LookUp(IceCream, Flavor = "Pistachio", OnOrder) Flavor-дың "Pistachio" әрпі тең жазбаны іздеу, бірақ ондай жазба жоқ. Ешқайсысы табылмағандықтан, Іздеу нәтижесі бос болады. бос
LookUp(IceCream, Flavor = "Vanilla") Flavor әрпі "Vanilla" әрпіне тең жазба іздейді, оның біреуі бар. Азайту формуласы берілмегендіктен, бүкіл жазба қайтарылады. { Дәм: "Vanilla", Саны: 200, Тапсырыс: 75 }

Таңдау бағандарымен сүзгілеу

Келесі мысалда деректер көзі ретінде Microsoft Dataverse жүйесіндегі Тіркелгі кестесі пайдаланылады. Бұл мысалда таңдалған Тізімді жолаққа басқару мәндеріне негізделген тіркелгілерді тізімдеу әдісі Filter көрсетілген:

Қадамдық

  1. Бос бағдарламаны ашыңыз.

  2. Жаңа экран опциясын таңдау арқылы жаңа экран қосыңыз.

  3. Енгізу қойыншасында Галерея, содан кейін Тігінен параметрін таңдаңыз.

  4. Оң жақ панельдегі Сипаттар қойыншасында Деректер көзі параметрін ашыңыз, содан кейін Тіркелгілер түймешігін таңдаңыз.

  5. (Қосымша) Орналасу тізімінде әртүрлі опцияларды таңдаңыз.

  6. Енгізу қойыншасында Кіріс, содан кейін Ашық тізім параметрін таңдаңыз. Қосымша екі ашық тізім басқару элементтерін қосу үшін қадамды қайталаңыз.

  7. Әр ашық тізім басқару элементі үшін, оң жақ панельдегі Сипаттар қойыншасында Деректер көзі параметрін ашыңыз, содан кейін Тіркелгілер түймешігін таңдаңыз. Өрістер опциясының жанындағы Өңдеу түймешігін таңдаңыз, содан кейін Негізгі мәтін және SearchField мәндерін таңдаңыз. Негізгі мәтін ашық тізімге қосу керек таңдаулар бағаны болуы керек. Басқа екі ашық тізім басқару элементі үшін қадамды қайталаңыз.

    Құрама жолақ мәндерін орнату.

  8. Галерея басқару элементін таңдаңыз және Элементтер сипатын келесі формулаға орнатыңыз:

    Filter(Accounts,
 'Industry' = ComboBox3.Selected.Industry Or IsBlank(ComboBox3.Selected.Industry),
 'Relationship Type' = ComboBox2.Selected.'Relationship Type' Or
   IsBlank(ComboBox2.Selected.'Relationship Type'),
 'Preferred Method of Contact' = ComboBox1.Selected.'Preferred Method of Contact' Or
   IsBlank(ComboBox1.Selected.'Preferred Method of Contact'))

    деректер көзі тіркелгілері.

Search Пайдаланушы тәжірибесі

Келесі мысалдарда IceCreamдеректер көзі пайдаланылады:

Көптеген бағдарламаларда үлкен деректер жиынындағы жазбалар тізімін сүзгілеу үшін іздеу жолағында бір немесе бірнеше таңбаны теруге болады. Теру кезінде тізім іздеу шарттарына сәйкес келетін жазбаларды ғана көрсетеді.

Осы мақаланың қалған бөлігіндегі мысалдар осы деректерді қамтитын Тұтынушылар деп аталатын тізімді іздеу нәтижелерін көрсетеді:

Search Клиенттер туралы.

Бұл деректер көзін жинақ ретінде жасау үшін Button басқару элементін жасаңыз және оның OnSelect сипатын мына формулаға орнатыңыз:

ClearCollect(Customers, Table({ Name: "Fred Garcia", Company: "Northwind Traders" }, { Name: "Cole Miller", Company: "Contoso" }, { Name: "Glenda Johnson", Company: "Contoso" }, { Name: "Mike Collins", Company: "Adventure Works" }, { Name: "Colleen Jones", Company: "Adventure Works" }) )

Осы мысалдағыдай, жазбалардың тізімін экранның төменгі жағында Галерея басқару элементінде көрсетуге болады. Экранның жоғарғы жағына жақын, пайдаланушылар қызықтыратын жазбаларды көрсете алуы үшін SearchInput деп аталатын Мәтінді енгізу басқару элементін қосуға болады.

Search Іздеу кірісін пайдалану.

Пайдаланушы SearchInput ішінде таңбаларды терген кезде, галереядағы нәтижелер автоматты түрде сүзіледі. Бұл жағдайда, галерея SearchInput ішінде тұтынушының аты (компания атауы емес) таңбалар ретімен басталатын жазбаларды көрсетуге конфигурацияланады. Пайдаланушы іздеу жолағында ко деп терсе, галерея мына нәтижелерді көрсетеді:

Search басталады.

Name бағанының негізінде сүзу үшін галерея басқару элементінің Items сипатын мына формулалардың біреуіне орнатыңыз:

Формула Сипаттама Нәтиже
Filter(Тұтынушылар, StartsWith(Name, SearchInput.Text) ) Customers деректер көзінде іздеу жолы Name бағанының басында көрінетін жазбаларды сүзгілейді. Тексеруде регистр ескерілмейді. Егер пайдаланушы іздеу жолағында co деп терсе, галерея Colleen Jones және Cole Miller аттарын көрсетеді. Галерея Mike Collins атын көрсетпейді, өйткені бұл жазбаның Name бағаны іздеу жолымен басталмайды. Filter Бастапқыда.
Filter(Тұтынушылар, SearchInput.Мәтін аты) Customers деректер көзінде іздеу жолы Name бағанының кез келген жерінде көрінетін жазбаларды сүзеді. Тексеруде регистр ескерілмейді. Егер пайдаланушы іздеу жолағында co деп терсе, галерея көрсетеді Colleen Jones,Cole Miller, және Mike Collins аттарын көрсетеді, өйткені іздеу жолы осы жазбалардың барлығының Name бағанында бір жерде көрінеді. Filter Іздеу кірісі арқылы.
Search(Тұтынушылар, SearchInput.Text, Name) In операторын пайдалануға ұқсас, Search функция әр жазбаның Атау бағанының кез келген жерінде сәйкестікті іздейді. Баған атын қос тырнақшаға алу керек. Search клиенттер.

Компания бағаны мен Аты бағанын қамту үшін іздеуді кеңейтуге болады:

Формула Сипаттама Нәтиже
Filter(Customers, StartsWith(Name, SearchInput.Text) || StartsWith(Company, SearchInput.Text) ) Customers деректер көзінде Name бағаны немесе Company бағаны іздеу жолымен басталатын (мысалы, co) жазбаларды сүзгілейді. || функцияларының біреуі true болса, операторының мәні true. Filter Клиенттер басталады.
Filter(Customers, SearchInput.Text in Name || SearchInput. Text in Company) Customers деректер көзінде Name бағаны немесе Company бағаны кез келген жерінде іздеу жолын (мысалы, co) қамтитын жазбаларды сүзгілейді. Filter Клиенттер іздеу кірісі.
Search(Customers, SearchInput.Text, Name, Company) In операторын пайдалануға ұқсас, Search функция Тұтынушылар деректер көзінен Атау бағанында немесе Компания бағанында кез келген жерде іздеу жолы (мысалы, co) бар жазбаларды іздейді. Search Функцияны оқу және жазу Filter мен бірнеше операторларды көрсеткіңіз келсе, оңайырақ. Search Іздеу кірісі бар клиенттер.
  • Last updated on