快速入門：使用多租用戶 Azure Logic Apps 和 Visual Studio Code 來建立和管理邏輯應用程式工作流程定義

  • 發行項

適用於：Azure Logic Apps (使用量)

本快速入門顯示如何建立和管理邏輯應用程式工作流程，使用多租用戶 Azure Logic Apps 和 Visual Studio Code 來協助您在組織和企業中自動化整合應用程式、資料、系統和服務的工作和流程。 您可以透過以程式碼為基礎的體驗，為邏輯應用程式建立和編輯使用 JavaScript 物件標記法 (JSON) 的基礎工作流程定義。 您也可以使用已部署至 Azure 的現有邏輯應用程式。 如需更多關於多租用戶與單一租用戶模型比較的資訊，請檢視單一租用戶與多租用戶比較和整合服務環境。

雖然您可以在 Azure 入口網站與 Visual Studio 中執行這些相同的工作，但當您已經熟悉邏輯應用程式定義且想要直接用於程式碼時，在 Visual Studio Code 中可更快開始使用。 例如，您可以停用、啟用、刪除及重新整理已建立的邏輯應用程式。 此外，您也可以從 Visual Studio Code 執行所在的任何開發平台 (例如 Linux、Windows、和 Mac) 來處理邏輯應用程式和整合帳戶。

針對本文，您可以從這個快速入門建立相同的邏輯應用程式；該快速入門較著重於基本概念。 您也可以學習在 Visual Studio 中建立範例應用程式，並學習如何透過 Azure CLI 建立和管理應用程式。 在 Visual Studio Code 中，邏輯應用程式看起來會像以下範例：

Example logic app workflow definition

必要條件

開始之前，請確定您具有下列項目：

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

  • 邏輯應用程式工作流程定義與其結構 (以 JSON 描述) 的基本知識

    如果您不熟悉 Azure Logic Apps，可以嘗試使用此快速入門，在 Azure 入口網站中建立您的第一個邏輯應用程式工作流程，並專注於基本概念。

  • 可存取網路以登入 Azure 與您的 Azure 訂用帳戶

  • 如果您還沒有以下這些工具，請加以下載並安裝：

  • 如果您的邏輯應用程式需要通過限制特定 IP 位址流量的防火牆，該防火牆必須允許存取輸入和輸出 Azure Logic Apps 所使用的 IP 位址，或是您的邏輯應用程式所在 Azure 區域的執行區段。 如果您的邏輯應用程式也使用受控連接器 (例如 Office 365 Outlook 連接器或 SQL 連接器)，或是使用自訂連接器，則防火牆也需要允許存取您邏輯應用程式的 Azure 區域中所有受控連接器輸出 IP 位址。

從 Visual Studio Code 存取 Azure

  1. 打開 Visual Studio Code。 在 Visual Studio Code 工具列上，選取 Azure 圖示。

    Select Azure icon on Visual Studio Code toolbar

  2. 在 Azure 視窗的 [Logic Apps] 下，選取 [登入 Azure]。 當 Microsoft 登入頁面提示您時，請使用您的 Azure 帳戶登入。

    Select

    1. 如果登入所花費的時間比平時長，Visual Studio Code 會提供裝置程式碼，以提示您透過 Microsoft 驗證網站登入。 若要改為使用程式碼登入，請選取 [使用裝置程式碼]。

      Continue with device code instead

    2. 若要複製程式碼，請選取 [複製並開啟]。

      Copy code for Azure sign in

    3. 若要開啟新的瀏覽器視窗並繼續前往驗證網站，請選取 [開啟連結]。

      Confirm opening a browser and going to authentication website

    4. 在 [登入您的帳戶] 頁面上輸入您的驗證碼，然後選取 [下一步]。

      Enter authentication code for Azure sign in

  3. 選取您的 Azure 帳戶。 登入之後，您可以關閉瀏覽器，然後返回 Visual Studio Code。

    在 [Azure] 窗格中，[Logic Apps] 和 [整合帳戶] 區段現在會顯示與您的帳戶相關聯的 Azure 訂用帳戶。 不過，若未看到您預期的訂用帳戶，或區段顯示過多訂用帳戶，請執行下列步驟：

    1. 將指標移至 Logic Apps 標籤上方。 在工具列出現時，選取 [選取訂用帳戶] (篩選圖示)。

      Find or filter Azure subscriptions

    2. 從顯示的清單中，選取您要顯示的訂用帳戶。

  4. 在 [Logic Apps] 底下，選取您要的訂用帳戶。 訂用帳戶節點會展開，並顯示任何存在於該訂用帳戶中的邏輯應用程式。

    Select your Azure subscription

    提示

    在 [整合帳戶] 底下選取您的訂用帳戶後，會顯示任何存在於該訂用帳戶中的整合帳戶。

