Menús
Los menús proporcionan rutas de navegación dentro de mashups. Para implementar un menú dentro de un mashup, se debe crear y definir el menú y, a continuación, añadirlo a un mashup.
Creación de un menú
1. En Composer, vaya a > y, a continuación, pulse en el botón Nuevo.
2. Introduzca un nombre, el nombre mostrado y una descripción para el nuevo menú.
3. Opcionalmente, se pueden añadir proyectos y etiquetas, y luego pulsar en Guardar.
Definición de un menú
En el área Definición de menú del menú recién creado, realice lo siguiente:
1. De manera opcional, seleccione un icono para representar el elemento de menú y, a continuación, asocie los grupos de usuarios adecuados al menú.
2. Para cada elemento del menú, pulse en el botón Añadir e introduzca la siguiente información:
|
Opciones
|
Descripción
|
|---|---|
|
Tipo
|
• Mashup: permite abrir un mashup cuando se pulsa en él.
• Menú: permite abrir otro menú cuando se pulsa en él. Esta opción permite la creación de estructuras multinivel.
• Hipervínculo: permite abrir un hipervínculo cuando se pulsa en él.
• Desconectar
|
|
Título
|
Título del elemento de menú. Los menús deben tener títulos únicos. Los títulos de menú duplicados harán que se combinen los permisos.
|
|
Vínculo
|
Permite vincular a un mashup o un hipervínculo.
|
|
Destino
|
Permite controlar si la página especificada en el campo Vínculo se abre en otra página o en la actual.
Cuando el tipo seleccionado es Menú, introduzca el nombre del submenú para abrir este campo.
|
|
Icono
|
Imagen que se muestra con el texto del título.
|
|
Grupos
|
Grupos que pertenecen al elemento de menú.
|
|
Por defecto
|
Permite definir qué elemento de menú se selecciona por defecto.
|
3. Pulse en 
para guardar los cambios.
para guardar los cambios.Adición de un menú a un mashup
 |
El widget de menú no es un widget dinámico. Como resultado, se requiere un panel cuando se inserta este widget en un mashup dinámico.
|
Para añadir un menú configurado a un mashup, arrastre y suelte un widget de menú en el mashup y seleccione el menú deseado en el campo Menú del panel de propiedades del widget. Asimismo, asegúrese de que el parámetro ConfiguredOrData esté definido en Configurado en las propiedades del widget. El parámetro Levels se puede utilizar para dividir un menú estructurado en dos secciones del mashup.
Adición de permisos a menús
En ThingWorx 8.3 y 8.4, se pueden añadir permisos a los menús de objetos del sistema y los menús de extensiones como se muestra en el siguiente ejemplo. En este ejemplo, el menú se denomina testMenu.
1. Utilice el servicio UpdateGroups en el menú para añadir permisos y referencias de grupo.
2. Cree una solicitud POST con el tipo de contenido y acepte los encabezados definidos en application/json. El cuerpo debe estar formado por matrices:
https://localhost/Thingworx/Menus/testMenu/Services/UpdateGroups
{
"groupReferences": {
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
},
"menuItems": {
"menuItems": [
{
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
}
]
}
}
3. Si hay más de un elemento de menú, se debe definir para cada fila repitiendo la propiedad groupReferences anidada en menuItems.
|
|
El orden de los elementos de menú se debe tener en cuenta al definir permisos. Verifique el orden antes de definir los permisos.
|
{
"groupReferences": {
"groupReferences": [
{
"name": "Developers",
"type": "Group"
}
]
},
"menuItems": {
"menuItems": [
{
"groupReferences": [
{
"name": "Developers",
"type": "Group"
}
]
}
]
}
}
Menús importados con extensiones
Por defecto, si se importa un menú con un objeto de extensión, la propiedad Group Associations de los menús y la propiedad Groups de los elementos de menú son editables.
|
|
Si se importa una versión actualizada de la extensión que contiene el menú, los cambios realizados en Composer se combinarán con los cambios realizados en la extensión, fuera de Composer.
|