在 Azure 逻辑应用中执行数据操作Perform data operations in Azure Logic Apps

本文介绍如何通过添加如下所述任务的操作,来处理逻辑应用中的数据:This article shows how you can work with data in your logic apps by adding actions for these tasks and more:

  • 从数组创建表。Create tables from arrays.
  • 基于条件从其他数组创建数组。Create arrays from other arrays based on a condition.
  • 从 JavaScript 对象表示法 (JSON) 对象属性创建用户友好的令牌,以便可以在工作流中轻松使用这些属性。Create user-friendly tokens from JavaScript Object Notation (JSON) object properties so you can easily use those properties in your workflow.

如果在此处找不到所需的操作,请尝试浏览逻辑应用提供的多种数据操作函数If you don't find the action you want here, try browsing the many various data manipulation functions that Logic Apps provides.

这些表格汇总了可用的数据操作,并根据操作可以处理的源数据类型进行组织,但每项说明以字母顺序显示。These tables summarize the data operations you can use and are organized based on the source data types that the operations work on, but each description appears alphabetically.

数组操作Array actions

这些操作帮助处理数组中的数据。These actions help you work with data in arrays.

操作Action 说明Description
创建 CSV 表Create CSV table 从数组创建逗号分隔值 (CSV) 表。Create a comma-separated value (CSV) table from an array.
创建 HTML 表Create HTML table 从数组创建 HTML 表。Create an HTML table from an array.
筛选数组Filter array 基于指定的筛选器或条件从数组创建数组子集。Create an array subset from an array based on the specified filter or condition.
Join Join 基于数组中的所有项创建一个字符串,并使用指定的字符分隔每个项。Create a string from all the items in an array and separate each item with the specified character.
Select Select 从不同数组中所有项的指定属性创建一个数组。Create an array from the specified properties for all the items in a different array.

JSON 操作JSON actions

这些操作帮助处理采用 JavaScript 对象表示法 (JSON) 格式的数据。These actions help you work with data in JavaScript Object Notation (JSON) format.

操作Action 说明Description
Compose Compose 从可能具有不同数据类型的多个输入创建一个消息或字符串。Create a message, or string, from multiple inputs that can have various data types. 然后可以使用此字符串作为单个输入,而无需反复输入相同的输入。You can then use this string as a single input, rather than repeatedly entering the same inputs. 例如,可以从各种输入创建单个 JSON 消息。For example, you can create a single JSON message from various inputs.
Parse JSON Parse JSON 为 JSON 内容中的属性创建用户友好的数据令牌,以便在逻辑应用中更轻松地使用这些属性。Create user-friendly data tokens for properties in JSON content so you can more easily use the properties in your logic apps.

先决条件Prerequisites

Compose 操作Compose action

若要从多个输入构造单个输出(例如 JSON 对象),可以使用“撰写”操作。 To construct a single output such as a JSON object from multiple inputs, you can use the Compose action. 输入可以采用不同的类型,例如整数、布尔值、数组、JSON 对象,以及 Azure 逻辑应用支持的其他任何本机类型(如二进制和 XML)。Your inputs can have various types such as integers, Booleans, arrays, JSON objects, and any other native type that Azure Logic Apps supports, for example, binary and XML. 然后,可以在“撰写”操作后面的操作中使用输出。 You can then use the output in actions that follow after the Compose action. “撰写”操作还能避免在生成逻辑应用的工作流时反复输入相同的输入。 The Compose action can also save you from repeatedly entering the same inputs while you build your logic app's workflow.

举例而言,可以从多个变量(例如,存储名字和姓氏的字符串变量,以及存储年龄的整数变量)构造 JSON 消息。For example, you can construct a JSON message from multiple variables, such as string variables that store people's first names and last names, and an integer variable that stores people's ages. 此处的“撰写”操作接受以下输入: Here, the Compose action accepts these inputs:

{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }

并创建此输出:and creates this output:

{"age":35,"fullName":"Owens,Sophie"}

若要尝试示例,请在逻辑应用设计器中遵循以下步骤。To try an example, follow these steps by using the Logic App Designer. 或者,如果你偏好使用代码视图编辑器,可将本文中的示例“撰写”和“初始化变量”操作复制到自己的逻辑应用基础工作流定义:数据操作代码示例 - 撰写Or, if you prefer working in the code view editor, you can copy the example Compose and Initialize variable action definitions from this article into your own logic app's underlying workflow definition: Data operation code examples - Compose

  1. Azure 门户或 Visual Studio 的逻辑应用设计器中打开逻辑应用。In the Azure portal or Visual Studio, open your logic app in Logic App Designer.

    本示例使用 Azure 门户以及包含一个“重复”触发器和多个“初始化变量”操作的逻辑应用。 This example uses the Azure portal and a logic app with a Recurrence trigger and several Initialize variable actions. 这些操作设置用于创建两个字符串变量和一个整数变量。These actions are set up for creating two string variables and an integer variable. 稍后测试逻辑应用时,可以手动运行应用,而无需等待触发器激发。When you later test your logic app, you can manually run your app without waiting for the trigger to fire.

    启动示例逻辑应用

  2. 在要创建输出的逻辑应用中,执行以下步骤之一:In your logic app where you want to create the output, follow one of these steps:

    • 若要在最后一个步骤下添加操作,请选择“新建步骤”。 To add an action under the last step, select New step .

      添加操作

    • 若要在步骤之间添加操作,请将鼠标移到连接箭头上方,以显示加号 (+)。To add an action between steps, move your mouse over the connecting arrow so the plus sign (+) appears. 选择加号,然后选择“添加操作”。 Choose the plus sign, and then select Add an action .

  3. 在“选择操作” 下的搜索框中,输入 compose 作为筛选器。Under Choose an action , in the search box, enter compose as your filter. 从操作列表中选择“撰写”操作。 From the actions list, select the Compose action.

    选择“撰写”操作

  4. 在“输入”框中,提供用于创建输出的输入。 In the Inputs box, provide the inputs you want for creating the output.

    对于本示例,在“输入”框中单击时,会显示动态内容列表,以便可以选择先前创建的变量: For this example, when you click inside the Inputs box, the dynamic content list appears so you can select the previously created variables:

    选择用于撰写的输入

    下面是已完成的示例“撰写”操作: Here is the finished example Compose action:

    完成的“撰写”操作

  5. 保存逻辑应用。Save your logic app. 在设计器工具栏上选择“保存”。 On the designer toolbar, select Save .

