DTL 変換の開発

DTL 変 換 の 開 発
Version 2012.2
2012 年 09 月 12 日
InterSystems Corporation 1 Memorial Drive Cambridge MA 02142 www.intersystems.com

DTL 変 換 の 開 発
Ensemble Version 2012.2 2012 年 09 月 12 日
Copyright © 2012 InterSystems Corporation
All rights reserved.
このドキュメントは、 Sun Microsystems、RenderX Inc.、 アドビ システムズ および ワールドワイド・ウェブ・コンソーシアム(www.w3c.org)のツールと
情 報 を 使 用 して、 Adobe Portable Document Format (PDF)で 作 成 およびフォーマットされました。 主 要 ドキュメント 開 発 ツールは、InterSystemsが 構
築 したCacheéと Javaを 使 用 した 特 別 目 的 のXML 処 理 アプリケーションです。
, ,
Caché WEBLINK, Distributed Cache Protocol, M/SQL, M/NET および M/PACT は InterSystems Corporation の 登 録 商 標 です。
, , and ,
InterSystems TrakCare, InterSystems Jalapeño Technology, Enterprise Cache Protocol, ECP および InterSystems Zen は InterSystems Corporation の
登 録 商 標 です。
ここで 使 われている 他 の 全 てのブランドまたは 製 品 名 は、 各 社 および 各 組 織 の 商 標 または 登 録 商 標 です。
このドキュメントは、インターシステムズ 社 ( 住 所 :One Memorial Drive, Cambridge, MA 02142)あるいはその 子 会 社 が 所 有 する 企 業 秘 密 および 秘 密
情 報 を 含 んでおり、インターシステムズ 社 の 製 品 を 稼 動 および 維 持 するためにのみ 提 供 される。この 発 行 物 のいかなる 部 分 も 他 の 目 的 のために 使
用 してはならない。また、インターシステムズ 社 の 書 面 による 事 前 の 同 意 がない 限 り、 本 発 行 物 を、いかなる 形 式 、いかなる 手 段 で、その 全 てまたは
一 部 を、 再 発 行 、 複 製 、 開 示 、 送 付 、 検 索 可 能 なシステムへの 保 存 、あるいは 人 またはコンピュータ 言 語 への 翻 訳 はしてはならない。
かかるプログラムと 関 連 ドキュメントについて 書 かれているインターシステムズ 社 の 標 準 ライセンス 契 約 に 記 載 されている 範 囲 を 除 き、ここに 記 載 さ
れた 本 ドキュメントとソフトウェアプログラムの 複 製 、 使 用 、 廃 棄 は 禁 じられている。インターシステムズ 社 は、ソフトウェアライセンス 契 約 に 記 載 され
ている 事 項 以 外 にかかるソフトウェアプログラムに 関 する 説 明 と 保 証 をするものではない。さらに、かかるソフトウェアに 関 する、あるいはかかるソフ
トウェアの 使 用 から 起 こるいかなる 損 失 、 損 害 に 対 するインターシステムズ 社 の 責 任 は、ソフトウェアライセンス 契 約 にある 事 項 に 制 限 される。
前 述 は、そのコンピュータソフトウェアの 使 用 およびそれによって 起 こるインターシステムズ 社 の 責 任 の 範 囲 、 制 限 に 関 する 一 般 的 な 概 略 である。 完
全 な 参 照 情 報 は、インターシステムズ 社 の 標 準 ライセンス 契 約 に 記 され、そのコピーは 要 望 によって 入 手 することができる。
インターシステムズ 社 は、 本 ドキュメントにある 誤 りに 対 する 責 任 を 放 棄 する。また、インターシステムズ 社 は、 独 自 の 裁 量 にて 事 前 通 知 なしに、 本 ド
キュメントに 記 載 された 製 品 および 実 行 に 対 する 代 替 と 変 更 を 行 う 権 利 を 有 する。
インターシステムズ 社 の 製 品 に 関 するサポートやご 質 問 は、 以 下 にお 問 い 合 わせください:
Tel:
Fax:
Email:
InterSystems Worldwide Customer Support
+1 617 621-0700
+1 617 374-9391
support@InterSystems.com

目 次
このドキュメントの 概 要 ...................................................................................................... 1
1 DTL 変 換 による 作 業 ..................................................................................................... 3
1.1 データ 変 換 ウィザードの 使 用 .................................................................................. 3
1.1.1 DTL クラスのパラメータ ................................................................................ 5
1.2 データ 変 換 のテスト .............................................................................................. 5
1.3 データ 変 換 リスト .................................................................................................. 6
2 データ 変 換 ビルダの 使 用 ............................................................................................... 7
2.1 変 換 のプロパティの 編 集 ....................................................................................... 9
2.2 アクションの 追 加 ................................................................................................ 10
2.2.1 Assign 文 の 構 築 ........................................................................................ 11
2.2.2 if 文 の 作 成 ............................................................................................... 14
2.2.3 for each 文 の 構 築 ...................................................................................... 15
2.2.4 ネストされたプロパティでの 作 業 ................................................................... 15
2.3 スタジオでの DTL 編 集 に 関 する 注 意 事 項 ............................................................. 17
2.3.1 DTL コードの 編 集 ..................................................................................... 17
2.3.2 DTL コードの 表 示 の 切 り 替 え ....................................................................... 17
3 DTL ドキュメント .......................................................................................................... 19
3.1 DTL ドキュメントの 構 造 ....................................................................................... 19
3.2 DTL ドキュメントの 構 文 規 則 ................................................................................. 22
3.2.1 REPORTERRORS パラメータの 使 用 法 .......................................................... 22
3.2.2 検 証 ........................................................................................................ 22
3.2.3 スクリプト 言 語 ............................................................................................ 23
3.2.4 真 と 偽 ...................................................................................................... 23
3.2.5 メッセージ・プロパティ 構 文 .......................................................................... 23
3.2.6 リテラル 文 字 列 .......................................................................................... 25
3.2.7 XML エンティティ ....................................................................................... 25
3.2.8 数 字 のコード ............................................................................................. 25
3.2.9 関 数 ........................................................................................................ 25
3.3 DTL 要 素 のタスク 別 リスト ..................................................................................... 26
3.3.1 データ 変 換 ............................................................................................... 26
3.3.2 データ 操 作 ............................................................................................... 26
3.3.3 コントロール・フロー .................................................................................... 26
3.3.4 ユーザ 記 述 コード ...................................................................................... 27
3.3.5 ロギング ................................................................................................... 27
3.4 DTL 要 素 の 構 文 規 則 ......................................................................................... 27
索 引 ............................................................................................................................ 29
DTL 変 換 の 開 発
iii

図 一 覧
図 1–1: DTL 変 換 テスト・ウィンドウ ..................................................................................... 5
図 2–1: データ 変 換 ビルダ — 変 換 ダイアグラムとアクション・リストのビュー ................................. 8
図 2–2: ソースからターゲットに 接 続 するコネクタ .................................................................. 12
図 2–3: リテラル 値 からターゲットのプロパティに 接 続 するコネクタ ........................................... 13
図 2–4: ソース・プロパティから if 文 に 接 続 するコネクタ ........................................................ 14
図 2–5: ソース・プロパティから foreach 文 に 接 続 するコネクタ ................................................ 15
図 2–6: ソースからターゲットの 親 プロパティに 接 続 するコネクタ ............................................. 15
図 2–7: ソースからターゲットのネストされたプロパティに 接 続 するコネクタ ................................ 16
図 2–8: 2 つの 同 じ 親 プロパティ 間 の 接 続 .......................................................................... 17
図 2–9: データ 変 換 ビルダのクラス・コード・ビュー ............................................................... 18
図 2–10: データ 変 換 ビルダの 生 成 コード・ビュー ................................................................. 18
図 3–1: DTL プログラム・リスト .......................................................................................... 20
図 3–2: データ 変 換 ビルダ .............................................................................................. 21
iv
DTL 変 換 の 開 発

テーブル 一 覧
テーブル 3–1: DTL 文 字 列 で 使 用 する XML エンティティ .................................................... 25
DTL 変 換 の 開 発
v

このドキュメントの 概 要
このドキュメントでは、データ 変 換 言 語 (DTL) を 使 用 して Ensemble データ 変 換 を 記 述 する 方 法 を 説 明 します。
このドキュメントの 内 容 は 次 のとおりです。
• “DTL 変 換 による 作 業 ”
• “データ 変 換 ビルダの 使 用 ”
• “DTL ドキュメント” では、DTL ドキュメントの 構 造 と 構 文 について 説 明 します。
詳 細 な 目 次 も 参 照 してください。
以 下 のドキュメントでは、 関 連 する 情 報 について 説 明 しています。
• "Ensemble プロダクションの 開 発 " では、“プロダクション・データ” の 章 に 背 景 情 報 を 記 載 しています。
• "Ensemble データ 変 換 言 語 リファレンス" では、DTL 要 素 について 個 別 に 説 明 します。
• "BPL プロセスの 開 発 " では、ビジネス・プロセス 言 語 (BPL) を 使 用 して Ensemble ビジネス・プロセスを 記 述 する 方
法 を 説 明 します。
• "Ensemble ビジネス・プロセス 言 語 (BPL) リファレンス" では、BPL 要 素 について 個 別 に 説 明 します。
DTL 変 換 の 開 発 1

