6.1.1. 実装ガイド¶

6.1.1.2.1.1. IM-BloomMaker から日付の送信する¶

日付入力エレメントを利用して日付を扱うために変数を設定します。

日付である「updateDate」のデータ型を「日付・時刻」に設定します。

日付を扱うために日付入力エレメントを設定します。

日付入力エレメントの value プロパティには「日付・時刻」型である「updateDate」を設定します。

アクション「IM-LogicDesigner フロールーティング〇にリクエストを送信する」のリクエストパラメータとして日付を含んだマップ型の変数を設定します。

6.1.1.2.1.2. IM-LogicDesigner での日付の受信とデータベースへの保存¶

ロジックフローの「入出力設定」で IM-BloomMaker から送信される情報に応じて入力を設定します。

日付を扱う「updateDate」のデータ型「date」に設定します。

入力値の情報をデータベースに保存するSQLユーザ定義タスクを用意します。

SQLユーザ定義タスクは以下が設定されているものとします。

設定項目	値
クエリ種別	INSERT
入力値	userCd <string> updateDate <sqltimestamp>
返却値	なし
クエリ	INSERT INTO example_table (user_cd, update_date) VALUES (/*userCd*/null, /*updateDate*/null)

用意したSQLユーザタスクのマッピング設定で日付をシステムタイムゾーンでの日付に変換します。

マッピング設定で日付をシステムタイムゾーンでの日付に変換するためにマッピング関数「convertInSystemTimeZone」を利用します。

変換後の日付をSQLユーザ定義タスクの入力値として設定します。

6.1.1.2.2.1. IM-LogicDesigner で保存されている日付を返却する¶

ロジックフローの「入出力設定」でデータベースから取得した情報を返却する出力を設定します。

日付を扱う「updateDate」のデータ型「date」に設定します。

データベースから取得した日付を返却するSQLユーザ定義タスクを用意します。

SQLユーザ定義タスクは以下が設定されているものとします。

設定項目	値
クエリ種別	SELECT
入力値	userCd <string>
返却値（records <object[]> の中の要素）	user_cd <string> update_date <sqltimestamp>
クエリ	SELECT user_cd, update_date FROM example_table WHERE user_cd = /*userCd*/’aoyagi’

用意したSQLユーザ定義タスクから取得した日付をマッピング設定でユーザのタイムゾーンでの日付に変換します。

マッピング設定でSQLユーザ定義タスクから取得した日付をマッピング関数「convertInAccountTimeZone」を利用してユーザのタイムゾーンでの日付に変換します。

変換後の日付をロジックフローの出力値として設定します。

6.1.1.2.2.2. IM-BloomMaker で日付を表示する¶

日付入力エレメントを利用して日付を扱うために変数を設定します。

日付である「updateDate」のデータ型を「日付・時刻」に設定します。

日付を表示するために日付入力エレメントを設定します。

日付入力エレメントの value プロパティには「日付・時刻」型である「updateDate」を設定します。

アクション「IM-LogicDesigner フロールーティング〇にリクエストを送信する」のレスポンスデータとして日付を含んだマップ型の変数を設定します。

6.1.1.2.3.1. IM-LogicDesigner で保存されている日付文字列を返却する¶

ロジックフローの「入出力設定」でデータベースから取得した情報を返却する出力を設定します。

日付を扱う「updateDate」のデータ型「string」に設定します。

データベースから取得した日付を返却するDatabase Fetchユーザ定義タスクを用意します。

Database Fetchユーザ定義タスクは以下が設定されているものとします。

設定項目	値
クエリ種別	SELECT
入力値	なし
返却値	user_cd <string> update_date <sqltimestamp>
クエリ	SELECT user_cd, update_date FROM example_table ORDER BY user_cd

用意したDatabase Fetchユーザタスクから取得した日付をマッピング設定でユーザの日付の時刻の表示形式で文字列に変換します。