有关基础工作流定义中此操作的详细信息,请参阅“撰写”操作For more information about this action in your underlying workflow definition, see the Compose action.

测试逻辑应用Test your logic app

若要确认“撰写”操作是否创建了预期的结果,请向自己发送一条通知,其中包含“撰写”操作的输出。 To confirm whether the Compose action creates the expected results, send yourself a notification that includes output from the Compose action.

  1. 在逻辑应用中,添加一个可以向自己发送“撰写”操作结果的操作。 In your logic app, add an action that can send you the results from the Compose action.

  2. 在该操作中,单击希望显示结果的任意位置。In that action, click anywhere you want the results to appear. 当动态内容列表打开时,请在“撰写”操作下面选择“输出”。 When the dynamic content list opens, under the Compose action, select Output .

    本示例使用“Office 365 Outlook - 发送电子邮件”操作,并在电子邮件的正文和主题中包含“输出”字段: This example uses the Office 365 Outlook - Send an email action and includes the Output fields in the email's body and subject:

    “发送电子邮件”操作中的“输出”字段

  3. 现在,请手动运行逻辑应用。Now, manually run your logic app. 在设计器工具栏上选择“运行”。 On the designer toolbar, select Run .

    根据所用的电子邮件连接器,会收到下面所示的结果:Based on the email connector you used, here are the results you get:

    包含“撰写”操作结果的电子邮件

“创建 CSV 表”操作Create CSV table action

若要创建包含来自数组中 JavaScript 对象表示法 (JSON) 对象的属性和值的逗号分隔值 (CSV) 表,请使用“数据操作 - 创建 CSV 表”操作。 To create a comma-separated value (CSV) table that has the properties and values from JavaScript Object Notation (JSON) objects in an array, use the Data Operations - Create CSV table action. 然后,可以在“创建 CSV 表”操作后面的操作中使用生成的表。 You can then use the resulting table in actions that follow the Create CSV table action.

如果你偏好使用代码视图编辑器,可将本文中的示例“创建 CSV 表”和“初始化变量”操作复制到自己的逻辑应用基础工作流定义:数据操作代码示例 - 创建 CSV 表If you prefer working in the code view editor, you can copy the example Create CSV table and Initialize variable action definitions from this article into your own logic app's underlying workflow definition: Data operation code examples - Create CSV table

  1. Azure 门户或 Visual Studio 的逻辑应用设计器中打开逻辑应用。In the Azure portal or Visual Studio, open your logic app in Logic App Designer.

    本示例使用 Azure 门户以及包含一个“重复”触发器和一个“初始化变量”操作的逻辑应用。 This example uses the Azure portal and a logic app with a Recurrence trigger and an Initialize variable action. 该操作设置用于创建一个变量,该变量的初始值是包含一些采用 JSON 格式的属性和值的数组。The action is set up for creating a variable whose initial value is an array that has some properties and values in JSON format. 稍后测试逻辑应用时,可以手动运行应用,而无需等待触发器激发。When you later test your logic app, you can manually run your app without waiting for the trigger to fire.

    启动示例逻辑应用

  2. 在要创建 CSV 表的逻辑应用中,执行以下步骤之一:In your logic app where you want to create the CSV table, follow one of these steps:

    • 若要在最后一个步骤下添加操作,请选择“新建步骤”。 To add an action under the last step, select New step .

      添加操作

    • 若要在步骤之间添加操作,请将鼠标移到连接箭头上方,以显示加号 (+)。To add an action between steps, move your mouse over the connecting arrow so the plus sign (+) appears. 选择加号,然后选择“添加操作”。 Choose the plus sign, and then select Add an action .

  3. 在“选择操作” 下的搜索框中,输入 create csv table 作为筛选器。Under Choose an action , in the search box, enter create csv table as your filter. 在操作列表中选择“创建 CSV 表”操作。 From the actions list, select the Create CSV table action.

    选择“创建 CSV 表”操作

  4. 在“从”框中,提供用于创建表的数组或表达式。 In the From box, provide the array or expression you want for creating the table.

    对于本示例,在“从”框中单击时,会显示动态内容列表,以便可以选择先前创建的变量: For this example, when you click inside the From box, the dynamic content list appears so you can select the previously created variable:

    选择用于创建 CSV 表的数组输出

    提示

    若要为 JSON 对象中的属性创建用户友好的令牌,以便可以选择这些属性作为输入,请在调用“创建 CSV 表”操作之前使用分析 JSONTo create user-friendly tokens for the properties in JSON objects so you can select those properties as inputs, use the Parse JSON before calling the Create CSV table action.

    下面是已完成的示例“创建 CSV 表”操作: Here is the finished example Create CSV table action:

    完成的“创建 CSV 表”操作

  5. 保存逻辑应用。Save your logic app. 在设计器工具栏上选择“保存”。 On the designer toolbar, select Save .

自定义表格式Customize table format

默认情况下,“列”属性设置为根据数组项自动创建表列。 By default, the Columns property is set to automatically create the table columns based on the array items. 若要指定自定义标头和值,请执行以下步骤:To specify custom headers and values, follow these steps:

  1. 打开“列”列表,然后选择“自定义”。 Open the Columns list, and select Custom .

  2. 在“标头”属性中,指定要改用的自定义标头文本。 In the Header property, specify the custom header text to use instead.

  3. 在“值”属性中,指定要改用的自定义值。 In the Value property, specify the custom value to use instead.

