＜本記事の目次＞

****************************************************************************************************

****************************************************************************************************

ボタン表示マスターとは

ボタン表示マスターとは、申請ステータスおよび権限セット毎にボタンの表示制御およびデザインの変更が可能なマスター設定です。

設定の基本単位は「権限セット × 申請ステータス × 対象ボタン」の組み合わせです。「この権限セットを持つユーザーが、このステータスのときに、このボタンをどのように表示するか」という形で設定します。

設定を始める前に

ボタン表示マスターを設定するには、まず「表示状態」と「対象ボタン」の意味を理解しておく必要があります。

◆表示状態とは

各ボタンに設定できる表示状態は以下の4種類です。

◆対象ボタンについて

ボタン表示マスターで制御できるボタンと、ボタン表示マスター未設定時の表示状態は下記の通りです。ボタン表示マスターでは、この初期状態から変更が必要なボタンの設定を行います。

ボタン表示マスターの設定項目

💡

補足：ユーザー定義ラベル・スタイルを設定する場合

ラベルやスタイルのみを変更する場合も、必ず「表示状態」を設定してください。
また、スタイルは下記の7種類より選択が可能です。

設定例

前提条件

本記事では、設定例として、以下のステータスと権限セットを使用するものとします。

また、権限セットは以下の2種類を使用するものとします。

本設定例では、以下の制御を実現します。

申請者（docutize_Form_Applicant）に対して：

• 「申請済み」になったら、申請者が申請を取り戻せるよう「取戻し」ボタンを表示する
• 「申請済み」「審査中」「審査完了」では、申請者が誤って「申請」ボタンを操作できないよう非表示にする
• 「差戻」では、申請者が再申請とわかるよう「申請」ボタンのラベルを「再申請」、スタイルを success に変更する

運用者（docutize_Form_User01）に対して：

• 「申請済み」になったら、審査開始のための「ステータス移行」ボタンを表示する
• 「審査中」で、申請を差し戻すための「差戻し」ボタンを表示する
• 「審査中」で、審査を完了するための「ステータス移行」ボタンを表示する

ボタン表示マスターのレコード数について

ボタン表示マスターのレコード数は、「どの権限セットのユーザーに対して、どのステータスで、どのボタンを変更するか」によって決まります。そのため、一律の計算式はありません。

基本的な考え方は「権限セット × 申請ステータス × 対象ボタン」の組み合わせ1つにつき、1レコードを作成します。初期状態から変更が必要なボタンのみ設定すればよいため、初期状態のままで問題ないボタンは設定不要です。

本設定例では、以下の内訳で合計8レコードになります。

ボタン表示マスター名の推奨命名ルール

重複や作成漏れを防ぐため、以下の形式で命名することを推奨します。

形式：[項番]_[権限セット対象名]_[申請ステータス]_[対象ボタン名]_[表示状態]
例　：01_申請者_申請済み_取戻し_活性
　　　06_運用者_申請済み_ステータス移行_活性

ボタン表示マスターレコードの作成

実際にボタン表示マスターにレコードを作成します。
本記事では、下記の8レコードを作成します。

◆申請者（docutize_Form_Applicant）

◆運用者（docutize_Form_User01）

ボタン表示マスターの設定は以上で完了です。

〈参考〉

ボタン表示マスター