Azure Logic Apps のワークフローからオンプレミスのファイル システムに接続する

  • [アーティクル]

適用対象: Azure Logic Apps (従量課金 + Standard)

この攻略ガイドでは、ファイル システム コネクタを使用して、Azure Logic Apps のワークフローからオンプレミスのファイル共有にアクセスする方法を示します。 これにより、ファイル共有やその他システムでイベントによってトリガーされると実行される自動ワークフローを作成して、ファイルを管理するアクションを実行することができます。 このコネクタが提供する機能は次のとおりです。

  • ファイルを作成、取得、追加、更新、削除する。
  • フォルダーまたはルート フォルダー内のファイルをリストする。
  • ファイルの内容とメタデータを取得します。

このハウツー ガイドのシナリオ例では、次のタスクの実行方法を示します。

  • ファイルが作成またはファイル共有に追加されたときにワークフローをトリガーし、メールを送信する。
  • ファイルが Dropbox アカウントからファイル共有にコピーされるときにワークフローをトリガーし、メールを送信する。

制限事項と既知の問題

  • 現在、ファイル システム コネクタは、Windows オペレーティング システム上の Windows ファイル システムのみをサポートしています。
  • マップされたネットワークはサポートされていません。

コネクタに関するテクニカル リファレンス

ファイル システム コネクタには、ロジック アプリの種類とホスト環境に基づいてさまざまなバージョンがあります。

ロジック アプリ 環境 コネクタのバージョン
従量課金プラン マルチテナント Azure Logic Apps デザイナーの [Standard] ラベルの下に表示される、マネージド コネクタ。 詳細については、次のドキュメントを確認してください。

- ファイル システム マネージド コネクタのリファレンス
- Azure Logic Apps のマネージド コネクタ
従量課金プラン 統合サービス環境 (ISE) デザイナーの [Standard] ラベルの下に表示されるマネージド コネクタと、Standard クラスとは異なるメッセージ制限がある ISE バージョン。 詳細については、次のドキュメントを確認してください。

- ファイル システム マネージド コネクタのリファレンス
- ISE メッセージの制限
- Azure Logic Apps のマネージド コネクタ
Standard シングルテナント Azure Logic Apps と App Service Environment v3 (Windows プランのみ) マネージド コネクタはコネクタ ギャラリーの [ランタイム]>[共有] に表示されます。組み込みコネクタはコネクタ ギャラリーの [ランタイム]>[アプリ内] に表示され、 サービス プロバイダーベースです。 組み込みコネクタには次のような違いがあります。

- 組み込みコネクタでは、Windows プランのみの App Service Environment v3 で実行される Standard ロジック アプリのみがサポートされます。

- 組み込みコネクタでは、オンプレミス データ ゲートウェイなしで接続文字列を使用してファイル共有に直接接続し、Azure 仮想ネットワークにアクセスできます。

詳細については、次のドキュメントを確認してください。

- ファイル システム マネージド コネクタのリファレンス
- ファイル システムの組み込みコネクタ リファレンス
- Azure Logic Apps の組み込みコネクタ

前提条件

  • Azure アカウントとサブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。

  • ファイル共有に接続するには、お使いのロジック アプリとホスティング環境に基づいてさまざまな要件が適用されます。

    • 従量課金プラン ロジック アプリ ワークフロー

    • Standard ロジック アプリ ワークフロー

      ファイル システムの組み込みコネクタまたはマネージド コネクタを使用できます。

      • ファイル システム マネージド コネクタを使用するには、マルチテナントの Azure Logic Apps での従量課金ロジック アプリ ワークフローと同じ要件に従います。

      • ファイル システムの組み込みコネクタを使用するには、Standard ロジック アプリ ワークフローを App Service Environment v3 で実行する必要がありますが、データ ゲートウェイ リソースは必要ありません。

  • 使用するファイル システムが存在するコンピューターへのアクセス権。 たとえば、ご使用のファイル システムと同じコンピューターにデータ ゲートウェイをインストールする場合は、そのコンピューター用のアカウントの資格情報が必要です。

  • 今回の攻略ガイドでシナリオ例に従うには、Office 365 Outlook、Outlook.com、Gmail など、Azure Logic Apps がサポートしているプロバイダーのメール アカウントが必要です。 他のプロバイダーについては、 サポートされている他の電子メール コネクタを確認してください。 この例では、職場または学校アカウントで Office 365 Outlook コネクタを使用します。 別のメール アカウントをお使いの場合でも、全体的な手順は同じですが、UI がやや異なる場合があります。

    重要

    Gmail コネクタの使用を希望する場合、ロジック アプリで制限なしにこのコネクタを使用できるのは、G-Suite ビジネス アカウントだけです。 Gmail コンシューマー アカウントを持っている場合は、Google によって承認された特定のサービスのみでこのコネクタを使用できるほか、認証に使用する Google クライアント アプリを Gmail コネクタで作成することができます。 詳細については、「Azure Logic Apps での Google コネクタのデータ セキュリティとプライバシー ポリシー」を参照してください。

  • ファイル システム アクション シナリオの例では、Dropboxアカウントが必要です。これには、無料でサインアップできます。

  • ファイル共有にアクセスするロジック アプリ ワークフロー。 ファイル システム トリガー操作でワークフローを開始する場合は、空のワークフローから開始する必要があります。 ファイル システム アクションを追加するには、任意のトリガーでワークフローを開始します。

