REST APIリファレンス

前へ次へ

階層マッパーの実行

階層マッパーを実行するには、POST要求を作成し、階層マッパーが処理するXMLまたはJSONデータを指定します。データは、要求本文のバッファーとして、または階層マッパーに渡すファイルとして提供することができます。出力は、応答で返されるバッファにするか、ファイルに出力を書き込むことができます。

POST要求

次のURIを使用して、階層マッパーを実行します。

/h2h/api/v1/service/run/<hierarchical mapper ID>

次の表に、セクションのフィールドとその説明を示します。

フィールド	タイプ	説明
agentGroupId	String	階層マッパーを実行するためのランタイム環境。ランタイム環境を指定しない場合、階層マッパーはクラウドサーバー上でネイティブに実行されます。
入力		詳細を入力します。
type	文字列	要求本文で送信する入力のタイプ。［バッファ］または［ファイル］を使用します。
値	文字列	階層マッパーに渡す値を入力します。入力がバッファである場合は、XMLまたはJSONデータを入力します。入力がファイルである場合は、ファイルへのパスを入力します。
出力		出力の詳細。
type	文字列	応答で受信する出力のタイプ。［バッファ］または［ファイル］を使用します。
値	文字列	応答で受信する出力。出力がバッファである場合は、空の文字列を使用します。出力がファイルである場合は、ファイルへのパスを入力します。

POST応答

成功した場合、階層マッパーはターゲット階層構造のデータを返します。

次の表に、応答内のフィールドとその説明を示します。

フィールド	タイプ	説明
output	String	出力値。出力は、バッファまたはファイルへのパスです。
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": "buffer",
        "value":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><HL7:MSH><MSH.1>1</MSH.1><MSH.2>^~\\&amp;</MSH.2><MSH.3><HD.1>GHH_ADT</HD.1></MSH.3><MSH.7>20080115153000</MSH.7><MSH.9><MSG.1>ADT</MSG.1><MSG.2>A01</MSG.2><MSG.3>ADT_A01</MSG.3></MSH.9><MSH.10>0123456789</MSH.10><MSH.11><PT.1>P</PT.1></MSH.11><MSH.12><VID.1>2.6</VID.1></MSH.12><MSH.16>AL</MSH.16></HL7:MSH>"
        },
    "output": {
        "type": "file",
        "value": "/root/idsm"
    }
}

成功すると、次の応答を受け取ります。

{
    "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": " "
    }
}

成功すると、次の応答を受け取ります。

{
    "output": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<Departments>\r\n<Department name=\"\">\r\n<Employee>\r\n<Profile>\r\n<Id>0</Id>\r\n<FullName>1</FullName>\r\n<Skills>\r\n<FHIR4></FHIR4>\r\n<XYZ></XYZ>\r\n<hl7></hl7>\r\n<HIPAA></HIPAA>\r\n</Skills>\r\n</Profile>\r\n</Employee>\r\n</Department>\r\n</Departments>\r\n",
    "message": "Success"
}

階層マッパー

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal