メインコンテンツまでスキップ

マッピング設定

ここでは、マッピング設定の基本的な操作について説明します。

参考

設定に進む前にマッピング設定の概要を確認したい場合は、「ロジックフローの構築 > マッピング」を参照してください。

基本操作​

エレメント間のデータのやり取りを定義するために、エレメントごとにマッピングを設定していきます。

マッピングを設定する​

  1. 該当するエレメントをクリックします。
    └ プロパティにエレメントの「基本設定」が表示されます。
  2. [マッピング設定]をクリックします。
    └ 「マッピング設定」ダイアログが表示されます。
  3. 入力と出力の間に線を引きます。
    └ マッピングが完了し、データの受け渡しが設定されます。
  4. [決定]をクリックします。
    └ 「ロジックフロー定義編集」画面に戻ります。
入力と出力の間に線を引く:

(1) 入力の端子にマウスを合わせます。
└ オレンジ色にハイライトされます。

(2) 処理をつなげたい出力の端子に向けてドラッグします。
└ ドラッグ中は灰色の破線で表示されます。

(3) 出力の端子がオレンジ色にハイライトされたらドロップします。
└ マッピングが定義され、黒色の実線で表示されます。

その他の操作
  • マップ型 map のデータに対して、新しいキーを追加したい場合は、[キーを追加]をクリックしてください。
  • 入力・出力項目の値を削除したい場合は、[削除]をクリックしてください。
  • 値の変換情報を確認したい場合は、線上にマウスを合わせるとツールチップで表示されます。
参考

IM-LogicDesignerでは、異なる型同士をマッピングすると暗黙的な型変換が行われます。データ型変換の例について、詳細は「CookBook - IM-LogicDesigner マッピング機能におけるデータ型変換について」を参照してください。

マッピングをデバッグする​

設定したマッピングが正しく機能しているかを確認するため、デバッグを実行します。マッピングのデバッグでは、次のような観点で確認します。

  • 入力値が意図したエンティティ項目に正しく渡されているか
  • 出力値が期待通りの形式・内容で返却されているか
  • 複雑なマッピング設定で、想定通りに接続しているか
  • 配列の有無や異なる型同士の接続で、期待通りに変換されているか

  1. [デバッグ]をクリックします。
    └ 「マッピングのデバッグ」画面が表示されます。
  2. 「入力値」の編集欄をダブルクリックします。
    └ デバッグに使用する値を設定するための「値の編集」画面が表示されます。
    └ 入力値のデータ型によって編集画面の内容は異なります。
  3. [実行]をクリックします。
    └ デバッグ結果が「出力値」に表示されます。
    └ 値全体を確認したい場合は、[値を表示]をクリックしてください。
その他の操作
  • 入力値を選択してから[値を編集]をクリックしても、同様に編集が可能です。
  • 入力値をJSON形式で定義したい場合は、[JSON入力]をクリックしてください。JSON入力では、一部対応していないデータ型や異なるデータ型が設定される場合があります。詳細は「IM-LogicDesigner仕様書 - 4.3.14. JSON上でのデータの表現」を参照してください。
  • 「マッピングのデバッグ」画面を開いた状態で、マッピングを修正し、再度デバッグを実行したい場合は、[ ]をクリックしてください。
    └ 最新のマッピング設定が反映された状態で、デバッグをやり直すことができます。

次のステップへ:ロジックフローのデバッグ

マッピング設定が完了したら、ロジックフローのデバッグを実行しましょう。「ロジックフローのデバッグ」では、実行時に渡す入力値や出力値、各エレメントが返す値、さらに事前に定義されている定数や変数の内容まで詳細に確認できます。

応用操作​

マッピング設定には基本的な操作に加えて、次のような応用的な操作も可能です。必要に応じて確認してください。

暗黙的な変数を利用する​