1
DTL 変 換 による 作 業
データ 変 換 は、あるメッセージを 別 のメッセージに 変 換 するための 手 段 です。Ensemble データ 変 換 言 語 (DTL) を 使 用
すると、この 変 換 をグラフィカルに 実 行 できます。 管 理 ポータルの [[Ensemble] > [データ 変 換 ビルダ]] ページでは、これ
らのデータ 変 換 クラスを 作 成 および 編 集 できます(スタジオで DTL クラスを 開 くと、データ 変 換 ビルダが 起 動 します。“ス
タジオでの DTL 編 集 に 関 する 注 意 事 項 ” の 節 を 参 照 してください)。
管 理 ポータルの [データ 変 換 ビルダ] ページに 移 動 すると、データ 変 換 ビルダが 開 いて、このネームスペース 内 で 最 後
に 操 作 した 変 換 が 表 示 されます。タイトル・バーの 左 側 にあるタブには、その 変 換 クラスの 名 前 が 表 示 されます。このネー
ムスペース 内 でこのページに 移 動 するのが 初 めての 場 合 は、 作 業 ペインは 空 であり、データ 変 換 ウィザードを 使 用 して
新 しい 変 換 を 作 成 するか、データ 変 換 ビルダを 使 用 して 編 集 対 象 の 既 存 の 変 換 を 開 く 必 要 があります。
[データ 変 換 リスト] ページを 使 用 して、ネームスペース 内 の 特 定 のデータ 変 換 を 検 索 して 開 くこともできます。
1.1 データ 変 換 ウィザードの 使 用
データ 変 換 ウィザードを 使 用 すると、Ens.DataTransformDTL クラスから 継 承 した DTL データ 変 換 をすばやく 作 成 でき
ます。このウィザードには 以 下 のダイアログが 表 示 され、 作 成 する 変 換 の 予 備 的 特 性 を 定 義 できます。
DTL 変 換 の 開 発 3

DTL 変 換 による 作 業
以 下 のフィールドの 値 を 入 力 します。
[パッケージ]
[ 名 前 ]
説 明
[ソースタイプ]
パッケージ 名 を 入 力 するか、 矢 印 をクリックしてネームスペース 内 のパッケージのリストから 選 択 します。
このデータ 変 換 クラスの 名 前 を 入 力 します。
(オプション) データ 変 換 の 説 明 を 入 力 します。これはクラスの 説 明 として 使 用 されます。
[メッセージ] オプションをクリックしてメッセージ・クラス 名 を 入 力 するか、[ファインダダイアログ] を 使 用 してメッ
セージ・クラスを 選 択 します。 以 下 のタイプのいずれかをクリックして、 適 切 な [ソースクラス] を 事 前 に 選 択 しま
す。
• [HL7] — EnsLib.HL7.Message
• [X12] — EnsLib.EDI.X12.Document
• [ASTM] — EnsLib.EDI.ASTM.Document
• [EDIFACT] — EnsLib.EDI.EDIFACT.Document
• [XML] — EnsLib.EDI.XML.Document
[ソースクラス]
ソース・メッセージのクラス。このクラスによって、どのドキュメント・タイプが 存 在 するのか、および 何 らかのドキュ
メント・タイプが 存 在 するのかどうかが 特 定 されます。ソース・タイプとして [メッセージ] を 選 択 した 場 合 は、クラス
を 選 択 する 必 要 があります。 特 定 の 仮 想 ドキュメント・ソース・タイプを 選 択 した 場 合 は、ソース・クラスはあらかじ
め 入 力 されます。
[ソース・ドキュメント・タイプ]
該 当 する 場 合 は、ソース・メッセージのドキュメント・タイプを 入 力 または 選 択 します。このネームスペースにロー
ドされた 該 当 するスキーマで 定 義 されている 任 意 のタイプを 選 択 できます。
[ターゲットタイプ]
上 記 のソースの 各 フィールドの 説 明 に 従 ってオプションをクリックして、ターゲット・メッセージの 形 式 を 選 択 しま
す。
[ターゲットクラス]
ターゲット・メッセージのクラスを 入 力 または 選 択 します。
[ターゲット・ドキュメント・タイプ]
該 当 する 場 合 は、ターゲット・メッセージのドキュメント・タイプを 入 力 または 選 択 します。このネームスペースに
ロードされた 該 当 するスキーマで 定 義 されている 任 意 のタイプを 選 択 できます。
ウィザードを 完 了 すると、 新 しい 変 換 がデータ 変 換 ビルダに 表 示 されて、データ 変 換 の 詳 細 内 容 を 開 発 できるようになり
ます。
4 DTL 変 換 の 開 発

データ 変 換 のテスト
1.1.1 DTL クラスのパラメータ
デフォルトでは、DTL ウィザードによって、 以 下 に 示 すように 2 つのパラメータが 生 成 済 みの DTL に 設 定 されます。
• 以 下 のように、REPORTERRORS パラメータを 真 に 設 定 します。
Parameter REPORTERRORS = 1;
このパラメータの 値 によって、 変 換 を 実 行 する 際 に 生 じたエラーが 警 告 としてイベント・ログに 記 録 されます。また、す
べてのエラーを 戻 り 値 として 含 めている 複 合 ステータス・コードが 返 されます。
• 以 下 のように、IGNOREMISSINGSOURCE パラメータを 真 に 設 定 します。
Parameter IGNOREMISSINGSOURCE = 1;
このパラメータ 値 によって、DTL は、 存 在 しないソース・セグメントからフィールド 値 を 取 得 しようとすることことが 原 因
で 発 生 するエラーを 抑 制 します。また、DTL は、 指 定 されたソース・セグメントが 存 在 しない 場 合 、subtransform の 呼
び 出 しをスキップします。
必 要 に 応 じてテストと 条 件 付 きロジック 分 岐 を 含 めることにより、この 動 作 を 正 確 に 制 御 できます。
このパラメータの 値 を 変 更 するには、データ 変 換 ビルダの [ 変 換 ] タブにある [エラーの 報 告 ] および [ 存 在 しないソース・
セグメントを 無 視 ] の 各 チェックボックスのチェックを 外 すか、またはチェックを 付 けます。これらのチェックボックスについ
ては、チェックを 付 けることによってパラメータに 値 1 ( 真 ) が 設 定 されます。
1.2 データ 変 換 のテスト
データ 変 換 を 編 集 してコンパイルした 後 に、そのデータ 変 換 をテストできます。 変 換 テスト・ウィザードは、 管 理 ポータル
の 以 下 の 場 所 から 起 動 できます。
• データ 変 換 ビルダの [ツール] タブで [テスト] をクリックします。
• 変 換 を 選 択 して、[データ 変 換 リスト] ページで [テスト] をクリックします。
図 1–1: DTL 変 換 テスト・ウィンドウ
DTL 変 換 の 開 発 5