若要从数组中返回值,可将 item() 函数与“创建 CSV 表”操作一起使用。 To return values from the array, you can use the item() function with the Create CSV table action. For_each 循环中,可以使用 items() 函数In a For_each loop, you can use the items() function.

例如,假设你希望表列仅包含数组中的属性值,而不包含属性名称。For example, suppose you want table columns that have only the property values and not the property names from an array. 若只要返回这些值,请遵循在设计器视图或代码视图中操作的步骤。To return only these values, follow these steps for working in designer view or in code view. 下面是此示例返回的结果:Here is the result that this example returns:

Apples,1
Oranges,2

在设计器视图中操作Work in designer view

在操作中,将“标头”列保留为空。 In the action, keep the Header column empty. 在“值”列中的每个行上,取消引用所需的每个数组属性。 On each row in the Value column, dereference each array property that you want. “值”下的每个行返回指定数组属性的所有值,并成为表中的列。 Each row under Value returns all the values for the specified array property and becomes a column in your table.

  1. 在“值”下的每个所需行上,单击编辑框以显示动态内容列表。 Under Value , on each row that you want, click inside the edit box so that the dynamic content list appears.

  2. 在动态内容列表中,选择“表达式”。 In the dynamic content list, select Expression .

  3. 在表达式编辑器中,输入此表达式用于指定所需的数组属性值,然后选择“确定”。 In the expression editor, enter this expression that specifies the array property value that you want, and select OK .

    item()?['<array-property-name>']

    例如:For example:

    • item()?['Description']
    • item()?['Product_ID']

    用于取消引用属性的表达式

  4. 对所需的每个数组属性重复上述步骤。Repeat the previous steps for each array property that you want. 完成后,操作如以下示例所示:When you're done, your action looks like this example:

    完成的表达式

  5. 若要将表达式解析为更具描述性的版本,请切换到代码视图并返回到设计器视图,然后重新打开折叠的操作:To resolve expressions into more descriptive versions, switch to code view and back to designer view, and then reopen the collapsed action:

    “创建 CSV 表”操作现在如以下示例所示: The Create CSV table action now appears like this example:

    包含已解析的表达式但不包含标头的“创建 CSV 表”操作

在代码视图中操作Work in code view

在操作的 JSON 定义中的 columns 数组内,将 header 属性设置为空字符串。In the action's JSON definition, within the columns array, set the header property to an empty string. 对于每个 value 属性,请取消引用所需的每个数组属性。For each value property, dereference each array property that you want.

  1. 在设计器工具栏上选择“代码视图”。 On the designer toolbar, select Code view .

  2. 在代码编辑器中操作的 columns 数组内,为所需的每个数组值列添加空的 header 属性和此 value 表达式:In the code editor, in the action's columns array, add the empty header property and this value expression for each column of array values that you want:

    {
       "header": "",
       "value": "@item()?['<array-property-name>']"
    }
    

    例如:For example:

    "Create_CSV_table": {
       "inputs": {
          "columns": [
             { 
                "header": "",
                "value": "@item()?['Description']"
             },
             { 
                "header": "",
                "value": "@item()?['Product_ID']"
             }
          ],
          "format": "CSV",
          "from": "@variables('myJSONArray')"
       }
    }
    
  3. 切换回到设计器视图,并重新打开折叠的操作。Switch back to designer view, and reopen the collapsed action.

    “创建 CSV 表”操作现在如以下示例所示,表达式已解析为更具描述性的版本: The Create CSV table action now appears like this example, and the expressions have resolved to more descriptive versions:

    包含已解析的表达式但不包含标头的“创建 CSV 表”操作

有关基础工作流定义中此操作的详细信息,请参阅“表”操作For more information about this action in your underlying workflow definition, see the Table action.

测试逻辑应用Test your logic app

若要确认“创建 CSV 表”操作是否创建了预期的结果,请向自己发送一条通知,其中包含“创建 CSV 表”操作的输出。 To confirm whether the Create CSV table action creates the expected results, send yourself a notification that includes output from the Create CSV table action.

  1. 在逻辑应用中,添加一个可以向自己发送“创建 CSV 表”操作结果的操作。 In your logic app, add an action that can send you the results from the Create CSV table action.

  2. 在该操作中,单击希望显示结果的任意位置。In that action, click anywhere you want the results to appear. 当动态内容列表打开时,请在“创建 CSV 表”操作下面选择“输出”。 When the dynamic content list opens, under the Create CSV table action, select Output .

    本示例使用 Office 365 Outlook“发送电子邮件”操作,并在电子邮件的正文中包含“输出”字段: This example uses the Office 365 Outlook Send an email action and includes the Output field in the email's body:

    “发送电子邮件”操作中的“输出”字段

  3. 现在,请手动运行逻辑应用。Now, manually run your logic app. 在设计器工具栏上选择“运行”。 On the designer toolbar, select Run .

    根据所用的电子邮件连接器,会收到下面所示的结果:Based on the email connector you used, here are the results you get:

    包含“创建 CSV 表”操作结果的电子邮件

“创建 HTML 表”操作Create HTML table action

若要创建包含来自数组中 JavaScript 对象表示法 (JSON) 对象的属性和值的 HTML 表,请使用“创建 HTML 表”操作。 To create an HTML table that has the properties and values from JavaScript Object Notation (JSON) objects in an array, use the Create HTML table action. 然后,可以在“创建 HTML 表”操作后面的操作中使用生成的表。 You can then use the resulting table in actions that follow the Create HTML table action.

