Cloud Software Group, Inc. EBX®
TIBCO EBX® Documentation
Mode navigation TIBCO EBX® Documentation

# Barres d'outils

## Définition

Une barre d'outils permet de personnaliser les boutons et menus affichés lors de la consultation de tables ou d'enregistrements dans un jeu de données. Les barres d'outils sont configurables dans le modèle de données via la section 'Configuration'.

Ajoutez une barre d'outils à partir de la section Barres d'outils du panneau de navigation, en cliquant sur la flèche située à droite de l'élément [ Tous les éléments ], puis en sélectionnant l'option Créer barre d'outils. Suivez ensuite l'assistant de création pour créer une barre d'outils. Une barre d'outils définit les informations suivantes :

Nom | Nom de la barre d'outils. Le nom de la barre d'outils doit être unique dans le modèle de données, il n'est pas possible de créer plusieurs barres d'outils avec le même nom. Les tables et associations pouvant utiliser des barres d'outils, utilisent ce nom pour définir la barre d'outils à utiliser.
Libellé et description | Libellés et descriptions internationalisés affichés à l'utilisateur.
Modèle de barre d'outils | Permet de créer une barre d'outils à partir d'une barre d'outils par défaut.
Emplacements | Définit les emplacements pour lesquels la barre d'outils peut être utilisée dans les jeux de données associés. Entête de table: Définit la barre d'outils à afficher en entête de la vue table par défaut. Ligne de table: Définit la barre d'outils à afficher pour chaque item de la vue table par défaut. Item de la vue tuiles: Définit la barre d'outils à afficher pour chaque item de la vue tuiles. Entête de formulaire: Définit la barre d'outils à afficher en entête du formulaire d'un enregistrement. Entête de hiérarchie: Définit la barre d'outils à afficher en entête de la hiérarchie par défaut de la table. Limitation connue Une barre d'outils définie en mode "Item de la vue tuiles" ne peut pas avoir plus de six éléments et elle ne peut avoir que des éléments de type action. L'affichage de ces boutons action est toujours en mode "Icône uniquement".

### Définir la structure d'une barre d'outils

Une barre d'outils peut définir les éléments suivants :

- Bouton action

- Bouton menu

- Séparateur

- Groupe de menu

- Action de menu

- Sous-menu

Ajoutez un de ces éléments sous une barre d'outils ou à un élément existant en cliquant sur la flèche située à droite de l'élément existant, puis en sélectionnant une option de création parmi celles présentées dans le menu. Suivez ensuite l'assistant de création pour créer un élément.

#### Bouton action

Ce type d'élément permet d'associer une action à un bouton dans une barre d'outils. L'action est exécutée lorsque l'utilisateur clique sur le bouton associé dans une barre d'outils. Un élément de type Bouton action définit les informations suivantes :

Cible | Définit si le service s'exécute sur la sélection courante ou dans un composant web. Un service s'exécutant dans un composant web n'a pas accès à la sélection courante, mais il est possible de spécifier une sélection et des paramètres spécifiques.
Service | Définit le service à exécuter lorsque l'utilisateur clique sur le bouton. Il est possible de sélectionner un service fourni, ou un service utilisateur défini dans un module ou dans le modèle de données courant. Si la cible 'Composant web' est sélectionnée, le service devra avoir été déclaré comme utilisable en tant que composant web dans les barres d'outils. ##### Voir aussi `WebComponentDeclarationContext.setAvailableAsToolbarAction`
Taille de la modale | Taille de la fenêtre modale affichant le composant web.
Redimensionnable | Indique si la fenêtre modale peut être redimensionnée.
Paramètres | Paramètres du service. Les paramètres ne peuvent être spécifiés que si la cible du service est 'Composant web'. Les valeurs spéciales suivantes sont aussi acceptées et seront interprétées en fonction du contexte au moment du lancement du service : ${current}, ${currentDataspaceOrSnapshot}, ${currentDataspace}, ${currentSnapshot}, ${currentDataset}, ${currentXpath}, ${currentNode} et ${currentPredicate}.
Libellé et description | Libellés et descriptions internationalisés affichés à l'utilisateur.
Rendu | Définit la manière d'afficher cet élément dans les jeux de données utilisant la barre d'outils. Il est possible d'afficher : l'icône seule, le texte seul, le texte avec l'icône sur la gauche ou le texte avec l'icône sur la droite.
Icône | Icône à afficher. Il est possible d'utiliser une icône parmi un ensemble d'icônes proposées, ou de faire référence à une icône en utilisant une URL.
Est en surbrillance | Indique si le bouton doit être par défaut en surbrillance.

