Utilisation et exemple

L'extension Web Liste d'éléments dispose de paramètres pour sa fonctionnalité essentielle, ainsi que de paramètres supplémentaires pour personnaliser son contenu.

Les paramètres principaux sont les suivants :

Clés d'éléments : référence à une plage de cellules contenant les noms uniques des éléments et des actions pour traitement ultérieur. Lorsqu'une action est déclenchée, Actions.Input.Text envoie l'une des valeurs suivantes :
- Actions.Input.Text="Row" : L'élément est sélectionné.
- Actions.Input.Text="Edit" : Un clic a été effectué sur le bouton Modifier.
- Actions.Input.Text="Delete" : Un clic a été effectué sur le bouton Supprimer.
Données de l'élément : référence à une plage de cellules contenant des données d'éléments ou à une cellule contenant du XML des mêmes données. La première colonne de la plage de données est réservée aux propriétés facultatives de clés d'éléments :
Titre (chaîne)
Description 1 (chaîne)
Description 2 (chaîne)
Horodatage (chaîne)
Visible (booléenne) : si cette propriété est définie sur False, l'élément est masqué. True est la valeur par défaut.
Activé (booléenne) : si cette propriété est False, l'élément est désactivé. True est la valeur par défaut.
Sélectionné (booléenne) : si cette propriété est définie sur True, l'élément est sélectionné. False est la valeur par défaut.
Modifier (booléenne) : si cette propriété est définie sur True, les icônes Modifier et supprimer apparaissent. False est la valeur par défaut.

Ces paramètres supplémentaires permettent de personnaliser le contenu. Entrer ="" pour utiliser les paramètres par défaut, le cas échéant.

Remarque

Lorsque du texte peut être spécifié, par exemple pour le message d'erreur, utiliser la fonction TRANSLATEUNIQUESTRING pour s'assurer que le texte est traduit si la langue de l'interface utilisateur est modifiée.

Sélection multiple : si cette propriété est définie sur True, la sélection multiple est activée. False est la valeur par défaut.
Espace réservé pour la zone de recherche : par défaut, la zone de recherche est visible et vide. Spécifier False pour désactiver la case à cocher.
Message d'erreur : par défaut, s'il n'y a pas d'éléments de liste, le message d'erreur est Aucun élément disponible.
Titre principal : titre de la liste. Par défaut, aucun titre n'est affiché.
Couleur du titre principal : la couleur par défaut du titre est #368ac0.
Couleur du titre : la couleur par défaut de la police du titre est #1a1a1a.
Couleur sélectionnée : couleur dans laquelle la ligne sélectionnée est mise en surbrillance. La valeur par défaut est #c8e9f4.
Texte des éléments sélectionné : par défaut, le texte est sélectionné. Ce paramètre n'est applicable que si la sélection multiple est activée.
Supprimer l'action : définit une action sur une cellule, déclenchée par un clic sur le bouton Supprimer. Le texte par défaut est Supprimer. Ce paramètre n'est applicable que si la sélection multiple est activée.
Masquer les bordures latérales : spécifier True pour masquer les bordures de gauche et de droite de la ligne. Par défaut, les bordures sont visibles.
Couleur des bordures : par défaut, la couleur des bordures est #d8d8d8.

Créer un rapport Application Studio.

Insérer ces données d'exemple dans la plage B8:H12 :


Clé	Titre	Description1	Description2	Activé	Sélectionné	Modifier
a	Élément A	Description A			FALSE	TRUE
b	Élément B	Description B	Informations détaillées B	FALSE	FALSE	FALSE
b	Élément C	Description C			TRUE	FALSE
d	Élément D	Description D			FALSE	FALSE

Créer une variable de rapport intitulée rv_SelectedItem et spécifier c comme valeur et valeur par défaut, et la sélectionner comme sa valeur. Dans les propriétés de la variable, spécifier False comme valeur de l'option Est persistante.
Dans la cellule G9, spécifier =ReportVariables.rv_SelectedItem.Text=B9. Copier la formule dans les cellules G10, G11 et G12.
Après cette mise à jour, les cellules conservent leurs textes d'origine.
Sur chacune des cellules clés (B9, B10, B11 et B12), créer une action avec les caractéristiques suivantes :

Actions : Type

Sélectionner Définir les paramètres comme type d'action.

Actions : Mode

Sélectionner Extension Web comme mode.

Actions : Condition

Spécifier =Actions.Input.Text="ROW".

Remarque
Cette condition n'est pas valide, sauf si le mode d'action est Extension Web.

