Composant Affichage de l'écran répéteur
Recueillez des informations sur plusieurs éléments de même type sur un écran avec le composant Répéteur. Pour utiliser la sortie du composant ailleurs dans le flux, tournez en boucle sur la sortie, puis enregistrez les données pertinentes dans une variable. Utilisez la variable pour élaborer une liste d'enregistrements.
Éditions requises
| Afficher les éditions prises en charge. |
Voici à quoi ressemble un composant Répéteur à l'exécution. Ce répétiteur contient cinq composants enfants qui ont été répétés à l'écran lorsque l'utilisateur a cliqué sur Ajouter pour ajouter une autre personne. Les composants enfants sont deux composants Texte nommés Prénom et Nom, un composant Date nommé Date de naissance, un composant Basculer nommé Recevoir des e-mails de mise à jour et un composant Groupe de cases à cocher nommé E-mails. Le composant Groupe de cases à cocher est défini pour être masqué jusqu'à ce que le composant Basculer soit défini sur Actif. L'utilisateur peut continuer à cliquer sur Ajouter et les cinq mêmes composants sont répétés à l'écran à chaque fois.
Configuration du composant Répéteur
| Attribut | Description |
|---|---|
| Nom d'API | Le nom d’API du composant. Un nom d'API peut inclure des traits de soulignement et des caractères alphabétiques sans espace. Il doit commencer par une lettre et ne peut pas se terminer par un trait de soulignement. Il ne peut pas non plus inclure deux traits de soulignement consécutifs. Les lecteurs d'écran utilisent le nom d'API pour annoncer le composant Répéteur et ses composants enfants. |
Configuration de Data Source
Sélectionnez la collection d'éléments qui préremplit le composant Répéteur à l'exécution. Les composants enfants du répétiteur peuvent référencer des valeurs de cette collection.
| Attribut | Description |
|---|---|
| Collecte des articles préremplis | Les champs de la collection sélectionnée sont disponibles pour les composants enfants dans le Répéteur. Le champ Collection d'articles préremplis n'est pas réactif. Par conséquent, les sorties d'une action d'écran ne remplissent pas les données dans les répétiteurs à l'exécution. |
| Identificateur unique des articles | L'identificateur unique des éléments est le nom d'API du champ qui contient un identifiant unique pour chaque élément de la collection. Ce champ est automatiquement défini sur le champ ID de l'objet. |
Configuration des options d'affichage
| Attribut | Description |
|---|---|
| Ajout ou retrait d'éléments par les utilisateurs | Déterminez si les utilisateurs de flux d'écran peuvent ajouter de nouveaux éléments ou retirer des éléments préremplis dans votre instance Répéteur. Les utilisateurs peuvent retirer les éléments qu'ils ont ajoutés manuellement. |
Définir la visibilité du composant
Spécifiez la logique qui détermine quand le flux affiche le composant.
| Option | Description |
|---|---|
| Quand afficher le composant | Configurez l'affichage du composant en utilisant une logique conditionnelle. Vous pouvez définir les composants sur :
|
Utilisation
Après avoir configuré le composant Répéteur, ajoutez et configurez un ou plusieurs composants enfants dans le répéteur. Le flux stocke l'entrée de l'utilisateur pour le composant Répéteur dans AllItems l'attribut du composant. Vous pouvez tourner en boucle sur les éléments de cette collection afin de créer une variable de collection à utiliser plus tard dans le flux.
Considérations relatives aux attributs AllItems
- L'attribut
AllItemsest vide lorsque :- Le composant Répéteur contient uniquement des composants enfants qui n'acceptent pas l'entrée de l'utilisateur, tels que le composant Texte d'affichage.
- Un utilisateur n'ajoute pas d'instances Répéteur à l'écran.
- L'attribut
AllItemsest nul lorsque tous les composants enfants sont masqués par la visibilité conditionnelle des champs. - L'attribut
AllItemset sa valeur sont en lecture seule. - L'attribut
AllItemsn'est pas pris en charge dans les éléments Attribution.
Considérations générales
- Vous ne pouvez pas inclure le composant Bouton d'action ou des champs d'enregistrement dans un répétiteur.
- La sortie des composants Répéteur n'est pas prise en charge dans les éléments Transformation, Filtre de collection ou Tri de collection.
- Vous ne pouvez pas référencer la sortie d'un autre composant Répéteur dans un composant enfant Répéteur.
- Les composants Choix qui référencent une ressource d'ensemble de choix de collection dans le champ Choix ne sont pas réactifs dans les composants Répéteur.
- Lorsque vous créez ou mettez à jour un écran, vous pouvez déplacer un composant sur le même écran dans le composant Répéteur. Vous pouvez également déplacer un composant depuis un composant Répéteur vers un autre emplacement à l'écran. Cependant, toutes les références au composant déplacé sont rompues.
- Si vous déplacez un composant avec la case Attribuer manuellement des variables sélectionnée dans un composant Répéteur, toutes les attributions manuelles sont retirées et la case est désélectionnée. Cependant, les variables existent toujours dans le flux. Nous recommandons de vérifier le composant après un déménagement pour vous assurer qu'il ne contient pas de références rompues.
- Les utilisateurs peuvent ajouter jusqu'à 30 instances du composant Répéteur à l'écran à l'exécution.
- Le format d'une référence à un composant Répéteur dans le composant lui-même est
{!repeaterAPIName.fieldName}. Dans les messages de validation et le package de métadonnées de flux, le format de la même référence est{!repeaterAPIName.AllItems[$Items].fieldName}.
Cet exemple montre un écran qui inclut un composant Répéteur avec les composants enfants Nom et Adresse e-mail pour collecter des informations sur les nouveaux clients.