DTL 変 換 による 作 業
初 期 状 態 では [ 出 力 メッセージ] ウィンドウは 空 で、[ 入 力 メッセージ] ウィンドウにはソース・メッセージに 適 した 形 式 のテ
キスト・スケルトンが 入 力 されています。テストするには、 以 下 の 手 順 を 実 行 します。
1. 適 切 なデータが 含 まれるように、[ 入 力 メッセージ] を 編 集 します。この 入 力 ボックスに 表 示 される 内 容 と 入 力 する 内
容 は、 次 のようにソースのタイプとクラスに 応 じて 異 なります。
• HL7 やその 他 の EDI メッセージの 場 合 は、このウィンドウには 生 のテキストが 表 示 されます。したがって、いくつ
かの 保 存 されたテキスト・ファイルを 用 意 し、これらのファイルから [ 入 力 メッセージ] ボックスにテキストをコピー・
アンド・ペーストできるようにします。
• 通 常 の Ensemble メッセージの 場 合 は、このウィンドウには、メッセージ・オブジェクト 内 の 各 プロパティのエントリ
を 持 つ XML スケルトンが 表 示 されます。したがって、 各 プロパティの 値 を 入 力 します。
2. [テスト] をクリックします。
3. [ 出 力 メッセージ] ボックスで 結 果 を 確 認 します。
1.3 データ 変 換 リスト
[[Ensemble] > [データ 変 換 リスト]] ページには、アクティブな Ensemble ネームスペースで 定 義 されているデータ 変 換 ク
ラスのリストが 表 示 されます。このページに 移 動 するには、Ensemble の [リスト] メニューで [データ 変 換 ] 項 目 をクリックし
ます。
DTL 変 換 は 青 色 で 表 示 されます。DTL 変 換 をダブルクリックすると、その DTL 変 換 がデータ 変 換 ビルダ 内 に 開 かれま
す。 黒 色 で 表 示 された 変 換 は、Ens.DataTransform から 派 生 したものです。これらの 変 換 はデータ 変 換 ビルダを 使 用 し
て 編 集 できないため、スタジオで 編 集 する 必 要 があります。
変 換 クラスを 選 択 することで、その 変 換 クラスをリボン・バーにある 以 下 のコマンドのいずれかのターゲットにできます。
• [ 編 集 ] — (DTL 変 換 のみ) データ 変 換 ビルダを 使 用 してデータ 変 換 を 変 更 または 表 示 できます。
• [テスト] — 変 換 テスト・ウィザードを 使 用 して 選 択 した 変 換 クラスをテストできます。
• [ 削 除 ] — 選 択 した 変 換 クラスを 削 除 できます。
• [エクスポート] — 選 択 した 変 換 クラスを XML ファイルにエクスポートできます。
• [インポート] — XML ファイルにエクスポートされたデータ 変 換 をインポートできます。
Ensemble の 他 のクラスと 同 じように、データ 変 換 クラスをエクスポートおよびインポートすることもできます。 管 理 ポータル
の [[システム] > [グローバル]] ページを 使 用 することも、スタジオの [ツール] メニューにある [エクスポート] コマンドや
[インポート] コマンドを 使 用 することもできます。
6 DTL 変 換 の 開 発

2
データ 変 換 ビルダの 使 用
管 理 ポータルまたはスタジオで DTL データ 変 換 を 開 くとき、またはウィザードを 使 用 して 新 しい DTL データ 変 換 を 作 成
するときは、データ 変 換 ビルダが 開 きます。
Ensemble の [データ 変 換 ビルダ] ページのリボン・バーには、 以 下 のオプションとコマンドが 表 示 されます。
コマンド
表 示
[ 新 規 作 成 ]
[ 開 く]
[ 保 存 ]
[ 名 前 を 付 けて
保 存 ]
[コンパイル]
100%
[アクション 追
加 ]
説 明
希 望 のビューをクリックします。 変 換 ダイアグラムとアクション・リストの 両 方 をページの 左 ペインに
表 示 することも、 不 要 なセクションを 非 表 示 にすることもできます。
データ 変 換 ウィザードを 起 動 して、 新 しい DTL データ 変 換 を 作 成 できます。
[ファインダダイアログ] を 起 動 してロードする 既 存 の DTL データ 変 換 クラスを 選 択 し、データ 変 換
ビルダを 使 用 して 編 集 を 開 始 できます。
データ 変 換 に 加 えた 変 更 内 容 を 保 存 できます。
編 集 中 のデータ 変 換 に 加 えた 変 更 内 容 を 新 しい DTL データ 変 換 クラスとして 保 存 できます。
DTL データ 変 換 をコンパイルできます。
リストからパーセンテージ 値 を 選 択 することで、DTL 変 換 ダイアグラムのサイズを 縮 小 または 拡 大
できます。
アクションを 変 換 に 追 加 できます (“アクションの 追 加 ” の 節 を 参 照 )。
選 択 したアクションをアクション・リストから 削 除 できます。
直 前 に 実 行 したアクションを 取 り 消 すことができます。
左 ペインは、ダイアグラム・エディタとその 下 にあるアクション・リストで 構 成 されています。
DTL 変 換 の 開 発 7

データ 変 換 ビルダの 使 用
図 2–1: データ 変 換 ビルダ — 変 換 ダイアグラムとアクション・リストのビュー
図 の 中 で、ソース ( 入 力 ) オブジェクトは 左 側 に、ターゲット ( 出 力 ) オブジェクトは 右 側 に 表 示 されます。 各 列 ヘッダには、
関 連 付 けられたメッセージ・クラスが 一 覧 表 示 され、 該 当 する 場 合 はスキーマ・カテゴリとメッセージ 構 造 も 一 覧 表 示 され
ます。
各 列 の 左 にある 位 置 コントローラを 使 用 して、ダイアグラムの 内 容 をスクロールできます。
この 方 法 によって、 各 列 を 個 別 にスクロールできます。コントローラの 2 つ 矢 印 の 間 をクリックして、ダイアグラムのその 側
面 のスクロールをリセットすることもできます。 別 の 方 法 として、 列 の 背 景 をクリックして、マウスを 上 下 にドラッグすることで
ダイアグラムの 内 容 を 移 動 することもできます。この 場 合 は、 列 の 内 容 がドラッグの 方 向 に 移 動 します。
列 の 間 の 線 によって、 中 央 の 仕 切 りをまたいでソース・オブジェクトとターゲット・オブジェクトが 接 続 されます。DTL ダイ
アグラムの 各 コネクタは、DTL コードの 、、または 文 に 対 応 します。これらの 文 の 全 体 的 な 目 的
は、 以 下 のとおりです。
1. 変 換 するソース・プロパティを 指 定 する
2. ( 必 要 に 応 じて) ソース・プロパティの 演 算 を 実 行 する
3. 結 果 をターゲット・プロパティにコピーする
左 ペインの 下 部 には、アクション・リストが 含 まれています。このリスト 内 のアクションは、 変 換 内 の 実 行 順 序 に 従 って 表 示
されます。アクションを 選 択 すると、そのアクションのプロパティが [アクション] タブに 表 示 されます。 詳 細 は、“アクション
の 追 加 ” の 節 を 参 照 してください。
エディタには、 以 下 のテーブルに 示 すような [アクション] リストを 管 理 するツールが 用 意 されています。
8 DTL 変 換 の 開 発

変 換 のプロパティの 編 集
ツール
説 明
選 択 したアクションを 1 つ 上 の 位 置 に 移 動 します。そのアクションが for each ブロックまたは if ブロッ
クで 最 初 の 位 置 にある 場 合 は、 上 に 移 動 してブロックの 外 に 表 示 されます。
選 択 したアクションを 1 つ 下 の 位 置 に 移 動 します。そのアクションが for each ブロックまたは if ブロッ
クで 最 後 の 位 置 にある 場 合 は、endif アクションまたは endeach アクションの 直 後 に 移 動 します。その
アクションが else の 直 前 の if ブロックで 最 後 の 位 置 にある 場 合 は、else ブロックの 最 初 の 位 置 に 移 動
します。
選 択 したアクションを 現 在 の for each ブロックまたは if ブロックの 外 に 移 動 します。これによって、アク
ションは 現 在 のブロックから for each ブロックまたは if ブロックの 直 前 の 位 置 に 移 動 します。( 該 当 する
for each アクションと endeach アクションの 間 にあるアクションのみ、または if アクションと endif アク
ションの 間 にあるアクションのみに 適 用 できます。)
選 択 したアクションを 次 の for each ブロックまたは if ブロックの 中 に 移 動 します。( 現 在 のアクションの
直 後 にあるアクションが for each または if の 場 合 のみ 使 用 可 能 です。)
データ 変 換 のすべてのアクションを 削 除 します。
この 行 のアクションを 削 除 します。
データ 変 換 ビルダの 右 ペインには、 以 下 のタブが 含 まれています。これらのタブは、ペイン 上 部 の 二 重 矢 印 をクリックす
ることで 表 示 または 非 表 示 にできます。
• [ 変 換 ] — このタブでは 変 換 のプロパティを 編 集 できます。
• [アクション] — このタブでは 選 択 したアクションのプロパティを 編 集 できます。
• [ツール] — このタブではデータ 変 換 をテストできます。
次 のいくつかのトピックでは、DTL 変 換 の 文 とプロパティを 追 加 および 編 集 する 方 法 を 説 明 します。
2.1 変 換 のプロパティの 編 集
[ 変 換 ] タブでは、データ 変 換 全 体 の 詳 細 を 編 集 できます。
[ 名 前 ]
[ 作 成 ]
DTL データ 変 換 クラスの 読 み 取 り 専 用 の 名 前 。
以 下 のいずれかを 選 択 します。
• new — データ 変 換 内 の 要 素 を 実 行 する 前 に、このターゲット・タイプの 新 しいオブジェクトを 作 成 します。こ
れがデフォルトです。
• copy — 変 換 内 の 要 素 を 実 行 する 前 に、ターゲット・オブジェクトとして 使 用 するソース・オブジェクトのコピー
を 作 成 します。
• existing — データ 変 換 の 呼 び 出 し 側 により 指 定 される 既 存 のオブジェクトをターゲット・オブジェクトとし
て 使 用 します。
DTL 変 換 の 開 発 9

