在 Azure 逻辑应用中创建变量以存储和管理值

适用范围：Azure 逻辑应用（消耗型 + 标准型）

本操作指南展示如何创建和使用变量，以便在逻辑应用工作流中存储和使用值。 例如，变量可帮助跟踪某个循环运行的次数。 若要循环访问某个数组或检查特定项的数组，可以使用变量来引用每个数组项的索引号。

可为整数、浮点数、布尔值、字符串、数组和对象等数据类型创建变量。 例如，创建变量之后，可以执行其他任务。

• 获取或引用变量的值。
• 按恒定值（也称为增量或减量）增加或减小变量。
• 向变量分配不同的值。
• 插入或追加变量值作为字符串或数组中的最后一个项。

变量只在创建它们的工作流实例中存在并保持全局性。 另外，它们保留在工作流实例中的任何循环迭代之间。 引用变量时，请使用变量的名称作为令牌，而不要使用操作的名称。操作名称通常用于引用操作的输出。

先决条件

• Azure 帐户和订阅。 如果你没有订阅，可以注册 Azure 帐户。

• 你要在其中创建变量的逻辑应用工作流和启动工作流的触发器。

  在添加用于创建和使用变量的操作之前，工作流的第一步必须使用触发器启动工作流。 有关详细信息，请参阅使用触发器或操作构建工作流。

以下步骤使用 Azure 门户，但利用适当的 Azure 逻辑应用扩展，也可以使用以下工具来创建逻辑应用工作流：

• 消耗型工作流：Visual Studio 或 Visual Studio Code

• 标准工作流：Visual Studio Code

根据你使用的是消耗工作流还是标准工作流，遵循相应的步骤：

初始化变量

可以在工作流中使用一个操作来创建一个变量并声明其数据类型和初始值。 可以仅在全局级别声明变量，而不是在作用域、条件和循环中声明。

如果从设计器切换到代码视图，以下示例演示“初始化变量”操作如何以 JavaScript 对象表示法 (JSON) 格式在工作流定义中显示：

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ 
            {
               "name": "Count",
               "type": "Integer",
               "value": 0
            }
         ]
      },
      "runAfter": {}
   }
},

以下示例演示其他变量类型：

布尔值变量

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myBooleanVariable",
               "type": "boolean",
               "value": false
            }
         ]
      },
      "runAfter": {}
   }
},

浮点变量

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myFloatVariable",
               "type": "float",
               "value": 1.99999
            }
         ]
      },
      "runAfter": {}
   }
},

字符串变量

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myStringVariable",
               "type": "string",
               "value": "lorem ipsum"
            }
         ]
      },
      "runAfter": {}
   }
},

对象变量

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "MyObjectVariable",
               "type": "object",
               "value": {
                  "ProductItem": {
                     "Name": "myProductName",
                     "ProductID": "000000"
                  }
               }
            }
         ]
      },
      "runAfter": {}
   }
},

包含整数的数组

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myArrayVariable",
               "type": "array",
               "value": [1, 2, 3]
            }
         ]
      },
      "runAfter": {}
   }
},

包含字符串的数组

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "myArrayVariable",
               "type": "array",
               "value": ["red", "orange", "yellow"]
            }
         ]
      },
      "runAfter": {}
   }
},

获取变量的值

若要检索或引用变量的内容，可以在工作流设计器和代码视图编辑器中使用 variables() 函数。 引用变量时，请使用变量的名称作为令牌，而不要使用操作的名称。操作名称通常用于引用操作的输出。

例如，以下表达式使用 variables() 函数从本指南中创建的数组变量中获取项。 string() 函数以字符串格式返回变量的内容："1, 2, 3, red"

@{string(variables('myArrayVariable'))}

递增变量

若要按特定常量值增大或递增某个变量，请将“递增变量”操作添加到工作流。 此操作仅适用于整数和浮点数变量。

如果从设计器切换到代码视图，以下示例演示“递增变量”操作如何以 JSON 格式在工作流定义中显示：

"actions": {
   "Increment_variable": {
      "type": "IncrementVariable",
      "inputs": {
         "name": "Count",
         "value": 1
      },
      "runAfter": {}
   }
},

示例：创建循环计数器

变量通常用于统计某个循环的运行次数。 本示例通过创建一个统计电子邮件中附件数的循环，来演示如何创建和使用变量完成此任务。