Database Fetchユーザタスクから取得した日付をマッピング関数「convertInAccountTimeZone」を利用してユーザのタイムゾーンでの日付に変換します。

マッピング関数「formatWithAccountTimeZone」を利用してユーザの日付の時刻の表示形式で文字列に変換します。

マッピング関数「formatWithAccountTimeZone」の入力の「value」にユーザのタイムゾーンに変換した日付を設定します。

日付形式文字列のフォーマットとして、ユーザが設定している「日付（標準表示）」形式とするためにマッピング関数「formatWithAccountTimeZone」の「pattern」に「アカウントコンテキスト - dateTimeFormats - dateStandard」を設定します。

6.1.1.2.3.2. IM-BloomMaker で日付一覧を表示する¶

テーブル（繰り返し）エレメントを利用して日付を一覧表示するために変数を設定します。

日付である「updateDate」のデータ型を「文字列」に設定します。

日付を一覧表示するためにテーブル（繰り返し）エレメントを設定します。

テーブル（繰り返し）エレメントの list プロパティには日付文字列を含んだマップ型の配列を設定します。

アクション「IM-LogicDesigner フロールーティング〇にリクエストを送信する」のレスポンスデータとして日付を含んだマップ型の配列変数を設定します。

6.1.1.2.4.1. IM-LogicDesigner で保存されている日付を返却する¶

ロジックフローの「入出力設定」でデータベースから取得した情報を返却する出力を設定します。

日付を扱う「updateDate」のデータ型「date」に設定します。

データベースから取得した日付を返却するDatabase Fetchユーザ定義タスクを用意します。

Database Fetchユーザ定義タスクは以下が設定されているものとします。

設定項目	値
クエリ種別	SELECT
入力値	なし
返却値	user_cd <string> update_date <sqltimestamp>
クエリ	SELECT user_cd, update_date FROM example_table ORDER BY user_cd

Database Fetchユーザタスクから取得した日付をマッピング関数「convertInAccountTimeZone」を利用してユーザのタイムゾーンでの日付に変換します。

6.1.1.2.4.2. IM-BloomMaker で日付一覧をリッチテーブルに表示する¶

リッチテーブルエレメントを利用して日付を一覧表示するために変数を設定します。

日付である「updateDate」のデータ型を「日付・時刻」型に設定します。

日付を一覧表示するためにリッチテーブルエレメントを設定します。

リッチテーブルエレメントの datasource プロパティには日付を含んだマップ型の配列を設定します。

リッチテーブルエレメントのheaderRowStringプロパティ、columnSettingsプロパティはそれぞれ以下のように設定します。

columnSettingsプロパティの日付を表示するcolumn（列）には、「type=dateOnlyDate」を設定します。

アクション「IM-LogicDesigner フロールーティング〇にリクエストを送信する」のレスポンスデータとして日付を含んだマップ型の配列変数を設定します。

リッチテーブルエレメントで日付を正しく表示するためには、「アカウントコンテキストのタイムゾーンを強制的に使用する」プロパティにチェックを入れ、ユーザタイムゾーンの日付でIm-BloomMakerに返却する必要があります。

6.1.1.2.4.3. リッチテーブルエレメントのその他の設定¶

リッチテーブルには、日付・時刻に関連するtypeを4つ用意しています。以下に使い分けについて示します。

type	ユースケース	BloomMakerの変数型	備考
date	日時を扱いたい場合に使用します。	日付・時刻型
dateOnlyDate	日付を扱いたい場合に使用します。	日付・時刻型	日付入力エレメントと互換性があります。互換したい場合は、preserveTimeプロパティをfalseに、appliedTimeZoneプロパティをaccount-contextに設定してください。
dateOnlyNumber	javaScriptのDate型を扱いたい場合を想定しています。	整数型
dateOnlyString	文字列型で日付を扱いたい場合に使用します。	文字列型

さらに詳細な仕様は以下のページでご確認ください。

