建立變數以在 Azure Logic Apps 中儲存和管理值

適用於：Azure Logic Apps (使用量 + 標準)

本操作指南示範如何建立和使用變數，以便您可以在邏輯應用程式工作流程中儲存和使用值。 例如，變數可協助您追蹤迴圈的執行次數。 逐一查看某個陣列或檢查陣列中是否有特定項目時，您可以使用變數來參考每個陣列項目的索引編號。

您可以為資料類型 (例如整數、浮點數、布林函數、字串、數列和物件) 建立變數。 建立變數之後，您可以執行其他工作，例如：

• 取得或參考變數值。
• 以常數值 (也稱為遞增量和遞減量) 來增大或減小變數。
• 指派不同的值給變數。
• 將變數值插入或附加做為字串或陣列中的最後一個項目。

變數只存在於建立它們的工作流程執行個體內，並且是全域性。 此外，它們只會在工作流程執行個體內跨任何迴圈反覆運算存留。 當您參考變數，請使用變數的名稱作為標記，而非動作的名稱，這是參考動作輸出的常用方法。

必要條件

• Azure 帳戶和訂用帳戶。 如果您沒有訂用帳戶，請註冊一個免費的 Azure 帳戶。

• 您想要在其中建立變數的邏輯應用程式工作流程，以及啟動工作流程的觸發程序。

  您必須從使用觸發程序作為工作流程的第一個步驟開始，才能新增建立和使用變數的動作。 如需詳細資訊，請參閱使用觸發程序或動作建立工作流程。

下列步驟使用 Azure 入口網站，但搭配適當的 Azure Logic Apps 擴充功能，您也可以使用下列工具來建置邏輯應用程式工作流程：

• 取用工作流程： 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" ]
      }
   }
},

增量變數

若要依特定常數值減少或遞減變數，請遵循遞增變數的步驟，不同之處在於您會改為將 [遞增變數] 動作新增至工作流程。 此動作僅適用於整數和浮點數變數。

下表描述遞減變數動作的資訊：

如果是從設計工具切換到程式碼檢視，下列範例會顯示 [遞減變數] 動作如何在工作流程定義中顯示，其為 JSON 格式：

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

設定變數

若要將不同的值指派給現有的變數，請遵循遞增變數的步驟，但有下列例外：

1. 找到並選擇設定變數動作。

2. 提供您要分配的變數名稱和數值。 新值和變數都必須具有相同的資料類型。 該值是必要的，因為此動作沒有預設值。

下表描述設定變數動作的資訊：

如果是從設計工具切換到程式碼檢視，下列範例會顯示 [設定變數] 動作如何在工作流程定義中顯示，其為 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. 提供數值追加字串或數列中的最後一個項目。 數值是必要項。

下表描述 [附加至...] 動作的資訊：

如果是從設計工具切換到程式碼檢視，下列範例會顯示 [附加至陣列變數] 動作如何在工作流程定義中顯示，其為 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 Logic Apps 的連接器
• 適用於 Azure Logic Apps 的內建連接器