データ 変 換 ビルダの 使 用
[ソースクラス]
ソース・メッセージのクラス。このクラスによって、どのドキュメント・タイプが 存 在 するのか、および 何 らかのドキュ
メント・タイプが 存 在 するのかどうかが 特 定 されます。
[ソースドキュメントタイプ]
該 当 する 場 合 は、ソース・メッセージのドキュメント・タイプを 入 力 または 選 択 します。このネームスペースにロー
ドされた 該 当 するスキーマで 定 義 されている 任 意 のタイプを 選 択 できます。
[ターゲットクラス]
ターゲット・メッセージのクラスを 入 力 または 選 択 します。
[ターゲットドキュメントタイプ]
[ 言 語 ]
[エラーの 報 告 ]
該 当 する 場 合 は、ターゲット・メッセージのドキュメント・タイプを 入 力 または 選 択 します。このネームスペースに
ロードされた 該 当 するスキーマで 定 義 されている 任 意 のタイプを 選 択 できます。
DTL の 要 素 内 で 使 用 している 言 語 を 入 力 します。Caché Basic または ObjectScript を 入 力 できます。
デフォルトの 言 語 は ObjectScript です。
前 章 の “DTL クラスのパラメータ” を 参 照 してください。
[ 存 在 しないソース・セグメントを 無 視 ]
[ 説 明 ]
前 章 の “DTL クラスのパラメータ” を 参 照 してください。
(オプション) 変 換 の 説 明 を 入 力 します。この 入 力 値 は、 タグの 子 である タグの 内 容 と
して 使 用 されます。
2.2 アクションの 追 加
データ 変 換 内 では、さまざまなタイプのアクションの 順 序 付 きセットを 定 義 できます。[アクション 追 加 ] リストは、 以 下 のテー
ブルに 示 すように、 追 加 するアクションのタイプに 分 割 されています。
アクションの 割 り 当 て
最 初 のアクション・セットは 文 の 操 作 です。
アクション
set
clear
remove
append
insert
説 明
ターゲット・プロパティの 値 を 設 定 します。
ターゲット・プロパティの 値 をクリアします。
ターゲット・プロパティからコレクション 項 目 を 削 除 します。
ターゲット・プロパティにコレクション 項 目 を 追 加 します。
ターゲット・プロパティにコレクション 項 目 を 挿 入 します。
10 DTL 変 換 の 開 発

アクションの 追 加
これらの 操 作 に 対 応 する [アクション] タブには、 追 加 の 属 性 である property、value、および key が 表 示 され
ます。このタブの 上 部 近 くの [ドキュメントを 参 照 ] をクリックすると、この 要 素 に 関 連 付 けられている 参 照 ページが 表 示 さ
れます。
このタイプのアクションの 追 加 に 関 する 詳 細 な 指 示 は、“Assign 文 の 構 築 ” を 参 照 してください。
コード・ブロック・アクション
以 下 のコード・ブロック・アクションを 変 換 に 追 加 できます。
アクション
if
for each
説 明
条 件 を 評 価 します。 詳 細 は、“If 文 の 構 築 ” を 参 照 してください。
コレクションの 内 容 をループ 処 理 します。 詳 細 は、“For Each 文 の 構 築 ” を 参 照 してください。
追 加 の 文
以 下 の 文 を 変 換 に 追 加 することもできます。
アクション
code
sql
trace
transform
説 明
カスタム・コードを 追 加 します。
SQL 文 を 追 加 します。
trace 文 を 追 加 します。
subtransform 文 を 追 加 します。
[アクション] タブの 上 部 近 くの [ドキュメントを 参 照 ] をクリックすると、この 要 素 に 関 連 付 けられている 参 照 ページが 表 示
されます。
Tipヒン
ト
以 下 に、ダイアグラムでのアクションの 編 集 に 関 するヒントを 示 します。
• ダイアグラムまたはリスト 内 でアクションを 選 択 する 際 、[アクション] タブを 使 用 すると、そのアクションのプロ
パティ・フィールドの 値 が 表 示 されます。[ドキュメントを 参 照 ] をクリックして、アクション 要 素 の 参 照 ページを
表 示 できます。
• データ 変 換 ビルダでアクションを 追 加 する 際 、ダブルクリックを 使 用 して 現 在 のアクションを 更 新 できます。
ソース 内 のフィールドをダブルクリックすると、エディタは 選 択 したアクションの 値 の 設 定 が 必 要 であると 解 釈
します。 同 様 に、ターゲット・フィールドをダブルクリックすると、エディタは 選 択 したアクションのターゲットの
設 定 が 必 要 であると 解 釈 します。
• assign アクションを 追 加 しようとする 前 に、 必 ずターゲット・プロパティを 選 択 してください。if アクションまたは
for each アクションを 追 加 する 前 に、ソース・プロパティを 選 択 してください。
2.2.1 Assign 文 の 構 築
様 々な 方 法 でターゲット・プロパティに 値 を 割 り 当 てることができます。 以 下 の 各 節 では、 使 用 可 能 なオプションと 特 殊 処
理 について 説 明 します。
• ソースからターゲットへの 値 のドラッグ
• ターゲットへのリテラル 値 の 割 り 当 て
• Assign 文 の 式 の 編 集
DTL 変 換 の 開 発 11

データ 変 換 ビルダの 使 用
2.2.1.1 ソースからターゲットへの 値 のドラッグ
データ 変 換 は、ソースのプロパティからターゲットのプロパティに 値 をコピーする set 文 でほとんどが 構 成 されま
す。 新 しい 文 を DTL データ 変 換 に 追 加 するには、ソースとターゲットとの 間 にコネクタをドラッグ・アンド・ドロッ
プするだけで 簡 単 に 実 行 できます。
1. ソース・プロパティの 右 にある 丸 いタブをクリックします。マウス・ボタンを 押 さえます。 画 面 には 以 下 のように 表 示 され
ます。
2. カーソルを、ターゲット・プロパティの 左 にある 三 角 形 のタブにドラッグします。これにより、ターゲット・プロパティの
ボックスの 色 が 変 化 します。 画 面 には 以 下 のように 表 示 されます。
3. 左 マウス・ボタンを 放 します。 画 面 には 以 下 のように 表 示 されます。
コネクタにより、ソース・プロパティからターゲット・プロパティに 線 が 描 画 され、 中 央 の 仕 切 りに 固 定 ドットが 残 り
ます。 コネクタを 選 択 するには、 線 自 体 に 正 確 に “ 合 わせようと” するよりも、 固 定 ドットをクリックした 方 が 簡 単
です。 固 定 ドットをクリックすると、その 色 が 変 化 し、コネクタの 線 は 太 くなり、ソース・プロパティとターゲット・プロパティは
色 付 きでハイライト 表 示 されます。つまり、 以 下 の 図 のように コネクタが 選 択 されます。
図 2–2: ソースからターゲットに 接 続 するコネクタ
2.2.1.2 ターゲットへのリテラル 値 の 割 り 当 て
ターゲット・プロパティにリテラル 値 を 割 り 当 てることができます。そのためには、ターゲット・プロパティを 選 択 して、[アク
ション 追 加 ] リストで [set] をクリックします。この 操 作 の [アクション] タブが 表 示 されます。[ 値 ] フィールドにリテラルの 数
値 または 文 字 列 値 を 入 力 して、[ 保 存 ] をクリックします。
12 DTL 変 換 の 開 発

