開発者向け機能：拡張機能：拡張ナビゲーションメニュー
概要¶
ナビゲーションメニューへのメニューの追加、削除等を行うための拡張機能です。
注意事項¶
パラメータ変更時はパラメータ変更時の確認事項を確認してください。
制限事項¶
- 拡張ナビゲーションメニューのJSONファイルを更新した後は「プリザンターを再起動」するまで反映しません。
- ユーザインターフェースのテーマで第2世代ユーザインターフェースのテーマの場合は、NavigationMenus.jsonまたは「拡張ナビゲーションメニュー」による子メニューの追加は最大3階層まで設定できます。
- ユーザインターフェースのテーマで第2世代ユーザインターフェースのテーマの場合は、NavigationMenus.jsonまたは「拡張ナビゲーションメニュー」によるIconの指定には対応していません。
設定方法¶
.\Pleasanter\App_Data\Parameters\ExtendedNavigationMenus\配下に以下の内容を含むJSONファイルを作成し、「アプリケーションを再起動」してください。ファイルの拡張子は必ずjsonにしてください。ExtendedNavigationMenus配下はフォルダで階層化する事が可能です。この場合、配下の全てのJSONファイルが設定ファイルとして読み込まれます。
パラメータリスト¶
JSONファイルに指定するパラメータは以下の通りです。
| パラメータ名 | 設定例 | 説明 |
|---|---|---|
| Description | "この拡張ナビゲーションメニューは…を表示します" | 拡張ナビゲーションメニューの説明。動作には影響しません。 |
| Disabled | false | trueの場合は無効化され動作しません。 |
| DeptIdList | [1,2,3] | 対象となる組織IDを配列形式で指定します。指定しない場合には省略可能です。 |
| GroupIdList | [1,2,3] | 対象となるグループIDを配列形式で指定します。指定しない場合には省略可能です。 |
| UserIdList | [1,2,3] | 対象となるユーザIDを配列形式で指定します。指定しない場合には省略可能です。 |
| SiteIdList | [1,2,3] | 対象となるサイトのサイトIDを配列形式で指定します。指定しない場合には省略可能です。 |
| IdList | [1,2,3] | 対象となるレコードのIDを配列形式で指定します。指定しない場合には省略可能です。 |
| TargetId | "NewMenu" | Actionで指定した操作をする時の対象となるIDを指定します。 |
| Action | "Append" | メニューの追加、削除等の操作を指定します。 |
| NavigationMenus | [{…},{…},…] | 拡張するメニューの定義を指定します。パラメータ設定のNavigationMenus.jsonを参照ください。 |
TargetId一覧¶
| ナビゲーションメニュー | TargetId |
|---|---|
 | NewMenu |
 | ViewModeMenu |
 | SettingsMenu |
 | HelpMenu |
 | AccountMenu |
Action一覧¶
Actionに指定できる操作についての一覧です。
| 変数 | 説明 |
|---|---|
| Prepend | TargetIdで指定したIDのメニューの前にメニューを追加します。 |
| Append | TargetIdで指定したIDのメニューの後ろにメニューを追加します。 |
| Remove | TargetIdで指定したIDのメニューを削除します。 |
| Replace | TargetIdで指定したIDのメニューを置換します。 |
| ReplaceAll | メニューをすべて置換します。 |
サンプルコード¶
❶ 新規作成（NewMenu）の前（上）に追加
表示結果¶
青枠がTargetIdの指すナビゲーションメニュー、赤枠が置換後のナビゲーションメニューです。
➋ 新規作成（NewMenu）の後（下）に追加
{
"TargetId": "NewMenu",
"Action": "Append",
"NavigationMenus": [
{
"ContainerId": "ProductManagementContainer",
"MenuId": "ProductManagement",
"Name": "商品管理",
"Icon": "ui-icon ui-icon-gear",
"ChildMenus": [
{
"Name": "食品",
"MenuId": "Food",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "569", "Index" ]
},
{
"Name": "飲料",
"MenuId": "Beverage",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "570", "Index" ]
},
{
"Name": "日用品",
"MenuId": "DailyEssentials",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "571", "Index" ]
}
]
}
]
}
表示結果¶
青枠がTargetIdの指すナビゲーションメニュー、赤枠が置換後のナビゲーションメニューです。
❹ ヘルプメニュー（HelpMenu）を置換（Replace）
{
"TargetId": "HelpMenu",
"Action": "Replace",
"NavigationMenus": [
{
"ContainerId": "ProductManagementContainer",
"MenuId": "ProductManagement",
"Name": "商品管理",
"Icon": "ui-icon ui-icon-gear",
"ChildMenus": [
{
"Name": "食品",
"MenuId": "Food",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "569", "Index" ]
},
{
"Name": "飲料",
"MenuId": "Beverage",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "570", "Index" ]
},
{
"Name": "日用品",
"MenuId": "DailyEssentials",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "571", "Index" ]
}
]
}
]
}
表示結果¶
青枠がTargetIdの指すナビゲーションメニュー、赤枠が置換後のナビゲーションメニューです。
❺ 全メニューを置換（ReplaceAll）
{
"TargetId": "HelpMenu",
"Action": "ReplaceAll",
"NavigationMenus": [
{
"ContainerId": "ProductManagementContainer",
"MenuId": "ProductManagement",
"Name": "商品管理",
"Icon": "ui-icon ui-icon-gear",
"ChildMenus": [
{
"Name": "食品",
"MenuId": "Food",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "569", "Index" ]
},
{
"Name": "飲料",
"MenuId": "Beverage",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "570", "Index" ]
},
{
"Name": "日用品",
"MenuId": "DailyEssentials",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "571", "Index" ]
}
]
}
]
}
表示結果¶
青枠がReplaceAllの対象となるナビゲーションメニュー、赤枠が置換後のナビゲーションメニューです。