ファイル システム トリガーを追加する

  1. Azure portal で、空のロジック アプリ ワークフローをデザイナーで開きます。

  2. デザイナーで、次の一般的な手順に従って、ワークフローに必要なファイル システム トリガーを追加します。

    詳細については、「ファイル システム トリガー」を参照してください。 この例では、[ファイルが作成されたとき] というトリガーを使用して、進めていきます。

  3. 接続情報ボックスに、必要に応じて以下の情報を指定します。

    プロパティ 必要 値 説明
    接続名 はい <connection-name> 接続のために使用する名前
    ルート フォルダー はい <root-folder-name> お使いのファイル システムのルート フォルダー。通常はメインの親フォルダーであり、ファイルで動作するすべてのトリガーの相対パスに使用されるフォルダーです。

    たとえば、オンプレミスのデータ ゲートウェイをインストールした場合は、データ ゲートウェイのインストールにコンピューター上のローカル フォルダーを使用します。 または、コンピューターがそのフォルダーにアクセスできるネットワーク共有のフォルダーを使用します。たとえば、\\PublicShare\\MyFileSystem となります。
    認証の種類 いいえ <auth-type> ファイル システム サーバーで使用される認証の種類。ここは、Windows とします
    ユーザー名 はい <domain-and-username> ファイル システムが存在するコンピューターのドメインとユーザー名。

    マネージド ファイル システム コネクタの場合は、バックスラッシュ (\) を付けて、次のいずれかの値を使用します。

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

    たとえば、ファイル システム フォルダーがオンプレミス データ ゲートウェイのインストールと同じコンピューター上にある場合は、<local-computer>\<username>を使用できます。

    - ISE ベースのファイル システム コネクタの場合は、バックスラッシュではなく、スラッシュ (/) を使用します。

    - <domain>/<username>
    - <local-computer>/<username>
    パスワード はい <password> ファイル システムが存在するコンピューターでのパスワード
    gateway いいえ - <Azure-subscription>
    - <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 portal で、ロジック アプリ ワークフローをデザイナーで開きます。

  2. デザイナーで、次の一般的な手順に従って、ワークフローに必要なファイル システム アクションを追加します。

    詳細については、「ファイル システム トリガー」を参照してください。 この例では、[ファイルの作成] というアクションを使用して、進めていきます。

  3. 接続情報ボックスに、必要に応じて以下の情報を指定します。

    プロパティ 必要 値 説明
    接続名 はい <connection-name> 接続のために使用する名前
    ルート フォルダー はい <root-folder-name> お使いのファイル システムのルート フォルダー。通常はメインの親フォルダーであり、ファイルで動作するすべてのトリガーの相対パスに使用されるフォルダーです。

    たとえば、オンプレミスのデータ ゲートウェイをインストールした場合は、データ ゲートウェイのインストールにコンピューター上のローカル フォルダーを使用します。 または、コンピューターがそのフォルダーにアクセスできるネットワーク共有のフォルダーを使用します。たとえば、\\PublicShare\\MyFileSystem となります。
    認証の種類 いいえ <auth-type> ファイル システム サーバーで使用される認証の種類。ここは、Windows とします
    ユーザー名 はい <domain-and-username> ファイル システムが存在するコンピューターのドメインとユーザー名。

    マネージド ファイル システム コネクタの場合は、バックスラッシュ (\) を付けて、次のいずれかの値を使用します。

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

    たとえば、ファイル システム フォルダーがオンプレミス データ ゲートウェイのインストールと同じコンピューター上にある場合は、<local-computer>\<username>を使用できます。

    - ISE ベースのファイル システム コネクタの場合は、バックスラッシュではなく、スラッシュ (/) を使用します。

    - <domain>/<username>
    - <local-computer>/<username>
    パスワード はい <password> ファイル システムが存在するコンピューターでのパスワード
    gateway いいえ - <Azure-subscription>
    - <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 にアップロードされたファイルに基づいて、ファイル システム サーバーにファイルを作成し、作成されたファイルに関する電子メールを送信します。

次のステップ