如果你偏好使用代码视图编辑器,可将本文中的示例“创建 HTML 表”和“初始化变量”操作复制到自己的逻辑应用基础工作流定义:数据操作代码示例 - 创建 HTML 表If you prefer working in the code view editor, you can copy the example Create HTML table and Initialize variable action definitions from this article into your own logic app's underlying workflow definition: Data operation code examples - Create HTML table

  1. Azure 门户或 Visual Studio 的逻辑应用设计器中打开逻辑应用。In the Azure portal or Visual Studio, open your logic app in Logic App Designer.

    本示例使用 Azure 门户以及包含一个“重复”触发器和一个“初始化变量”操作的逻辑应用。 This example uses the Azure portal and a logic app with a Recurrence trigger and an Initialize variable action. 该操作设置用于创建一个变量,该变量的初始值是包含一些采用 JSON 格式的属性和值的数组。The action is set up for creating a variable whose initial value is an array that has some properties and values in JSON format. 稍后测试逻辑应用时,可以手动运行应用,而无需等待触发器激发。When you later test your logic app, you can manually run your app without waiting for the trigger to fire.

    启动示例逻辑应用

  2. 在要创建 HTML 表的逻辑应用中,执行以下步骤之一:In your logic app where you want to create an HTML table, follow one of these steps:

    • 若要在最后一个步骤下添加操作,请选择“新建步骤”。 To add an action under the last step, select New step .

      添加操作

    • 若要在步骤之间添加操作,请将鼠标移到连接箭头上方,以显示加号 ( + )。To add an action between steps, move your mouse over the connecting arrow so the plus sign ( + ) appears. 选择加号,然后选择“添加操作”。 Select the plus sign, and then select Add an action .

  3. 在“选择操作” 下的搜索框中,输入 create html table 作为筛选器。Under Choose an action , in the search box, enter create html table as your filter. 在操作列表中选择“创建 HTML 表”操作。 From the actions list, select the Create HTML table action.

    选择“创建 HTML 表”操作

  4. 在“从”框中,提供用于创建表的数组或表达式。 In the From box, provide the array or expression you want for creating the table.

    对于本示例,在“从”框中单击时,会显示动态内容列表,以便可以选择先前创建的变量: For this example, when you click inside the From box, the dynamic content list appears so you can select the previously created variable:

    选择用于创建 HTML 表的数组输出

    提示

    若要为 JSON 对象中的属性创建用户友好的令牌,以便可以选择这些属性作为输入,请在调用“创建 HTML 表”操作之前使用分析 JSONTo create user-friendly tokens for the properties in JSON objects so you can select those properties as inputs, use the Parse JSON before calling the Create HTML table action.

    下面是已完成的示例“创建 HTML 表”操作: Here is the finished example Create HTML table action:

    完成的“创建 HTML 表”操作

  5. 保存逻辑应用。Save your logic app. 在设计器工具栏上选择“保存”。 On the designer toolbar, select Save .

自定义表格式Customize table format

默认情况下,“列”属性设置为根据数组项自动创建表列。 By default, the Columns property is set to automatically create the table columns based on the array items. 若要指定自定义标头和值,请执行以下步骤:To specify custom headers and values, follow these steps:

  1. 打开“列”列表,然后选择“自定义”。 Open the Columns list, and select Custom .

  2. 在“标头”属性中,指定要改用的自定义标头文本。 In the Header property, specify the custom header text to use instead.

  3. 在“值”属性中,指定要改用的自定义值。 In the Value property, specify the custom value to use instead.

若要从数组中返回值,可将 item() 函数与“创建 HTML 表”操作一起使用。 To return values from the array, you can use the item() function with the Create HTML table action. For_each 循环中,可以使用 items() 函数In a For_each loop, you can use the items() function.

例如,假设你希望表列仅包含数组中的属性值,而不包含属性名称。For example, suppose you want table columns that have only the property values and not the property names from an array. 若只要返回这些值,请遵循在设计器视图或代码视图中操作的步骤。To return only these values, follow these steps for working in designer view or in code view. 下面是此示例返回的结果:Here is the result that this example returns:

Apples,1
Oranges,2

在设计器视图中操作Work in designer view

在操作中,将“标头”列保留为空。 In the action, keep the Header column empty. 在“值”列中的每个行上,取消引用所需的每个数组属性。 On each row in the Value column, dereference each array property that you want. “值”下的每个行返回指定属性的所有值,并成为表中的列。 Each row under Value returns all the values for the specified property and becomes a column in your table.

  1. 在“值”下的每个所需行上,单击编辑框以显示动态内容列表。 Under Value , on each row that you want, click inside the edit box so that the dynamic content list appears.

  2. 在动态内容列表中,选择“表达式”。 In the dynamic content list, select Expression .

  3. 在表达式编辑器中,输入此表达式用于指定所需的数组属性值,然后选择“确定”。 In the expression editor, enter this expression that specifies the array property value that you want, and select OK .

    item()?['<array-property-name>']

    例如:For example:

    • item()?['Description']
    • item()?['Product_ID']

    用于取消引用属性的表达式

  4. 对所需的每个数组属性重复上述步骤。Repeat the previous steps for each array property that you want. 完成后,操作如以下示例所示:When you're done, your action looks like this example:

    完成的表达式

  5. 若要将表达式解析为更具描述性的版本,请切换到代码视图并返回到设计器视图,然后重新打开折叠的操作:To resolve expressions into more descriptive versions, switch to code view and back to designer view, and then reopen the collapsed action:

    “创建 HTML 表”操作现在如以下示例所示: The Create HTML table action now appears like this example:

    包含已解析的表达式但不包含标头的“创建 HTML 表”操作

在代码视图中操作Work in code view