アクションの 追 加
リテラル 値 の 割 り 当 ては、 中 央 の 仕 切 り 内 の 四 角 形 によって 表 現 されます。 以 下 の 図 に 示 すように、コネクタはこの 四 角
いドットから 始 まりターゲット・プロパティで 終 わります。リテラル 割 り 当 てコネクタを 選 択 するには、この 四 角 形 をクリックし
ます。
図 2–3: リテラル 値 からターゲットのプロパティに 接 続 するコネクタ
2.2.1.3 Assign 文 の 式 の 編 集
データ 変 換 ビルダの [アクション 追 加 ] リストを 使 用 すると、 有 効 な 文 を 簡 単 に 作 成 できます。
重 要
[アクション 追 加 ] リストにある assign のオプションを 使 用 すると、 複 数 のソース・プロパティを 参 照 する 式
を [ 値 ] フィールドに 入 力 できます。これは、ドラッグ・アンド・ドロップを 使 用 して 単 一 のソース・プロパティ
の 値 を 単 一 のターゲット・プロパティに 割 り 当 てた 場 合 はできません。
[アクション] タブにある assign の 操 作 の [ 値 ] フィールドには、 以 下 を 入 力 できます。
• リテラル 値
• 関 数 呼 び 出 し
• ソース・プロパティの 名 前
• 以 上 の 任 意 の 組 み 合 わせ
[ 値 ] フィールドには 1 行 のテキストのみを 入 力 できます。これは、データ 変 換 のネイティブ・スクリプト 言 語 (ObjectScript
または Caché Basic) で 記 述 する 必 要 があります。ネイティブ・スクリプト 言 語 は、[ 変 換 ] タブの [ 言 語 ] フィールドで 指 定
します。
式 で Ensemble 関 数 を 使 用 するには、[ 値 ] フィールドの 横 にある
ます。このウィザードを 以 下 のように 使 用 します。
をクリックして、データ 変 換 関 数 ウィザードを 起 動 し
• ドロップダウン・リストから [ 関 数 ] を 選 択 すると、 関 数 の 定 義 に 必 要 な 詳 細 フィールドが 表 示 されます。このフィール
ドは、ダイアログのコンテキスト 依 存 ヘルプに 従 って 編 集 できます。
• 以 下 の 例 に 示 す ReplaceStr 関 数 は、Ensemble のデータ 変 換 およびビジネス・ルールで 使 用 可 能 ないくつかのユー
ティリティ 関 数 のうちの 1 つです。 詳 細 は、"Ensemble プロダクションの 開 発 " の “Ensemble プロダクション” の 章
の “ユーティリティ 関 数 ” の 節 を 参 照 してください。
• 変 更 内 容 を 保 存 する 場 合 は [OK] を、 保 存 せずにウィザードを 終 了 する 場 合 は [キャンセル] をクリックします。
DTL 変 換 の 開 発 13

データ 変 換 ビルダの 使 用
注 釈
これらの 指 示 はすべて、if アクションの [ 条 件 ] フィールドにも 当 てはまります。
2.2.2 if 文 の 作 成
DTL の 要 素 は、 論 理 式 で 構 成 される 条 件 を 評 価 します。この 式 の 結 果 は、 真 または 偽 です。 詳 細 は、 リファ
レンスのエントリを 参 照 してください。
データ 変 換 ビルダを 使 用 して if 文 を 構 築 できます。そのためには、ソース・プロパティを 選 択 して、[アクション 追 加 ] リス
トで [if] をクリックします。if 文 が 追 加 されると、DTL ダイアグラムには、ソース・プロパティを 始 点 とし、ソース・オブジェク
トとターゲット・オブジェクトの 間 の 中 央 の 仕 切 りにある 菱 形 を 終 点 とするコネクタが 表 示 されます。if アクションを 選 択 す
るには、この 菱 形 をクリックします。
図 2–4: ソース・プロパティから if 文 に 接 続 するコネクタ
if ブロックはアクション・リストの 末 尾 に 表 示 されます。このブロックには、else 文 と endif 文 が 含 まれています。if 文 を 構 築
するには、 以 下 の 手 順 を 実 行 します。
• set アクションの [ 値 ] の 式 を 入 力 する 場 合 と 同 じ 方 法 で、[ 条 件 ] を [アクション] タブに 入 力 します。 詳 細
は、“assign 文 の 式 の 編 集 ” の 節 を 参 照 してください。
• 文 を if ブロックに 追 加 するには ( 条 件 が 真 の 場 合 に 実 行 します)、if 文 をクリックして、 該 当 するアクションを 追 加 しま
す。assign 文 の 追 加 は、ドラッグ・アンド・ドロップ、 式 、リテラル 割 り 当 てなど、アクションの 追 加 のトピックで 説 明 のあ
るテクニックを 使 用 して 行 います。 追 加 の if 文 または for each 文 も 同 様 に 追 加 できます。
文 を 追 加 すると、DTL ダイアグラムにコネクタが 表 示 され、アクション・リストの if ブロックの 中 に DTL 文 が 表 示 され
ます。
• 文 を else ブロックに 追 加 するには ( 条 件 が 偽 の 場 合 に 実 行 します)、else 文 をクリックします。 追 加 したアクションは
いずれも、else 文 と endif 文 の 間 に 表 示 されます。
14 DTL 変 換 の 開 発

アクションの 追 加
2.2.3 for each 文 の 構 築
要 素 により、コレクション 内 の 要 素 ごとに 一 度 ずつ、または HL7 ドキュメントなどにある 繰 り 返 しプロパティに 対
して 繰 り 返 し 実 行 される 一 連 のアクティビティが 定 義 されます。 詳 細 は、 リファレンスのエントリを 参 照 してくださ
い。
データ 変 換 ビルダを 使 用 して for each 文 を 構 築 できます。そのためには、ソース・メッセージでコレクションまたは 繰 り 返
しプロパティを 選 択 して、[アクション 追 加 ] リストで [for each] をクリックします。このコード・ブロックに 対 して [アクション]
タブが 表 示 されます。
for each 文 が 追 加 されると、if コネクタと 同 様 に、ソース・プロパティを 始 点 とし、 菱 形 を 終 点 とするコネクタが DTL ダイア
グラムに 表 示 されます。
図 2–5: ソース・プロパティから foreach 文 に 接 続 するコネクタ
[プロパティ] フィールドには、 選 択 したソース・プロパティの 名 前 が 自 動 的 に 入 力 されます。 必 要 に 応 じて、[キー] 変 数
の 名 前 を 変 更 できます。
if ブロックはアクション・リストの 末 尾 に 表 示 されます。このブロックには、else 文 と endif 文 が 含 まれています。if 文 を 構 築
するには、 以 下 の 手 順 を 実 行 します。
for each ブロックは、 選 択 したアクションに 応 じてアクション・リストに 表 示 されます。このブロックは、endeach 文 で 終 了 し
ます。 文 を for each ブロックに 追 加 するには、for each 文 をクリックして、 該 当 するアクションを 追 加 します。assign 文 の
追 加 は、ドラッグ・アンド・ドロップ、 式 、リテラル 割 り 当 てなど、アクションの 追 加 のトピックで 説 明 のあるテクニックを 使 用
して 行 います。 追 加 の if 文 または for each 文 も 同 様 に 追 加 できます。
文 を 追 加 すると、DTL ダイアグラムにコネクタが 表 示 され、アクション・リストの for each ブロックの 中 に DTL 文 が 表 示 さ
れます。
2.2.4 ネストされたプロパティでの 作 業
ネストされたプロパティ (サブプロパティ) は、 仮 想 ドキュメントの 中 にあります。 仮 想 ドキュメントは、 複 雑 で 構 造 化 された
データ (Electronic Data Interchange (EDI) 形 式 が 典 型 的 ) を 組 み 込 むために 使 用 されるメッセージ 本 文 のタイプです。
この 規 則 についての 詳 細 は、"Ensemble 仮 想 ドキュメント" を 参 照 してください。このトピックでは、データ 変 換 ビルダが
ネストされたプロパティを 処 理 する 方 法 について 説 明 します。
コネクタが 実 線 の 場 合 、そのダイアグラムには 、、または 文 に 含 まれる 実 際 のプロパティが 表 示
されていることを 意 味 します。コネクタの 片 側 または 両 側 が 点 線 の 場 合 、 点 線 が 表 示 されている 側 にネストされたサブプ
ロパティがあることを 意 味 します。
図 2–6: ソースからターゲットの 親 プロパティに 接 続 するコネクタ
このネストされたプロパティは、 親 プロパティ 名 の 横 にある 展 開 アイコンをクリックすると、 表 示 することができます。 親
プロパティが 展 開 されている 場 合 は、 の 収 縮 アイコンが 表 示 されます。このアイコンをクリックすると、サブプロパティ
のリストを 非 表 示 にすることができます。 展 開 していたプロパティを 収 縮 させると、グレー 表 示 の 展 開 アイコン が 表 示
されます。
DTL 変 換 の 開 発 15

データ 変 換 ビルダの 使 用
図 2–7: ソースからターゲットのネストされたプロパティに 接 続 するコネクタ
2.2.4.1 すべてのネストされたプロパティの 割 り 当 て
ソースとターゲットの 親 プロパティが 同 じ 場 合 、すべてのネストされたサブプロパティの 値 を 一 度 に 割 り 当 てることができま
す。その 場 合 、 親 プロパティを 展 開 してサブプロパティを 表 示 する 必 要 はありません。ソース 側 の 親 プロパティからター
ゲット 側 の 親 プロパティにカーソルをドラッグするだけです。
以 下 の DTL ダイアグラムでは、ソース 側 とターゲット 側 の EVN プロパティ 間 の 1 つのコネクタに 次 の EVN のサブプロ
パティのすべてが 含 まれます。
• EventTypeCode
• RecordedDateTime とそのすべてのサブプロパティ
• DateTimePlannedEvent とそのすべてのサブプロパティ
• EventReasonCode
• OperatorID、そのすべての 反 復 、およびそのすべてのサブプロパティ
• EventOccurred とそのすべてのサブプロパティ
16 DTL 変 換 の 開 発