https://document.intra-mart.jp/library/bloommaker/public/im_bloommaker_user_guide/texts/appendix/elements/regular.html#imrichtable

6.1.1.3.1.1. IM-BloomMaker から日時の送信する¶

日付入力エレメントと時刻入力エレメントを利用して日時を扱うために変数を設定します。

日時である「updateDate」のデータ型を「日付・時刻」に設定します。

日時の日付を扱うために日付入力エレメントを設定します。

日時の時刻を扱うために時刻入力エレメントを設定します。

日付入力エレメントの value プロパティには「日付・時刻」型である「updateDate」を設定します。preserveTime プロパティを有効に設定します。

時刻入力エレメントの value プロパティにも「日付・時刻」型である「updateDate」を設定します。

アクション「IM-LogicDesigner フロールーティング〇にリクエストを送信する」のリクエストパラメータとして日時を含んだマップ型の変数を設定します。

6.1.1.3.1.2. IM-LogicDesigner での日時の受信とデータベースへの保存¶

ロジックフローの「入出力設定」で IM-BloomMaker から送信される情報に応じて入力を設定します。

日時を扱う「updateDate」のデータ型「date」に設定します。

入力値の情報をデータベースに保存するSQLユーザ定義タスクを用意します。

SQLユーザ定義タスクは以下が設定されているものとします。

設定項目	値
クエリ種別	INSERT
入力値	userCd <string> updateDate <sqltimestamp>
返却値	なし
クエリ	INSERT INTO example_table (user_cd, update_date) VALUES (/*userCd*/null, /*updateDate*/null)

ロジックフローの入力値の日時データをそのままSQLユーザ定義タスクの入力値として設定します。

6.1.1.3.2.1. IM-LogicDesigner で保存されている日時を返却する¶

ロジックフローの「入出力設定」でデータベースから取得した情報を返却する出力を設定します。

日時を扱う「updateDate」のデータ型「date」に設定します。

データベースから取得した日時を返却するSQLユーザ定義タスクを用意します。

SQLユーザ定義タスクは以下が設定されているものとします。

設定項目	値
クエリ種別	SELECT
入力値	なし
返却値（records <object[]> の中の要素）	user_cd <string> update_date <sqltimestamp>
クエリ	SELECT user_cd, update_date FROM example_table WHERE user_cd = /*userCd*/’aoyagi’

用意したSQLユーザタスクから取得した日時をロジックフローの出力値として設定します。

6.1.1.3.2.2. IM-BloomMaker で日時を表示する¶

日付入力エレメントと時刻入力エレメントを利用して日時を扱うために変数を設定します。

日時である「updateDate」のデータ型を「日付・時刻」に設定します。

日時を表示するために日付入力エレメントを設定します。

日時を表示するために時刻入力エレメントを設定します。

日付入力エレメントの value プロパティには「日付・時刻」型である「updateDate」を設定します。

時刻入力エレメントの value プロパティにも「日付・時刻」型である「updateDate」を設定します。

アクション「IM-LogicDesigner フロールーティング〇にリクエストを送信する」のレスポンスデータとして日時を含んだマップ型の変数を設定します。

6.1.1.3.3.1. IM-LogicDesigner で保存されている日時文字列を返却する¶

ロジックフローの「入出力設定」でデータベースから取得した情報を返却する出力を設定します。

日時を扱う「updateDate」のデータ型「string」に設定します。

データベースから取得した日時を返却するDatabase Fetchユーザ定義タスクを用意します。

Database Fetchユーザ定義タスクは以下が設定されているものとします。

設定項目	値
クエリ種別	SELECT
入力値	なし
返却値	user_cd <string> update_date <sqltimestamp>
クエリ	SELECT user_cd, update_date FROM example_table ORDER BY user_cd

用意したDatabase Fetchユーザタスクから取得した日時をマッピング設定でユーザの日時の時刻の表示形式で文字列に変換します。

