Azure Logic Appsでファイル内のフラットファイルをエンコードおよびデコードする。

[アーティクル]
01/10/2024

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

企業間 (B2B) シナリオでビジネスパートナーに XML コンテンツを送信する前に、そのコンテンツをあらかじめエンコードすることが必要になる場合があります。エンコードされた XML コンテンツを受信した場合は、まずそのコンテンツをデコードする必要があります。 Azure Logic Apps でロジックアプリワークフローを構築する場合、フラットファイルのエンコードとデコードを行うには、フラットファイル組み込みコネクタアクションとフラットファイルスキーマをエンコードとデコードに使います。 フラットファイル アクションは、マルチテナントの従量課金ロジックアプリワークフローとシングルテナントの Standard ロジックアプリワークフローで使用できます。

フラットファイル トリガーは使用できませんが、任意のトリガーまたはアクションを使って、ソース XML コンテンツをワークフローにフィードできます。たとえば、組み込みのコネクタトリガー、Azure Logic Apps で使用できるマネージドまたは Azure でホストされるコネクタトリガー、または別のアプリを使用できます。

この記事では、フラットファイルのエンコードとデコードのアクションを既存のワークフローに追加する方法について説明します。

フラットファイルのエンコードまたはデコードアクションをワークフローに追加します。
使うスキーマを選びます。

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

前提条件

Azure アカウントとサブスクリプション。サブスクリプションをまだお持ちでない場合には、無料の Azure アカウントにサインアップしてください。
フラットファイル アクションを使用する、空または既存のロジックアプリワークフロー。

空のワークフローがある場合は、任意のトリガーを使用してワークフローを開始します。この例では、要求トリガーを使用します。
ロジックアプリのリソースとワークフロー。フラットファイル操作に使用できるトリガーはないので、ワークフローに含めるトリガーは最小限にする必要があります。詳しくは、次のドキュメントをご覧ください。
- マルチテナント Azure Logic Apps で従量課金ロジックアプリワークフローの例を作成する
- シングルテナント Azure Logic Apps で Standard ロジックアプリワークフローの例を作成する
XML コンテンツのエンコードとデコードに使うフラットファイルスキーマ。詳細については、Azure Logic Apps でのワークフローを使うスキーマの追加に関する記事を参照してください。
従量課金制または Standard ロジックアプリワークフローのどちらを使用しているかに基づいて、統合アカウントリソースが必要になります。通常、このリソースは、エンタープライズ統合と B2B ワークフローで使用するために成果物を定義して格納する場合に必要です。

重要

連携するには、統合アカウントとロジックアプリリソースの両方が、同じ Azure サブスクリプションと Azure リージョンに存在する必要があります。
- 従量課金ロジックアプリワークフローを使っている場合、ロジックアプリリソースには統合アカウントへのリンクが必要です。
- Standard ロジックアプリワークフローを使っている場合は、次のシナリオに基づいて、ロジックアプリリソースを統合アカウントにリンクすること、スキーマをロジックアプリリソースに直接アップロードすること、またはその両方を行うことができます。
  - 必要なまたは使用したい成果物を含む統合アカウントが既にある場合は、成果物を使用する場所になる複数の Standard ロジックアプリリソースに統合アカウントをリンクできます。こうすることで、個々のロジックアプリにスキーマをアップロードする必要がありません。詳細については、ロジックアプリリソースの統合アカウントへのリンクに関するページを参照してください。
  - フラットファイル組み込みコネクタを使用すると、ロジックアプリリソースまたはリンクされた統合アカウントに以前にアップロードしたスキーマを選べますが、両方は選べません。その後、同じロジックアプリリソース内のすべての子ワークフローで、この成果物を使用できます。
  そのため、統合アカウントがないか、または必要としない場合は、アップロードオプションを使用できます。それ以外の場合は、リンクオプションを使用できます。どちらの方法でも、同じロジックアプリリソース内のすべての子ワークフローで、これらの成果物を使用できます。

制限事項

デコードする XML コンテンツは、UTF-8 形式でエンコードする必要があります。
フラットファイルスキーマの場合、含める XML グループの "1 より大きい" 値に設定した max count プロパティ数が多くなりすぎないようにしてください。 max countプロパティ値が1より大きいXMLグループをmax countプロパティが1より大きい別のXMLグループ内にネストしないでください。
Azure Logic Apps を使ってフラットファイルスキーマを解析し、次のフラグメントの選択を許可するスキーマの場合は、Azure Logic Apps によってそのフラグメントの "シンボル" と "予測" が生成されます。スキーマで許可されるコンストラクトの数が 100,000 を超えるなど、このような構造が多すぎると、スキーマの拡張が過度に大きくなり、リソースと時間が多すぎます。

スキーマのアップロード

スキーマを作成したら、次のシナリオに基づいてスキーマをアップロードする必要があります。

従量課金ロジックアプリワークフローを使っている場合は、統合アカウントにスキーマを追加します。
Standard ロジックアプリワークフローを使っている場合は、スキーマを統合アカウントに追加するか、スキーマをロジックアプリリソースに追加します。

