從 Azure Logic Apps 中的工作流程連線到內部部署檔案系統

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

本操作指南說明如何使用檔案系統連接器,從 Azure Logic Apps 中的工作流程存取內部部署檔案共用。 接著,您可以建立自動化工作流程,以在檔案共用或其他系統中的事件觸發時執行,並執行動作來管理檔案。 連接器提供以下功能:

  • 建立、取得、附加更新及刪除檔案。
  • 列出資料夾或根資料夾中的檔案。
  • 取得檔案內容與中繼資料。

在此操作指南中,範例案例會示範下列工作:

  • 在檔案建立或新增至檔案共用時觸發工作流程,然後傳送電子郵件。
  • 將檔案從 Dropbox 帳戶複製到檔案共用時觸發工作流程,然後傳送電子郵件。

限制和已知問題

  • 檔案系統連接器目前僅支援 Windows 作業系統上的 Windows 檔案系統。
  • 不支援使用對應的網路磁碟機。

連接器技術參考

根據邏輯應用程式類型和主機環境,檔案系統連接器會有不同的版本。

邏輯應用程式 Environment 連接器版本
耗用 多租使用者 Azure Logic Apps 受管理連接器,顯示在設計工具的 Standard 標籤下。 如需詳細資訊,請參閱下列文件:

- 檔案系統受控連接器參考
- Azure Logic Apps 的受控連接器
耗用 整合服務環境 (ISE) 受控連接器,會顯示在 [標準] 標籤下的設計工具中,而 ISE 版本的訊息限制會與 [標準] 類別不同。 如需詳細資訊,請參閱下列文件:

- 檔案系統受控連接器參考
- ISE 訊息限制
- Azure Logic Apps 中的受控連接器
標準 單一租用戶 Azure Logic Apps 和 App Service 環境 v3 (僅限 Windows 方案) 受控連接器 (顯示於連接器資源庫的 [執行階段]>[共用] 下) 和內建連接器 (顯示於連接器資源庫的 [執行階段]>[應用程式內] 下,並且以服務提供者為基礎)。 內建連接器在以下幾方面有所不同:

- 內建連接器僅支援在採用 Windows 方案的 App Service 環境 v3 中執行的標準邏輯應用程式。

- 內建版本可以使用不含內部部署資料閘道的連接字串,直接連線至檔案共用並存取 Azure 虛擬網路。

如需詳細資訊,請參閱下列文件:

- 檔案系統受控連接器參考
- 檔案系統內建連接器參考
- Azure Logic Apps 中的內建連接器

必要條件

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

  • 若要連線至檔案共用,需要根據您的邏輯應用程式和裝載環境,套用不同的需求:

    • 使用量邏輯應用程式工作流程

      • 在多租用戶 Azure Logic Apps 中,您需要符合下列需求:

        1. 在本機電腦上安裝內部部署資料閘道

          檔案系統受控連接器必需安裝的閘道和檔案系統伺服器,必須存在於相同的 Windows 網域中。

        2. 在 Azure 中建立內部部署資料閘道資源

        3. 將檔案系統受控連接器觸發程序或動作新增至工作流程之後,請選取您先前建立的資料閘道資源,以便連線至檔案系統。

      • 在 ISE 中,您不需要內部部署資料閘道。 相反地,您可以使用 ISE 版本的檔案系統連接器。

    • 標準邏輯應用程式工作流程

      您可使用檔案系統內建連接器或受控連接器。

      • 若要使用檔案系統受控連接器,請遵循與多租用戶 Azure Logic Apps 中使用量邏輯應用程式工作流程相同的需求。

      • 若要使用檔案系統內建連接器,您的標準邏輯應用程式工作流程必須在 App Service 環境 v3 中執行,但不需要資料閘道資源。

  • 您想要使用的檔案系統所在電腦的存取權。 例如,如果您在與檔案系統相同的電腦上安裝資料閘道,則需要該電腦的帳戶認證。

  • 若要遵循此操作指南中的範例案例,您需要一個來自受 Azure Logic Apps 支援之提供者的電子郵件帳戶,例如 Office 365 Outlook、Outlook.com 或 Gmail。 針對其他提供者,請檢閱其他支援的電子郵件連接器。 此範例使用具有公司或學校帳戶的 Office 365 Outlook 連接器。 如果您使用另一個電子郵件帳戶,則整體步驟相同,但您的 UI 可能稍有不同。

    重要

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

  • 如需檔案系統動作案例範例,您需要 Dropbox 帳戶 (英文),可以免費註冊。

  • 您要在其中存取檔案共用的邏輯應用程式工作流程。 若要使用檔案系統觸發程序啟動工作流程,必須從空白工作流程開始。 若要新增檔案系統動作,請使用任何觸發程序啟動工作流程。