入力エリアには、入力・変数・定数があらかじめ設定されています。さらに、暗黙的な変数を利用することで、データの受け渡しを柔軟かつ効率的に行うことができます。暗黙的な変数とは、開発者が個別に定義しなくても、システム側で自動的に生成・管理される変数のことです。これらの変数は、特定の処理やイベントに応じて自動的に値が割り当てられるため、マッピング時にそのまま利用できます。

  1. プルダウンをクリックします。
    └ 利用可能な変数の一覧が表示されます。
  2. 使用したい変数を選択します。
    └ 選択すると、一覧が閉じます。
  3. [入力を追加]をクリックします。
    └ 選択した変数が入力項目に追加されます。
  4. 入力と出力に線を引き、マッピングを設定します。

暗黙的な変数の種類を確認する​

ユーザ・アカウント情報​

ログイン中のユーザやアカウントに関する情報を保持する変数です。

アカウントコンテキストでは、アクセス中のユーザの状態(ステータス)に関する情報を取得できます。ユーザコードやロケールなどのアカウント情報に加え、認証状況などのプロパティも取得できます。

アカウントコンテキストから取得できる情報は、ロジックフローを実行したユーザが対象です。「ユーザ切り替え」制御要素を含む場合は、切り替え後のユーザが対象となります。

たとえば、アカウントコンテキストから取得したユーザコードをエンティティデータの検索条件に設定することで、ロジックフローを実行したユーザ自身のデータだけを取得できます。

取得できる情報は管理者および一般ユーザが設定した内容に基づくため、各種操作ガイドもあわせて参照することをおすすめします。

変数名プロパティ名説明
applicationLicensesアプリケーションライセンス一覧現在のユーザが保持しているアプリケーションライセンスの一覧です。ログインしていない場合、またはシステム管理者の場合は、nullを取得します。
「テナント管理者操作ガイド - アプリケーションライセンス一覧を使用する」
authenticated認証状況ログインユーザとして認証されているかどうかを表します。プラットフォームユーザなど、ユーザによるログインを伴わずにシステムから処理を実行する場合は、未認証となります。
calendarIdカレンダーID現在のユーザが利用するカレンダーを識別するIDです。
「一般ユーザ操作ガイド - カレンダーを設定する」
dateTimeFormats日時表示形式一覧現在のユーザが利用する日時の表示形式に関する情報の一覧です。
「一般ユーザ操作ガイド - 日付と時刻の形式を設定する」
dateInput日付の入力形式年/月/日の形式で日付を入力します。(例:"yyyy/MM/dd")
dateSimple日付の簡易形式日/月の形式で日付を表示します。(例:"d/MM")
dateStandard日付の標準形式日/月/年の形式で日付を表示します。(例:"d/MM/yyyy")
timeInput時刻の入力形式時:分の形式で時刻を入力します。(例:"HH:mm")
timeStandard時刻の標準形式時:分の形式で時刻を表示します。(例:"HH:mm")
timeTimestamp時刻のタイムスタンプ形式時:分:秒の形式で時刻を表示します。(例:"HH:mm:ss")
encoding文字エンコーディング現在のユーザが利用する文字エンコーディングです。
※intra-mart Accel Platformで使用する文字コードはUTF-8のみ
firstDayOfWeek週の開始曜日現在のユーザが利用する週の開始曜日に関する情報です。
「一般ユーザ操作ガイド - カレンダーを設定する」
homeUrlホームURL現在のユーザが利用するホーム画面のURLです。
「テナント管理者操作ガイド - ホームURLを設定する」
localeロケール現在のユーザが利用するロケール(言語や地域の設定)です。
「一般ユーザ操作ガイド - ロケールを設定する」
loginTimeログイン時刻現在のユーザがログインした時刻を表します。ログインしていない場合は、nullを取得します。
roleIdsロールID一覧現在のユーザに設定されているロールIDの一覧です。サブロールも含まれます。ログインしていない場合、またはシステム管理者の場合は、nullを取得します。
「テナント管理者操作ガイド - ロールを設定する」
tenantIdテナントID現在の操作対象となっているテナントのIDです。システム起動時など、ユーザに依存しない処理の場合は、nullを取得します。
「システム管理者操作ガイド - テナント情報」
themeIdテーマID現在のユーザが利用するテーマを識別するIDです。
「一般ユーザ操作ガイド - テーマを設定する」
「テーマ仕様書 - intra-mart が提供するテーマの一覧」
timeZoneタイムゾーン現在のユーザが利用するタイムゾーン(標準時の地域設定)です。
「一般ユーザ操作ガイド - ロケールを設定する」
userCdユーザコード現在のユーザのユーザコードです。ログインしていない場合など、ユーザによるログインを伴わない処理では、システムで定義された固定のユーザコードが使用されます。
「IM-共通マスタ 管理者操作ガイド - ユーザの基本設定」
userTypeユーザ種別現在のユーザの種別を表します。
  • 一般ユーザ:ログインユーザおよび未認証ユーザ
  • システム管理者:システムで利用するユーザ
  • プラットフォームユーザ:ジョブの実行ユーザ
