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

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

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

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

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

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

制限事項と既知の問題

  • 現在、ファイル システム コネクタは、Windows オペレーティング システム上の Windows ファイル システムのみをサポートしています。
  • マップされたネットワーク ドライブはサポートされていません。
  • 内蔵コネクタの場合、ルートフォルダーはトップレベルのファイル共有でなければなりません。 コネクターはネストされたルートフォルダパスをサポートしていません。 代わりに、コネクタ操作で相対パスを使ってサブフォルダを指定します。
  • 標準ロジックアプリは最大20の組み込みファイルシステム接続をサポートします。
  • コネクタは同じルートフォルダを異なる認証情報で使う複数の組み込み接続をサポートしていません。

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

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

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

- ファイル システム マネージド コネクタのリファレンス
- Azure Logic Apps のマネージド コネクタ
標準 Workflow Service Plan または App Service Environment v3（Windows プランのみ）における単一テナント Azure Logic Apps マネージド コネクタ。コネクタ ギャラリーの [ 共有] の下に表示され、組み込みコネクタは、コネクタ ギャラリーの [組み込み ] の下に表示され、 サービス プロバイダー ベースです。 内蔵コネクターは、オンプレミスのデータゲートウェイなしで直接ファイル共有に接続し、Azureの仮想ネットワークにアクセスできます。

詳細については次を参照してください:

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

前提条件

  • Azure アカウントとサブスクリプション。 無料の Azure アカウントを取得します。

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

    • 消費型ロジックアプリのワークフロー

    • 標準ロジック アプリワークフロー:

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

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

        • File Systemの内蔵コネクタを使用するには、Standard LogicアプリのワークフローはWindowsベースのWorkflow Service PlanまたはApp Service Environment v3上で動作しなければなりませんが、データゲートウェイリソースは必要ありません。

        • 統合された仮想ネットワークを通じてファイル共有トラフィックをルーティングするには、 WEBSITE_CONTENTOVERVNET アプリの設定を 1に設定するか、 vnetContentShareEnabled サイトプロパティを有効にしてください。 仮想ネットワークがファイルサーバーの完全適格ドメイン名(FQDN)を解決し、ポート445でのSMB送信を許可していることを確認してください。

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

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

    重要

    Gmailコネクタを使用するには、G-Suiteビジネスアカウントのみがロジックアプリで制限なく使用できます。

    Gmail コンシューマー アカウントをお持ちの場合は、特定の Google が承認したサービスでのみこのコネクタを使用できます。または、 Gmail コネクタでの認証に使用する Google クライアント アプリを作成することもできます。

    詳細については、「Azure Logic Apps における Google コネクタのデータ セキュリティとプライバシー ポリシー」を参照してください。

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

  • ファイル共有にアクセスするワークフローを含むロジック アプリ リソース。

    ファイル システム トリガーを使用してワークフローを開始するには、空のワークフローが必要です。

    ファイル システム アクションを使用するには、シナリオに最も適した任意のトリガーからワークフローを開始できます。

    ロジック アプリのリソースとワークフローがない場合は、次の記事を参照してください。

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

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

  2. ワークフローのトリガーを追加する一般的な手順に従って、シナリオに合ったファイルシステムトリガーを追加してください。

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

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

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

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

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

    - < ドメイン>\<ユーザー名>
    - < ローカルコンピュータ>\<ユーザー名>

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

    - <gateway-resource-name>    		 このセクションは、マネージド ファイル システム コネクタにのみ適用されます。

    - 　 サブスクリプション: データ ゲートウェイ リソースに関連付けられている Azure サブスクリプション
    - 接続ゲートウェイ: データ ゲートウェイ リソース

    次の例は、 ファイル システム マネージド コネクタ トリガーの接続情報を示しています。

    ファイル システム マネージド コネクタ トリガーのコンシューマション ワークフロー デザイナーと接続情報を示すスクリーンショット。

  4. 完了したら、[ 新規作成] を選択します。

    Azure Logic Apps により、接続の作成とテストが行われ、この接続が適切に機能していることが確認されます。 接続が正しく設定されている場合は、選択したトリガーのセットアップ オプションが表示されます。

  5. ワークフローの作成を続けます。

    1. トリガーに必要な情報を入力します。

      この例では、ファイル システム サーバー上のフォルダー パスを選択して、新しく作成されたファイルを確認します。 返すファイルの数と、確認する頻度を指定します。

      従量課金ワークフロー デザイナーと、

    2. ワークフローをテストするには、指定したフォルダー内のファイル システムにファイルが作成されたときに電子メールを送信する Outlook コネクタ アクションを追加します。 メールの受信者、件名、本文を入力します。 テスト目的で自分のメール アドレスを使用できます。

      「消費型ワークフロー デザイナー」、ファイルが作成されたときに呼ばれるトリガーという名前の管理されたコネクタ、そして「メールを送信」という名前のアクションを示すスクリーンショット。

      ヒント

      ワークフローで前の手順の出力を追加するには、トリガーの編集ボックス内を選択します。 動的コンテンツ リストが表示されたら、使用可能な出力から選択します。

  6. 完了したら、ワークフローを保存します。

  7. ワークフローをテストするには、ワークフローをトリガーするファイルをアップロードします。

