開発者向け機能：拡張機能：拡張ナビゲーションメニュー
## 概要
ナビゲーションメニューへのメニューの追加、削除等を行うための拡張機能です。
## 注意事項
パラメータ変更時は[パラメータ変更時の確認事項](/ja/manual/parameter-edit)をご確認ください。
## 制限事項
1. 拡張ナビゲーションメニューのJSONファイルを更新した後は「プリザンターを再起動」するまで反映しません。
1. [ユーザインターフェースのテーマ](/ja/manual/user-management-theme)で第2世代ユーザインターフェースのテーマの場合は、「NavigationMenu.json」または「拡張ナビゲーションメニュー」による子メニューの追加は最大3階層まで設定できます。
1. [ユーザインターフェースのテーマ](/ja/manual/user-management-theme)で第2世代ユーザインターフェースのテーマの場合は、「NavigationMenu.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|[{…},{…},…]|拡張するメニューの定義を指定します。パラメータ設定の「NavigationMenu.json」を参照ください。|
## Action一覧
Actionに指定できる操作についての一覧です。
|変数|説明|
|:--|:--|
|Append|TargetIdで指定したIDのメニューの後ろにメニューを追加します。|
|Prepend|TargetIdで指定したIDのメニューの前にメニューを追加します。|
|Remove|TargetIdで指定したIDのメニューを削除します。|
|Replace|TargetIdで指定したIDのメニューを置換します。|
|ReplaceAll|メニューをすべて置換します。|
## サンプルコード
##### JSON
```
{
"SiteIdList": [ 5000000, 5000001, 5000002 ],
"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", "5000000", "Index" ]
},
{
"Name": "飲料",
"MenuId": "Beverage",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "5000001", "Index" ]
},
{
"Name": "日用品",
"MenuId": "DailyEssentials",
"Icon": "ui-icon ui-icon-triangle-1-e",
"LinkParams": [ "Items", "5000002", "Index" ]
}
]
}
]
}
```
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/parameter-edit">パラメータ設定：パラメータ変更時の確認事項</a><span>2023/04/05 up</span></li></ul></article>
<ul><li><a href="/ja/manual/user-management-theme">ユーザ管理機能：ユーザインターフェースのテーマをカスタマイズ</a><span>2024/12/10 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />
