Visual Studio Code を使ってロジックアプリワークフローでデータを変換するマップを作成する

2025-03-03

適用対象: Azure Logic Apps (Standard)

ロジックアプリワークフローで異なる XML 形式または JSON 形式を使用するメッセージを交換する場合は、"変換" する方法を指定するか、XML ドキュメント間や JSON ドキュメント間など、ソース形式からターゲット形式へとデータを変換する方法を指定する必要があります。このタスクは、ソーススキーマとターゲットのスキーマのデータ構造の間にギャップがある場合に特に重要です。 "スキーマ" は、XML または JSON ドキュメント内のデータ要素、属性、およびデータ型を記述します。

データ構造間の変換を定義してギャップを埋めるには、ソースとターゲットのスキーマ内のデータ要素間のリレーションシップを指定するマップ (.xslt ファイル) を作成できます。 Standard ロジックアプリプロジェクトのコンテキスト内で Azure Logic Apps (Standard) 拡張機能と共に Visual Studio Code を使用することで、マップを視覚的に作成および編集できます。 Data Mapper ツールでは、ドラッグアンドドロップジェスチャを使用したマッピングと変換の統合エクスペリエンス、式を構築するための事前構築済みの関数、マップをワークフローで使用する前に手動でテストする方法が提供されます。

マップを作成したら、ロジックアプリプロジェクトのワークフローまたは Azure portal 内の Standard ロジックアプリワークフローから、そのマップを直接呼び出すことができます。このタスクでは、Data Mapper XSLT を使用した変換という名前の Data Mapper 操作アクションをワークフローで使用することができます。

この攻略ガイドでは、空のデータマップの作成、ソースおよびターゲットスキーマの選択、さまざまな種類のスキーマ要素間マッピングの作成、マップの保存とテストを行い、ロジックアプリプロジェクトのワークフローからマップを呼び出す方法を示します。

制限事項と既知の問題

Data Mapper は、現在、Windows オペレーティングシステムで実行されている Visual Studio Code でのみ機能します。
Data Mapper は現在、Azure portal ではなく Visual Studio Code 内でのみ使用でき、従量課金ロジックアプリプロジェクトではなく Standard ロジックアプリプロジェクト内からのみ使用できます。
Data Mapper は現在、コンマ区切り値 (.csv) ファイル形式を使用するスキーマをサポートしていません。
Data Mapper の Code ペインは現在読み取り専用です。
Data Mapper のレイアウトと項目の位置は現在自動で行われ読み取り専用です。
Filter 関数は、二重引用符で囲まれた数値条件を正しく処理します (例: ">=10")。ただし、現在、この関数は、アイテム名が "= 'Pen'" かどうかのチェックなどの文字列比較では動作が一貫していません。
ソーススキーマとターゲットスキーマの親配列要素間のマッピングを作成すると、Mapper は配列項目要素を反復処理するループを自動的に追加します。ただし、ソースとターゲットの配列項目要素の間のマッピングを明示的に作成する必要があります。
Data Mapper ツールで作成されたマップを呼び出すには、「Data Mapper XSLT を使用した変換」という名前の Data Mapper 操作アクションのみを使用できます。他のツールによって作成されたマップの場合は、XML 変換という名前の XML 操作アクションを使用します。
Data Mapper を使って作成したマップを Azure portal のワークフローで使うには、Standard ロジックアプリのリソースにそれを直接追加する必要があります。
現在、カスタム関数はこのリリースではサポートされていません。

前提条件

Standard ロジックアプリワークフローを作成する Visual Studio Code と Azure Logic Apps (Standard) 拡張機能。

Note

