PowerApps 中的 Filter、Search 和 LookUp 函数

灰太狼 2022-04-24 15:40 793阅读 0赞

**描述：**

**Filter** ：函数查找表中满足公式的记录。 使用 **Filter** 可查找匹配一个或多个条件的一组记录并丢弃不匹配的记录。

**LookUp** ：函数查找表中满足公式的第一条记录。 使用 **LookUp** 可查找匹配一个或多个条件的单个记录。

对于这两者，系统都会针对表的每条记录计算公式。 结果为 *true* 的记录将包含在结果中。 除常规公式[运算符][Link 1]外，还可对子字符串匹配项使用 **[in][]** 和 **[exactin][in]** 运算符。

当前正在处理的记录字段在该公式中可用。 只需按名称对其引用，这与引用任何其他值的方法相同。另外，也可以从整个应用中引用控件属性和其他值。 有关详细信息，请参阅下面的示例和[使用记录作用域][Link 2]。

**Search** ：函数在表中查找其某个列中包含某个字符串的记录。 字符串可能出现在列中的任何位置；例如，搜索“rob”或“bert”会在包含“Robert”的列中找到匹配项。 搜索不区分大小写。 与 **Filter** 和**LookUp** 不同，**Search** 函数使用单个字符串而非公式进行匹配。

**Filter** 和 **Search** 返回包含与原始表相同的列的表和匹配条件的记录。 **LookUp** 用公式将记录归约为单个值后，仅返回找到的第一条记录。 如果未找到记录，**Filter** 和 **Search** 将返回[空][Link 3]表，**LookUp** 将返回空白。

[表][Link 4]是 PowerApps 中的一个值，与字符串或数字类似。 可以向函数传递表，也可以从函数返回表。**Filter**、**Search** 和 **LookUp** 不会修改表。 相反，它们将表作为参数，并从中返回表、记录或单个值。 请参阅[使用表][Link 4]，了解更多详情。

--------------------

**委派：**

条件允许时，PowerApps 将把筛选和排序操作委派给数据源，并按需对结果进行分页。 例如，当启动显示“[库][Link 5]”控件（已填充数据）的应用时，最初仅会将第一组记录转入设备。 用户滚动鼠标时，将从数据源中引入其他数据。 进而将加快应用启动和访问超大数据集的速度。

但是，委派并不总是可行。 数据源所支持的用于委派的函数和运算符会有所不同。 如果无法实现公式的完全委派，创作环境将出现警告，其中会标记出不能委派的部分。 如果可能，请考虑更改公式，以避免使用不能委派的函数和运算符。 [委派列表][Link 6]中详细说明可以委派的数据源和操作。

如果委派不可行，PowerApps 将仅拉取一小组记录进行本地操作。 筛选和排序函数将对缩减的一组记录执行操作。 **[库][Link 5]** 中的可用内容可能并不完整，这可能使用户感到困惑。

--------------------

**语法：**

**Filter**( *Table*, *Formula1* \[, *Formula2*, ... \] )

*  *Table* - 必需。 要搜索的表。
 *  *Formula(s)* - 必需。 计算表的每个记录时所依据的公式。 此函数返回计算结果为 **true** 的所有记录。 可以引用表中的列。 如果提供多个公式，则通过 **[And][]** 函数将所有公式的结果合并。

**Search**( *Table*, *SearchString*, *Column1* \[, *Column2*, ... \] )

*  *Table* - 必需。 要搜索的表。
 *  *SearchString* - 必需。 要搜索的字符串。 如果为空白或者是空字符串，将返回所有记录。
 *  *Column(s)* - 必需。 要在*表*中搜索的列的名称。 要搜索的列必须包含文本。 列名称必须是用双引号括起来的字符串。 但是，列名称必须是静态的，并且不能使用公式计算。 如果在任意这些列的数据中找到了作为部分匹配项的 *SearchString* ，将返回完整记录。

备注

对于列名称带空格的 SharePoint 和 Excel 数据源，请将每个空格指定为“\_x0020\_”。 例如，将“Column Name”指定为“Column\_x0020\_Name”。

**LookUp**( *Table*, *Formula* \[, *ReductionFormula* \] )

*  *Table* - 必需。 要搜索的表。 在 UI 中，此语法显示为函数框上方的“源”。
 *  *Formula* - 必需。 计算表的每个记录时所依据的公式。 此函数返回计算结果为 **true** 的第一条记录。 可以引用表中的列。 在 UI 中，此语法显示为函数框上方的“条件”。
 *  *ReductionFormula* - 可选。 此公式会对找到的记录进行计算，然后将记录缩减为一个值。 可以引用表中的列。 如果没有使用这个参数，此函数将返回表中的完整记录。 在 UI 中，此语法显示为函数框上方的“结果”。

--------------------

**示例：**

以下示例使用 **IceCream** [数据源][Link 7]：

![icecream.png][]