スタジオでの DTL 編 集 に 関 する 注 意 事 項
図 2–8: 2 つの 同 じ 親 プロパティ 間 の 接 続
以 下 の 1 行 の DTL コードでこれと 同 じことを 行 います。
2.3 スタジオでの DTL 編 集 に 関 する 注 意 事 項
スタジオでのデータ 変 換 ビルダの 動 作 には、 以 下 の 相 違 点 があります。
2.3.1 DTL コードの 編 集
要 素 を 追 加 または 編 集 するには、スタジオ・ツールバーで [ 他 のコードを 表 示 ] をクリックして 表 示 される DTL コー
ド・ビューにコード 行 を 入 力 します。
スタジオ・ツールバーで
[コンパイル] を 選 択 した 場 合 も、ダイアグラム・ビューが 更 新 されます。
2.3.2 DTL コードの 表 示 の 切 り 替 え
データ 変 換 の DTL ダイアグラムを 表 示 しているときに、スタジオ・ツールバーで [ 他 のコードを 表 示 ] を 選 択 すると、
同 じデータ 変 換 の DTL クラス・ビューに 変 更 できます。その 結 果 は 以 下 の 図 のとおりです。DTL コードが、クラス・コー
ドの XData DTL ブロックの 中 に 表 示 されます。
DTL 変 換 の 開 発 17

