Collections
Explication : Ce connecteur vous permet de gérer les collections, une collection est un ensemble d’éléments partageant les mêmes champs.
Explication détaillée : Vous pouvez comparer cela en quelque sorte à l’équivalent d’une ressource avec ses propres champs et enregistrements mais qui ne serait pas “sauvegardée”.
Il est également important de savoir que les collections sont le résultat de nombreuses autres actions d’autres connecteurs, comme par exemple la lecture d’enregistrements” qui donnera une “collection” d’enregistrements.
Ainsi, il est possible d’utiliser les collections à de nombreux usages que nous allons voir plus en détail.
Exemple: Je souhaite créer un scénario d’import, je vais donc créer une collection dont je copie les champs sur la ressource ou je souhaite faire mes imports, j’importerais ensuite le contenu d’un tableur dans ma collection, puis j’utiliserais le connecteur ressource et j’importerais ma collection dans une ressource.
Actions
- Créer une collection : Cette action permet de créer une collection vide avec les champs de votre choix, il est également possible de copier les champs d’une ressource déjà existante pour gagner du temps dans certains cas.
- Insérer un élément dans une collection : Une fois la collection ciblée choisie, vous pouvez y insérer un “élément”, l’équivalent d’un “Enregistrement”.
- Compter les éléments : Cette action vous permet de connaitre le nombre d’éléments contenu dans une collection et de l’utiliser par la suite comme ingrédient.
- Supprimer les doublons : Cette action vous permet de supprimer les doublons d’éléments d’une collection, vous devez utiliser un critère “d’égalité” qui permettrait de déterminer quels éléments sont des doublons. Par exemple un ID, un matricule, etc.
- Mélanger une collection : Cette action permet de “mélanger” l’ordre des éléments d’une collection.
- Agréger une collection : Choisissez un champs d’une collection puis agréger les éléments de celle-ci selon un type d’agrégation (Prenons un champs nombre “NB”):
- Premier : Renvoi le premier champ "NB" de la liste des éléments
- Dernier : Renvoi le dernier champ "NB" de la liste des éléments
- Éléments à l’index : Renvoi le champ "NB" de la liste des éléments à l'index défini. (Par exemple, si je met “10”, j’aurais le 10ème élément).
- Somme : Fais la somme des "NB"
- Minimum : Donne le plus petit "NB" de la liste d'éléments
- Maximum : Donne le plus grand "NB" de la liste d'éléments
- Moyenne : Fais la moyenne des "NB" de la liste d'éléments
Vous devez aussi choisir si vous souhaitez exclure les valeurs “nulles” de votre agrégation, si ne vous les excluez pas, vous pouvez les remplacer par une autre valeur que vous pouvez définir.
- Nettoyer une Collection : Choisissez une collection puis un ou plusieurs champs, ensuite vous pourrez choisir une ou plusieurs actions de nettoyage qui dépendent du type de champs à nettoyer :
- Supprimer l’entité si la valeur est nulle
- Supprimer l’entité si la valeur est vide
- Supprimer les espaces
- Supprimer les balises html
- Supprimer l’entité si la valeur est Zéro
- Convertir un champs d’une collection en une liste : Après avoir selectionné une collection et un champs, cette action vous permettra de récupérer un ingrédient qui contient une liste de tous les éléments du champ sélectionné.
Par exemple, si vous sélectionnez le champs “Photo” d’une collection de 30 “Rapport Terrain”, vous pourrez utiliser cet ingrédient pour le mettre dans un champ photo multiple ou dans une pièce jointe de mail ou autres…
- Filtrer une Collection : Cette action vous permet de filtrer et trier les éléments d’une collection de votre choix selon un ou plusieurs critères.
- Mapper une Collection : En sélectionnant une Collection “D’entrée” vous pouvez la “remapper” vers une nouvelle collection de “Sortie”, à savoir, ajouter/retirer/changer ses champs pour d’autres types de champs ou changer leur nom, etc.
Exporter une Collection en tableau HTML: Cette action vous permet d’exporter une collection en tableau HTML selon une configuration tabulaire (les mêmes que pour une ressource) et ainsi obtenir un tableau utilisable dans un email ou un export de document par exemple.