<table> 
 <thead> 
 <tr> 
 <th>公式</th> 
 <th>描述</th> 
 <th>结果</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>Filter( IceCream, OnOrder &gt; 0 )</td> 
 <td>返回&nbsp;OnOrder&nbsp;大于零的记录。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/icecream-onorder.png"></td> 
 </tr> 
 <tr> 
 <td>Filter( IceCream, Quantity + OnOrder &gt; 225 )</td> 
 <td>返回&nbsp;Quantity&nbsp;和&nbsp;OnOrder&nbsp;列的总和大于 225 的记录。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/icecream-overstock.png"></td> 
 </tr> 
 <tr> 
 <td>Filter( IceCream, "chocolate" in Lower( Flavor ) )</td> 
 <td>返回其&nbsp;Flavor&nbsp;名称中出现单词“chocolate”（不区分字母大小写）的记录。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/icecream-chocolate.png"></td> 
 </tr> 
 <tr> 
 <td>Filter( IceCream, Quantity &lt; 10 &amp;&amp; OnOrder &lt; 20 )</td> 
 <td>返回&nbsp;Quantity&nbsp;小于 10 且OnOrder&nbsp;小于 20 的记录。&nbsp;没有符合这些条件的记录，因此将返回空表。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/icecream-empty.png"></td> 
 </tr> 
 <tr> 
 <td>Search( IceCream, "choc", "Flavor" )</td> 
 <td>返回其&nbsp;Flavor&nbsp;名称中出现字符串“choc”（不区分字母大小写）的记录。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/icecream-chocolate.png"></td> 
 </tr> 
 <tr> 
 <td>Search( IceCream, "", "Flavor" )</td> 
 <td>因为搜索词为空，所以将返回所有记录。</td> 
 <td><img alt="" src="/images/20220212/3c64b572c7994c26827e742de8d73cc6.png"></td> 
 </tr> 
 <tr> 
 <td>LookUp( IceCream, Flavor = "Chocolate", Quantity )</td> 
 <td>搜索&nbsp;Flavor&nbsp;等于“Chocolate”的记录，其中有一个此类记录。&nbsp;对于找到的第一个记录，将返回该记录的Quantity。</td> 
 <td>100</td> 
 </tr> 
 <tr> 
 <td>LookUp( IceCream, Quantity &gt; 150, Quantity + OnOrder )</td> 
 <td>搜索&nbsp;Quantity&nbsp;大于 100 的记录，其中有多个此类记录。&nbsp;对于找到的第一个&nbsp;Flavor&nbsp;为“Vanilla”的记录，将返回&nbsp;Quantity&nbsp;和OnOrder&nbsp;列的总和。</td> 
 <td>250</td> 
 </tr> 
 <tr> 
 <td>LookUp( IceCream, Flavor = "Pistachio", OnOrder )</td> 
 <td>搜索&nbsp;Flavor&nbsp;等于“Pistachio”的记录，其中不存在此类记录。&nbsp;由于未找到匹配项，Lookup&nbsp;将返回空白。</td> 
 <td>空白</td> 
 </tr> 
 <tr> 
 <td>LookUp( IceCream, Flavor = "Vanilla" )</td> 
 <td>搜索&nbsp;Flavor&nbsp;等于“Vanilla”的记录，其中有一个此类记录。&nbsp;由于未提供归约公式，因此将返回完整记录。</td> 
 <td>{风格："普通"，Quantity:200，OnOrder:75 }</td> 
 </tr> 
 </tbody> 
</table>

**搜索用户体验**

在许多应用中，你可在搜索框中键入一个或多个字符来对较大数据集中的记录列表进行筛选。 键入时，列表中仅显示与搜索条件匹配的记录。

本主题其余部分中的示例演示了搜索包含此数据的列表（名为 **Customers**）的结果：

![customers.png][]

若要将此数据源创建为集合，请创建一个\*\*[按钮][Link 8]\*\* 控件，并将其 **OnSelect** 属性设置为以下公式：

**ClearCollect (客户、 表 (\{名称："Fred Garcia"，公司："Northwind Traders"\}，\{名称："Cole Miller"，公司："Contoso"\}，\{名称："Glenda johnson 的演示"，公司："Contoso"\}，\{名称："Mike Collins"，公司："Adventure Works"\}，\{名称："Colleen Jones"，公司："Adventure Works"\}))**

如此示例中所示，可在屏幕底部的[**库控件**][Link 5]中显示记录列表。 在靠近屏幕顶部的位置，可添加名为**SearchInput** 的[**文本输入**][Link 9]控件，以便用户能够指定对哪些记录感兴趣。

![customers-ux-unfiltered.png][]

当用户在 **SearchInput** 中键入字符时，系统将自动筛选库中的结果。 在本例中，库被配置为显示客户名称（不是公司名称）以 **SearchInput** 中的字符序列开头的记录。 如果用户在搜索框中键入 **co**，库将显示以下结果：

![customers-ux-startswith-co.png][]

若要基于 **Name** 列进行筛选，需将库控件的 **Items** 属性设置为以下公式之一：

