階層マッパー
このリソースを使用して階層マッパーを実行し、階層データを別の階層構造に変換します。
POST要求
階層マッパーを実行するには、POST要求を作成し、階層マッパーが処理するXMLデータを指定します。XMLデータは、要求本文のバッファーとして、または階層マッパーに渡すファイルとして提供することができます。出力は、応答で返されるバッファにするか、ファイルに出力を書き込むことができます。
次のURIを使用して、階層マッパーを実行します。
/h2h/api/v1/service/run/<hierarchical mapper ID>
階層マッパーIDは、データ統合のユーザーインタフェースで階層マッパーを開くと確認することができます。URLの最後の文字列が階層マッパーです。
例えば、URL https://dm-us.informaticacloud.com/diUI/products/integrationDesign/main/idsm/7sQJvjkeZLIfpWg6hpYwqJ/readである場合、階層マッパーIDは7sQJvjkeZLIfpWg6hpYwqJです。
次の表に、セクションのフィールドとその説明を示します。
フィールド | タイプ | 説明 |
|---|
agentGroupId | String | 階層マッパーを実行するためのランタイム環境。 |
入力 | | 詳細を入力します。 |
type | 文字列 | 要求本文で送信する入力のタイプ。［バッファ］または［ファイル］を使用します。 |
値 | 文字列 | 階層マッパーに渡す値を入力します。入力がバッファである場合は、XMLデータを入力します。入力がファイルである場合は、ファイルへのパスを入力します。 |
出力 | | 出力の詳細。 |
type | 文字列 | 応答で受信する出力のタイプ。［バッファ］または［ファイル］を使用します。 |
値 | 文字列 | 応答で受信する出力。出力がバッファである場合は、空の文字列を使用します。出力がファイルである場合は、ファイルへのパスを入力します。 |
POST応答
成功した場合、階層マッパーはターゲット階層構造のデータを返します。
次の表に、応答内のフィールドとその説明を示します。
フィールド | タイプ | 説明 |
|---|
output | String | 出力値。出力は、バッファまたはファイルへのパスです。 |
message | 文字列 | 応答メッセージ（Success）。 |
バッファからファイルへのPOST要求の例
次の要求は、XMLデータをバッファとして変換し、変換されたデータを出力ファイルに格納する階層マッパーを実行します。
成功すると、次の応答を受け取ります。
{
"output": "/root/idsm/hmapper_runtime_api_5040_output.xml",
"message": "Success"
}
バッファへのファイルのPOST要求の例
次の要求は、ファイル内のXMLデータを変換し、その出力を応答のバッファとして返す階層マッパーを実行します。
POST <server URL>/h2h/api/v1/service/run/<hierarchical mapper ID>
Content-Type: application/json
Accept: application/json
IDS-SESSION-ID: jpaybAKQMsmdt7vLJ02z0
{
"agentGroupId": "016GOR25000000000005",
"input": {
"type": "file",
"value":"/root/idsm/2.6_parser_response.xml"
},
"output": {
"type": "buffer",
"value": " "
}
}
成功すると、次の応答を受け取ります。