Menus
Les menus fournissent des chemins de navigation dans les applications composites. Pour implémenter un menu dans une application composite, vous devez le créer et le définir, puis l'ajouter à une application composite.
Création d'un menu
1. Dans Composer, choisissez > , puis cliquez sur le bouton Nouveau.
2. Entrez un nom, un nom affiché et une description pour le nouveau menu.
3. Si vous le souhaitez, vous pouvez ajouter des projets et des tags. Cliquez ensuite sur Enregistrer.
Définition d'un menu
Dans la zone Définition de menu du nouveau menu, procédez comme suit :
1. Si vous le souhaitez, sélectionnez une icône pour représenter l'élément de menu, puis associez au menu les groupes d'utilisateurs appropriés.
2. Pour chaque élément du menu, cliquez sur le bouton Ajouter, puis entrez les informations suivantes :
|
Options
|
Description
|
|---|---|
|
Type
|
• Application composite : ouvre une application composite lorsque vous cliquez sur cette option.
• Menu : ouvre un autre menu lorsque vous cliquez sur cette option. Cette option permet la création de structures multiniveau.
• Hyperlien : ouvre un lien hypertexte lorsque vous cliquez sur cette option.
• Déconnexion
|
|
Titre
|
Titre de l'élément de menu. Les menus doivent avoir des titres uniques. Les titres de menu en double entraînent la fusion des permissions.
|
|
Lien
|
Liens vers une application composite ou lien hypertexte.
|
|
Cible
|
Vérifie si la page spécifiée dans le champ Lien est ouverte dans une nouvelle page ou dans l'actuelle.
Lorsque le type sélectionné est Menu, entrez le nom du sous-menu pour ouvrir ce champ.
|
|
Icône
|
Image affichée avec le texte du titre.
|
|
Groupes
|
Groupes appartenant à l'élément de menu.
|
|
Par défaut
|
Définit l'élément de menu sélectionnée par défaut.
|
3. Cliquez sur 
pour enregistrer vos modifications.
pour enregistrer vos modifications.Ajout d'un menu à une application composite
 | Le widget Menu n'est pas un widget dynamique. Par conséquent, un panneau est requis lorsque ce widget est intégré dans une application composite dynamique. |
Pour ajouter le menu configuré à une application composite, faites glisser et déposez un widget Menu sur votre application composite, puis sélectionnez le menu voulu dans le champ Menu du panneau de propriétés du widget. Vérifiez également que le paramètre ConfiguredOrData est défini sur Configuré dans les propriétés du widget. Le paramètre Levels peut être utilisé pour fractionner un menu structuré sur deux sections de l'application composite.
Ajout de permissions aux menus
Dans ThingWorx 8.3 et 8.4, vous pouvez ajouter des permissions aux menus d'objets système et aux menus d'extension en suivant l'exemple ci-dessous. Dans cet exemple, le menu est nommé testMenu.
1. Utilisez le service UpdateGroups dans le menu pour ajouter des permissions et des références de groupe.
2. Effectuez une demande POST avec le type de contenu et les en-têtes d'acceptation définis sur application/json. Le corps doit être un tableau :
https://localhost/Thingworx/Menus/testMenu/Services/UpdateGroups
{
"groupReferences": {
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
},
"menuItems": {
"menuItems": [
{
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
}
]
}
}
"groupReferences": {
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
},
"menuItems": {
"menuItems": [
{
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
}
]
}
}
3. Si vous avez plus d'un élément de menu, vous devez le définir pour chaque ligne en répétant l'action imbriquée groupReferences sous menuItems.
| | L'ordre des éléments de menu doit être pris en compte lors de la définition des permissions. Vérifiez l'ordre avant de définir les permissions. |
"menuItems": [
{
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
},
{
"groupReferences": [
{
"name": "Administrators",
"type": "Groups"
}
]
}
{
"groupReferences": [
{
"name": "Developers",
"type": "Groups"
}
]
},
{
"groupReferences": [
{
"name": "Administrators",
"type": "Groups"
}
]
}
Menus importés avec des extensions
Par défaut, si un menu est importé avec un objet d'extension, la propriété Group Associations concernant les menus et la propriété Groups concernant les options de menu sont modifiables.
| | Si vous importez une version actualisée de l'extension qui contient le menu, les modifications effectuées dans Composer sont fusionnées avec toutes les modifications apportées à l'extension, en dehors de Composer. |