参考
コラム

IM-LogicDesignerでは、アカウントコンテキストからロジックフローを実行したユーザに関する情報を取得できます。一方、IM-BloomMakerでは、環境情報変数のアカウントコンテキストからログインユーザに関する情報を取得し、画面の処理で利用できます。詳細は、「環境情報変数の確認 - ユーザ・アカウント情報」を参照してください。

処理・実行情報​

実行中のフローに関する情報やタスクの処理結果などを保持する変数です。

セッション情報では、セッション内で実行中のロジックフローに関する情報を取得できます。フローIDやバージョンなどのフローに関する情報に加え、日付情報や定数値なども取得できます。

変数名プロパティ名説明
baseUrlベースURLWebサーバのベースURLを表す定数値です。テナント情報や設定ファイルにベースURLが定義されている場合は、その値を取得します。ベースURLが定義されていない場合は、リクエストオブジェクトからベースURLを解決します。なお、ジョブや非同期タスクなどのバックエンド処理で実行され、リクエストオブジェクトを取得できない場合は、値を取得できません。
fileSeparatorファイル区切り文字ファイル区切り文字を表す定数値です。実際に返される値は、IM-LogicDesignerが動作しているOSによって異なります。
flowIdフローID実行中のロジックフローのフローIDを取得します。
lineSeparator改行コード改行コードを表す定数値です。実際に返される値は、IM-LogicDesignerが動作しているOSによって異なります。
startTime実行日時ロジックフローが実行された日時の情報を取得します。
systemDateシステム日付情報システム日付の情報を取得します。startTimeとは異なり、このプロパティが利用された時点の日付を取得します。
versionフローバージョン実行中のロジックフローのフローバージョンを取得します。
参考

エイリアスを利用する​

エイリアス一覧には、ロジックフローのプロパティで設定された各エレメントのエイリアスが表示されます。エイリアスを設定することで、マッピング時に特定のエレメントの処理結果を参照できます。

  1. プルダウンをクリックします。
    └ 利用可能な変数の一覧が表示されます。
  2. 使用したいエイリアスを選択します。
    └ 選択すると、一覧が閉じます。
  3. [入力を追加]をクリックします。
    └ 選択した変数が入力項目に追加されます。
  4. 入力と出力に線を引き、マッピングを設定します。
参考

エイリアスの詳細は、「IM-LogicDesigner仕様書 - 4.1.5.2. エイリアス」を参照してください。

マッピング関数を利用する​