新增檔案系統觸發程序

  1. Azure 入口網站上,於設計工具中開啟您的空白邏輯應用程式工作流程。

  2. 在設計工具中,依照這些一般步驟將您想要的檔案系統觸發程序新增至工作流程

    如需詳細資訊,請參閱檔案系統觸發程序。 此範例會繼續執行名為檔案已建立時的觸發程序。

  3. 在 [連線資訊] 方塊中,視需要提供下列資訊:

    屬性 必填 Description
    連線名稱 Yes <connection-name> 用於連線的名稱
    根資料夾 Yes <root-folder-name> 檔案系統的根資料夾通常是主要父資料夾,而且是用於檔案上所有觸發程序之相對路徑的資料夾。

    例如,如果您已安裝內部部署資料閘道,請使用具有資料閘道安裝之電腦上的本機資料夾。 或者,使用電腦可以存取該資料夾的網路共用資料夾,例如 \\PublicShare\\MyFileSystem
    驗證類型 No <auth-type> 您檔案系統伺服器所使用的驗證類型:Windows
    使用者名稱 Yes <domain-and-username> 您的檔案系統資料夾所在電腦的網域和使用者名稱。

    針對受控檔案系統連接器,請搭配反斜線使用下列其中一個值 (\):

    - <domain>\<username>
    - <local-computer>\<username>

    例如,如果您的檔案系統資料夾與內部部署資料閘道安裝位於相同的電腦上,則您可以使用 <local-computer><\username>

    - 針對 ISE 型檔案系統連接器,請改用斜線 (/):

    - <domain>/<username>
    - <local-computer>/<username>
    密碼 Yes <password> 您的檔案系統所在電腦的密碼
    閘道 No - <Azure 訂閱>
    - <gateway-resource-name>
    本節僅適用於受控檔案系統連接器:

    - 訂用帳戶:與資料閘道資源相關聯的 Azure 訂用帳戶
    - 連線閘道:資料閘道資源

    下列範例顯示檔案系統受控連接器觸發程序的連線資訊:

    Screenshot showing Consumption workflow designer and connection information for File System managed connector trigger.

    下列範例顯示檔案系統 ISE 型觸發程序的連線資訊:

    Screenshot showing Consumption workflow designer and connection information for File System ISE-based connector trigger.

  4. 完成時,選取建立

    Azure Logic Apps 會設定並測試連線,以確定連線運作正常。 如果連線已正確設定,則選取的觸發程序會出現安裝選項。

  5. 繼續建置您的工作流程。

    1. 為您的觸發程序提供必要的資訊。

      在此範例中,選取檔案系統伺服器上的資料夾路徑,以檢查新建立的檔案。 指定要傳回的檔案數目,以及您想要檢查的頻率。

      Screenshot showing Consumption workflow designer and the trigger named When a file is created.

    2. 若要測試工作流程,請新增 Outlook 動作,以讓系統在指定的資料夾中,有檔案建立於檔案系統時,傳送電子郵件給您。 輸入電子郵件收件者、主旨和本文。 為了進行測試,您可以使用自己的電子郵件地址。

      Screenshot showing Consumption workflow designer, managed connector trigger named When a file is created, and action named Send an email.

      提示

      若要在工作流程中新增先前步驟的輸出,請選取觸發程序的編輯方塊。 當動態內容清單出現時,請從可用的輸出中選取。

  6. 完成後,請儲存您的工作流程。

  7. 若要測試您的工作流程,請上傳檔案,以觸發工作流程。