以前は個別に存在していた Data Mapper 拡張機能は、Azure Logic Apps (Standard) 拡張機能と統合されました。競合を回避するため、Azure Logic Apps (Standard) 拡張機能をインストールまたは更新すると、Data Mapper 拡張機能の既存のバージョンはすべて削除されます。拡張機能のインストールまたは更新後、Visual Studio Code を再起動してください。
変換するデータ型を記述するソースとターゲットのスキーマファイル。これらのファイルには、次のいずれかの形式を使用できます。
- .xsd ファイル拡張子を持つ XML スキーマ定義ファイル
- .json ファイル拡張子を持つ JavaScript Object Notation ファイル
少なくともトリガーを持つステートフルまたはステートレスワークフローを含む Standard ロジックアプリプロジェクト。プロジェクトがない場合は、Visual Studio Code で次の手順に従います。
1. Azure アカウントに接続します (またしていない場合)。
2. ローカルフォルダー、ローカル Standard ロジックアプリプロジェクト、ステートフルまたはステートレスワークフローを作成します。ワークフローの作成時に、[現在のウィンドウで開く] を選択します。
マップをテストし、変換が期待どおりに動作することを確認する場合は、サンプルの入力データ。
Run XSLT 関数を使うには、XSLT スニペットが、ファイル名拡張子 .xml または .xslt のいずれかのファイルに存在する必要があります。 XSLT スニペットは、ローカルプロジェクトフォルダー構造の InlineXslt フォルダー (Artifacts>DataMapper>Extensions>InlineXslt) に配置する必要があります。このフォルダー構造が存在しない場合は、不足しているフォルダーを作成します。

データマップを作成する

Visual Studio Code で、Standard ロジックアプリプロジェクトのフォルダーを開きます。
Visual Studio Code の左側のメニューで、Azure アイコンを選択します。
Azure ウィンドウの Data Mapper で、[データマップの作成] を選択します。

Visual Studio Code のタイトルバーにプロンプトボックスが開きます。そこでマップの名前を指定できます。
プロンプトボックスに、データマップ名を入力します。

このガイドでは、これらの手順で名前「Example-data-map」を使用します。

Data Mapper は、空のデータマップを作成し開きます。
次の手順に従って、ソースおよびターゲットスキーマを選択します。
1. [ソース] ペインで、 [新規追加]>[参照] を選択して、ソーススキーマを検索してアップロードします。
  
  ソーススキーマを追加すると、[ソース] ペインに、ソーススキーマ内のデータ型の XML 要素 "nodes" が設定されます。次に例を示します。
