Mapperロジック

Mapperロジックとは

Mapperロジックとは、四則演算や文字置換などさまざまな値の変換や加工を行うことができる機能です。

Mapperロジックの使用方法

Mapperロジックの配置

Mapperロジックを使用する場合は、ツールパレットのロジックアイコンをマッピングキャンバスにドラッグ&ドロップします。

たとえば、入力データに数値「1.05」を加算し、出力するという処理の場合、以下のように設定します。

マッピングリンクのつなぎ方

Mapperロジックの入力ハンドラへリンクをつなぐ方法は、入力ハンドラの種類によって変わります。
Mapperロジックの出力は、ほかのロジックや出力スキーマの要素にリンクをつなぎます。

入力ハンドラへのリンク

各Mapperロジックの機能や入力ハンドラの情報については、各Mapperロジックのヘルプを参照してください。

Mapperロジックの設定

Mapperロジックの各プロパティ項目の設定は、プロパティ設定ダイアログまたはプロパティインスペクタから行います。

Mapperロジックの移動方法

マッピングキャンバスに配置されたMapperロジックは、アイコンをドラッグ&ドロップすることで、いつでも移動できます。
Mapperロジックがマッピングされている場合は、マッピングリンクも一緒に移動します。

右クリックメニュー

マッピングキャンバスに配置したMapperロジックは、右クリックメニューから以下の処理を行うことができます。
デザイナのメニューからも同様の処理を行うことができます。
項目の説明
項目名 説明 備考
切り取り ロジックアイコンの切り取りを行います。  
コピー ロジックアイコンのコピーを行います。  
削除 ロジックアイコンの削除を行います。  
配置 ロジックアイコンの並び替えを行います。
  • 左揃え
  • 右揃え
  • 上揃え
  • 下揃え
  • 左右に整列
  • 上下に整列
  • アイコン複数選択時のみ実行できます。
  • [左右に整列]および[上下に整列]は、3つ以上のアイコン選択時に実行できます。
貼り付け 切り取りした、またはコピーしたロジックアイコンの貼り付けを行います。  
プロパティ ロジックのプロパティ設定ダイアログを開きます。
  • アイコン単一選択時のみ実行できます。
ヘルプ ロジックのヘルプを開きます。  

Mapperロジックの仕様

Mapperロジックの種類

Mapperロジックには「繰り返し」「変換」の二種類があります。
種類はアイコンの左上のチップで判別できます。

ロジックの種類 チップ画像 パレットのタブ名
繰り返しロジック 繰り返しロジックを表すチップ 繰り返し
変換ロジック 変換ロジックを表すチップ 分岐
条件
数値
文字列
日付
Excel

通常、繰り返しロジックで分割したそれぞれのデータを変換ロジックで加工し、順に出力します。

変換ロジックのデータの型

変換ロジックの入出力ハンドラにはそれぞれ型が定められています。
入力ハンドラの型は、入力時に変換されるデータの型を意味し、出力データの型は、変換・加工の結果データの型を意味します。

通常、入力データの型と、ロジックの入力ハンドラの型が異なる場合、入力ハンドラの型へのキャスト(変換)が動的に行われます。
型のキャストを行うことができない(変換できない)場合には、実行時エラーが発生します。

実行時エラーの発生によるスクリプトの停止を防ぐには、あらかじめデータ自体のチェックを行うか、スクリプト上のMapperコンポーネントを例外監視処理で囲んでください。

変換ロジックの型

ロジックパレットは型により分類されており、型はアイコンの右下のチップで判別できます。

ロジックの型 内部データ型 チップ画像 パレットのタブ名
真偽値型 boolean 真偽値型を表すチップ 条件
数値型 BigDecimal 数値型を表すチップ 数値
文字列型 String 文字列型を表すチップ 文字列
日付型 Date 日付型を表すチップ 日付

数値型ロジックの内部データ型

Mapperで扱う数値型は、小数点も含むデータを正確に表現できるBigDecimal型で処理を行っています。
文字列型で数値演算が行われる場合、BigDecimal型に変換され処理を行います。
数値の小数点以下を切り捨てたい場合には、文字列のロジック「数値フォーマッティング」を使用してください。

各型を文字列型に変換した場合のフォーマット

ロジックの型またはスクリプト変数のデータ型を、文字列型にマッピングした場合のフォーマットは以下の通りです。

文字列型でのフォーマット
日付型 「yyyy-MM-dd'T'HH:mm:ss.SSSZZ」
バイナリ型 BASE64エンコード
数値型/整数型/10進数型 実数形式
真偽値型 「true」または「false」

日付型のフォーマットについては、「日時フォーマッティングのフォーマット」を参照してください。

nullが入力された場合

データベースアダプタなどのデータに、値が存在しないことを表すnullが入っていることがあります。
変換ロジックに入力されたnullは、以下の様に処理されます。
nullを表現できない出力先アダプタにnullを出力した場合、nullはアダプタ内で適切な表現に変換されます。
また、入力スキーマがテーブルモデル型で出力スキーマがXML型の場合、出力データにマッピングされた入力データのnull値は、途中のMapperロジックでも空文字として扱います。

nullオプションを指定可能なロジックの一覧は、「nullオプション」を参照してください。

仕様制限

Mapper共通

注意事項

Mapper共通