マッピング設定では、前のエレメントからの出力値に対して、マッピング関数を使った演算処理を行い、その結果をそのまま次のエレメントへの入力値に渡すことができます。マッピング関数とは、マッピング設定で利用できる小規模な演算処理を行う関数のことです。この関数を利用することで、ロジックフローで新たな処理タスクを追加せずに、マッピング設定だけで処理を完結できます。

  1. プルダウンをクリックします。
    └ 利用可能な関数の一覧が表示されます。
  2. 使用したい関数を選択します。
    └ 選択すると、一覧が閉じます。
  1. [関数を追加]をクリックします。
    └ 選択した関数がマッピング設定ペインに追加されます。
  2. 入力と関数、関数と出力に線を引き、マッピングを設定します。
その他の操作

マッピング関数を削除したい場合は、該当する関数にマウスを合わせ、表示される[ ]をクリックしてください。

マッピング関数の種類を確認する​

マッピング関数は、用途に応じて以下のような種類に分けられます。

数値データや文字列を扱う関数​

数値形式や文字列形式の入力値に対する操作、または数値データと文字列の相互変換などに利用できる関数です。

「数値演算」にあるマッピング関数を利用すると、数値データに対して演算処理を行い、その結果を出力できます。

  • add:数値aと数値bを加算(+)する
  • subtract:数値aと数値bを減算(-)する
  • multiply:数値aと数値bを乗算(×)する
  • divide:数値aと数値bを除算(÷)する
  • mod:数値aと数値bを除算した余りを求める
  • roundUp:数値を指定した桁数(スケール)で切り上げる
  • round:数値を指定した桁数(スケール)で四捨五入する
  • roundDown:数値を指定した桁数(スケール)で切り捨てる
  • abs:数値の絶対値を求める
  • pow:数値aを数値bでべき乗する
  • max:数値aと数値bを比較し、最大値を求める
  • min:数値aと数値bを比較し、最小値を求める
参考

「数値演算」にあるマッピング関数の仕様(引数や戻り値など)の詳細は、「IM-LogicDesigner仕様書 – 5.3.1.3. 数値演算」を参照してください。

日付データを扱う関数​

日付や時刻の変換・演算、ユーザのタイムゾーンとシステムタイムゾーンの変換などに利用できる関数です。

「日付操作」にあるマッピング関数では、日付や時間に対する操作を行い、その結果を出力できます。

  • parse:文字列を日付に変換する
  • format:日付を文字列に変換する
  • calcDate:日付を演算する
  • interval:日付aと日付bの期間(間隔)を取得する
  • beginMonthDay:月初の日付を取得する
  • endMonthDay:月末の日付を取得する
  • convertInSystemTimeZone:ユーザのタイムゾーンの日付をシステムタイムゾーンの日付に変換する
  • convertInAccountTimeZone:システムタイムゾーンの日付をユーザのタイムゾーンの日付に変換する
  • parseWithAccountTimeZone:文字列を指定した日付フォーマットに従って、ユーザのタイムゾーンの日付としてDate型に変換する
  • formatWithAccountTimeZone:Date型を指定した日付フォーマットを、ユーザのタイムゾーンの日付を表す文字列に変換**する
参考
新しくIDを生成する関数​

IDの生成に利用できる関数です。

「ID生成」にあるマッピング関数では、一意となるIDを生成できます。

  • identifier:API Identifierを利用して、一意となるIDを生成する
  • uuid:UUID(universally unique identifier)を生成する
参考
配列やオブジェクトを扱う関数​

配列やオブジェクトの操作、オブジェクトと文字列の相互変換などに利用できる関数です。

「配列操作」にあるマッピング関数では、配列への要素の追加や削除、要素の取得などを行い、その結果を出力できます。

  • unshift:配列の先頭に要素を追加する
  • push:配列の末尾に要素を追加する
  • remove:配列から指定したインデックスの要素を削除する
  • replace:配列から指定したインデックスの要素を別の要素に置換する
  • size:配列の要素数を取得する
  • get:配列から指定したインデックスの要素を取得する
  • insert:配列の指定したインデックスに要素を追加する
  • first:配列の先頭の要素を取得する
  • last:配列の末尾の要素を取得する
参考