在操作的 JSON 定义中的 columns 数组内,将 header 属性设置为空字符串。In the action's JSON definition, within the columns array, set the header property to an empty string. 对于每个 value 属性,请取消引用所需的每个数组属性。For each value property, dereference each array property that you want.

  1. 在设计器工具栏上选择“代码视图”。 On the designer toolbar, select Code view .

  2. 在代码编辑器中操作的 columns 数组内,为所需的每个数组值列添加空的 header 属性和此 value 表达式:In the code editor, in the action's columns array, add the empty header property and this value expression for each column of array values that you want:

    {
       "header": "",
       "value": "@item()?['<array-property-name>']"
    }
    

    例如:For example:

    "Create_HTML_table": {
       "inputs": {
          "columns": [
             { 
                "header": "",
                "value": "@item()?['Description']"
             },
             { 
                "header": "",
                "value": "@item()?['Product_ID']"
             }
          ],
          "format": "HTML",
          "from": "@variables('myJSONArray')"
       }
    }
    
  3. 切换回到设计器视图,并重新打开折叠的操作。Switch back to designer view, and reopen the collapsed action.

    “创建 HTML 表”操作现在如以下示例所示,表达式已解析为更具描述性的版本: The Create HTML table action now appears like this example, and the expressions have resolved to more descriptive versions:

    包含已解析的表达式但不包含标头的“创建 HTML 表”操作

有关基础工作流定义中此操作的详细信息,请参阅“表”操作For more information about this action in your underlying workflow definition, see the Table action.

测试逻辑应用Test your logic app

若要确认“创建 HTML 表”操作是否创建了预期的结果,请向自己发送一条通知,其中包含“创建 HTML 表”操作的输出。 To confirm whether the Create HTML table action creates the expected results, send yourself a notification that includes output from the Create HTML table action.

  1. 在逻辑应用中,添加一个可以向自己发送“创建 HTML 表”操作结果的操作。 In your logic app, add an action that can send you the results from the Create HTML table action.

  2. 在该操作中,单击希望显示结果的任意位置。In that action, click anywhere you want the results to appear. 当动态内容列表打开时,请在“创建 HTML 表”操作下面选择“输出”。 When the dynamic content list opens, under the Create HTML table action, select Output .

    本示例使用 Office 365 Outlook“发送电子邮件”操作,并在电子邮件的正文中包含“输出”字段: This example uses the Office 365 Outlook Send an email action and includes the Output field in the email's body:

    “发送电子邮件”操作中的“输出”字段

    备注

    在电子邮件操作中包含 HTML 表输出时,请确保在电子邮件中操作的高级选项中,将“是 HTML”属性设置为“是”。 When including the HTML table output in an email action, make sure that you set the Is HTML property to Yes in the email action's advanced options. 这样,电子邮件操作便可以正确设置 HTML 表的格式。That way, the email action correctly formats the HTML table.

  3. 现在,请手动运行逻辑应用。Now, manually run your logic app. 在设计器工具栏上选择“运行”。 On the designer toolbar, select Run .

    根据所用的电子邮件连接器,会收到下面所示的结果:Based on the email connector you used, here are the results you get:

    包含“创建 HTML 表”操作结果的电子邮件

“筛选数组”操作Filter array action

若要创建包含符合特定条件的项的小型数组,请从现有的数组使用“筛选数组”操作。 To create a smaller array that has items, which meet specific criteria, from an existing array, use the Filter array action. 然后,可以在“筛选数组”操作后面的操作中使用筛选的数组。 You can then use the filtered array in actions that follow after the Filter array action.

备注

在条件中使用的任何筛选器文本区分大小写。Any filter text that you use in your condition is case sensitive. 此外,此操作无法更改数组中项的格式或组成部分。Also, this action can't change the format or components of items in the array.

要使操作使用“筛选数组”操作的数组输出,这些操作必须接受数组作为输入,或者必须将输出数组转换为另一种兼容格式。 For actions to use the array output from the Filter array action, either those actions must accept arrays as input, or you might have to transform the output array into another compatible format.

如果你偏好使用代码视图编辑器,可将本文中的示例“筛选数组”和“初始化变量”操作复制到自己的逻辑应用基础工作流定义:数据操作代码示例 - 筛选数组If you prefer working in the code view editor, you can copy the example Filter array and Initialize variable action definitions from this article into your own logic app's underlying workflow definition: Data operation code examples - Filter array

  1. Azure 门户或 Visual Studio 的逻辑应用设计器中打开逻辑应用。In the Azure portal or Visual Studio, open your logic app in Logic App Designer.

    本示例使用 Azure 门户以及包含一个“重复”触发器和一个“初始化变量”操作的逻辑应用。 This example uses the Azure portal and a logic app with a Recurrence trigger and an Initialize variable action. 该操作设置用于创建一个变量,该变量的初始值是包含一些示例整数的数组。The action is set up for creating a variable whose initial value is an array that has some sample integers. 稍后测试逻辑应用时,可以手动运行应用,而无需等待触发器激发。When you later test your logic app, you can manually run your app without waiting for the trigger to fire.

    备注

    尽管本示例使用了简单的整数数组,但此操作对 JSON 对象数组特别有用,在其中,可以基于对象的属性和值进行筛选。Although this example uses a simple integer array, this action is especially useful for JSON object arrays where you can filter based on the objects' properties and values.

    启动示例逻辑应用

  2. 在要创建筛选数组的逻辑应用中,执行以下步骤之一:In your logic app where you want to create the filtered array, follow one of these steps:

    • 若要在最后一个步骤下添加操作,请选择“新建步骤”。 To add an action under the last step, select New step .

      添加操作

    • 若要在步骤之间添加操作,请将鼠标移到连接箭头上方,以显示加号 ( + )。To add an action between steps, move your mouse over the connecting arrow so the plus sign ( + ) appears. 选择加号,然后选择“添加操作”。 Select the plus sign, and then select Add an action .

  3. 在搜索框中,输入 filter array 作为筛选器。In the search box, enter filter array as your filter. 在操作列表中选择“筛选数组”操作。 From the actions list, select the Filter array action.

    选择“筛选数组”操作

  4. 在“从”框中,提供要筛选的数组或表达式。 In the From box, provide the array or expression you want to filter.

    对于本示例,在“从”框中单击时,会显示动态内容列表,以便可以选择先前创建的变量: For this example, when you click inside the From box, the dynamic content list appears so you can select the previously created variable:

    选择用于创建筛选数组的数组输出

  5. 对于条件,请指定要比较的数组项,选择比较运算符,然后指定比较值。For the condition, specify the array items to compare, select the comparison operator, and specify the comparison value.

    本示例使用 item() 函数访问数组中的每个项,“筛选数组”操作搜索值大于 1 的数组项: This example uses the item() function for accessing each item in the array while the Filter array action searches for array items whose value is greater than one:

    完成的“筛选数组”操作

  6. 保存逻辑应用。Save your logic app. 在设计器工具栏上选择“保存”。 On the designer toolbar, select Save .