测试工作流

1. 若要手动触发工作流，请执行相应的步骤：

   消耗工作流

   在设计器工具栏中选择“运行触发器”>“运行”来手动运行工作流。

   标准工作流

   在工作流菜单上，选择“概述”。 在工具栏上选择“运行”>“运行”。

2. 将包含一个或多个附件的电子邮件发送到本示例中使用的电子邮件帐户。

   此步骤将触发工作流触发器，从而创建并运行工作流实例。 因此，工作流会发送消息或电子邮件，其中显示了发送的电子邮件中的附件数目。

如果从设计器切换到代码视图，以下示例演示 For each 循环和“递增变量”操作如何以 JSON 格式在工作流定义中显示：

"actions": {
   "For_each": {
      "type": "Foreach",
      "actions": {
         "Increment_variable": {
           "type": "IncrementVariable",
            "inputs": {
               "name": "Count",
               "value": 1
            },
            "runAfter": {}
         }
      },
      "foreach": "@triggerBody()?['Attachments']",
      "runAfter": {
         "Initialize_variable": [ "Succeeded" ]
      }
   }
},

递减变量

若要按特定常量值减小或递减变量，请遵循递增变量步骤，不过需要向工作流添加“递减变量”操作。 此操作仅适用于整数和浮点数变量。

下表描述了“递减变量”操作的信息：

属性	需要	值	描述
客户	是	<variable-name>	要减量的变量的名称
值	否	<increment-value>	减量变量的值。 默认值为 1。 提示：尽管此值是可选的，但最好是设置此值，以便始终知道用于递减变量的特定值。

如果从设计器切换到代码视图，以下示例演示“递减变量”操作如何以 JSON 格式在工作流定义中显示：

"actions": {
   "Decrement_variable": {
      "type": "DecrementVariable",
      "inputs": {
         "name": "Count",
         "value": 1
      },
      "runAfter": {}
   }
},

设置变量

若要将其他值赋给现有变量，请遵循递增变量步骤，不过需要：

1. 改为找到并选择“设置变量”操作。

2. 提供要分派的变量名称和值。 新值和变量必须具有相同的数据类型。 之所以需要该值，是因为此操作没有默认值。

下表描述了“设置变量”操作的信息：

属性	需要	值	描述
客户	是	<variable-name>	要更改的变量的名称
值	是	<new-value>	要分派变量的值。 两者必须具有相同的数据类型。

如果从设计器切换到代码视图，以下示例演示“设置变量”操作如何以 JSON 格式在工作流定义中显示：

以下示例将 Count 变量的当前值更改为其他值：

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
               "name": "Count",
               "type": "Integer",
               "value": 0
          } ]
      },
      "runAfter": {}
   },
   "Set_variable": {
      "type": "SetVariable",
      "inputs": {
         "name": "Count",
         "value": 100
      },
      "runAfter": {
         "Initialize_variable": [ "Succeeded" ]
      }
   }
},

追加到变量

对于存储字符串或数组的变量，可以插入或追加一个变量值，作为这些字符串或数组中的最后一个项。 可以按照递增变量步骤操作，但需要：

1. 根据变量是字符串还是数组，找到并选择以下操作之一：

   • 追加到字符串变量
   • 追加到数组变量

2. 提供要作为字符串或数组中的最后一项追加的值。 此值是必需的。

下表描述了“追加到...”操作的信息：

属性	需要	值	描述
客户	是	<variable-name>	要更改的变量的名称
值	是	<append-value>	要追加的值，可以是任何类型

如果从设计器切换到代码视图，以下示例演示“追加到数组变量”操作如何以 JSON 格式在工作流定义中显示。

以下示例创建一个数组变量，并将另一个值添加为数组中的最后一个项。 结果是包含此数组的已更新变量：[1,2,3,"red"]

"actions": {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [ {
            "name": "myArrayVariable",
            "type": "Array",
            "value": [1, 2, 3]
         } ]
      },
      "runAfter": {}
   },
   "Append_to_array_variable": {
      "type": "AppendToArrayVariable",
      "inputs": {
         "name": "myArrayVariable",
         "value": "red"
      },
      "runAfter": {
        "Initialize_variable": [ "Succeeded" ]
      }
   }
},

后续步骤

• 适用于 Azure 逻辑应用的托管连接器
• 适用于 Azure 逻辑应用的内置连接器