菜单
菜单提供混搭内的导航路径。要在混搭中实现菜单,您需要创建和定义菜单,然后将其添加到混搭。
创建菜单
1. 在 Composer 中,浏览至“可视化” > “菜单”,然后单击“新建”按钮。
2. 输入新菜单的名称、显示名称和说明。
3. 或者,可以添加项目和标记,然后单击“保存”
定义菜单
在新建菜单的“菜单定义”区域中,执行以下操作:
1. 或者,选择一个图标来表示菜单项,然后将相应的用户组关联到该菜单。
2. 针对该菜单中的每个项,单击“添加”按钮,并输入下列信息:
新建菜单项
选项
说明
“类型”
“混搭”- 单击后将打开混搭。
“菜单”- 单击后将打开其他菜单。此选项可创建多级结构。
“超级链接”- 单击后将打开超级链接。
“退出登录”
“标题”
菜单项的标题。菜单必须具有唯一标题。重复的菜单标题将导致权限合并。
“链接”
指向混搭或超链接的链接。
“目标”
控制在“链接”字段中指定的页面是在新页面中打开还是在当前页面中打开。
所选类型为“菜单”时,输入子菜单的名称可打开此字段。
“图标”
与标题文本一起显示的图像。
“组”
属于菜单项的组。
“默认”
定义默认选择的菜单项。
3. 单击 以保存您的更改。
向混搭添加菜单
* 
“菜单”小组件不是响应式小组件。因此,在将此小组件插入响应式混搭时,需要一个面板。
要将已配置的菜单添加到混搭,请将菜单小组件拖放到混搭上,并在小组件属性面板的“菜单”字段中选择所需的菜单。此外,请确保已在小组件属性中将 ConfiguredOrData 参数设置为“已配置”Levels 参数可用于将结构化菜单拆分到混搭的两个部分。
将权限添加至菜单
在 ThingWorx 8.3 和 8.4 中,可通过遵循以下示例中的步骤将权限添加至系统对象菜单和扩展菜单。此示例中的菜单名为 testMenu
1. 使用菜单上的 UpdateGroups 服务来添加权限和组引用。
2. 发送带有内容类型的 POST 请求,并接受将标题设置为 application/json。主体必须是数组:
https://localhost/Thingworx/Menus/testMenu/Services/UpdateGroups
{
"groupReferences": {
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
},
"menuItems": {
"menuItems": [
{
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
}
]
}
}
3. 如果有多个菜单项,则必须通过在 menuItems 下重复嵌套的 groupReferences 来针对每一行对菜单项进行设置。
* 
设置权限时必须考虑菜单项的顺序。请在设置权限前验证顺序。
"menuItems": [
{
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
},
{
"groupReferences": [
{
"name": "Administrators",
"type": "Groups"
}
]
}
导入菜单时带有扩展
默认情况下,如果导入菜单时带有扩展对象,则可编辑菜单的 Group Associations 属性和菜单项的 Groups 属性。
* 
如果导入的扩展的已更新版本包含菜单,则在 Composer 中所做的更改将会与在 Composer 外部扩展中所做的任何更改合并。