##### Note

Un élément de type Bouton action peut uniquement être créé sous un élément de type barre d'outils.

#### Bouton menu

Ce type d'élément permet de définir un menu qui est affiché lorsque l'utilisateur clique sur le bouton associé dans une barre d'outils. Un élément de type Bouton menu définit les informations suivantes :

Libellé et description | Libellés et descriptions internationalisés affichés à l'utilisateur.
Rendu | Définit la manière d'afficher cet élément dans les jeux de données utilisant la barre d'outils. Il est possible d'afficher : l'icône seule, le texte seul, le texte avec l'icône sur la gauche ou le texte avec l'icône sur la droite.
Icône | Icône à afficher. Il est possible d'utiliser une icône parmi un ensemble d'icônes proposées, ou de faire référence à une icône en utilisant une URL.
Est en surbrillance | Indique si le bouton doit être par défaut en surbrillance.

##### Note

Un élément de type Bouton menu peut uniquement être créé sous un élément de type barre d'outils.

#### Séparateur

Ce type d'élément permet d'insérer un séparateur sous la forme d'espacements entre deux éléments d'une barre d'outils.

##### Note

Un élément de type Séparateur peut uniquement être créé sous un élément de type barre d'outils.

#### Groupe de menu

Ce type d'élément permet de définir un groupe d'éléments dans un menu. Un élément de type Groupe de menu définit les informations suivantes :

Libellé et description | Libellés et descriptions internationalisés affichés à l'utilisateur.
Type de groupe | Indique le type de groupe de menu à créer : - 'Local' permet de créer un groupe de menu vide. - 'Groupe de services' permet d'assigner un groupe de services existant à ce groupe de menu. - 'Menu builder' permet d'assigner un menu prédéfini à ce groupe de menu. Une fois créé, il n'est pas possible de changer le type de ce groupe de menu.
Nom du groupe de service | Définit un groupe de services existant à réutiliser. Un groupe de services est déclaré dans un module et peut inclure d'autres groupes de services. Tous les services contenus dans ce groupe seront affichés dans les jeux de données associés.
Nom du Menu builder | Indique le menu prédéfini à assigner à ce groupe de menu: - 'Menu par défaut "Actions"' correspond au menu 'Actions' de la barre d'outil par défaut. Les services standards et utilisateurs y sont présentés sans distinction. - 'Menu par défaut "Actions"' (avec séparateur)' a le même contenu que le menu 'Actions' de la barre d'outil par défaut, mais les services standards et utilisateurs y sont présentés séparément (d'abord les services standards, puis les services utilisateurs).
Services exclus | Définit les services à exclure du groupe de services à réutiliser. Les services exclus ne seront pas affichés dans les jeux de données associés.
Groupes de services exclus | Définit les groupes à exclure du groupe de services à réutiliser. Les services contenus dans les groupes à exclure ne seront pas affichés dans les jeux de données associés.
Politique d'affichage | Si "Filtrage intelligent", les services configurés en accès direct, c'est à dire via un bouton action ou une action de menu, seront retirés de la génération automatique de ce groupe.

##### Note

Un élément de type Groupe de menu peut uniquement être créé sous les éléments suivants :

- Bouton menu

- Sous-menu

#### Action de menu

Ce type d'élément permet d'associer une action à une entrée d'un menu dans une barre d'outils. L'action est exécutée lorsque l'utilisateur clique sur l'entrée correspondante dans un menu. Un élément de type Action de menu définit les informations suivantes :