成功であれば、このワークフローは新しいファイルに関する電子メールを送信します。

ファイル システム アクションを追加する

ロジック アプリ ワークフローの例では最初に Dropbox トリガーを使用していますが、任意のトリガーを使用できます。

  1. Azure portal で、従量課金ロジック アプリ リソースを開きます。 デザイナーでワークフローを開きます。

  2. 一般的な手順に従ってワークフローにアクションを追加し、シナリオに合ったファイルシステムアクションを追加してください。

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

  3. メッセージが表示されたら、接続情報を入力します。 詳細については、前のセクションの表を参照してください。

  4. ワークフローの作成を続けます。

    1. アクションに必要な情報を入力します。

      この例では、使用するファイル システム サーバーのフォルダー パスを選択します。ここでは、ルート フォルダーです。 Dropbox にアップロードされたファイルに基づいて、ファイル名とファイル コンテンツを入力します。

      従量課金ワークフロー デザイナーと、ファイルの作成という名前のファイル システム マネージド コネクタ アクションを示すスクリーンショット。

      ヒント

      ワークフローで前のステップの出力を追加するには、アクションの編集ボックス内を選択します。 動的コンテンツ リストが表示されたら、使用可能な出力から選択します。

    2. このワークフローをテストするために、ファイル システム アクションによってファイルが作成された時に、自分宛に電子メールを送信する Outlook アクションを追加します。 メールの受信者、件名、本文を入力します。 テスト目的で自分のメール アドレスを使用できます。

      従量課金ワークフロー デザイナー、マネージド コネクタの [ファイルの作成] アクション、および [電子メールの送信] アクションを示すスクリーンショット。

  5. 完了したら、ワークフローを保存します。

  6. ワークフローをテストするには、ワークフローをトリガーするファイルをアップロードします。

成功であれば、ワークフローは DropBox にアップロードされたファイルに基づいて、ファイル システム サーバーにファイルを作成し、作成されたファイルに関する電子メールを送信します。

内蔵のファイルシステムコネクタのトラブルシューティング

もし操作が InvalidServiceProviderConnection エラーで失敗し、 C:\mounts\FileSystem のようなマウントパスが存在しないと報告すると、Logicアプリはマウントもファイル共有にもアクセスできません。

次の項目を確認します。

  • ルートフォルダがファイルサーバーのFQDNやIPアドレスとトップレベルの共有名(例えば \\file-server.contoso.com\MyShare)を含む完全なUNCパスを使用しているか確認してください。 マシン名だけを使ったり、入れ子リストフォルダを入れたりしないでください。
  • 仮想ネットワークルートテーブルとネットワークセキュリティグループが、ロジックアプリからポート445のファイルサーバーへのSMBトラフィックを許可しているか確認してください。
  • ロジックアプリのKuduコンソールから nslookup <FQDN> を実行し、ファイルサーバー名が解決されているか確認し、期待されるパスが C:\mountsに存在するか確認してください。
  • トラフィックが統合された仮想ネットワークを利用する必要がある場合は、 WEBSITE_CONTENTOVERVNET が 1 に設定されているか、 vnetContentShareEnabled サイトのプロパティが有効になっているかを確認してください。
  • アカウントがトップレベルのシェアにアクセスする許可を持っているか確認してください。 アカウントが入れ子リストフォルダしかアクセスできない場合は、そのフォルダを別の共有として公開し、新しいトップレベルの共有をルートフォルダとして使います。

関連コンテンツ

  • 最終更新: