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

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

parts オブジェクト

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

parts オブジェクトの例

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 }
            },
            {
                'fidItemName': { 'value': 'コピー用紙A4', 'type': 'text', 'enabled': false, 'display': true },
                'fidItemCount': { 'value': '10', 'type': 'number', 'enabled': false, 'display': true }
            }
        ]
    }
}

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

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

プロパティ	説明	型
value	パーツの値	any
type	パーツのタイプ	string
enabled	パーツが入力可能であれば true、不可であれば false	boolean
display	パーツが表示状態であれば true、非表示であれば false	boolean

value プロパティの取得値

「parts」 オブジェクト内の 「value」 から取得できるデータはパーツのタイプごとに異なります。

type	タイプ	取得する値の詳細	補足
text	テキスト（一行）パーツ	パーツに入力された値	-
number	テキスト（一行）パーツ 数値型	パーツに入力された値	取得値にカンマは含まれません
number_v2	数値パーツ	パーツに入力された値	取得値にカンマは含まれません
money	テキスト（一行）パーツ 金額型	パーツに入力された値	取得値にカンマは含まれません
textarea	テキストエリアパーツ	パーツに入力された値	-
date	日付パーツ	パーツに入力された値	取得値はDateオブジェクトになります
list	リストメニューパーツ	選択された「項目名」	-
checkbox	チェックボックスパーツ	チェックがONの場合：チェック時の表示コメント チェックがOFFの場合：チェックされていない場合の表示コメント	-
radio	ラジオボタンパーツ	選択された「項目名」	-
lookup	マスター連携パーツ	パーツに入力された値	-
label	ラベルパーツ	パーツに指定された「ラベルの内容」	-
calculate	自動計算パーツ	計算済みの値	読み取り専用
excelimport	Excel添付取込パーツ	添付されたExcelファイルの情報（ファイル名・ファイルサイズ）が格納されます	読み取り専用。 フォームを再利用した場合、および送信済みフォーム閲覧画面（form.view）では、ファイルサイズは取得できません
attachment	添付ファイルパーツ	添付されたファイルの情報（ファイル名・ファイルサイズ）が格納されます	読み取り専用。 フォームを再利用した場合、および送信済みフォーム閲覧画面（form.view）では、ファイルサイズは取得できません
table	テーブルパーツ	テーブル内のパーツオブジェクトが配列形式で行ごとに格納されます。	-

value プロパティへの値設定

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

type	タイプ	値セット時の挙動	補足
text	テキスト（一行）パーツ	指定した値がテキストパーツにセットされる	-
number	テキスト（一行）パーツ 数値型	指定した値がテキストパーツにセットされる	パーツに設定された小数点有効桁数やカンマ自動付加等のフォーマットに従って表示するためには、数値型として設定する必要があります
number_v2	数値パーツ	指定した値が数値パーツにセットされる	-
money	テキスト（一行）パーツ 金額型	指定した値がテキストパーツにセットされる	パーツに設定されたカンマ自動付加等のフォーマットに従った形式で表示するためには、金額型として設定する必要があります
textarea	テキストエリアパーツ	指定した値がテキストエリアパーツにセットされる	-
date	日付パーツ	指定した値が日付パーツにセットされる	-
list	リストメニューパーツ	指定した値と一致する「項目名」が選択される	リストに存在しない選択肢はセット不可
checkbox	チェックボックスパーツ	指定した値が「チェック時の表示コメント」と一致すればチェックが ON になる	チェックボックスに存在しない選択肢はセット不可
radio	ラジオボタンパーツ	指定した値と一致する「項目名」が選択される	ラジオボタンに存在しない選択肢はセット不可
lookup	マスター連携パーツ	指定した値がマスター連携パーツにセットされる	-
label	ラベルパーツ	指定した値でパーツに指定された「ラベルの内容」が書き換えられる	-
calculate	自動計算パーツ	value の設定は反映されません	読み取り専用
excelimport	Excel添付取込パーツ	value の設定は反映されません	読み取り専用
attachment	添付ファイルパーツ	value の設定は反映されません	読み取り専用
table	テーブルパーツ	テーブル内のパーツオブジェクトの value 値を書き換えると、テーブル外のパーツ value 値を書き換えた場合と同様の挙動を示します。	-

display プロパティへの値設定

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

制限事項

• コラボフォームに対応していないパーツ（時刻パーツ・画像パーツ）は「parts」オブジェクトに含まれません（イベントの操作対象外です）。
• 「parts」オブジェクトの「enabled」値は取得のみ可能です。「enabled」値を設定してパーツの有効/無効状態を変更することはできません。
• 「form.confirm.show」「form.submit」および「form.view」では、「value」値を書き換えてパーツ値の変更を行うことはできません。
• テーブルパーツのIDは「tbl_1」固定です。
• 自動計算パーツの「enabled」値は常に「false」です。
• ラベルパーツの「enabled」値は常に「false」です。
• テーブルパーツの「enabled」値は常に「false」です。
• テーブルパーツの「display」値を「false」にして非表示にすることはできません（テーブル内パーツの「display」値は、テーブル外のパーツと同様に書き換えて表示/非表示を変更できます）。
• 添付ファイルパーツおよび Excel 添付取込パーツについて、フォームを再利用した場合、および送信済みフォーム閲覧画面（form.view）では、ファイルサイズは取得できません。