Libellé et description | Libellés et descriptions internationalisés affichés à l'utilisateur.
Cible | Définit si le service s'exécute sur la sélection courante ou dans un composant web. Un service s'exécutant dans un composant web n'a pas accès à la sélection courante, mais il est possible de spécifier une sélection et des paramètres spécifiques.
Service | Définit le service à exécuter lorsque l'utilisateur clique sur le bouton. Il est possible de sélectionner un service fourni, ou un service utilisateur défini dans un module ou dans le modèle de données courant. Si la cible 'Composant web' est sélectionnée, le service devra avoir été déclaré comme utilisable en tant que composant web dans les barres d'outils. ##### Voir aussi `WebComponentDeclarationContext.setAvailableAsToolbarAction`
Taille de la modale | Taille de la fenêtre modale affichant le composant web.
Redimensionnable | Indique si la fenêtre modale peut être redimensionnée.
Paramètres | Paramètres du service. Les paramètres ne peuvent être spécifiés que si la cible du service est 'Composant web'. Les valeurs spéciales suivantes sont aussi acceptées et seront interprétées en fonction du contexte au moment du lancement du service : ${current}, ${currentDataspaceOrSnapshot}, ${currentDataspace}, ${currentSnapshot}, ${currentDataset}, ${currentXpath}, ${currentNode} et ${currentPredicate}.

##### Note

Un élément de type Action de menu peut uniquement être créé sous un élément de type Groupe de menu.

#### Sous-menu

Ce type d'élément permet d'ajouter un sous-menu dans un menu d'une barre d'outils. Un Sous-menu définit les informations suivantes :

Libellé et description | Libellés et descriptions internationalisés affichés à l'utilisateur.

##### Note

Un élément de type Sous-menu peut uniquement être créé sous un élément de type Groupe de menu.

### Supprimer des éléments

Tous les éléments d'une barre d'outils peuvent être supprimés de celle-ci en utilisant la flèche située à droite de l'élément à supprimer.

Si un élément contenant d'autres éléments est supprimé, alors la suppression est effectuée récursivement sur tous les éléments situés sous l'élément supprimé.

### Dupliquer des éléments existants

Pour dupliquer un élément, cliquez sur la flèche située à droite de l'élément à dupliquer. Spécifiez le nom et les propriétés de l'élément dupliqué. Toutes les propriétés de l'élément source sont dupliquées.

L'élément dupliqué est ajouté au même niveau que l'élément d'origine, en dernière position. Lorsqu'un élément contenant d'autres éléments est dupliqué, tous les sous-éléments sont dupliqués avec leurs propriétés.

### Déplacer des éléments

Pour déplacer un élément, cliquez sur la flèche et sélectionnez l'option de déplacement souhaitée.

### Associer avec des tables existantes

Pour associer une barre d'outils avec des tables existantes, cliquez sur la flèche et sélectionnez l'option Associer à des tables. Ce service permet de définir une barre d'outils en tant que barre d'outils par défaut d'un ensemble de tables. Pour cela, définissez les positions cibles de la barre d'outils et sélectionnez les tables ou types de données complexes, définissant les propriétés de la table, à associer à la barre d'outils. La barre d'outils sera définie par défaut aux positions définies sur les tables et types sélectionnées.

### Exporter les barres d'outils

Il est possible d'exporter les barres d'outils définies dans le modèle dans un document XML. Pour cela, sélectionner l'option Export XML disponible dans le menu Actions de la section 'Barres d'outils'. Suivez ensuite l'assistant pour exporter les barres d'outils.

##### Note

Une sélection de barres d'outils peut être exportée en sélectionnant dans la section 'Barres d'outils' les barres d'outils à exporter, puis en sélectionnant l'option Export XML disponible dans le menu Actions. Les barres d'outils peuvent aussi être exportées en utilisant le service d'export des modèles de données accessible depuis le menu 'Actions' du modèle de données dans le panneau de navigation.

##### Voir aussi

- Import et export de modèles de données.

### Importer des barres d'outils

Il est possible d'importer des barres d'outils existantes à partir d'un document XML. Pour cela, sélectionner l'option Import XML disponible dans le menu Actions de la section Barres d'outils. Suivez ensuite l'assistant pour importer les barres d'outils.

##### Note

Les barres d'outils peuvent aussi être importées en utilisant le service d'import de modèles de données accessible depuis le menu 'Actions' du modèle de données dans le panneau de navigation.

##### Voir aussi

- Import et export de modèles de données.

##### Voir aussi

- Utilisation des barres d'outils

Sommaire du guide utilisateur

TIBCO EBX® Documentation