1. Navigation
2. 操作説明
2.1. 画面構成
MDCモジュールで提供する標準的な画面レイアウトは以下で構成されています。
サイドメニュー開閉アイコン、ロゴ(設定時)、テナント名、全文検索(設定時)、カスタムアイテム(設定時)、ユーザーメニューで構成されています。
アプリケーションバー左端のメニューアイコンをクリックすると、サイドメニューが表示されます。
アプリケーションバー右端のアカウントアイコンをクリックすると、ユーザーメニューが表示されます。
Top画面やEntityView、Action等と紐づくアイテムを一覧表示するメニューです。
検索画面やTop画面等のメインコンテンツを表示するためのエリアです。
2.2. アプリケーションバー
画面上部のアプリケーションバーです。サイドメニュー開閉アイコン、ロゴ(設定時)、テナント名、全文検索(設定時)、カスタムアイテム(設定時)、ユーザーメニューで構成されています。
ユーザーメニュー
管理・設定
開発者向けの管理コンソール(AdminConsole)を起動します。管理者のみが利用できます。
ただし、モバイル幅のディスプレイではメニューに表示されません。
ライト/ダークテーマの変更
テナント設定の テーマ切り替えの有効化
が有効になっている場合、ライト/ダークテーマを切り替えることができます。
言語の変更
テナント設定の 多言語機能
を利用する設定が有効になっている場合、他の言語に切り替えることができます。
ナヴィゲーション変更
ユーザーにマッチするロールが複数であり、それに対応するNavigation定義も複数の場合に表示されます。
対象のナヴィゲーションを選択することで、表示されるナヴィゲーションとTop画面が変更されます。
プレビュー日付
テナント設定の 日付プレビュー表示機能
が有効になっている場合、特定の日時を現在日時としてプレビューすることができます。
特定の日時における表示を確認したい場合に利用します。
ユーザー情報変更
ユーザーが自身の情報を変更する画面を表示します。初期状態ではパスワードのみ変更可能です。
Navigation定義の設定によってユーザー情報の変更が可能になります。
アプリケーション管理
ユーザーに設定されているOAuthのクライアント情報の閲覧とメンテナンス(削除)、有効なRememberMe設定の閲覧とメンテナンス(無効化)、個人アクセストークンのメンテナンス(生成/削除)が可能なアプリケーション管理画面を表示します。
代理ログイン
代理ログイン機能(代理ログイン/解除、代理ログイン許可ユーザーの選択)へのリンクを表示します。
代理ログインする
他のユーザーに成り代わってログインします。権限などは代理ログインしたユーザーのものになります。
認証ポリシーの設定により、代理ログイン機能が利用できる場合に表示されます。
代理ログインしている場合は、「代理ログインを解除」メニューが表示されます。
代理ログインの許可
他のユーザーに対して、自身に成り代わって操作することを許可します。
代理ログインを許可するユーザーと許可期間を指定します。
2段階認証
2段階認証の情報を表示します。Navigation定義に TwoStep Verification が設定されているか、ログインしているユーザーの認証ポリシーに1つ以上の2段階認証方式が設定されている場合に表示されます。認証ポリシーにおける2段階認証の詳細については、2段階認証を参照してください。
初期状態では、ログインしているユーザーの認証ポリシーに紐づく2段階認証の情報が表示されます。
Navigation定義で TwoStep Verification が設定されている場合には、 TwoStep Verification で 2段階認証が設定された認証ポリシー
として指定した認証ポリシーに紐づく2段階認証の情報が表示されます。また、2段階認証設定の有効化/無効化(認証ポリシーの切り替え)が利用できるようになります。
2段階認証画面上の有効/無効スイッチを押下すると、Navigation定義の TwoStep Verification
で設定されている、 2段階認証が設定された認証ポリシー(有効の場合)
/ 2段階認証が設定されていない認証ポリシー(無効の場合)
にユーザーの認証ポリシーを切り替えることができます。
2段階認証(時間ベース)
2段階認証(時間ベース)のポリシーが設定されている場合、2段階認証(時間ベース)を設定することができます。
設定ボタンを押下すると、2段階認証(時間ベース)設定画面が表示されます。
2段階認証(時間ベース)が設定されている場合は、解除ボタンが表示されます。
ログアウト
現在ログイン中のユーザーをログアウトします。 ログアウト後はログイン画面が表示されます。
全文検索
全文検索機能が利用可能な場合、ユーザーメニューの左側に全文検索用アイコンが表示されます。アイコンをクリックすると全文検索ダイアログが表示されます。
全文検索の対象とするエンティティと検索キーワードを入力し、検索ボタンを押すと、全文検索結果が表示されます。
カスタムアイテム
Navigationで定義したカスタムアイテムを表示します。表示ラベル、アイコン、クリックイベント、表示エリア(アプリケーションバー、ユーザーメニュー)を設定できます。
2.3. サイドメニュー
Top画面やEntityView、Action等と紐づくアイテムを一覧表示するメニューです。
iPLAssについて
アプリケーションのライセンス条項を表示します。 iPLAssが利用するライブラリに関するライセンスも併せて表示します。
3. Navigationの管理
3.1. Navigationの作成
AdminConsoleのメニューから Navigation
を右クリックし、 Navigationを作成する
を選択します。
表示されたダイアログの Name
には対応するロールコードを設定して下さい。
3.2. 設定
画面上の上半分がアプリケーションバーの設定、下半分がサイドメニューの設定という構成になっています。
Navigationでの設定項目です。
設定項目 | 利用箇所 | 説明 | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Display Order |
ナヴィゲーション切り替え |
ナヴィゲーション切り替えでの表示順序を指定します。 以下の順番によりソートを行います。
|
||||||||||||||||
Show Display Name |
ナヴィゲーション切り替え |
ナヴィゲーション切り替えで表示する名称をNavigation定義の表示名にします。未チェック時はロール名( = Navigation定義名)を表示します。 |
||||||||||||||||
Search Menu Enabled |
メニューの検索 |
メニューの検索機能を有効にするかを指定します。 |
アプリケーションバー
左側のドロップ可能領域に対して、右側の Items
からパーツをドラッグ&ドロップしてパーツの配置/編集を行います。
標準提供するパーツには以下のものがあります。いずれのパーツも複数配置することはできません。
パーツ名 | 説明 |
---|---|
Preview Date |
プレビュー日付機能へのリンクを表示する場合に設定するパーツです。 |
Application Maintenance |
アプリケーション管理機能へのリンクを表示する場合に設定するパーツです。 |
FullText Search |
全文検索の設定を行うパーツです。 |
TwoStep Verification |
2段階認証の設定を行うパーツです。 |
User Impersonation |
代理ログインの設定を行うパーツです。 |
User Maintenance |
ユーザー情報変更でユーザー自身に情報を変更させる場合に設定するパーツです。 |
Custom Item |
カスタムアイテムの設定を行うパーツです。 |
各パーツのアイコンをクリックすることで、パーツの詳細設定ができます。 ここからは各パーツの詳細設定について説明します。
Preview Date
テナント設定の 日付プレビュー表示機能
が有効になっている場合、特定の日時を現在日時としてプレビューすることができます。
特定の日時における表示を確認したい場合に利用します。
設定項目 | 設定内容 |
---|---|
Title |
タイトルをカスタマイズしたい場合に設定します。未指定の場合のデフォルトは、 |
Use Preview Date |
プレビュー日付の管理機能を有効化するかを指定します。 |
Application Maintenance
ユーザーメニューでアプリケーション管理機能へのリンクを表示する場合に設定を行います。
アプリケーションの管理画面では、ユーザーに設定されているOAuthのクライアント情報の閲覧とメンテナンス(削除)、有効なRememberMe設定の閲覧とメンテナンス(無効化)、個人アクセストークンのメンテナンス(生成/削除)が可能です。
個人アクセストークンとは、iPLAssで定義したWeb APIへのBearer Tokenによる認証でID/パスワードの代わりに使用できる認証トークンです。
設定項目 | 設定内容 |
---|---|
Title |
タイトルをカスタマイズしたい場合に設定します。未指定の場合のデフォルトは、 |
Use Personal access token |
個人アクセストークンの管理機能を有効化するかを指定します。 |
FullText Search
MDCモジュールで全文検索機能を利用する場合に設定します。
全文検索のクロール対象とした各Entityに対して、表示可否やEntityViewの対象Viewを指定します。
設定項目 | 設定内容 |
---|---|
Show FullTextSearch Window |
チェックを入れると、アプリケーションバーに全文検索用のアイコンが表示されます。 |
Entity Name |
全文検索のクロール対象としたEntityの表示名が表示されます。編集不可な項目です。 |
View Name |
全文検索の結果表示で利用するEntityViewのView名を指定します。Entity毎に設定可能です。 |
Show in search list |
チェックを入れると、全文検索の対象となります。Entity毎に設定可能です。 |
TwoStep Verification
2段階認証の情報を表示します。また、2段階認証設定の有効化/無効化の切り替えが利用できるようになります(2段階認証の有効化/無効化は認証ポリシーの切り替えによって実現する仕組みです)。
Authentication Policy Without TwoStep Verification
と Authentication Policy With TwoStep Verification
の両方が設定されている場合、2段階認証設定の有効化/無効化(認証ポリシーの切り替え)を利用することができます。
設定項目 | 設定内容 |
---|---|
Authentication Policy Without TwoStep Verification |
2段階認証ポリシーが設定されていない認証ポリシーを設定します。 |
Authentication Policy With TwoStep Verification |
2段階認証ポリシーが設定されている認証ポリシーを設定します。 |
User Impersonation
ユーザーメニューで代理ログイン機能(代理ログイン許可ユーザーの選択)へのリンクを表示する場合に設定を行います。
設定項目 | 設定内容 |
---|---|
Can Impersonation To |
代理ログイン許可ユーザーの設定可否を指定します。 |
User View |
ユーザーを検索する際に用いるユーザー情報( |
初期状態では、ユーザー情報にMDC用のEntityViewは登録されていません。必要に応じてユーザー情報のEntityViewを作成してください。
User Maintenance
ユーザーメニューでユーザー情報変更を選択した際に、ユーザー自身に情報を変更させるための設定を行います。
ユーザーが編集可能な項目は設定したViewの内容に依存します。パーツ未指定時はパスワードの変更のみ可能です。
設定項目 | 設定内容 |
---|---|
User View |
ユーザーが自身の情報を変更するための画面で用いるユーザー情報( |
初期状態では、ユーザー情報にMDC用のEntityViewは登録されていません。ユーザーが自身の情報を変更するための画面で利用するユーザー情報のEntityViewを作成してください。
なお、ユーザーに権限に絡む項目など必要以上の項目を編集させないように注意してください。
Custom Item
アプリケーションバーやユーザーメニューにカスタムアイテムを表示したい場合に設定します。
表示ラベル、アイコン、クリックイベント、表示エリア(アプリケーションバー、ユーザーメニュー)を設定できます。
設定項目 | 設定内容 |
---|---|
Display Label |
画面で表示するラベルを設定します。 |
Icon Tag |
Material Design Iconsのアイコンタグを設定できます。(例:mdi-note) |
AppBar Item Display Area |
カスタムアイテム表示する位置を設定します。
|
Custom Event On Click |
アイテムクリック時に実行されるJavaScriptコードを設定します。 |
サイドメニュー
左側のドロップ可能領域に対して、右側のメニューアイテムリストからメニューアイテムをドラッグ&ドロップして編集を行います。また、配置したメニューアイテムをドロップ可能領域内でドラッグ&ドロップすることで、順序を変更することができます。
ドロップ可能領域に追加したメニューアイテムの編集や削除(ドロップ可能領域からの削除)は右クリックで表示されるコンテキストメニューから実行します。また、各メニューアイテムをダブルクリックした場合は、該当メニューアイテムの編集画面が表示されます。
メニューアイテム自体を追加したい場合は、メニューアイテムリスト領域で、NodeMenuItem
、 ActionMenuItem
、 EntityMenuItem
、 UrlMenuItem
から追加したいメニューアイテムのフォルダを右クリックし、表示されるコンテキストメニューから実行します。
メニューアイテム自体を編集/削除したい場合は、メニューアイテムリスト領域で、対象のメニューアイテムを右クリックして表示されるコンテキストメニューから実行します。各アイテムをダブルクリックした場合は該当メニューアイテムの編集画面が表示されます。
AdminConsole上からエンティティを新規で作成した場合、 DEFAULT
定義の一番下に自動的にEntityMenuItemが追加されます。
メニューアイテムは NodeMenuItem
、 ActionMenuItem
、 EntityMenuItem
、 UrlMenuItem
の4種類に分類されます。
登録済のメニューアイテムをダブルクリックするか、右クリックでコンテキストメニューからメニューアイテムを編集します。
編集した内容は利用されているドロップ可能領域にも反映されます。 また。メニューアイテムを削除した場合も利用されているドロップ可能領域から削除されます。
NodeMenuItem
階層を表すメニューアイテムです。このメニューアイテムの下に他のメニューアイテムを配置できます。
最大3階層までネストすることが可能です( NodeMenuItem
を2つまでネストして利用可能です)。
項目 | 内容 |
---|---|
Name |
識別名です。
|
Display Name |
サイドメニューに表示される名称です。 |
Description |
説明を記載します。 |
Icon URL |
メニューアイテムの先頭に付与するアイコンをURLで指定します。 以下のルールによりパスを判断します。
|
Icon Tag |
Material Design Iconsのアイコンタグを設定できます。(例:mdi-note) |
Image Color |
|
ActionMenuItem
定義された任意のActionを実行する為のメニューアイテムです。
項目 | 内容 |
---|---|
Name |
識別名です。
|
Display Name |
サイドメニューに表示される名称です。 |
Description |
説明を記載します。 |
Icon URL |
メニューアイテムの先頭に付与するアイコンをURLで指定します。 以下のルールによりパスを判断します。
|
Icon Tag |
Material Design Iconsのアイコンタグを設定できます。(例:mdi-note) |
Image Color |
|
Execute Action |
メニューがクリックされた際に実行するAction定義を選択します。 |
Parameter |
実行Actionに渡すパラメータを指定します。 (例:defName=OrderItemAggregate) |
Dynamic Customize Setting |
実行時にメニューアイテムの設定をカスタマイズするGroovyScriptを設定します。 以下の項目がバインドされており、設定のカスタマイズは下記項目を変更することで行えます。
|
EntityMenuItem
別途定義された任意のエンティティの検索画面を表示する為のメニューアイテムです。 AdminConsole上からエンティティを作成した場合は、自動的に対応するEntityMenuItemが作成されます。
ツールやパッケージ機能でエンティティ定義のみをインポートした場合は自動的には作成されません。 インポートしたエンティティに対してメニューを表示したい場合は、手動でEntityMenuItemを作成してください。
項目 | 内容 |
---|---|
Name |
識別名です。
|
Display Name |
サイドメニューに表示される名称です。未指定の場合、エンティティの表示名が利用されます。 |
Description |
説明を記載します。 |
Icon URL |
メニューアイテムの先頭に付与するアイコンをURLで指定します。 以下のルールによりパスを判断します。
|
Icon Tag |
Material Design Iconsのアイコンタグを設定できます。(例:mdi-note) |
Image Color |
|
Entity |
メニューアイテムがクリックされた際に操作対象とするエンティティを選択します。 |
View Name |
表示するEntityViewのView名を指定します。 未指定の場合、Parameterでの設定があればそれを優先し、Parameterにも無い場合はデフォルトのViewを表示します。 |
Parameter |
検索画面表示時のリクエストパラメータを指定することが可能です。
|
show with execute search |
画面表示時に検索を実行します。 |
Dynamic Customize Setting |
実行時にメニューアイテムの設定をカスタマイズするGroovyScriptを設定します。 以下の項目がバインドされており、設定のカスタマイズは下記項目を変更することで行えます。
|
UrlMenuItem
任意のURLを表示する為のメニューアイテムです。
項目 | 内容 |
---|---|
Name |
識別名です。
|
Display Name |
サイドメニューに表示される名称です。 |
Description |
説明を記載します。 |
Icon URL |
メニューアイテムの先頭に付与するアイコンをURLで指定します。 以下のルールによりパスを判断します。
|
Icon Tag |
Material Design Iconsのアイコンタグを設定できます。(例:mdi-note) |
Image Color |
|
URL |
表示対象のURLを設定します。 URLのパスはIcon URLと同様のルールで判断されます。 |
Parameter |
URLに付与するクエリ文字列を設定します。 (例:name=aaaa&value=bbbb….) |
show new window |
メニューアイテムクリック時に新しいページ(ウィンドウまたはタブ)で開きます。 |
Dynamic Customize Setting |
実行時にメニューアイテムの設定をカスタマイズするGroovyScriptを設定します。 以下の項目がバインドされており、設定のカスタマイズは下記項目を変更することで行えます。
|
4. ロールとの連動
mtp.auth.Role
エンティティのロールコードとNavigationの定義名が連動しており、ユーザーにマッチするロールに対応するNavigation定義を元にナヴィゲーションを表示します。
ユーザーにマッチするロールに対応するNavigation定義が存在しない場合は、 DEFAULT
定義を元にナヴィゲーションを表示します。 DEFAULT
定義も存在しない場合には、ナヴィゲーションにはデフォルト項目のみが表示されます。 DEFAULT
定義は、管理者によるナビゲーション変更か、Navigation定義が存在しないロールの場合にのみ使用されるデフォルトのNavigation定義です。
TopView も同様にロールと連動しています。ユーザーにマッチするロールが複数であり、それに対応するNavigation定義も複数の場合には、画面右上のユーザーメニューに ナヴィゲーション変更
が表示されます。対象のナヴィゲーションを選択することで、表示されるナヴィゲーションが変更されます。