如果成功,您的工作流程會傳送有關新檔案的電子郵件。

新增檔案系統動作

範例邏輯應用程式工作流程會從 Dropbox 觸發程序開始,但您可以使用任何您想要的觸發程序。

  1. Azure 入口網站中,在設計工具中開啟您的邏輯應用程式工作流程。

  2. 在設計工具中,依照這些一般步驟將您想要的檔案系統動作新增至工作流程

    如需詳細資訊,請參閱檔案系統觸發程序。 此範例會繼續執行名為建立檔案的動作。

  3. 在 [連線資訊] 方塊中,視需要提供下列資訊:

    屬性 必填 Description
    連線名稱 Yes <connection-name> 用於連線的名稱
    根資料夾 Yes <root-folder-name> 檔案系統的根資料夾通常是主要父資料夾,而且是用於檔案上所有觸發程序之相對路徑的資料夾。

    例如,如果您已安裝內部部署資料閘道,請使用具有資料閘道安裝之電腦上的本機資料夾。 或者,使用電腦可以存取該資料夾的網路共用資料夾,例如 \\PublicShare\\MyFileSystem
    驗證類型 No <auth-type> 您檔案系統伺服器所使用的驗證類型:Windows
    使用者名稱 Yes <domain-and-username> 您的檔案系統資料夾所在電腦的網域和使用者名稱。

    針對受控檔案系統連接器,請搭配反斜線使用下列其中一個值 (\):

    - <domain>\<username>
    - <local-computer>\<username>

    例如,如果您的檔案系統資料夾與內部部署資料閘道安裝位於相同的電腦上,則您可以使用 <local-computer><\username>

    - 針對 ISE 型檔案系統連接器,請改用斜線 (/):

    - <domain>/<username>
    - <local-computer>/<username>
    密碼 Yes <password> 您的檔案系統所在電腦的密碼
    閘道 No - <Azure 訂閱>
    - <gateway-resource-name>
    本節僅適用於受控檔案系統連接器:

    - 訂用帳戶:與資料閘道資源相關聯的 Azure 訂用帳戶
    - 連線閘道:資料閘道資源

    下列範例顯示檔案系統受控連接器動作的連線資訊:

    Screenshot showing connection information for File System managed connector action.

    下列範例顯示檔案系統 ISE 型連接器動作的連線資訊:

    Screenshot showing connection information for File System ISE-based connector action.

  4. 完成時,選取建立

    Azure Logic Apps 會設定並測試連線,以確定連線運作正常。 如果連線已正確設定,則選取的動作會出現安裝選項。

  5. 繼續建置您的工作流程。

    1. 為您的動作提供必要的資訊。

      在此範例中,請選取檔案系統伺服器上要使用的資料夾路徑,為此處的根資料夾。 根據上傳至 Dropbox 的檔案,輸入檔案名稱和內容。

      Screenshot showing Consumption workflow designer and the File System managed connector action named Create file.

      提示

      若要在工作流程中新增先前步驟的輸出,請選取動作的編輯方塊內部。 當動態內容清單出現時,請從可用的輸出中選取。

    2. 若要測試工作流程,請新增 Outlook 動作,以在檔案系統動作建立檔案時,傳送電子郵件給您。 輸入電子郵件收件者、主旨和本文。 為了進行測試,您可以使用自己的電子郵件地址。

      Screenshot showing Consumption workflow designer, managed connector

  6. 完成後,請儲存您的工作流程。

  7. 若要測試您的工作流程,請上傳檔案,以觸發工作流程。

如果成功,您的工作流程會根據 DropBox 中上傳的檔案,在檔案系統伺服器上建立檔案,並傳送關於建立檔案的電子郵件。

下一步