建立新的邏輯應用程式

  1. 如果您未從 Visual Studio Code 中登入 Azure 帳戶和訂用帳戶，請依照先前的步驟立即登入。

  2. 在 Visual Studio Code 中的 Logic Apps 底下，開啟訂用帳戶的捷徑功能表，然後選取 [建立邏輯應用程式]。

    From subscription menu, select

    此時會出現一份清單，顯示您訂用帳戶中的任何 Azure 資源群組。

  3. 在資源群組清單中，選取 [建立新的資源群組] 或現有的資源群組。 在此範例中，請建立新的資源群組。

    Create a new Azure resource group

  4. 提供您的 Azure 資源群組名稱，然後按 ENTER 鍵。

    Provide name for your Azure resource group

  5. 選取要儲存邏輯應用程式中繼資料的 Azure 區域。

    Select Azure location for saving logic app metadata

  6. 為您的邏輯應用程式提供名稱，然後按 Enter 鍵。

    Provide name for your logic app

    在您位於 Azure 視窗中的 Azure 訂用帳戶底下，會出現新的和空白的邏輯應用程式。 Visual Studio Code 也會開啟 JSON (.logicapp.json) 檔案，其中包含邏輯應用程式的基本架構工作流程定義。 現在，您可以開始在此 JSON 檔案中手動撰寫邏輯應用程式的工作流程定義。 如需與工作流程定義的結構和語法有關的技術參考，請參閱 Azure Logic Apps 的工作流程定義語言結構描述。

    Empty logic app workflow definition JSON file

    例如，以下是範例邏輯應用程式工作流程定義，以 RSS 觸發程序和 Office 365 Outlook 動作為開頭。 通常 JSON 元素會在每個區段中依字母順序顯示。 不過，此範例大致上會以邏輯應用程式步驟出現在設計工具中的順序來顯示這些元素。

    重要

    如果您想要重複使用此範例邏輯應用程式定義，您必須要有組織帳戶，例如 @fabrikam.com。 請務必將虛構的電子郵件地址取代為您自己的電子郵件地址。 若要使用不同的電子郵件連接器 (例如 Outlook.com 或 Gmail)，請將 Send_an_email_action 動作取代為 Azure Logic Apps 支援的電子郵件連接器所提供的類似動作。

    如果您想要使用 Gmail 連接器，只有 G-Suite 商務帳戶可以在邏輯應用程式中使用此連接器，而不受限制。 如果您有 Gmail 取用者帳戶，您只能使用此連接器搭配特定的 Google 核准服務，或者您可以建立 Google 用戶端應用程式，以用來向 Gmail 連接器進行驗證。 如需詳細資訊，請參閱 Azure Logic Apps 中 Google 連接器的資料安全性和隱私權原則。

    {
   "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {
      "$connections": {
         "defaultValue": {},
         "type": "Object"
      }
   },
   "triggers": {
      "When_a_feed_item_is_published": {
         "recurrence": {
            "frequency": "Minute",
            "interval": 1
         },
         "splitOn": "@triggerBody()?['value']",
         "type": "ApiConnection",
         "inputs": {
            "host": {
               "connection": {
                  "name": "@parameters('$connections')['rss']['connectionId']"
               }
            },
            "method": "get",
            "path": "/OnNewFeed",
            "queries": {
               "feedUrl": "http://feeds.reuters.com/reuters/topNews"
            }
         }
      }
   },
   "actions": {
      "Send_an_email_(V2)": {
         "runAfter": {},
         "type": "ApiConnection",
         "inputs": {
            "body": {
               "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
               "Subject": "RSS item: @{triggerBody()?['title']}",
               "To": "sophia-owen@fabrikam.com"
            },
            "host": {
               "connection": {
                  "name": "@parameters('$connections')['office365']['connectionId']"
               }
            },
            "method": "post",
            "path": "/v2/Mail"
         }
      }
   },
   "outputs": {}
}

  7. 完成後，請儲存邏輯應用程式的工作流程定義。 (檔案功能表 > 儲存，或按下 Ctrl+S 鍵)

  8. 當系統提示您將邏輯應用程式上傳至您的 Azure 訂用帳戶時，請選取 [上傳]。

    此步驟會將您的邏輯應用程式發佈至 Azure 入口網站，並讓您的邏輯在 Azure 中上線並執行。

    Upload new logic app to your Azure subscription