<table> 
 <thead> 
 <tr> 
 <th>公式</th> 
 <th>描述</th> 
 <th>结果</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>Filter( Customers, StartsWith( Name, SearchInput.Text ) )</td> 
 <td>筛选&nbsp;Customers&nbsp;数据源，查找搜索字符串出现在&nbsp;Name&nbsp;列开头的记录。&nbsp;测试不区分大小写。&nbsp;如果用户在搜索框中键入&nbsp;co，库将显示Colleen Jones&nbsp;和&nbsp;Cole Miller。&nbsp;库不会显示&nbsp;Mike Collins，因为该记录的&nbsp;Name&nbsp;列不以搜索字符串开头。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/customers-name-co-startswith.png"></td> 
 </tr> 
 <tr> 
 <td>Filter( Customers, SearchInput.Text in Name )</td> 
 <td>筛选&nbsp;Customers&nbsp;数据源，查找搜索字符串出现在&nbsp;Name&nbsp;列中任意位置的记录。&nbsp;测试不区分大小写。&nbsp;如果用户在搜索框中键入&nbsp;co，库将显示Colleen Jones、Cole Miller&nbsp;和Mike Collins，因为搜索字符串都出现在所有这些记录的&nbsp;Name&nbsp;列中的某个位置。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/customers-name-co-contains.png"></td> 
 </tr> 
 <tr> 
 <td>Search( Customers, SearchInput.Text, "Name" )</td> 
 <td>与使用&nbsp;in&nbsp;运算符类似，Search&nbsp;函数从每条记录的&nbsp;Name&nbsp;列中的任意位置搜索匹配项。&nbsp;请注意，必须将列名称括在双引号内。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/customers-name-co-contains.png"></td> 
 </tr> 
 </tbody> 
</table>

可以扩展搜索，使其包括 **Company** 列和 **Name** 列：

<table> 
 <thead> 
 <tr> 
 <th>公式</th> 
 <th>描述</th> 
 <th>结果</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>Filter( Customers, StartsWith( Name, SearchInput.Text ) || StartsWith( Company, SearchInput.Text ) )</td> 
 <td>筛选&nbsp;Customers&nbsp;数据源，查找Name&nbsp;列或&nbsp;Company&nbsp;列以搜索字符串（例如&nbsp;co）开头的记录。&nbsp;如果任一&nbsp;StartsWith&nbsp;函数为&nbsp;true，则&nbsp;<a href="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/operators" rel="nofollow">||&nbsp;运算符</a>&nbsp;为&nbsp;true。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/customers-all-co-startswith.png"></td> 
 </tr> 
 <tr> 
 <td>Filter( Customers, SearchInput.Text in Name || SearchInput.Text in Company )</td> 
 <td>筛选&nbsp;Customers&nbsp;数据源，查找Name&nbsp;列或&nbsp;Company&nbsp;列任意位置包含搜索字符串（例如co）的记录。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/customers-all-co-contains.png"></td> 
 </tr> 
 <tr> 
 <td>Search( Customers, SearchInput.Text, "Name", "Company" )</td> 
 <td>与使用&nbsp;in&nbsp;运算符类似，Search函数筛选&nbsp;Customers&nbsp;数据源，查找&nbsp;Name&nbsp;列或&nbsp;Company&nbsp;列任意位置包含搜索字符串（例如co）的记录。&nbsp;如果希望指定多个列和多个&nbsp;in&nbsp;运算符，那么Search&nbsp;函数会比&nbsp;Filter&nbsp;更易于读取和写入。&nbsp;请注意，必须将列的名称括在双引号内。</td> 
 <td><img alt="" src="https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/media/function-filter-lookup/customers-all-co-contains.png"></td> 
 </tr> 
 </tbody> 
</table>

--------------------

原文网址：[https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/function-filter-lookup][https_docs.microsoft.com_zh-cn_powerapps_maker_canvas-apps_functions_function-filter-lookup]

[Link 1]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/operators
[in]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/operators#in-and-exactin-operators
[Link 2]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/working-with-tables#record-scope
[Link 3]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/function-isblank-isempty
[Link 4]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/working-with-tables
[Link 5]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/controls/control-gallery
[Link 6]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/delegation-list
[And]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/function-logicals
[Link 7]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/working-with-data-sources
[icecream.png]: /images/20220212/3c64b572c7994c26827e742de8d73cc6.png
[customers.png]: /images/20220212/c46b15ca08d149478a657e2ac0dbb143.png
[Link 8]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/controls/control-button
[Link 9]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/controls/control-text-input
[customers-ux-unfiltered.png]: /images/20220212/90ee2708f6074cbb9ec29fcdbfbe1bb1.png
[customers-ux-startswith-co.png]: /images/20220212/df6de793efab483aa901c485a7e027f4.png
[https_docs.microsoft.com_zh-cn_powerapps_maker_canvas-apps_functions_function-filter-lookup]: https://docs.microsoft.com/zh-cn/powerapps/maker/canvas-apps/functions/function-filter-lookup