Azure Portal から、デザイナーでロジックアプリワークフローを開きます (まだ開いていない場合)。
ワークフローに必要なトリガーやその他のアクションがワークフローにない場合は、最初にそれらの操作を追加します。フラットファイル操作に使用できるトリガーはありません。

この例では、[HTTP 要求の受信時] という名前の要求トリガーを使用して続行します。
ワークフローデザイナーで、フラットファイルアクションを追加するステップの下にある [新しいステップ] を選びます。
[操作を選択してください] の検索ボックスで、[組み込み] を選びます。検索ボックスに「フラットファイル」と入力します。
アクションの一覧で、 [フラットファイルのエンコード] という名前のアクションを選択します。
アクションの [コンテンツ] プロパティで、次の手順に従って、エンコードするトリガーまたは前のアクションからの出力を指定します。
1. [コンテンツ] ボックス内をクリックして、動的コンテンツリストを表示します。
2. 動的コンテンツリストから、エンコードするフラットファイルコンテンツを選びます。
  
  この例では、動的コンテンツの一覧の [HTTP 要求の受信時] で、トリガーからの本文コンテンツ出力を表す Body トークンを選択します。
Note

動的コンテンツリストに [本文] プロパティが表示されない場合は、 [HTTP 要求の受信時] セクションのラベルの横にある [表示数を増やす] を選択します。エンコードするコンテンツを [コンテンツ] ボックスに直接入力することもできます。
[スキーマ名] リストからスキーマを選びます。

Note

スキーマリストが空の場合、ロジックアプリリソースが統合アカウントにリンクされていないか、統合アカウントにスキーマファイルが含まれていません。

完了すると、アクションは次の例のようになります。

他の省略可能なパラメーターをアクションに追加するには、[新しいパラメーターの追加] リストからそれらのパラメーターを選びます。

パラメーター	価値	説明
空のノード生成のモード	ForcedDisabled または HonorSchemaNodeProperty または ForcedEnabled	フラットファイルのエンコードを使用した空のノード生成に使うモード BizTalk の場合、フラットファイルスキーマには、空のノード生成を制御するプロパティがあります。フラットファイルスキーマの空のノード生成プロパティの動作に従うか、この設定を使用して Azure Logic Apps で空のノードを生成または省略することができます。詳細については、「空の要素のタグ」を参照してください。
XML 正規化	Yes または No	フラットファイルエンコードの XML 正規化を有効または無効にする設定。詳細については、「XmlTextReader.Normalization」を参照してください。

ワークフローを保存します。デザイナーのツールバーで、 [保存] を選択します。

フラットファイルのデコードアクションを追加する

従量課金プラン
Standard

Azure Portal から、デザイナーでロジックアプリワークフローを開きます (まだ開いていない場合)。
ワークフローに必要なトリガーやその他のアクションがワークフローにない場合は、最初にそれらの操作を追加します。フラットファイル操作に使用できるトリガーはありません。

この例では、[HTTP 要求の受信時] という名前の要求トリガーを使用して続行します。
ワークフローデザイナーで、フラットファイルアクションを追加するステップの下にある [新しいステップ] を選びます。
[操作を選択してください] の検索ボックスで、[組み込み] を選びます。検索ボックスに「フラットファイル」と入力します。
アクションの一覧で、 [フラットファイルのデコード] という名前のアクションを選択します。
アクションの [コンテンツ] プロパティで、次の手順に従って、デコードするトリガーまたは前のアクションからの出力を指定します。
1. [コンテンツ] ボックス内をクリックして、動的コンテンツリストを表示します。
2. 動的コンテンツリストから、エンコードするフラットファイルコンテンツを選びます。
  
  この例では、動的コンテンツの一覧の [HTTP 要求の受信時] で、トリガーからの本文コンテンツ出力を表す Body トークンを選択します。
Note

動的コンテンツリストに [本文] プロパティが表示されない場合は、 [HTTP 要求の受信時] セクションのラベルの横にある [表示数を増やす] を選択します。エンコードするコンテンツを [コンテンツ] ボックスに直接入力することもできます。
[スキーマ名] リストからスキーマを選びます。

Note

スキーマリストが空の場合、ロジックアプリリソースが統合アカウントにリンクされていないか、統合アカウントにスキーマファイルが含まれていません。

完了すると、アクションは次の例のようになります。
ワークフローを保存します。デザイナーのツールバーで、 [保存] を選択します。

以上で、フラットファイルのデコードアクションの設定が完了しました。実際のアプリでは、デコードしたデータを Salesforce などの基幹業務 (LOB) アプリに保存することが必要になる場合があります。または、そのデコードしたデータを取引先に送信することもできます。デコードアクションの出力を Salesforce または取引先に送信するには、Azure Logic Apps で使用可能な他のコネクタを使用します。

ワークフローのテスト

Postman または同様のツールと POST メソッドを使って、要求トリガーの HTTP POST URL プロパティに含まれる要求トリガーの URL に呼び出しを送信します。また、要求本文にエンコードまたはデコードする XML コンテンツを含めます。
ワークフローの実行が完了したら、ワークフローの実行履歴に移動し、フラットファイルアクションの入力と出力を調べます。

次のステップ

Enterprise Integration Pack について詳細を確認する

Azure Logic Appsでファイル内のフラット ファイルをエンコードおよびデコードする。