13.10.1. エレメントの表示設定を行う¶

13.10.1.1. 設定ファイルの作成¶

エレメントの表示・非表示や並び順を変更するには、設定ファイルを使います。

設定ファイルは JSON で記述します。

設定ファイルは、パブリックストレージに配置します。

• 以下のディレクトリに移動します。

  「{パブリックストレージのパス}/im_bloommaker/designer」

• 「settings.json」という名前でファイルを作成します。

13.10.1.2. 表示するエレメントを指定する¶

• 「settings.json」をテキストエディタで開きます。

• 以下の内容をファイルに記述して保存します。

  指定するエレメントのクラス名については「IM-BloomMakerが提供する標準のエレメントのクラス名と提供開始バージョン一覧」を参照してください。

{
    "version": 1,
    "whitelist": [
        {
            "elements": [
                {
                    "name": "パレットに表示したいエレメントのクラス名"
                }
            ]
        }
    ]
}

コラム

上記の手順で「elements」配下の「name」に指定したエレメントのみパレットに表示されます。

例えば、「Box」（「ボックス」エレメント）を指定した場合、パレットには「ボックス」エレメントのみ表示されます。

• 複数のエレメントをパレットに表示したい場合は、以下のように表示したいエレメントの数だけ「elements」の配下の要素を増やして記述します。

{
    "version": 1,
    "whitelist": [
        {
            "elements": [
                {
                    "name": "エレメントAのクラス名"
                },
                {
                    "name": "エレメントBのクラス名"
                },
                {
                    "name": "エレメントCのクラス名"
                }
            ]
        }
    ]
}

13.10.1.3. エレメントの並び順を変更する¶

• 「settings.json」をテキストエディタで開きます。
• 以下の内容をファイルに記述して保存します。

{
    "version": 1,
    "whitelist": [
        {
            "elements": [
                {
                    "name": "エレメントAのクラス名",
                    "sortNumber": 3
                },
                {
                    "name": "エレメントBのクラス名",
                    "sortNumber": 1
                },
                {
                    "name": "エレメントCのクラス名",
                    "sortNumber": 2
                }
            ]
        }
    ]
}

コラム

「elements」配下の「sortNumber」で指定した数値の順番でエレメントがパレットに表示されます。

例えば、上記の記述の場合、パレットには「エレメントB」「エレメントC」「エレメントA」の順番でエレメントが表示されます。

注意

「sortNumber」は、エレメントが属するカテゴリ内でのエレメントの順番を指定します。

エレメントを別のカテゴリに移動させたり、カテゴリ自体の順番を変えたりすることはできません。

13.10.1.4. 条件によってエレメントの表示・非表示を切り替える¶

13.10.1.5. 表示するエレメントや条件を細かく制御する¶

「whitelist」の配下に複数の要素を記述すると、表示するエレメントや条件を細かく指定できます。

• 「settings.json」をテキストエディタで開きます。
• 以下の内容をファイルに記述して保存します。

{
    "version": 1,
    "whitelist": [
        {
            "elements": [
                {
                    "name": "エレメントAのクラス名"
                }
            ],
            "conditions": [
                {
                    "type": "条件タイプ",
                    "value": "条件A"
                }
            ]
        },
        {
            "elements": [
                {
                    "name": "エレメントBのクラス名"
                }
            ],
            "conditions": [
                {
                    "type": "条件タイプ",
                    "value": "条件B"
                }
            ]
        },
        {
            "elements": [
                {
                    "name": "エレメントCのクラス名"
                }
            ],
            "conditions": [
                {
                    "type": "条件タイプ",
                    "value": "条件C"
                }
            ]
        }
    ]
}

コラム

例えば、上記の設定内容で条件Aと条件Bに一致し、条件Cには一致しないユーザがデザイナ画面を表示した場合、パレットには「エレメントA」と「エレメントB」のみ表示されます。

13.10.1.6. 設定ファイルのフォーマット¶

「settings.json」のフォーマットは以下の通りです。

{
    "version": 1,
    "whitelist": [
        {
            "elements": [
                {
                    "name": "",
                    "sortNumber": 0
                }
            ],
            "conditions": [
                {
                    "type": "",
                    "value": "",
                    "start": "",
                    "end": ""
                }
            ],
            "matchType": ""
        }
    ]
}

＜設定項目の説明＞

項目	必須	説明
version	－	バージョンを指定します。1を指定してください。
whitelist	必須	表示するエレメントと条件を指定するブロックです。 配下の要素は複数指定可能です。 複数指定の方法は「表示するエレメントや条件を細かく制御する」を参照してください。
elements	必須	表示するエレメントを指定するブロックです。 配下の要素は複数指定可能です。 複数指定の方法は「表示するエレメントを指定する」を参照してください。
name	必須	エレメントのクラス名を指定します。 指定するエレメントのクラス名については「IM-BloomMakerが提供する標準のエレメントのクラス名と提供開始バージョン一覧」を参照してください。
sortNumber	－	エレメントの並び順を指定します。 数値で指定してください。
conditions	－	条件を指定するブロックです。 配下の要素は複数指定可能です。 複数指定の方法は「複数の条件を指定する」を参照してください。
type	必須	条件のタイプを指定します。 指定できる値は「userCd」「roleId」「term」のいずれかです。
value	typeに「userCd」または「roleId」を指定した場合は必須	条件を指定します。 typeに「userCd」または「roleId」を指定した場合のみ利用されます。
start	－	開始日時を指定します。 ISO 8601形式（yyyy-MM-ddTHH:mm:ss）の日時を指定してください。 typeに「term」を指定した場合のみ利用されます。
end	－	終了日時を指定します。 ISO 8601形式（yyyy-MM-ddTHH:mm:ss）の日時を指定してください。 typeに「term」を指定した場合のみ利用されます。
matchType	－	条件のマッチタイプを指定します。 指定できる値は「and」「or」のいずれかです。 未指定の場合は「and」として扱います。