有关基础工作流定义中此操作的详细信息,请参阅“查询”操作For more information about this action in your underlying workflow definition, see Query action.

测试逻辑应用Test your logic app

若要确认“筛选数组”操作是否创建了预期的结果,请向自己发送一条通知,其中包含“筛选数组”操作的输出。 To confirm whether Filter array action creates the expected results, send yourself a notification that includes output from the Filter array action.

  1. 在逻辑应用中,添加一个可以向自己发送“筛选数组”操作结果的操作。 In your logic app, add an action that can send you the results from the Filter array action.

  2. 在该操作中,单击希望显示结果的任意位置。In that action, click anywhere you want the results to appear. 当动态内容列表打开时,请选择“表达式”。 When the dynamic content list opens, select Expression . 若要获取“筛选数组”操作的数组输出,请输入包含“筛选数组”操作名称的以下表达式: To get the array output from the Filter array action, enter this expression that includes the Filter array action's name:

    @actionBody('Filter_array')

    本示例使用 Office 365 Outlook“发送电子邮件”操作,并在电子邮件正文中包含 actionBody('Filter_array') 表达式的输出:This example uses the Office 365 Outlook Send an email action and includes the outputs from the actionBody('Filter_array') expression in the email's body:

    “发送电子邮件”操作中的操作输出

  3. 现在,请手动运行逻辑应用。Now, manually run your logic app. 在设计器工具栏上选择“运行”。 On the designer toolbar, select Run .

    根据所用的电子邮件连接器,会收到下面所示的结果:Based on the email connector you used, here are the results you get:

    包含“筛选数组”操作结果的电子邮件

Join 操作Join action

若要创建包含数组中所有项的字符串,并使用特定的分隔符分隔这些项,请使用“联接”操作。 To create a string that has all the items from an array and separate those items with a specific delimiter character, use the Join action. 然后,可以在“联接”操作后面的操作中使用该字符串。 You can then use the string in actions that follow after the Join action.

如果你偏好使用代码视图编辑器,可将本文中的示例“联接”和“初始化变量”操作复制到自己的逻辑应用基础工作流定义:数据操作代码示例 - 联接If you prefer working in the code view editor, you can copy the example Join and Initialize variable action definitions from this article into your own logic app's underlying workflow definition: Data operation code examples - Join

  1. Azure 门户或 Visual Studio 的逻辑应用设计器中打开逻辑应用。In the Azure portal or Visual Studio, open your logic app in Logic App Designer.

    本示例使用 Azure 门户以及包含一个“重复”触发器和一个“初始化变量”操作的逻辑应用。 This example uses the Azure portal and a logic app with a Recurrence trigger and an Initialize variable action. 此操作设置用于创建一个变量,该变量的初始值是包含一些示例整数的数组。This action is set up for creating a variable whose initial value is an array that has some sample integers. 稍后测试逻辑应用时,可以手动运行应用,而无需等待触发器激发。When you test your logic app later, you can manually run your app without waiting for the trigger to fire.

    启动示例逻辑应用

  2. 在要从数组创建字符串的逻辑应用中,执行以下步骤之一:In your logic app where you want to create the string from an array, follow one of these steps:

    • 若要在最后一个步骤下添加操作,请选择“新建步骤”。 To add an action under the last step, select New step .

      添加操作

    • 若要在步骤之间添加操作,请将鼠标移到连接箭头上方,以显示加号 ( + )。To add an action between steps, move your mouse over the connecting arrow so the plus sign ( + ) appears. 选择加号,然后选择“添加操作”。 Select the plus sign, and then select Add an action .

  3. 在搜索框中,输入 join 作为筛选器。In the search box, enter join as your filter. 在操作列表中选择此操作: JoinFrom the actions list, select this action: Join

    选择“联接”操作

  4. 在“从”框中,提供包含要联接的项(字符串形式)的数组。 In the From box, provide the array that has the items you want to join as a string.

    对于本示例,在“从”框中单击时,会显示动态内容列表,以便可以选择先前创建的变量: For this example, when you click inside the From box, the dynamic content list that appears so you can select the previously created variable:

    选择用于创建字符串的数组输出

  5. 在“联接方式”框中,输入用于分隔每个数组项的字符。 In the Join with box, enter the character you want for separating each array item.

    本示例使用冒号 (:) 作为分隔符。This example uses a colon (:) as the separator.

    提供分隔符

  6. 保存逻辑应用。Save your logic app. 在设计器工具栏上选择“保存”。 On the designer toolbar, select Save .

有关基础工作流定义中此操作的详细信息,请参阅“联接”操作For more information about this action in your underlying workflow definition, see the Join action.

测试逻辑应用Test your logic app