マッピング関数「formatWithAccountTimeZone」を利用してユーザの日時の時刻の表示形式で文字列に変換します。

マッピング関数「formatWithAccountTimeZone」の入力の「value」にDatabase Fetchユーザタスクから取得した日時を設定します。

日時形式文字列のフォーマットとして、ユーザが設定している「日付（標準表示）」形式と「時刻（標準表示）」を組み合わせた形式にするためにマッピング関数「formatWithAccountTimeZone」の「pattern」に「アカウントコンテキスト - dateTimeFormats - dateStandard」と「アカウントコンテキスト - dateTimeFormats - timeStandard」の2つを配列操作マッピング関数「push」を利用して設定します。

6.1.1.3.3.2. IM-BloomMaker で日時一覧を表示する¶

テーブル（繰り返し）エレメントを利用して日時を一覧表示するために変数を設定します。

日時である「updateDate」のデータ型を「文字列」に設定します。

日時を一覧表示するためにテーブル（繰り返し）エレメントを設定します。

テーブル（繰り返し）エレメントの list プロパティには日時文字列を含んだマップ型の配列を設定します。

アクション「IM-LogicDesigner フロールーティング〇にリクエストを送信する」のレスポンスデータとして日時を含んだマップ型の配列変数を設定します。

6.1.1.3.4.1. IM-LogicDesigner で保存されている日時を返却する¶

ロジックフローの「入出力設定」でデータベースから取得した情報を返却する出力を設定します。

日時を扱う「updateDate」のデータ型「date」に設定します。

データベースから取得した日時を返却するDatabase Fetchユーザ定義タスクを用意します。

Database Fetchユーザ定義タスクは以下が設定されているものとします。

設定項目	値
クエリ種別	SELECT
入力値	なし
返却値	user_cd <string> update_date <sqltimestamp>
クエリ	SELECT user_cd, update_date FROM example_table ORDER BY user_cd

用意したDatabase Fetchユーザタスクから取得した日時をマッピングします。

6.1.1.3.4.2. IM-BloomMaker で日時一覧をリッチテーブルに表示する¶

リッチテーブルエレメントを利用して日時を一覧表示するために変数を設定します。

日時である「updateDate」のデータ型を「日付・時刻」型に設定します。

日時を一覧表示するためにリッチテーブルエレメントを設定します。

リッチテーブルエレメントの datasource プロパティには日時を含んだマップ型の配列を設定します。

リッチテーブルエレメントのheaderRowStringプロパティ、columnSettingsプロパティはそれぞれ以下のように設定します。

columnSettingsプロパティの日付を表示するcolumn（列）には、「type=date」を設定します。

アクション「IM-LogicDesigner フロールーティング〇にリクエストを送信する」のレスポンスデータとして日付を含んだマップ型の配列変数を設定します。

リッチテーブルエレメントで日時を正しく表示するためには、「アカウントコンテキストのタイムゾーンを強制的に使用する」プロパティに必ずチェックに入れてください。

6.1.1.3.4.3. リッチテーブルエレメントのその他の設定¶

リッチテーブルには、日付・時刻に関連するtypeを4つ用意しています。以下に使い分けについて示します。

type	ユースケース	BloomMakerの変数型	備考
date	日時を扱いたい場合に使用します。	日付・時刻型
dateOnlyDate	日付を扱いたい場合に使用します。	日付・時刻型	日付入力エレメントと互換性があります。互換したい場合は、preserveTimeプロパティをfalseに、appliedTimeZoneプロパティをaccount-contextに設定してください。
dateOnlyNumber	javaScriptのDate型を扱いたい場合を想定しています。	整数型
dateOnlyString	文字列型で日付を扱いたい場合に使用します。	文字列型

さらに詳細な仕様は以下のページでご確認ください。

https://document.intra-mart.jp/library/bloommaker/public/im_bloommaker_user_guide/texts/appendix/elements/regular.html#imrichtable