適用対象: Azure Logic Apps (従量課金 + Standard)
この記事では、ファイル転送プロトコル (FTP) コネクタを使って Azure Logic Apps のワークフローから FTP サーバーにアクセスする方法について説明します。 FTP サーバーまたは他のシステムのイベントによってトリガーされたときに実行される自動化されたワークフローを作成し、FTP サーバー上のファイルを管理するアクションを実行できます。
たとえば、FTP サーバーでイベントを監視して応答する FTP トリガーによってワークフローを開始できます。 トリガーにより、ワークフロー内のアクションで出力を使用できるようになります。 ワークフローで、次の特定のタスクを使用して、FTP サーバー アカウントを介してファイルを作成、送信、受信、管理する FTP アクションを実行できます。
- ファイルの追加または変更を監視します。
- ファイルを作成、コピー、削除、一覧表示、更新する。
- ファイルのメタデータと内容を取得する。
- フォルダーを管理する。
Azure Logic Apps を初めて使用する場合は、次のドキュメントを参照してください。
コネクタに関するテクニカル リファレンス
FTP コネクタには、ロジック アプリの種類とホスト環境に基づいてさまざまなバージョンがあります。
| ロジック アプリの種類 (プラン) | 環境 | コネクタのバージョン |
|---|---|---|
| 従量課金 | マルチテナント Azure Logic Apps | マネージド コネクタ。 共有 フィルターを使用してコネクタ ギャラリーに表示されます。 詳細については、以下を参照してください。 - FTP マネージド コネクタのリファレンス - Azure Logic Apps のマネージド コネクタ |
| Standard | シングルテナント Azure Logic Apps と App Service Environment v3 (Windows プランのみ) | - マネージド コネクタ。 共有 フィルターを使用してコネクタ ギャラリーに表示されます。 - 組み込みコネクタ。 組み込み フィルターを使用してコネクタ ギャラリーに表示され、 サービス プロバイダー ベースです。 組み込みコネクタは、接続文字列を使用して Azure 仮想ネットワークに直接アクセスできます。 詳細については、以下を参照してください。 - FTP マネージド コネクタのリファレンス - FTP 組み込みコネクタ操作 - Azure Logic Apps のマネージド コネクタ - Azure Logic Apps の組み込みコネクタ |
制限事項
容量とスループット
Standard ワークフローの組み込みコネクタ:
既定では、FTP アクションは 200 MB 以下のファイルの読み取りまたは書き込みが可能です。 現時点では、FTP 組み込みコネクタはチャンクをサポートしていません。
従量課金プラン ワークフローと Standard ワークフローのマネージド コネクタ
既定では、FTP アクションは 50 MB 以下のファイルの読み取りまたは書き込みが可能です。 50 MB を超えるファイルを処理するために、FTP アクションでは、メッセージのチャンクがサポートされています。 ファイルのコンテンツの取得アクションでは、暗黙的にチャンクが使用されます。
FTP マネージド コネクタまたは Azure ホステッド コネクタのトリガーでは、 最後に変更 されたタイムスタンプが保持されると、不足、不完全、または遅延の結果が発生する可能性があります。 一方、Standard ロジック アプリ ワークフローの FTP "組み込み" コネクタ トリガーには、この制限はありません。 詳細については、FTP コネクタの 制限事項を参照してください。
FTP マネージド コネクタは、FTP サーバーへの限られた数の接続を作成できます。 制限は、ロジック アプリ リソースが存在する Azure リージョンの接続容量に基づいています。 この制限が従量課金ロジック アプリ ワークフローで問題となる場合は、FTP 組み込みコネクタを使用する標準ロジック アプリ ワークフローを作成します。
- 組み込み FTP コネクタとマネージド FTP コネクタはどちらも、TLS の拡張機能である FTPS 経由の明示的な FTP のみをサポートします。 どちらのコネクタ バージョンでも、暗黙的な FTPS はサポートされていない。
前提条件
Azure アカウントとサブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。
FTP アカウントにアクセスするロジック アプリ ワークフロー。 FTP トリガーでワークフローを開始するには、空のワークフローから開始する必要があります。 FTP アクションを使用するには、別のトリガー ([繰り返し] トリガーなど) でワークフローを開始します。
FTP マネージド コネクタと組み込みコネクタの両方に適用されるその他の要件については、「 FTP マネージド コネクタのリファレンス - 要件」を参照してください。
既知の問題
既定では、配列を受け入れて返すトリガーには、通常、既に有効になっている 分割設定 があります。 トリガーは、各配列項目を処理する個別のワークフロー インスタンスを内部的に作成することで、配列を自動的に デバッチ します。 配列項目が同時に処理されるように、すべてのワークフロー インスタンスが並列して実行されます。
[分割時] 設定を有効にすると、マネージド コネクタ トリガーは、すべての配列項目の出力をリストとして返します。 これらの出力を参照する後続のアクションは、最初にこれらの出力をリストとして処理する必要があります。 各配列項目を個別に処理するために、アクションを追加できます。 たとえば、これらの配列項目を反復処理するために、For each ループを使用できます。 メタデータまたはプロパティのみを返すトリガーの場合、最初に配列項目のメタデータを取得するアクションを使用し、次に、項目の内容を取得するアクションを使用します。
この方法は マネージド コネクタ トリガーにのみ適用する必要があります。Split on 設定を有効にして一度に 1 つの配列項目の出力を返す組み込みのコネクタ トリガーには適用しないでください。
たとえば、[ファイルが追加または変更されたとき (プロパティのみ)] という名前のマネージド コネクタ トリガーがあるとします。このトリガーは、新しいファイルまたは更新されたファイルのメタデータまたはプロパティを配列として返します。 各ファイルのメタデータを個別に取得するために、配列を反復処理する For each ループを使用できます。 このループでは、次のマネージド コネクタ アクションを指定されている順序で使用します。
各ファイルのメタデータを取得するための [ファイルのメタデータの取得]。
各ファイルの内容を取得するための [ファイルの内容の取得] アクション。
FTP トリガーを追加する
従量課金プラン ロジック アプリ ワークフローでは、FTP マネージド コネクタのみ使用できます。 一方、Standard ロジック アプリ ワークフローでは、FTP マネージド コネクタ "および" FTP 組み込みコネクタを使用できます。
FTP マネージド コネクタと組み込みコネクタでは、それぞれ 1 つのトリガーのみ使用できます。
マネージド コネクタ トリガー: [ファイルが追加または変更されたとき (プロパティのみ)] という名前の FTP トリガーは、FTP サーバーで 1 つ以上のファイルがフォルダーに追加されたとき、または変更されたときに、従量課金プランまたは Standard ロジック アプリ ワークフローを実行します。 このトリガーでは、ファイルの内容ではなく、ファイルのプロパティまたはメタデータのみが取得されます。 ファイルの内容を取得するために、ワークフローは他の FTP アクションを使用してこのトリガーに従うことができます。
詳細については、「 ファイルが追加または変更されたとき (プロパティのみ)」を参照してください。
組み込みコネクタ トリガー: [ファイルが追加または更新されたとき]という名前の FTP トリガーは、FTP サーバーで 1 つ以上のファイルがフォルダーに追加されたとき、または変更されたときに、Standard ロジック アプリ ワークフローを実行します。 このトリガーでは、ファイルの内容ではなく、ファイルのプロパティまたはメタデータのみが取得されます。 コンテンツを取得するために、ワークフローは他の FTP アクションを使用してこのトリガーに従うことができます。 詳細については、「 ファイルが追加または更新されたとき」を参照してください。
次の手順では、Azure portal を使用します。 従量課金または標準ロジック アプリ用の対応する Azure Logic Apps 拡張機能を使用すると、代わりに次のツールを使用してロジック アプリ ワークフローを作成および編集できます。
- 従量課金ロジック アプリ ワークフロー: Visual Studio Code
- Standard ロジック アプリ ワークフロー: Visual Studio Code
このセクションでは、次の FTP コネクタ トリガーに関する手順を示します。
[ファイルが追加または更新されたとき] という名前の "組み込み" トリガー
この FTP 組み込みトリガーを使用する場合は、FTP マネージド トリガーを使用する場合とは異なり、最初にファイル メタデータの取得アクションを使用せずに 、ファイル コンテンツの取得 という名前の FTP 組み込みアクションを使用して ファイル の内容を取得できます。 FTP 組み込みコネクタ操作の詳細については、「 FTP 組み込みコネクタ操作」を参照してください。
この組み込みの FTP トリガーは、従量課金ロジック アプリ ワークフローでは使用できません。
[ファイルが追加または変更されたとき (プロパティのみ)] という名前の "マネージド" トリガー
この FTP マネージド トリガーを使用する場合は、追加または変更されたファイルに対して他のアクションを使用する前に、 ファイル メタデータ の取得アクションを使用して 1 つの配列項目を取得する必要があります。 この対処法は、この記事で前述した [Split On] (分割) 設定に関する既知の問題から導き出したものです。
組み込みのコネクタ トリガーを追加する
組み込みのコネクタ トリガーを Standard ワークフローに追加するには:
Azure portal で、ロジック アプリ リソースを開きます。
リソース サイドバー メニューの [ ワークフロー] で [ ワークフロー] を選択し、デザイナーで開く空のワークフローを選択します。
デザイナーで、[トリガーの 追加] を選択します。
ファイルが追加または更新されたとき (プレビュー) に FTP トリガーを追加するには、一般的な手順に従います。
接続に関する情報を指定します。 完了したら、[ 新規作成] を選択します。
Note
既定では、このコネクタからファイルがテキスト形式で転送されます。 たとえば、エンコードが使用される状況で、バイナリ形式でファイルを転送するには、[バイナリ転送] オプションを選択します。
トリガー情報ウィンドウが表示されたら、[ フォルダー パス ] ボックスで、監視するフォルダーへのパスを指定します。
完了したら、ワークフローを保存します。
ワークフローを保存すると、Azure でデプロイされたライブ ロジック アプリに更新プログラムが発行されます。 トリガーのみの場合、ワークフローでは、指定したスケジュールに基づいて FTP サーバーのチェックのみ行われます。 後のセクションで説明するように、トリガーに応答し、トリガー出力で何かを行うアクションを追加する必要があります。
マネージド コネクタ トリガーを追加する
消費または標準のワークフローにマネージドコネクタのトリガーを追加するには:
Azure portal で、ロジック アプリ リソースを見つけて開きます。
従量課金ロジック アプリと Standard ロジック アプリのどちらがあるかに基づきます。
リソースの使用: リソースサイドバーメニューの開発ツールから、デザイナーを選択してワークフローを開きます。
標準: リソースサイドバーメニューの[ワークフロー]で、[ ワークフロー]を選択 します。 デザイナーで開く空白のワークフローを選択してください。
ワークフロー デザイナーで、[ トリガーの追加] を選択します。
一般的な手順に従って、ファイルが追加または変更されたときに FTP トリガーを追加します (プロパティのみ)。
接続に関する情報を指定します。 完了したら、[ 新規作成] を選択します。
Note
既定では、このコネクタからファイルがテキスト形式で転送されます。 たとえば、エンコードが使用される状況で、バイナリ形式でファイルを転送するには、[バイナリ転送] オプションを選択します。
トリガー情報ウィンドウが開いたら、新しいファイルまたは編集されたファイルを監視するフォルダーを見つけます。
[フォルダー] ボックスで、フォルダー アイコンを選択してフォルダー ディレクトリを表示します。
右矢印 (>) を選択します。 目的のフォルダーを参照し、そのフォルダーを選択します。
選択されたフォルダーが [フォルダー] ボックスに表示されます。
完了したら、ワークフローを保存します。
ワークフローを保存すると、Azure によって、デプロイされたライブ ロジック アプリに更新プログラムが発行されます。 トリガーのみの場合、ワークフローでは、指定したスケジュールに基づいて FTP サーバーのチェックのみ行われます。 後のセクションで説明するように、トリガーに応答し、トリガーの出力で何かを行うアクションを追加する必要があります。
FTP アクションを追加する
従量課金プラン ロジック アプリ ワークフローでは、FTP マネージド コネクタのみ使用できます。 標準ロジック アプリ ワークフローでは、FTP マネージド コネクタと FTP 組み込みコネクタを使用できます。 各バージョンには複数のアクションがあります。 たとえば、マネージド コネクタ バージョンと組み込みコネクタ バージョンの両方に、ファイルのメタデータを取得するため、およびファイルの内容を取得するための独自のアクションがあります。
- 組み込みコネクタ アクション: これらのアクションは、Standard ロジック アプリ ワークフローでのみ実行されます。
- マネージド コネクタ アクション: これらのアクションは、従量課金プランまたは Standard ロジック アプリ ワークフローで実行されます。
次の手順では、Azure portal を使用します。 従量課金用または Standard 用の対応する Azure Logic Apps 拡張機能では、代わりに次のツールを使用して、ロジック アプリ ワークフローを作成および編集できます。
- 従量課金ワークフロー: Visual Studio Code
- Standard ワークフロー: Visual Studio Code
FTP アクションを使用する前に、ワークフローがトリガーによって既に開始されている必要があります。トリガーは、任意の種類のものを選択できます。 たとえば、汎用の [繰り返し] 組み込みトリガーを使用して、特定のスケジュールに基づきワークフローを開始できます。
FTP アクションを追加して使用する手順は、ワークフローで組み込みコネクタとマネージド コネクタのどちらを使用するかによって異なります。
組み込みのトリガー ワークフロー: 組み込みトリガーで始まるワークフローに組み込みアクションを追加する手順について説明します。
FTP 組み込みトリガーを使用していて、新しく追加または更新されたファイルの内容が必要な場合は、 For each ループを使用して、トリガーによって返される配列を反復処理できます。 その後、他の中間アクションなしで [ファイルの内容の取得] アクションのみを使用できます。 FTP 組み込みコネクタ操作の詳細については、「 FTP 組み込みコネクタ操作」を参照してください。
マネージド トリガー ワークフロー: マネージド トリガーで始まるワークフローにマネージド アクションを追加する手順について説明します。
FTP マネージド コネクタ トリガーを使用し、新しく追加または変更されたファイルの内容が必要な場合は、 For each ループを使用して、トリガーによって返される配列を反復処理できます。 その後、[ファイルの内容の取得] アクションを使用する前に、[ファイルのメタデータの取得] という名前の FTP アクションなど、中間アクションを使用する必要があります。
組み込みトリガーを使用したワークフロー
組み込みのコネクタ トリガーで始まる標準ワークフローにアクションを追加するには:
Azure portal で、ロジック アプリ リソースを見つけて開きます。
リソースサイドバーメニューの[ワークフロー]で、[ ワークフロー]を選択 します。 FTP 組み込みトリガーを使用してワークフローを選択します。
デザイナーで、次の 一般的な手順 に従って、 ファイル コンテンツの取得 という名前の FTP アクションをワークフローに追加します。
必要に応じて、接続に関する情報を指定します。 完了したら、[ 新規作成] を選択します。
Note
既定では、このコネクタからファイルがテキスト形式で転送されます。 たとえば、エンコードが使用される状況で、バイナリ形式でファイルを転送するには、[バイナリ転送] オプションを選択します。
開いたアクション情報ペインで、[ ファイル パス ] 内を選択して入力オプションを表示します。 稲妻アイコンを選択して、動的コンテンツ リストを開きます。
これで、前のトリガーからの出力を選択できます。
動的なコンテンツの一覧で、[ファイルが追加または更新されたとき] の下にある [ファイルのパス] を選択します。
これで、[ファイルのパス] プロパティで、[ファイルのパス] トリガーの出力が参照されるようになりました。
ワークフローに必要な他のアクションを追加します。
完了したら、ワークフローを保存します。 デザイナーのツール バーで、[保存] を選択します。
マネージド トリガーを使用したワークフロー
マネージドコネクタトリガーで始まる消費型または標準のワークフローにアクションを追加するために:
Azure portal で、ロジック アプリ リソースを見つけて開きます。
従量課金ロジック アプリと Standard ロジック アプリのどちらがあるかに基づきます。
リソースの使用: リソースサイドバーメニューの開発ツールから、デザイナーを選択してワークフローを開きます。
標準: リソースサイドバーメニューの[ワークフロー]で、[ ワークフロー]を選択 します。 FTP マネージド コネクタ トリガーで始まるワークフローを選択します。 ワークフローサイドバーメニューで、デザイナーを選択してワークフローを開きます。
デザイナーで、次の 一般的な手順 に従って、 ファイル メタデータの取得 という名前の FTP アクションをワークフローに追加します。
必要に応じて、接続に関する情報を指定します。 完了したら、[ 新規作成] を選択します。
Note
既定では、このコネクタからファイルがテキスト形式で転送されます。 たとえば、エンコードが使用される状況で、バイナリ形式でファイルを転送するには、[バイナリ転送] オプションを選択します。
開いたアクション情報ウィンドウで、[ ファイル ] 内を選択して入力オプションを表示します。 稲妻アイコンを選択して、動的コンテンツ リストを開きます。
これで、前のトリガーからの出力を選択できます。
動的なコンテンツの一覧で、[ファイルが追加または変更されたとき (プロパティのみ)] の下にある [List of Files Id] (ファイル ID の一覧) を選択します。
これで、[ファイル] プロパティでは、[List of Files Id] (ファイル ID の一覧) トリガーの出力が参照されます。
デザイナーで、次の 一般的な手順 に従って、 ファイル コンテンツの取得 という名前の FTP アクションをワークフローに追加します。
表示されるアクション情報ウィンドウで、[ ファイル ] 内を選択して入力オプションを表示します。 稲妻アイコンを選択して、動的コンテンツ リストを開きます。
これで、前のトリガーまたはアクションからの出力を選択できます。
動的なコンテンツの一覧で、[ファイルのメタデータの取得] の下にある [ID] を選択します。
これで、[ファイル] プロパティで [ID] アクションの出力が参照されます。
ワークフローに必要な他のアクションを追加します。
完了したら、ワークフローを保存します。 デザイナーのツール バーで、[保存] を選択します。
ワークフローをテストする
ワークフローによって目的の内容が返されるか確認するために、追加または更新されたファイルの内容を自分に送信する別のアクションを追加します。 この例では、[メールの送信] という名前の Office 365 Outlook アクションを使用します。
組み込みトリガーとアクションを使用したワークフロー
Office 365 Outlook アクションを Standard ワークフローに追加するには:
デザイナーの [ ファイル コンテンツの取得 ] アクションで、次の 一般的な手順 に従って、[ 電子メール をワークフローに送信] という名前のアクションを追加します。
代わりに Outlook.com アカウントがある場合は、Outlook.com 電子メールの送信アクションを 追加します。
必要に応じて、メール アカウントにサインインします。
アクション情報ウィンドウで、必要な値を指定し、テストするその他のパラメーターまたはプロパティを含めます。
たとえば、[ファイルの内容の取得] アクションから [ファイルのコンテンツ] の出力を追加できます。 この出力を見つけるには、次の手順に従います。
[ ファイル コンテンツの取得 ] アクションで、[ 本文 ] 内を選択して入力オプションを表示します。 稲妻アイコンを選択して、動的コンテンツ リストを開きます。 この一覧の [ ファイルコンテンツの取得] で、[ ファイルコンテンツ] を選択します。
動的なコンテンツの一覧で、[ファイルの内容の取得] の下にある [ファイルのコンテンツ] を選択します。
Body プロパティに、ファイル コンテンツ アクションの出力が含まれるようになりました。
ワークフローを保存します。
ワークフローをテストしてトリガーするために、次の手順に従います。
デザイナー のツール バーで、[ 実行>実行] を選択します。
ワークフローによって監視される FTP フォルダーにファイルを追加します。
マネージド トリガーとアクションを使用したワークフロー
従量課金または標準ワークフローに Office 365 Outlook のアクションを追加するには:
デザイナーの [ ファイル コンテンツの取得 ] アクションで、次の 一般的な手順 に従って、[ 電子メール をワークフローに送信] という名前のアクションを追加します。
代わりに Outlook.com アカウントがある場合は、Outlook.com 電子メールの送信アクションを 追加します。
必要に応じて、メール アカウントにサインインします。
アクション情報ボックスで、必要な値を指定し、テストするその他のパラメーターまたはプロパティを追加します。
たとえば、[ファイルの内容の取得] アクションから [ファイルのコンテンツ] の出力を追加できます。 この出力を見つけるには、次の手順に従います。
[ ファイル コンテンツの取得 ] アクションで、[ 本文 ] ボックス内を選択して入力オプションを表示します。 稲妻アイコンを選択して、動的コンテンツ リストを開きます。 この一覧の [ ファイルコンテンツの取得] で、[ ファイルコンテンツ] を選択します。
動的なコンテンツの一覧で、[ファイルの内容の取得] の下にある [ファイルのコンテンツ] を選択します。
Body プロパティに、ファイル コンテンツ アクションの出力が含まれるようになりました。
ロジック アプリ ワークフローを保存します。
ワークフローをテストしてトリガーするために、次の手順に従います。
デザイナー のツール バーで、[ 実行>実行] を選択します。
ワークフローによって監視される FTP フォルダーにファイルを追加します。