若要确认“联接”操作是否创建了预期的结果,请向自己发送一条通知,其中包含“联接”操作的输出。 To confirm whether the Join action creates the expected results, send yourself a notification that includes output from the Join action.

  1. 在逻辑应用中,添加一个可以向自己发送“联接”操作结果的操作。 In your logic app, add an action that can send you the results from the Join action.

  2. 在该操作中,单击希望显示结果的任意位置。In that action, click anywhere you want the results to appear. 当动态内容列表打开时,请在“联接”操作下面选择“输出”。 When the dynamic content list opens, under the Join action, select Output .

    本示例使用 Office 365 Outlook“发送电子邮件”操作,并在电子邮件的正文中包含“输出”字段: This example uses the Office 365 Outlook Send an email action and includes the Output field in the email's body:

    “发送电子邮件”操作中的“输出”字段

  3. 现在,请手动运行逻辑应用。Now, manually run your logic app. 在设计器工具栏上选择“运行”。 On the designer toolbar, select Run .

    根据所用的电子邮件连接器,会收到下面所示的结果:Based on the email connector you used, here are the results you get:

    包含“联接”操作结果的电子邮件

Parse JSON 操作Parse JSON action

若要引用或访问 JavaScript 对象表示法 (JSON) 内容中的属性,可以使用“分析 JSON”操作为这些属性创建用户友好的字段或令牌。 To reference or access properties in JavaScript Object Notation (JSON) content, you can create user-friendly fields or tokens for those properties by using the Parse JSON action. 这样,在为逻辑应用指定输入时,便可以从动态内容列表中选择这些属性。That way, you can select those properties from the dynamic content list when you specify inputs for your logic app. 对于此操作,可以提供 JSON 架构,或者从示例 JSON 内容或有效负载生成 JSON 架构。For this action, you can either provide a JSON schema or generate a JSON schema from your sample JSON content or payload.

如果你偏好使用代码视图编辑器,可将本文中的示例“分析 JSON”和“初始化变量”操作复制到自己的逻辑应用基础工作流定义:数据操作代码示例 - 分析 JSONIf you prefer working in the code view editor, you can copy the example Parse JSON and Initialize variable action definitions from this article into your own logic app's underlying workflow definition: Data operation code examples - Parse JSON

  1. Azure 门户或 Visual Studio 的逻辑应用设计器中打开逻辑应用。In the Azure portal or Visual Studio, open your logic app in Logic App Designer.

    本示例使用 Azure 门户以及包含一个“重复”触发器和一个“初始化变量”操作的逻辑应用。 This example uses the Azure portal and a logic app with a Recurrence trigger and an Initialize variable action. 该操作设置用于创建一个变量,该变量的初始值是包含属性和值的 JSON 对象。The action is set up for creating a variable whose initial value is a JSON object that has properties and values. 稍后测试逻辑应用时,可以手动运行应用,而无需等待触发器激发。When you later test your logic app, you can manually run your app without waiting for the trigger to fire.

    启动示例逻辑应用

  2. 在要分析 JSON 内容的逻辑应用中,执行以下步骤之一:In your logic app where you want to parse the JSON content, follow one of these steps:

    • 若要在最后一个步骤下添加操作,请选择“新建步骤”。 To add an action under the last step, select New step .

      添加操作

    • 若要在步骤之间添加操作,请将鼠标移到连接箭头上方,以显示加号 ( + )。To add an action between steps, move your mouse over the connecting arrow so the plus sign ( + ) appears. 选择加号,然后选择“添加操作”。 Select the plus sign, and then select Add an action .

  3. 在搜索框中,输入 parse json 作为筛选器。In the search box, enter parse json as your filter. 在操作列表中选择“分析 JSON”操作。 From the actions list, select the Parse JSON action.

    选择“分析 JSON”操作

  4. 在“内容”框中,提供要分析的 JSON 内容。 In the Content box, provide the JSON content you want to parse.

    对于本示例,在“内容”框中单击时,会显示动态内容列表,以便可以选择先前创建的变量: For this example, when you click inside the Content box, the dynamic content list appears so you can select the previously created variable:

    选择“分析 JSON”操作的 JSON 对象

  5. 输入 JSON 架构用于描述所要分析的 JSON 内容。Enter the JSON schema that describes the JSON content you're parsing.

    在本示例中,JSON 架构如下所示:For this example, here is the JSON schema:

    为要分析的 JSON 对象提供 JSON 架构

    如果没有架构,可以从要分析的 JSON 内容或有效负载生成该架构。 If you don't have the schema, you can generate that schema from the JSON content, or payload , you're parsing.

    1. 在“分析 JSON”操作中,选择“使用示例有效负载生成架构” 。In the Parse JSON action, select Use sample payload to generate schema .

    2. 在“输入或粘贴示例 JSON 有效负载”下提供 JSON 内容,然后选择“完成”。 Under Enter or paste a sample JSON payload , provide the JSON content, and then select Done .

      输入用于生成架构的 JSON 内容

  6. 保存逻辑应用。Save your logic app. 在设计器工具栏上选择“保存”。 On the designer toolbar, select Save .

有关基础工作流定义中此操作的详细信息,请参阅“分析 JSON”操作For more information about this action in your underlying workflow definition, see Parse JSON action.

测试逻辑应用Test your logic app

若要确认“分析 JSON”操作是否创建了预期的结果,请向自己发送一条通知,其中包含“分析 JSON”操作的输出。 To confirm whether the Parse JSON action creates the expected results, send yourself a notification that includes output from the Parse JSON action.

  1. 在逻辑应用中,添加一个可以向自己发送“分析 JSON”操作结果的操作。 In your logic app, add an action that can send you the results from the Parse JSON action.

  2. 在该操作中,单击希望显示结果的任意位置。In that action, click anywhere you want the results to appear. 当动态内容列表打开时,可在“分析 JSON”操作下面选择已分析的 JSON 内容中的属性。 When the dynamic content list opens, under the Parse JSON action, you can now select the properties from the parsed JSON content.

    本示例使用Office 365 Outlook“发送电子邮件”操作,并在电子邮件的正文和主题中包含 FirstNameLastNameEmail 字段:This example uses the Office 365 Outlook Send an email action and includes the FirstName , LastName , and Email fields in the email's body:

    “发送电子邮件”操作中的 JSON 属性

    下面是完成的电子邮件操作:Here is the finished email action:

    完成的电子邮件操作

  3. 现在,请手动运行逻辑应用。Now, manually run your logic app. 在设计器工具栏上选择“运行”。 On the designer toolbar, select Run .

    根据所用的电子邮件连接器,会收到下面所示的结果:Based on the email connector you used, here are the results you get:

    包含“联接”操作结果的电子邮件