Paramètres : Nom

Cliquer sur Ajouter un paramètre et sélectionner la variable rv_SelectedItem.

Paramètres : Propriété

Spécifier Selected Value(.Text).

Paramètres : Valeur

Pour l'action dans B9, spécifier =B9. Pour les autres actions, spécifier =B10, =B11 et =B12 respectivement.
Créer une variable de rapport intitulée rv_TitleItemA et spécifier l'élément A comme valeur. Dans les propriétés de la variable, spécifier l'élément A comme valeur par défaut et sélectionner False comme valeur de l'option Est persistante.
Dans la cellule C9, spécifier =ReportVariables.rv_TitleItemA.Text et appuyer sur Entrée.
Après cette mise à jour, la cellule conserve son texte d'origine.
Dans la cellule B9, créer une action avec les caractéristiques suivantes :

Actions : Type

Sélectionner Définir les paramètres comme type d'action.

Actions : Mode

Sélectionner Extension Web comme mode.

Actions : Condition

Spécifier =Actions.Input.Text="EDIT"

Remarque
Cette condition n'est pas valide, sauf si le mode d'action est Extension Web.

Paramètres : Nom

Cliquer sur Ajouter un paramètre et sélectionner la variable rv_TitleItemA.

Paramètres : Propriété

Sélectionner Value(.Text)

Paramètres : Valeur

Spécifier ="Edited Item A".

Dans la cellule B13, spécifier la formule SETPROPERTY suivante :

=SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)

Cliquer sur Extension Web dans la barre d'outils Objets et double-cliquer sur l'extension Web Liste d'éléments.
Le curseur prend la forme d'une croix.
Faire glisser le curseur pour insérer, dimensionner et positionner l'extension Web.
Spécifier les paramètres suivants :

Noms uniques

Spécifier la plage de cellules contenant les noms uniques des éléments de liste. Dans cet exemple, spécifier =B9:B12.

Données de l'élément

Spécifier la plage de cellules qui définit la table de données pour l'extension. Dans cet exemple, spécifier =B13.
Si nécessaire, entrer des valeurs pour ces paramètres ou spécifier ="" pour utiliser les valeurs par défaut.

Titre principal

Par défaut, la liste n'a pas de titre. Si nécessaire, définir un mot de passe.

Couleur de police du titre principal

Si un titre principal est spécifié, sa couleur par défaut est bleue (#368ac0). Si nécessaire, spécifier une valeur de couleur différente.

Espace réservé pour la zone de recherche

Par défaut, la zone de recherche est vide. Si nécessaire, entrer du texte à afficher dans la zone. Pour masquer la zone de recherche, spécifier FALSE (sensible à la casse).

Message d'erreur

Par défaut, aucune erreur ne s'affiche si aucun élément n'est disponible. Si nécessaire, spécifier un message d'erreur. Utiliser TRANSLATESTRING pour faciliter la traduction de l'erreur si la langue de l'interface est modifiée.

Couleur de police du titre

Par défaut, le titre des éléments de liste est gris foncé (#1a1a1a). Si nécessaire, spécifier une valeur de couleur différente

Couleur sélectionnée

Spécifier la couleur dans laquelle l'élément de liste sélectionné est mis en surbrillance. La valeur par défaut est bleu clair (#c8e9f4). Si nécessaire, spécifier une valeur de couleur différente.

Multisélection

Par défaut, un seul élément peut être sélectionné. Pour activer les cases à cocher pour la sélection de plusieurs éléments, spécifier =”TRUE”.

Masquer les bordures latérales

Par défaut, chaque ligne comporte une bordure gauche et droite. Spécifier “=TRUE” pour masquer ces bordures.

Couleur de bordure

Par défaut, les bordures supérieures et latérales de la liste sont gris clair (#d8d8d8). Si nécessaire, spécifier une valeur de couleur différente.

Texte des éléments sélectionnés

Si la sélection multiple est activée, le nombre d'éléments sélectionnés est indiqué, suivi de Sélectionné. Si nécessaire, entrer un autre texte. Utiliser TRANSLATESTRINGUNIQUE pour faciliter la traduction du texte si la langue de l'interface est modifiée.

Bouton Supprimer de la barre d'action

Si la sélection multiple est activée, il est possible d'afficher un bouton Supprimer pour désélectionner les éléments sélectionnés. Spécifier la référence d'une cellule contenant le mot Supprimer.

Utiliser TRANSLATESTRING pour faciliter la traduction du bouton si la langue de l'interface est modifiée.