2. [変換先] ペインで、[新規追加>[参照] を選択して、ターゲットスキーマを検索してアップロードします。
  
  ターゲットスキーマを追加すると、[変換先] ペインに、ターゲットスキーマ内のデータ型の XML 要素 "nodes" が設定されます。次に例を示します。

ヒント

スキーマの読み込みに問題が発生した場合は、ソースとターゲットのスキーマファイルをロジックアプリプロジェクトの [Artifacts]/[スキーマ] フォルダーにローカルに追加できます。このシナリオでは、Data Mapper でソーススキーマとターゲットスキーマを指定するには、[ソース] と [変換先] ペインで、[新規追加] を使用するのではなく、[既存の一覧] を開き、スキーマを選択します。

スキーマデータ型

次の表では、スキーマに表示される可能性のあるデータ型について説明します。

Symbol	型	詳細情報
	Complex (配列)	項目または繰り返し項目ノードを含む。配列要素には、次の接続ポイントも表示されます。
	Bool	True または False のみ
	Complex	オブジェクト JSON 型に似た子プロパティを持つ XML オブジェクト
	DateTime
	Decimal
	Integer	整数のみ
	String

要素間の直接マッピングを作成する

ソースおよびターゲットスキーマの同じ型の要素間での簡単な変換を指定するには、次の手順に従います。

マッピングを作成する際のコードの動作を確認するには、Mapper の右上隅にある [コードの表示] を選択します。
Mapper 画面の [ソース] ペインで、マップするソース要素を見つけます。
- 既定では、親要素は自動的に展開され、子が表示されます。
- 次の使用例は、ソース要素からマッピングを開始しますが、ターゲット要素からマッピングを開始することもできます。
ポインターがプラス記号 (+) に変わるまで、ソース要素名の横にある円の上にマウスポインターを移動します。

この例では、Employee ID ソース要素から開始するマッピングを作成します。
[変換先] ペインでソース要素がターゲット要素の円に接続されるように、線をドラッグして描画します。

この例では、ソース要素と同じデータ型を持つ ID ターゲット要素とのマッピングを完了します。

これで、同じデータ型を持つ両方の要素間の直接マッピングが作成されました。

[コード] ペインには、作成したマッピング関係が表示されます。

ヒント

マッピングに問題があるかどうかを確認するには、[イシューの表示]を選択します。たとえば、データ型が一致しない要素間のマッピングを作成すると、[警告] タブの [イシュー] リストに警告が表示されます。

要素間の複雑なマッピングを作成する

結合する要素や異なるデータ型を持つ要素など、ソーススキーマとターゲットスキーマの要素間のより複雑な変換を指定するには、1 つ以上の関数を使用してマッピングで必要な変換を実行できます。

Mapper 画面では、関数ラベルは関数グループに基づいて色分けされます。関数名の横に、関数のシンボルが表示されます。次に例を示します。

スクリーンショットには、関数ラベルの例が示されています。

次の表に、使用可能な関数グループと関数の例を示します。完全な一覧については、Data Mapper の [関数] の一覧を参照してください。

グループ	関数の例
コレクション	Average、Count、Direct Access、Distinct 値、Filter、Index、Join、Maximum、Minimum、Reverse、Sort、Subsequence、Sum
Conversion	To Date、To Integer、To Number、To String
日付と時刻	Add Days、Current Date、Current Time、Equals Date
論理比較	Equal、Exists、Greater、Greater or equal、If、If Else、Is Nil、Is Null、Is Number、Is String、Less、Less or Equal、Logical AND、Logical NOT、Logical OR、Not Equal
計算	Absolute、Add、Arctangent、Ceiling、Cosine、Divide、Exponential、Exponential (base 10)、Floor、Integer Divide、Log、Log (base 10)、Module、Multiply、Power、Round、Sine、Square Root、Subtract、Tangent
String	Codepoints to String、Concat、Contains、Ends with、Length、Lowercase、Name、Regular Expression Matches、Regular Expression Replace、Replace、Starts with、String to Codepoints、Substring、Substring after、Substring before、Trim、Trim Left、Trim Right、Uppercase
Utility	Copy、Error、Execute XPath、Format DateTime、Format Number、Run XSLT

マッピングなしで関数を追加する

このセクションの例では、ソース要素のデータを文字列からターゲット要素型である日付/時刻に変換します。この例では、最初にマッピングを作成せずに開始し、1 つの入力を受け入れる To Date 関数を使用します。

マッピングを作成する際のコードの動作を確認するには、Mapper の右上隅にある [コードの表示] を選択します。
関数の一覧から、使用する関数を見つけて選択すると、Mapper 画面にその関数が追加されます。関数の一覧が折りたたまれている場合は、Mapper の左上隅にある関数アイコン () を選択します。

次の使用例では、Conversion 関数グループにある To Date 関数を選択します。

Note

マップ上にマッピングが存在しない場合、またはマップに関数を追加するときにマッピングが選択されている場合、関数は表示されますが、要素やその他の関数には接続されません。次に例を示します。
関数をソースおよびターゲット要素に接続します。
1. ドラッグして、ソース要素と関数の左端の間に線を描画します。ソース要素または関数のいずれからも開始できます。
2. 関数の右端とターゲット要素の間に線をドラッグして描画します。ターゲット要素からでも関数からでも開始できます。
[コード] ペインには、作成したマッピング関係が表示されます。
Mapper 画面で、関数の図形を選択して関数の詳細を表示します。
[入力] タブで、使用する入力を確認または編集します。

一部のシナリオでは、ソース要素とターゲット要素の直接のペアを超えて変換を定義する必要があります。たとえば、配列のペアとその項目の間の変換を定義するには、配列間にループを作成する必要があります。要素の値が条件を満たすときにタスクを実行するには、要素間に条件を追加する必要があります。

複数の入力を使用する関数を追加する

このセクションの例では、複数のソース要素を入力として連結し、1 つの出力をターゲット要素にマップします。この例では、複数の入力を受け取る Concat 関数を使用します。

マッピングを作成する際のコードの動作を確認するには、Mapper の右上隅にある [コードの表示] を選択します。
関数の一覧から、使用する関数を見つけて選択すると、Mapper 画面にその関数が追加されます。

関数の一覧が折りたたまれている場合は、Mapper の左上隅にある関数アイコン () を選択します。

次の使用例は、String 関数グループ内にある Concat 関数を選択します。

Note

マップ上にマッピングが存在しない場合、またはマップに関数を追加するときにマッピングが選択されている場合、関数は表示されますが、要素やその他の関数には接続されません。次に例を示します。
Mapper 画面で、関数の図形を選択して関数の詳細を表示します。
[入力] タブで、入力として使用するソーススキーマ要素を選択します。

次の使用例は、FirstName および LastName ソーススキーマ要素を関数の入力として選択します。 Mapper は、それぞれについてソース要素と関数の間に対応するマッピングを自動的に追加します。
マッピングを完了するには、関数の右端とターゲット要素の間に線をドラッグして描画します。ターゲット要素または関数のいずれからでも開始できます。

[コード] ペインには、作成したマッピングリレーションシップが表示されます。

配列を反復処理する

ソーススキーマとターゲットスキーマに配列が含まれている場合は、配列の項目を反復処理するループを作成できます。このセクションの例では、Employee ソース配列と Person ターゲット配列を処理するループを作成し、配列の項目間のマッピングを作成します。

マッピングを作成する際のコードの動作を確認するには、Mapper の右上隅にある [コードの表示] を選択します。
Mapper 画面の [ソース] と [変換先] のペインで、マップする配列を見つけます。
配列項目のペアの間に線をドラッグして描画します。 [ソース] ペインまたは [変換先] ペインのいずれからも開始できます。

次の例では、[ソース] ペインから開始し、Employee ソース配列と Person ターゲット配列の Name 項目をマップします。

配列項目の最初のペアのマッピングが完了すると、Mapper は、次の接続ポイントの種類を持つソースとターゲットの配列の親要素の間にループを自動的に追加します。

次の例では、ソース Employee とターゲット Person の親配列の間に自動的に追加されたループが強調表示されています。

[コード] ペインには、作成したマッピングとループが表示されます。
引き続き他の配列要素をマッピングします。次に例を示します。

タスクを実行する条件を評価する

条件を評価し、条件が満たされたときにタスクを実行するマッピングを追加したいとします。このシナリオでは、複数の関数を使用できます。

次の例では、購入数量が 20 品目を超えると、マッピングは次の関数を使用して適用する割引を計算します。

関数グループ	機能	この例の目的
比較	より大きい	購入数量が 20 を超えているかどうかを確認します。
比較	次の場合	Greater 関数で true が返されるかどうかを確認します。
計算	Multiply	条件が true の場合は、品目価格に 10% を掛けて割引を計算します。

[ソース] と [変換先] のペインで、自分のシナリオでマップする要素を見つけます。

この例では、次のメトリックを使用します。
- [ソース] ペイン: ItemPrice と ItemQuantity
- [変換先] ペイン: ItemPrice、ItemQuantity、および ItemDiscount
関数の一覧から、使用する関数を見つけて選択すると、Mapper 画面にその関数が追加されます。
- 関数の一覧が折りたたまれている場合は、Mapper の左上隅にある関数アイコン () を選択します。
- 必要に応じて、Mapper 画面上で関数図形を移動して、選択しやすくします。
この例では、Mapper 画面に次の関数を追加します: Greater、If、および Multiply
マッピングを作成する際のコードの動作を確認するには、Mapper の右上隅にある [コードの表示] を選択します。

自分のシナリオに必要な特定の順序でソース要素、関数、およびターゲット要素を接続します。

この例では、マッピングを正しく作成するために、指定した順序で次の項目を接続します。

スタート	End キー
ItemPrice ソース要素	ItemPrice ターゲット要素
ItemQuantity ソース要素	Greater 関数の入力 (図形の左端)。この入力は、関数の詳細の Value 1 フィールドのデータを提供します。
Greater 関数の出力 (図形の右端)	If 関数の入力 (図形の左端)。この入力は、関数の詳細の Condition フィールドのデータを提供します。
ItemPrice ソース要素	Multiply 関数の入力 (図形の左端)。この入力は、関数の詳細の Multiplicand フィールドのデータを提供します。
Multiply 関数の出力 (図形の右端)。	If 関数の入力 (図形の左端)。この入力は、関数の詳細の Value フィールドのデータを提供します。
If 関数の出力 (図形の右端)。	ItemDiscount ターゲット要素

次の例は、この時点でのマッピングを示しています。

スクリーンショットには、例の条件シナリオのための Mapper 画面、データ要素、および関数とマッピングが示されています。

[入力] タブの次の関数の詳細で、次の値を確認または指定します。

機能	入力フィールドと値
より大きい	- Value 1: ItemQuantity ソース要素 - Value 2: カスタム値として 20
Multiply	- Multiplicand 1: ItemPrice ソース要素 - Multiplicand 2: カスタム値として .10
次の場合	- Condition: is-greater-than (ItemQuantity, 20) - 値: multiply(ItemPrice, .10)

完成した例を次のマップに示します。

スクリーンショットには、完成した条件の例が示されています。

[コード] ペインには、作成したマッピングが表示されます。

スクリーンショットには、[コード] ペインが示されています。Greater、If、Multiply の各関数を使用したソースおよびターゲット要素の間の条件付きのマッピングが表示されています。

マップを保存する

完了したら、マップツールバーで [保存] を選択します。

Visual Studio Code では、マップは次の成果物として保存されます。

Artifacts>MapDefinitions プロジェクトフォルダー内の <your-map-name>.yml ファイル
Artifacts>Maps プロジェクトフォルダー内の <your-map-name>.xslt ファイル

マップをテストする

変換が期待どおりに動作することを確認するには、サンプル入力データが必要です。

マップをテストする前に、マップを保存して、現在の <your-map-name>.xslt ファイルを生成します。
マップツールバーで、[テストパネルを開く] を選択します。
[マップのテスト] ペインの [サンプルデータ] ボックスにサンプル入力を貼り付け、[テスト] を選択します。

[結果] ボックスにテスト結果が表示されます。

プロジェクト内のワークフローからマップを呼び出す

Visual Studio Code のアクティビティバーで、[エクスプローラー] (ファイルアイコン) を選択して、ロジックアプリのプロジェクト構造を表示します。
ワークフロー名を持つフォルダーを展開します。 workflow.json ファイルのショートカットメニューから、[デザイナーを開く] を選択します。
ワークフローデザイナーで、この一般的な手順に従って、Data Mapper XSLT を使用した変換という名前の Data Mapper 操作組み込みアクションを追加します。
デザイナーで、[Data Mapper XSLT を使用した変換] アクションを選びます。
表示されるアクション情報ペインで、[コンテンツ] の値を指定し、[ソースのマップ] を [ロジックアプリ] に設定したままにします。
マップ名 一覧を開き、マップ (.xslt ファイル) を選択します。

Azure portal で同じ [Data Mapper XSLT を使用した変換] アクションを使うには、マップを Standard ロジックアプリリソースに追加する必要があります。

Azure Logic Apps での B2B 操作を使用したデータ変換については、「Azure Logic Apps でワークフローに変換用のマップを追加する」を参照してください

次の方法で共有

Visual Studio Code を使ってロジック アプリ ワークフローでデータを変換するマップを作成する