选择操作Select action

若要创建包含从现有数组中的值生成的 JSON 对象的数组,请使用“选择”操作。 To create an array that has JSON objects built from values in an existing array, use the Select action. 例如,可以通过指定每个 JSON 对象必须包含的属性,以及将源数组中的值映射到这些属性的方式,来为整数数组中的每个值创建一个 JSON 对象。For example, you can create a JSON object for each value in an integer array by specifying the properties that each JSON object must have and how to map the values in the source array to those properties. 尽管可以更改这些 JSON 对象中的组成部分,但输出数组的项数始终与源数组相同。And although you can change the components in those JSON objects, the output array always has the same number of items as the source array.

备注

要使操作使用“选择”操作的数组输出,这些操作必须接受数组作为输入,或者必须将输出数组转换为另一种兼容格式。 For actions to use the array output from the Select action, either those actions must accept arrays as input, or you might have to transform the output array into another compatible format.

如果你偏好使用代码视图编辑器,可将本文中的示例“选择”和“初始化变量”操作复制到自己的逻辑应用基础工作流定义:数据操作代码示例 - 选择If you prefer working in the code view editor, you can copy the example Select and Initialize variable action definitions from this article into your own logic app's underlying workflow definition: Data operation code examples - Select

  1. Azure 门户或 Visual Studio 的逻辑应用设计器中打开逻辑应用。In the Azure portal or Visual Studio, open your logic app in Logic App Designer.

    本示例使用 Azure 门户以及包含一个“重复”触发器和一个“初始化变量”操作的逻辑应用。 This example uses the Azure portal and a logic app with a Recurrence trigger and an Initialize variable action. 该操作设置用于创建一个变量,该变量的初始值是包含一些示例整数的数组。The action is set up for creating a variable whose initial value is an array that has some sample integers. 稍后测试逻辑应用时,可以手动运行应用,而无需等待触发器激发。When you later test your logic app, you can manually run your app without waiting for the trigger to fire.

    启动示例逻辑应用

  2. 在要创建数组的逻辑应用中,执行以下步骤之一:In your logic app where you want to create the array, follow one of these steps:

    • 若要在最后一个步骤下添加操作,请选择“新建步骤”。 To add an action under the last step, select New step .

      添加操作

    • 若要在步骤之间添加操作,请将鼠标移到连接箭头上方,以显示加号 ( + )。To add an action between steps, move your mouse over the connecting arrow so the plus sign ( + ) appears. 选择加号,然后选择“添加操作”。 Select the plus sign, and then select Add an action .

  3. 在“选择操作”下,选择“内置”。 Under Choose an action , select Built-in . 在搜索框中,输入 select 作为筛选器。In the search box, enter select as your filter. 在“操作”列表中,选择“选择”操作。 From the actions list, select the Select action.

    选择“选择”操作

  4. 在“从”框中,指定所需的源数组。 In the From box, specify the source array you want.

    对于本示例,在“从”框中单击时,会显示动态内容列表,以便可以选择先前创建的变量: For this example, when you click inside the From box, the dynamic content list appears so you can select the previously created variable:

    选择“选择”操作的源数组

  5. 在“映射”框的左列中,提供要将源数组中每个值分配到的属性名称。 In the Map box's left-hand column, provide the property name you want to assign each value in the source array. 在右列中指定一个表达式,用于表示要将该属性分配到的值。In the right-hand column, specify an expression that represents the value you want to assign the property.

    本示例使用表达式中访问每个数组项的 item() 函数,将“Product_ID”指定为分配到整数数组中每个值的属性名称。This example specifies "Product_ID" as the property name to assign each value in the integer array by using the item() function in an expression that accesses each array item.

    指定要创建的数组的 JSON 对象属性和值

    下面是完成的操作:Here is the finished action:

    完成的“选择”操作

  6. 保存逻辑应用。Save your logic app. 在设计器工具栏上选择“保存”。 On the designer toolbar, select Save .

有关基础工作流定义中此操作的详细信息,请参阅“选择”操作For more information about this action in your underlying workflow definition, see Select action.

测试逻辑应用Test your logic app

若要确认“选择”操作是否创建了预期的结果,请向自己发送一条通知,其中包含“选择”操作的输出。 To confirm whether the Select action creates the expected results, send yourself a notification that includes output from the Select action.

  1. 在逻辑应用中,添加一个可以向自己发送“选择”操作结果的操作。 In your logic app, add an action that can send you the results from the Select action.

  2. 在该操作中,单击希望显示结果的任意位置。In that action, click anywhere you want the results to appear. 当动态内容列表打开时,请选择“表达式”。 When the dynamic content list opens, select Expression . 若要获取“选择”操作的数组输出,请输入包含“选择”操作名称的以下表达式: To get the array output from the Select action, enter this expression that includes the Select action's name:

    @actionBody('Select')

    本示例使用 Office 365 Outlook“发送电子邮件”操作,并在电子邮件正文中包含 @actionBody('Select') 表达式的输出:This example uses the Office 365 Outlook Send an email action and includes the outputs from the @actionBody('Select') expression in the email's body:

    “发送电子邮件”操作中的操作输出

  3. 现在,请手动运行逻辑应用。Now, manually run your logic app. 在设计器工具栏上选择“运行”。 On the designer toolbar, select Run .

    根据所用的电子邮件连接器,会收到下面所示的结果:Based on the email connector you used, here are the results you get:

    包含“选择”操作结果的电子邮件

后续步骤Next steps