在設計工具中檢視邏輯應用程式

在 Visual Studio Code 中，您可以在唯讀設計檢視中開啟邏輯應用程式。 雖然您無法在設計工具中編輯邏輯應用程式，但您可以使用設計工具檢視，以視覺化方式查看邏輯應用程式的工作流程。

在 Azure 視窗的 [Logic Apps] 底下，開啟邏輯應用程式的捷徑功能表，然後選取 [在設計工具中開啟]。

唯讀設計工具會在另一個視窗中開啟，並顯示邏輯應用程式的工作流程，例如：

View logic app in read-only designer

在 Azure 入口網站中檢視

若要在 Azure 入口網站中檢閱您的邏輯應用程式，請執行下列步驟：

  1. 使用與邏輯應用程式相關聯的相同 Azure 帳戶和訂用帳戶，登入 Azure 入口網站。

  2. 在 Azure 入口網站的搜尋方塊中，輸入您的邏輯應用程式名稱。 從結果清單中，選取您的邏輯應用程式。

    Your new logic app in Azure portal

編輯已部署的邏輯應用程式

在 Visual Studio Code 中，您可以開啟並編輯已在 Azure 中部署的邏輯應用程式的工作流程定義。

重要

在生產環境中編輯正在執行的邏輯應用程式之前，請先停用邏輯應用程式，以降低中斷該邏輯應用程式的風險，並盡可能避免運作中斷。

  1. 如果您未從 Visual Studio Code 中登入 Azure 帳戶和訂用帳戶，請依照先前的步驟立即登入。

  2. 在 Azure 視窗的 [Logic Apps] 下，展開 Azure 訂用帳戶，並選取您要的邏輯應用程式。

  3. 開啟您的邏輯應用程式功能表，然後選取 [在編輯器中開啟]。 或者，在邏輯應用程式的名稱旁，選取 [編輯] 圖示。

    Open editor for existing logic app

    Visual Studio Code 會在您的本機暫存資料夾中開啟 .logicapp.json 檔案，讓您可以檢視邏輯應用程式的工作流程定義。

    View workflow definition for published logic app

  4. 在邏輯應用程式的工作流程定義中進行變更。

  5. 完成後，儲存變更。 (檔案功能表 > 儲存，或按下 Ctrl+S 鍵)

  6. 當系統提示您上傳變更並覆寫 Azure 入口網站中現有的邏輯應用程式時，請選取 [上傳]。

    此步驟會將您的更新發佈至 Azure 入口網站中的邏輯應用程式。

    Upload edits to logic app definition in Azure

檢視或升階其他版本

在 Visual Studio Code 中，您可以開啟並檢閱邏輯應用程式的較舊版本。 您也可以將舊版升階為目前的版本。

重要

在生產環境中變更正在執行的邏輯應用程式之前，請先停用邏輯應用程式，以降低中斷該邏輯應用程式的風險，並盡可能避免運作中斷。

  1. 在 Azure 視窗中的 [Logic Apps] 底下，展開您的 Azure 訂用帳戶，以便檢視該訂用帳戶中的所有邏輯應用程式。

  2. 在您的訂用帳戶底下展開邏輯應用程式，然後展開 [版本]。

    [版本] 清單會顯示您較早版本的邏輯應用程式 (如果有的話)。

    Your logic app's previous versions

  3. 若要檢視較早的版本，請選取下列其中一個步驟：

    • 若要檢視 JSON 定義，請在 [版本] 底下選取該定義的版本號碼。 或者，開啟該版本的捷徑功能表，然後選取 [在編輯器中開啟]。

      新檔案會在您的本機電腦上開啟，並顯示該版本的 JSON 定義。

    • 若要在唯讀設計工具中檢視版本，請開啟該版本的捷徑功能表，然後選取 [在設計工具中開啟]。

  4. 若要將較早的版本升階為目前的版本，請執行下列步驟：

    1. 在 [版本] 底下開啟較早版本的捷徑功能表，然後選取 [升階]。

      Promote earlier version

    2. 若要在 Visual Studio Code 提示您進行確認後繼續操作，請選取 [是]。

      Confirm promoting earlier version

      Visual Studio Code 將選取的版本升階為目前的版本，並將新的號碼指派給升階後的版本。 先前的目前版本此時會出現在升階後的版本底下。