データ 変 換 ビルダの 使 用
図 2–9: データ 変 換 ビルダのクラス・コード・ビュー
スタジオ・ツール・バーで
[コンパイル] を 選 択 すると、データ 変 換 に 対 して 生 成 されたクラス・コードを 表 示 できます。
( 前 の 図 にある) DTL クラス・コード・ビューから、 [ 他 を 表 示 ] を 選 択 します。 以 下 の 図 に 示 すように、データ 変 換 で 生
成 されたコードが 表 示 されます。
図 2–10: データ 変 換 ビルダの 生 成 コード・ビュー
注 釈
データ 変 換 ビルダ・ビュー、クラス・コード・ビュー、および 生 成 コード・ビューを 切 り 替 えるには、
ドを 表 示 ] を 繰 り 返 しクリックします。
[ 他 のコー
18 DTL 変 換 の 開 発

3
DTL ドキュメント
データ 変 換 言 語 (DTL) ドキュメントは、データ 変 換 を 定 義 する XML ドキュメントです。
DTL データ 変 換 の 主 な 目 的 は、 応 答 メッセージで 受 信 した 項 目 を、 継 続 要 求 メッセージの 発 行 に 必 要 なパラメータに 変
換 することです。つまり、"Ensemble プロダクションの 開 発 " の “Ensemble メッセージ” の 章 で 説 明 されているように、
データ 変 換 のソース・オブジェクトおよびターゲット・オブジェクトは、 通 常 、Ensemble メッセージ・オブジェクトです。
Ensemble メッセージは、メッセージ・ヘッダとメッセージ 本 文 オブジェクトで 構 成 されます。“メッセージを 変 換 ” する 際 、
データ 変 換 によってメッセージに 対 して 実 際 に 行 われることは、 古 いメッセージ 本 文 オブジェクト (ソース) をスワップアウ
トして 新 しいもの (ターゲット) に 交 換 することです。 以 下 の 変 換 は、このプロセス 中 に 行 われます。
• ソースのプロパティからターゲットのプロパティに 値 をコピーします。
• ソースのプロパティの 値 を 使 用 して 計 算 を 行 います。
• 計 算 結 果 をターゲットのプロパティにコピーします。
• ターゲットのプロパティにリテラル 値 を 割 り 当 てます。
• ソースのプロパティのうち、ターゲットに 関 連 がないものを 無 視 します。
この 章 では、DTL ドキュメントに 関 する 以 下 の 内 容 について 説 明 します。
• DTL ドキュメントの 構 造
• DTL ドキュメントの 構 文 規 則
• DTL 要 素 のタスク 別 リスト
• DTL 要 素 の 構 文 規 則
3.1 DTL ドキュメントの 構 造
DTL ドキュメントは、Ens.DataTransformDTL から 継 承 するクラスの XData DTL ブロック 内 に 配 置 する 必 要 があります 次
の 図 は、DTL ドキュメントの 簡 単 な 例 です。
DTL 変 換 の 開 発 19

DTL ドキュメント
図 3–1: DTL プログラム・リスト
上 の 図 内 の 番 号 (1、2、3 ~ 9) は、 以 下 のリスト 内 の 番 号 に 対 応 しています。
1. この DTL ドキュメントは、Demo.HL7.MsgRouter.ORMLastNameTransform というデータ 変 換 を 定 義 します。
2. この DTL ドキュメントは Ens.DataTransformDTL のサブクラスです。
3. DTL ドキュメントは、Ensemble クラスの XDATA (XML メタデータ) セクション 内 に 含 まれます。
含 まれているクラスをコンパイルすると、DTL コンパイラでは DTL ドキュメントが 検 証 および 解 析 され、データ 変 換
の 実 行 に 必 要 なコードを 含 むクラスが 生 成 されます。このメカニズムは、DTL ドキュメントを XML コードとして 開 発
する 場 合 も、データ 変 換 ビルダを 使 用 して 開 発 する 場 合 も 変 わりません。
4. このデータ 変 換 は、targetClass が EnsLib.HL7.Message であるオブジェクトに 記 述 します。このオブジェクトは、
targetDocType で 識 別 されるドキュメント 構 造 に 適 合 する 仮 想 ドキュメントです。
5. このデータ 変 換 は、sourceClass が EnsLib.HL7.Message であるオブジェクトからプロパティ 値 を 取 得 します。このオ
ブジェクトは、sourceDocType で 識 別 されるドキュメント 構 造 に 適 合 する 仮 想 ドキュメントです。
6. ターゲット・オブジェクトの create オプションには、 以 下 の 値 のいずれかを 指 定 できます。
• new — データ 変 換 内 の 要 素 を 実 行 する 前 に、ターゲット・タイプの 新 しいオブジェクトを 作 成 します。これがデ
フォルトです。
• copy — 変 換 内 の 要 素 を 実 行 する 前 に、ターゲット・オブジェクトとして 使 用 するソース・オブジェクトのコピーを
作 成 します。
• existing — ターゲット・オブジェクトとしてデータ 変 換 の 呼 び 出 し 側 により 指 定 される 既 存 のオブジェクトを 使
用 します。
7. このデータ 変 換 内 の 任 意 の 式 およびコード・ブロックに 使 用 される language は、ObjectScript です。
8. このデータ 変 換 の 主 要 部 分 は、ソース・オブジェクト 内 のプロパティから 値 を 取 得 し、ターゲット・オブジェクト 内 のプ
ロパティに 値 を 割 り 当 てます。このプロセスの 一 部 として、ソース・オブジェクト 内 で 見 つかった 値 に 基 づき、 論 理 的
または 反 復 的 なオペレーションを 実 行 できます。この 章 の 以 降 のトピックで 詳 細 を 説 明 します。
9. 要 素 内 で、 予 約 語 source および target は、データ 変 換 のソース・オブジェクトおよびターゲット・オブ
ジェクトを 参 照 します。
20 DTL 変 換 の 開 発

DTL ドキュメントの 構 造
スタジオで DTL データ 変 換 を 開 くと、データ 変 換 ビルダに DTL ドキュメントのダイアグラム 表 現 が 表 示 されます。ダイア
グラムの 中 で、ソース ( 入 力 ) オブジェクトは 左 側 に、ターゲット ( 出 力 ) オブジェクトは 右 側 に 表 示 されます。ダイアグラム
中 のソース・オブジェクトとターゲット・オブジェクトのプロパティ 間 の 各 コネクタは、ソースのプロパティをターゲットのプロ
パティに 割 り 当 てる DTL コード 内 の 文 に 対 応 します。ダイアグラムの 下 には、アクションのリストが 実 行 順 に 表 示 されま
す。
以 下 のダイアグラムは、データ 変 換 クラス Demo.HL7.MsgRouter.ORMLastNameTransform のデータ 変 換 ビルダ・ビュー
を 示 しています。これは、 上 の "DTL プログラム・リスト" の 図 で 示 しているデータ 変 換 と 同 じものです。
図 3–2: データ 変 換 ビルダ
各 列 の 左 にある 位 置 コントローラを 使 用 して、ダイアグラムの 内 容 をスクロールできます。
この 方 法 でスクロールすると、 各 列 が 個 別 に 実 行 されます。コントローラの 2 つ 矢 印 の 間 をクリックして、ダイアグラムのそ
の 側 面 のスクロールをリセットすることもできます。また、 列 の 背 景 をクリックし、マウスを 上 下 にドラッグすることによって、
ダイアグラムの 内 容 を 移 動 することもできます。ドラッグした 方 向 に 列 の 内 容 が 移 動 します。
スタジオでデータ 変 換 ビルダを 表 示 しているときに、スタジオ・ツールバーの [ 他 のコードを 表 示 ] をクリックすることによっ
て、 同 じデータ 変 換 の DTL クラス・ビューに 変 更 できます。DTL クラス・ビューから [ 他 のコードを 表 示 ] を 再 びクリックす
ることによって、 生 成 されたデータ 変 換 後 のクラス・コードを 表 示 できます。
DTL 変 換 の 開 発 21

DTL ドキュメント
3.2 DTL ドキュメントの 構 文 規 則
すべての DTL ドキュメントには、 以 下 の 共 通 した 構 文 規 則 があります。
Class MyPackage.MyDTL Extends Ens.DataTransformDTL
{
Parameter REPORTERRORS = 1;
XData DTL [ XMLNamespace = "http://www.intersystems.com/dtl" ]
{
This is a comment for the assign element
}
}
3.2.1 REPORTERRORS パラメータの 使 用 法
Ens.DataTransformDTL クラスではパラメータ REPORTERRORS=0 が 宣 言 されるため、Ensemble は 変 換 エラーを 通 知
せずに、xform カテゴリのトレース・メッセージとしてログに 記 録 します。
DTL クラスを 作 成 するときには、このパラメータを REPORTERRORS=1 にオーバーライドして、Ensemble での 変 換 の 実
行 中 に 発 生 したすべてのエラーが 警 告 としてイベント・ログに 記 録 され、すべてのエラーを 示 す 複 合 ステータス・コードが
戻 り 値 として 返 されるようにします。 付 属 のウィザードを 使 用 して DTL データ 変 換 クラスを 作 成 する 場 合 は、この 設 定 が
自 動 的 に 行 われます。
3.2.2 検 証
DTL ドキュメントは、 適 切 に 構 成 され、DTL スキーマで 指 定 された 検 証 ルールに 一 致 する 必 要 があります。 一 致 しない
場 合 、そのドキュメントは DTL コンパイラによって 拒 否 され、エラー・メッセージが 表 示 されます。
DTL 構 文 の 入 力 時 にはスタジオ・アシスト (ワード・コンプリート 機 能 ) が 役 立 ちます。
1. スタジオを 起 動 します。
2. DTL データ 変 換 クラスを 開 きます。
3. 以 下 のように、XData DTL ブロックに 適 切 な XMLNamespace パラメータが 設 定 されていることを 確 認 します。
XData DTL [ XMLNamespace = "http://www.intersystems.com/dtl" ]
{
}
4. XData DTL で、 と の 間 にカーソルを 置 きます。
5. 入 力 を 開 始 します。 意 味 のある 最 初 の 文 字 を 入 力 すると、そのコンテキストに 適 した DTL 要 素 と 属 性 のリストが 表 示
されます。
6. このリストから 項 目 を 選 択 するには、 目 的 の 項 目 をクリックして Enter キーを 押 します。
22 DTL 変 換 の 開 発

DTL ドキュメントの 構 文 規 則
7. 完 全 な 単 語 がコードに 自 動 的 に 追 加 されます。
注 釈
XML についての 知 識 のあるユーザは、DTL スキーマを 表 示 できます。スタジオを 起 動 して Ensemble ネーム
スペースに 移 動 し、[プロダクション] タブをクリックします。[ファイル] メニューの [ 開 く] オプションを 選 択 して、ク
ラス Ens.Schema.DTL を 選 択 してください。
3.2.3 スクリプト 言 語
DTL ドキュメントは、1 つの 実 行 可 能 クラスにコンパイルされます。DTL 開 発 者 がこのしくみを 意 識 することはほとんどあ
りませんが、 以 下 の 場 合 は 例 外 です。この 場 合 、データ 変 換 の 実 行 に 使 用 する 言 語 を 認 識 する 必 要 があります。
• いずれかの 要 素 に、 実 行 時 に 評 価 される 式 が 含 まれている 場 合 。
• データ 変 換 にユーザ 記 述 のコードを 挿 入 する 要 素 が 使 用 されている 場 合 。
データ 変 換 用 のスクリプト 言 語 は、 要 素 の language 属 性 で 指 定 されます。 値 "basic" は Caché Basic を
表 し、 値 "objectscript" は ObjectScript を 表 します。 指 定 しない 場 合 は、デフォルトの ObjectScript が 使 用 されま
す。MVBasic はサポートされません。データ 変 換 内 のすべての 式 、および 要 素 内 のコード 行 は、 指 定 の 言 語 で
記 述 されている 必 要 があります。
これらの Caché プログラミング 言 語 の 詳 細 は、 以 下 のドキュメントを 参 照 してください。
• Caché ObjectScript の 使 用 法
• Caché ObjectScript リファレンス
• Caché Basicの 使 用 法
• Caché Basic リファレンス
3.2.4 真 と 偽
一 部 の DTL 属 性 では、Ensemble の 表 記 規 則 に 従 ってブーリアン 値 を 指 定 できます。つまり、 整 数 値 1 は 真 、 整 数 値
0 は 偽 を 意 味 します。DTL ソース・コードで、async などのブーリアン 属 性 を 真 に 設 定 するときは、 以 下 の 2 種 類 の 表 記
法 のいずれかを 使 用 できます。
async='1'
async='true'
同 様 に、async を 偽 に 設 定 するときは、 以 下 の 2 種 類 の 表 記 法 のいずれかを 使 用 できます。
async='0'
async='false'
3.2.5 メッセージ・プロパティ 構 文
"Ensemble プロダクションの 開 発 " の “Ensemble メッセージ” の 章 で 説 明 されているように、データ 変 換 のソース・オブ
ジェクトおよびターゲット・オブジェクトは、 通 常 、Ensemble メッセージ 本 文 オブジェクトです。これらのオブジェクトは、 以
下 のいずれかの 一 般 タイプになります。
• 標 準 の Ensemble メッセージ 本 文 オブジェクト
• 仮 想 ドキュメント
• 永 続 オブジェクト
• シリアル・オブジェクト
DTL 変 換 の 開 発 23

DTL ドキュメント
このトピックでは、DTL データ 変 換 を 使 用 して、さまざまな 種 類 のメッセージ 本 文 オブジェクトのプロパティにアクセスし、
それらを 変 更 する 方 法 を 説 明 します。
3.2.5.1 オブジェクトのプロパティ
標 準 の Ensemble メッセージ 本 文 は、メッセージ・データを 含 むプロパティを 定 義 することで、 組 み 込 みメッセージ 本 文 ク
ラス (Ens.Request または Ens.Response) を 拡 張 します。これらのオブジェクトのプロパティを 参 照 するには、 通 常 のドッ
ト 構 文 を 使 用 します。 以 下 に 例 を 示 します。
Ensemble メッセージ 本 文 として 使 用 する 永 続 オブジェクトまたはシリアル・オブジェクトのプロパティを 参 照 するときも、 同
じドット 構 文 を 使 用 できます。
3.2.5.2 仮 想 ドキュメントのプロパティ
Ensemble には、 仮 想 ドキュメントと 呼 ばれる 別 の 種 類 のメッセージ 本 文 があります。 仮 想 ドキュメントは、HL7 や X12 な
どの Electronic Data Interchange (EDI) 形 式 で 使 用 するように 設 計 されています。 標 準 メッセージ 本 文 では、メッセージ
のコンテンツ 全 体 を 正 式 なプロパティ・セットとして 記 述 しなければなりませんが、 仮 想 ドキュメントを 使 用 すれば、サイズ
の 大 きい 複 雑 なドキュメントを Ensemble メッセージとして 記 述 できます。 代 わりに、メッセージ 本 文 内 の 単 一 のプロパティ
が、HL7 または X12 スキーマ 定 義 を 指 定 します。
HL7 または X12 スキーマ 定 義 は XML スキーマと 同 じではありませんが、XML 形 式 で 記 述 されるスキーマです。 仮 想
ドキュメントのスキーマ 定 義 は、 目 的 のデータ 項 目 が 含 まれているメッセージ 本 文 を 指 定 します。このデータ 項 目 を 仮 想
プロパティと 呼 びます。 背 景 情 報 は、ドキュメント "Ensemble 仮 想 ドキュメント" を 参 照 してください。
DTL データ 変 換 内 から 仮 想 プロパティの 値 を 参 照 するには 2 つの 方 法 があります。 以 下 の 方 法 が 使 用 できます。
• DTL 要 素 、、、および で、 中 かっこ {} 構 文 を 使 用 します。 構 文 は 以 下 のとおりです。
myHL7Message.{myVirtualPropertyPath}
以 下 に 例 を 示 します。
• 、 など、その 他 の DTL 要 素 からインスタンス・メソッド GetValueAt または SetValueAt を 呼 び 出 します。
これらのメソッドは、 上 記 の 要 素 から 呼 び 出 すこともできます。 以 下 に 例 を 示 します。
詳 細 は、ドキュメント Ensemble 仮 想 ドキュメント の “ 仮 想 プロパティの 構 文 ” の 節 を 参 照 してください。
3.2.5.3 永 続 オブジェクトまたはシリアル・オブジェクトのプロパティ
メッセージ 本 文 は、 標 準 のメッセージ 本 文 や 仮 想 ドキュメントだけに 限 定 されているわけではありません。 任 意 の 永 続 オ
ブジェクトまたはシリアル・オブジェクトを 使 用 できます。これらのオブジェクトのプロパティを 参 照 するには、 通 常 のドット
構 文 を 使 用 します。 以 下 に 例 を 示 します。
注 釈
追 加 の 構 文 情 報 および 例 は、"Caché オブジェクトの 使 用 法 " の “Caché オブジェクト・モデル” の 章 にある
“クラスのタイプ” を 参 照 してください。
24 DTL 変 換 の 開 発

DTL ドキュメントの 構 文 規 則
3.2.6 リテラル 文 字 列
DTL では、 値 全 体 を 囲 む 引 用 符 とは 別 に、リテラル 文 字 列 値 を 別 の 引 用 符 で 囲 む 必 要 があります。 例 えば、 以 下 の 例
では、value='"ULTRA"' と 指 定 しています。したがって、 文 字 列 ULTRA がターゲット・メッセージの ReceivingApplication
フィールドに 挿 入 されます。value='ULTRA' および value="ULTRA" は 有 効 ではありません。
注 釈
DTL を 使 用 して HL7 仮 想 ドキュメントを 変 換 する 場 合 は、 特 別 な 考 慮 が 必 要 となります。"Ensemble 仮 想 ドキュ
メント" の “リテラル 文 字 列 の 構 文 ” の 節 を 参 照 してください。
3.2.7 XML エンティティ
DTL は XML を 拡 張 したものなので、DTL 文 内 の 一 部 の 文 字 を XML エンティティで 表 す 必 要 があります。 該 当 する 文
字 を 以 下 の 表 に 示 します。
テーブル 3–1: DTL 文 字 列 で 使 用 する XML エンティティ
文 字
>
<
&
'
"
XML エン
ティティ
&gt;
&lt;
&amp;
&apos;
&quot;
説 明
右 山 かっこ ( 大 なり) 記 号 。
左 山 かっこ ( 小 なり) 記 号 。
アンパサンド。
一 重 引 用 符 (アポストロフィ)。 一 重 引 用 符 で 囲 まれた 文 字 列 では、&apos; エンティティを 使
用 して ' 文 字 を 表 す 必 要 があります。
二 重 引 用 符 。 二 重 引 用 符 で 囲 まれた 文 字 列 では、&quot; エンティティを 使 用 して " 文 字 を
表 す 必 要 があります。
「Joe’s "Good Time" Bar & Grill」という 名 前 の 雇 用 者 のリテラル 文 字 列 を するには、DTL 文 で 次 の
構 文 を 使 用 する 必 要 があります。
この 制 約 は、DTL の 文 または 文 の 中 には 適 用 されません。
3.2.8 数 字 のコード
DTL のリテラル 文 字 列 内 では、 文 字 の 10 進 表 記 または 16 進 表 記 を 使 用 できます。
文 字 列 &#n; は Unicode 文 字 を 表 します (n は Unicode 文 字 の 10 進 数 )。 例 えば、&#233; は、 揚 音 アクセント 符 号 付
きのラテン 文 字 e (é) を 表 します。
また、 文 字 列 &#xh; も Unicode 文 字 を 表 します (h は 16 進 の Unicode 文 字 番 号 )。 例 えば、&#x00BF は 逆 さの 疑 問
符 (¿) を 表 します。
3.2.9 関 数
DTL データ 変 換 内 では、 式 には Ensemble ユーティリティ 関 数 の 1 つへの 呼 び 出 しを 含 めることができます。このような
関 数 には、 他 のプログラミング 言 語 で 使 い 慣 れている 数 学 的 な 処 理 関 数 または 文 字 列 処 理 関 数 などがあります。
DTL 変 換 の 開 発 25

DTL ドキュメント
以 下 の DTL 文 では、ユーティリティ 関 数 ToUpper を 使 用 して 文 字 列 をすべて 大 文 字 に 変 換 します。この
文 は、DTL データ 変 換 クラス 内 のメソッドのように、ダブルドット 構 文 を 使 用 して ToUpper を 参 照 します。
利 用 可 能 なユーティリティ 関 数 のリスト、およびビジネス・ルールまたは DTL データ 変 換 でそれらの 関 数 を 使 用 するため
の 適 切 な 構 文 は、“Ensemble プロダクションの 開 発 ” の “ 新 しいプロダクションの 作 成 ” の 章 にある “ユーティリティ 関
数 ” を 参 照 してください。この 節 では、カスタム・コードを 追 加 して、 一 連 の 組 み 込 みユーティリティ 関 数 を 拡 張 する 方 法
についても 説 明 します。
3.3 DTL 要 素 のタスク 別 リスト
ここでは、DTL 要 素 を 機 能 別 にグループ 化 し、 各 要 素 の 目 的 について 説 明 します。
• データ 変 換
• データ 操 作
• 制 御 フロー
• ユーザ 記 述 コード
• ロギング
3.3.1 データ 変 換
DTL ドキュメントは、1 つの 要 素 とそのさまざまな 子 要 素 で 構 成 されます。 要 素 は、データ 変
換 のコンテナです。 は、 完 全 なオブジェクトまたはメッセージ 上 で 機 能 します。Electronic Data Interchange
形 式 を 表 す 仮 想 ドキュメントの 場 合 、 はメッセージの 1 つのセグメントだけで 機 能 します。
3.3.2 データ 操 作
DTL には、データを 検 索 してそのデータをある 場 所 から 別 の 場 所 に 移 動 できる 要 素 があります。
• 要 素 は、ターゲット・プロパティとそのプロパティに 割 り 当 てる 式 の 指 定 に 使 用 されます。 通 常 、この 式 はソー
ス・オブジェクトのプロパティの 1 つに 対 して 実 行 され、その 結 果 ターゲット・オブジェクトの 1 つのプロパティの 値 が
決 定 されます。
• 要 素 を 使 用 すると、データ 変 換 内 から 埋 め 込 みの SQL SELECT 文 を 実 行 できます。
3.3.3 コントロール・フロー
DTL には、DTL データ 変 換 内 での 実 行 順 序 を 制 御 する、 制 御 フロー 要 素 があります。
• 要 素 は、 繰 り 返 し 実 行 される 一 連 のアクティビティを 定 義 します。
• 要 素 は、 条 件 を 評 価 し、 真 の 場 合 の 操 作 または 偽 の 場 合 の 操 作 を 実 行 します。
• 要 素 は、 別 のデータ 変 換 を 呼 び 出 します。
26 DTL 変 換 の 開 発

DTL 要 素 の 構 文 規 則
3.3.4 ユーザ 記 述 コード
DTL の 表 現 だけでは 特 定 の 問 題 を 解 決 できない 場 合 のために、Ensemble ではデータ 変 換 内 にユーザ 記 述 コードを 埋
め 込 むしくみが 用 意 されています。この 埋 め 込 みは、 要 素 および 選 択 されたスクリプト 言 語 を 使 用 して 行 われま
す。
3.3.5 ロギング
DTL 構 文 では、 要 素 を 使 用 して、コンソール・ウィンドウにテキスト・メッセージを 書 き 込 むことができます。
3.4 DTL 要 素 の 構 文 規 則
DTL 内 のほとんどの 要 素 は、 を 子 要 素 としてサポートしています。これにより、DTL 要 素 に 詳 しいコメント
を 関 連 付 けることができます。すべての 要 素 に 対 して 位 置 属 性 を 提 供 する BPL とは 異 なり、 は、ほとんど
の DTL 要 素 が 共 通 して 持 つ、 唯 一 の 子 要 素 または 属 性 です。 要 素 を 使 用 する 場 合 は、 注 釈 の 対 象 とな
る 要 素 の 最 初 の 子 として 挿 入 する 必 要 があります。
DTL 変 換 の 開 発 27

索 引
シンボル
エディタ
データ 変 換 ビルダ, 7
ツール
データ 変 換 ビルダ, 7
データ
変 換
ダイアグラム, 7
データ 変 換
インポートとエクスポート, 6
ビルダ
DTL, データ 変 換 , 7
D
DTL
グラフィック 規 則 , 7
ダイアグラム, 7
ビルダ, 7
S
SVG, 7
DTL 変 換 の 開 発 29