共用方式為

快速入門：使用 Visual Studio Code 在多租戶 Azure Logic Apps 中建立整合工作流程

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

本快速入門說明如何在多租戶 Azure Logic Apps 中建立邏輯應用程式的工作流程，透過 Visual Studio Code 自動化任務並整合跨服務、系統、應用程式與資料的組織與企業流程。 你可以透過程式碼體驗建立並編輯底層的工作流程定義，這些定義使用 JavaScript 物件符號（JSON）來實現工作流程。 你也可以處理已經部署到 Azure 的現有邏輯應用程式工作流程。 欲了解更多關於多租戶與單租戶模型的資訊，請參閱 Azure Logic Apps 中的單租戶與多租戶。

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

本文中，你可以建立與此 快速入門相同的邏輯應用程式工作流程，重點放在基本概念上。 您也可以 瞭解如何透過 Azure CLI 建立和管理應用程式。 在 Visual Studio Code 中，邏輯應用程式的工作流程看起來像以下範例：

範例邏輯應用程式工作流程定義

必要條件

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

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

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

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

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

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

  • 如果你的邏輯應用程式工作流程需要透過受限於特定 IP 位址流量的防火牆進行通訊，該防火牆必須允許在 Azure 內，針對你的邏輯應用程式所在區域內，Azure Logic Apps 或執行時所使用的入口和出口 IP 位址的存取。 如果你的邏輯應用程式工作流程也使用受管理連接器，例如Office 365的Outlook連接器或SQL連接器，或使用自訂連接器，防火牆也必須允許存取邏輯應用程式Azure區域內所有管理連接器的外站IP位址。

從 Visual Studio Code 存取 Azure

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

    在 Visual Studio Code 工具列上選取 Azure 圖示

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

    選取 [登入 Azure]

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

      改用裝置代碼繼續

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

      複製 Azure 登入的程式代碼

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

      確認開啟瀏覽器並前往驗證網站

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

      輸入 Azure 登入的驗證碼

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

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

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

      尋找或篩選 Azure 訂用帳戶

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

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

    選取您的 Azure 訂用帳戶

    提示

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

建立新的邏輯應用程式

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

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

    從訂用帳戶功能表中，選取 [建立邏輯應用程式]

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

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

    建立新的 Azure 資源群組

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

    為您的 Azure 資源群組提供名稱

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

    選取 Azure 位置以儲存邏輯應用程式元數據

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

    提供邏輯應用程式的名稱

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

    空白邏輯應用程式工作流程定義 JSON 檔案

    例如，以下是範例邏輯應用程式工作流程定義，以 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": 30
         },
         "splitOn": "@triggerBody()?['value']",
         "type": "ApiConnection",
         "inputs": {
            "host": {
               "connection": {
                  "name": "@parameters('$connections')['rss']['connectionId']"
               }
            },
            "method": "get",
            "path": "/OnNewFeed",
            "queries": {
               "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
               "sinceProperty": "PublishDate"
            }
         }
      }
   },
   "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. 當系統提示你上傳 Logic App 工作流程定義到 Azure 訂閱時，選擇 「上傳」。

    此步驟會將您的邏輯應用程式工作流程定義發布到 Azure 入口網站，使工作流程在 Azure 中即時運作。

    將新的 Logic 應用程式工作流程定義上傳到你的 Azure 訂閱

在 Designer 中查看 Logic 應用程式的工作流程定義

在 Visual Studio Code 中，你可以以唯讀設計檢視開啟你的 Logic 應用程式工作流程定義。 雖然你無法在設計器中編輯 Logic App 的工作流程定義，但你可以透過設計器檢視來視覺化檢視 Logic App 的工作流程。

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

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

在唯讀設計器中查看 Logic 應用程式的工作流定義

在 Azure 入口網站中檢視

要在 Azure 入口網站中檢視你的 Logic 應用程式工作流程定義，請依照以下步驟操作：

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

  2. 在 Azure 入口網站的搜尋框中，輸入 Logic 應用程式的工作流程定義名稱。 從結果列表中選擇 Logic 應用程式。

    你於 Azure portal 中的新 Logic App 工作流程定義

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

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

重要

在你編輯正在執行的 Logic App 工作流程之前，先避免該 Logic App 被破壞的風險，並先停用 你的 Logic App 資源，盡量減少干擾。

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

  2. 在 Azure 視窗中，在 Logic Apps 裡面，展開你的 Azure 訂閱，然後選擇你想要的 Logic App 資源。

  3. 打開 Logic App 的右鍵選單，選擇 「在編輯器中開啟」。 或者，在邏輯應用程式的名稱旁，選取 [編輯] 圖示。

    開啟現有邏輯應用程式的編輯器

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

    檢視已發佈邏輯應用程式的工作流程定義

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

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

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

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

    將編輯上傳到 Azure 中的 Logic App 資源

檢視或推廣其他版本

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

重要

在你更改正在執行的 Logic App 工作流程之前，先避免破壞該 Logic App 工作流程的風險，並先 停用 Logic App 資源，盡量減少干擾。

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

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

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

    邏輯應用程式的先前版本

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

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

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

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

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

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

      推廣舊版

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

      確認推廣較早版本

      Visual Studio Code 將選取的版本升階為目前的版本，並將新的號碼指派給升階後的版本。 先前的現行版本如今會出現在提升版本的下方。

停用或啟用邏輯應用程式

在 Visual Studio Code 中，如果你編輯已發佈的邏輯應用程式工作流程並儲存變更，你會 覆寫 已經部署好的應用程式。 為了避免在生產環境中打斷 Logic App 的工作流程並減少中斷，請先停用你的 Logic App 資源。 之後，您可以在確認邏輯應用程式仍可運作後，再重新啟用邏輯應用程式。

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

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

  • 觸發器不會在下一次符合其條件時被觸發。

  • 觸發器狀態會記住邏輯應用程式暫停的位置。 因此，如果您重新啟用邏輯應用，則觸發機制會對自上次執行以來所有未處理的項目生效。

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

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

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

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

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

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

      停用邏輯應用程式

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

      啟用邏輯應用程式

刪除邏輯應用程式

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

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

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

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

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

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

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

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

    刪除邏輯應用程式

下一步

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

  • Last updated on