停用或啟用邏輯應用程式

在 Visual Studio Code 中，如果您編輯已發佈的邏輯應用程式並儲存變更，則會覆寫您已部署的應用程式。 若要避免在生產環境中斷邏輯應用程式，並盡可能避免運作中斷，請先停用邏輯應用程式。 之後，您可以在確認邏輯應用程式仍可運作後，再重新啟用邏輯應用程式。

  • Azure Logic Apps會繼續所有進行中和擱置的執行，直到完成為止。 根據其數量或待處理項目，此程序可能需要一些時間才能完成。

  • Azure Logic Apps 不會建立或執行新的工作流程執行個體。

  • 觸發程序不會在下一次符合其條件時引發。

  • 不過，觸發程序狀態會記住邏輯應用程式的停止點。 因此，如果您重新啟用邏輯應用程式，則觸發程序會在上次執行後針對所有未處理的項目引發。

    若要停止觸發程序在上次執行後未處理的項目上觸發，請先清除觸發程序的狀態，再重新啟用邏輯應用程式：

    1. 在邏輯應用程式中，編輯工作流程觸發程序的任何部分。
    2. 儲存您的變更。 此步驟會重設觸發程序的目前狀態。
    3. 重新啟用邏輯應用程式。

  • 停用工作流程時，您仍可重新提交執行。

  1. 如果您未從 Visual Studio Code 中登入 Azure 帳戶和訂用帳戶，請依照先前的步驟立即登入。

  2. 在 Azure 視窗中的 [Logic Apps] 底下，展開您的 Azure 訂用帳戶，以便檢視該訂用帳戶中的所有邏輯應用程式。

    1. 若要停用邏輯應用程式，請開啟該邏輯應用程式功能表，然後選取 [停用]。

      Disable your logic app

    2. 當您準備好要重新啟用邏輯應用程式時，請開啟邏輯應用程式的功能表，然後選取 [啟用]。

      Enable your logic app

刪除邏輯應用程式

刪除邏輯應用程式會以下列方式影響工作流程執行個體：

  • Azure Logic Apps 會盡力取消任何進行中和擱置的執行。

    即使數量較大或存在待處理項目，大部分執行都會在完成或開始之前取消。 不過，取消程序可能需要一些時間才能完成。 同時，服務透過取消程序運作時，可能會挑選某些執行程序來執行。

  • Azure Logic Apps 不會建立或執行新的工作流程執行個體。

  • 如果您刪除某個工作流程，然後重新建立相同的工作流程，重新建立的工作流程不會擁有與刪除的工作流程相同的中繼資料。 您必須重新儲存任何呼叫已刪除工作流程的工作流程。 如此一來，呼叫者就能獲得重新建立的工作流程的正確資訊。 否則，對重新建立的工作流程的呼叫會因為 Unauthorized 錯誤而失敗。 此行為也適用於在企業整合帳戶中使用成品的工作流程，以及呼叫 Azure 函數的工作流程。

  1. 如果您未從 Visual Studio Code 中登入 Azure 帳戶和訂用帳戶，請依照先前的步驟立即登入。

  2. 在 Azure 視窗中的 [Logic Apps] 底下，展開您的 Azure 訂用帳戶，以便檢視該訂用帳戶中的所有邏輯應用程式。

  3. 找出您要刪除的邏輯應用程式，開啟邏輯應用程式功能表，然後選取 [刪除]。

    Delete your logic app

下一步

在 Visual Studio Code 中建立單一租用戶型的邏輯應用程式工作流