パーツのデータと状態の操作

フォーム内のパーツにセットされたデータの詳細や、状態の操作について説明します。

partsオブジェクト

イベントハンドラーの戻り値となるdataオブジェクトには「parts」オブジェクトが含まれています。
このpartsオブジェクトを使って、パーツのデータを参照したり、パーツにデータをセットしたり、パーツの表示/非表示を切り替えることが可能です。

partsオブジェクトの例
partsオブジェクトの例
Copied!

parts:{
fidDeliveryPoint: {
'type': 'text',
'enabled' : true,
'display' : true,
'value': '神奈川事業所'
},
fidDeliveryType: {
'type': 'list',
'enabled' : true,
'display' : true,
'value': '定期便'
}
tbl_1{
'type': 'table',
'enabled' : false,
'display' : true,
'value': [{
'fidItemName': { 'value': '純正トナーカートリッジ','type': 'text', 'enabled' : false, 'display' : true },
'fidItemCount': { 'value': '2', 'type': 'number', 'enabled' : false, 'display' : true },
'fidItemPrice': { 'value': '6980', 'type': 'number', 'enabled' : false, 'display' : true }
},{
'fidItemName': { 'value': 'コピー用紙A4','type': 'text', 'enabled' : false, 'display' : true },
'fidItemCount': { 'value': '10', 'type': 'number', 'enabled' : false, 'display' : true },
'fidItemPrice': { 'value': '460', 'type': 'number', 'enabled' : false, 'display' : true }
}]
}


上記の例では、「fidDeliveryPoint」「fidDeliveryType」はテーブル外の通常のパーツを、「tbl_1」オブジェクトのvalue値が、テーブル内にあるパーツを示しています。
（例が長くなるため、テーブル内の行は2行のみとして作成しています。）

partsオブジェクトのプロパティ

プロパティ

説明

型

value

パーツの値。タイプがtableの場合は

テーブル内のパーツオブジェクトが格納されます。

any

type

パーツのタイプ

string

enabled

パーツが入力可能であればtrue、不可であればfalse

boolean

display

パーツが表示状態であればtrue、非表示であればfalse

boolean


valueプロパティの取得値

partsオブジェクト内の、value値から取得できるデータはパーツのタイプごとに異なります。
次の表はパーツタイプ毎のvalue値の内訳を示します。

type

タイプ

取得する値の詳細

補足

text

テキスト（一行）パーツ

パーツに入力された値

-

number

テキスト（一行）パーツ 数値型

パーツに入力された値

取得値にカンマは含まれません

money

テキスト（一行）パーツ 金額型

パーツに入力された値

取得値にカンマは含まれません

textarea

テキストエリアパーツ

パーツに入力された値

-

date

日付パーツ

パーツに入力された値

取得値はDateオブジェクトになります

time

時刻パーツ

パーツに入力された値

HH:MM形式の文字列です

list

リストメニューパーツ

選択された「項目名」

-

checkbox

チェックボックスパーツ

チェックがONの場合：チェック時の表示コメント

チェックがOFFの場合：チェックされていない場合の表示コメント

-

radio

ラジオボタンパーツ

選択された「項目名」

-

lookup

マスター連携パーツ

パーツに入力された値

-

label

ラベルパーツ

パーツに指定された「ラベルの内容」

-

table

テーブルパーツ

テーブル内のパーツオブジェクトが配列形式で行ごとに格納されます。

-


valueプロパティへの値設定

partsオブジェクトのvalue値を書き換えると、その変更が申請書に反映されます。
次の表はパーツタイプ毎にvalue値を書き換えた場合の挙動を示します。

type

タイプ

値セット時の挙動

補足

text

テキスト（一行）パーツ

指定した値がテキスト（一行）パーツにセットされる

-

number

テキスト（一行）パーツ 数値型

指定した値がテキスト（一行）パーツにセットされる

パーツに設定された小数点有効桁数やカンマ自動付加等のフォーマットに従った形式で表示するためには、数値型として設定する必要があります。

money

テキスト（一行）パーツ 金額型

指定した値がテキスト（一行）パーツにセットされる

パーツに設定されたカンマ自動付加等のフォーマットに従った形式で表示するためには、金額型として設定する必要があります。

textarea

テキストエリアパーツ

指定した値がテキストエリアパーツにセットされる

-

date

日付パーツ

指定した値が日付パーツにセットされる

編集不可項目にセットした場合、パーツに設定されたフォーマットに従った日付形式で表示されます。

time

時刻パーツ

指定した値が時刻パーツにセットされる

・指定した値が「:」で区切られていない場合はセットされません（初期値のままとなります）

・編集不可項目にセットした場合、パーツに設定されたフォーマットに従った日付形式で表示されます。

list

リストメニューパーツ

指定した値と一致する「項目名」が選択される

リストに存在しない選択肢はセット不可

checkbox

チェックボックスパーツ

指定した値が「チェック時の表示コメント」と一致すればチェックがONになる

チェックボックスに存在しない選択肢はセット不可

radio

ラジオボタンパーツ

指定した値と一致する「項目名」が選択される

ラジオボタンに存在しない選択肢はセット不可

lookup

マスター連携パーツ

指定した値がマスター連携パーツにセットされる

-

label

ラベルパーツ

指定した値で、パーツに指定された「ラベルの内容」が書き換えられる

-

table

テーブルパーツ

テーブル内のパーツオブジェクトのvalue値を書き換えると、テーブル外のパーツvalue値を書き換えた場合と同様の挙動を示します。

-



displayプロパティへの値設定

画面表示時にパーツが表示されている場合は、イベントハンドラー内の処理で、partsオブジェクトのdisplay値を書き換えて、パーツの表示/非表示を変更することができます。

制限事項

以下のパーツはpartsオブジェクトに含まれません（イベントの操作対象外です。）
自動計算
Excel添付取込
添付ファイル
画像
数値

partsオブジェクトのenabled値は取得のみ可能です。 enabled値を設定し、パーツの有効/無効状態を変更することはできません。

画面イベントによっては、valueプロパティへの値設定が制限されている場合があります。 詳細につきましては、 利用可能な画面、イベントの一覧 より、各画面イベントの詳細をご確認ください。

申請書のテーブル内のpartsオブジェクトは配列として取得できますが、 配列の数を増減させても画面には反映されません。

Excelフォームでは明細の行追加・削除などの操作がないため、 テーブルパーツのpartsオブジェクトのenabled値は常にfalseとなります。

Excelフォームでは明細内のパーツを経路で非表示にする事ができないため、 テーブルパーツのpartsオブジェクトのdisplay値は常にtrueとなります。 また、display値を変更することはできません。

通常フォームのテーブルパーツのIDは、「tbl_{配置順}」の形式になります。 例）複数のテーブルパーツを配置した場合は、 最初に配置したテーブルパーツのIDは「tbl_1」に、2つめのテーブルパーツのIDは「tbl_2」になります。

Excelフォームの明細は「tbl_1」固定になります。