Récupération dynamique de données avec des répétiteurs de données
Un répétiteur de données permet de se connecter à un objet Salesforce standard ou personnalisé et de récupérer un jeu de données selon les critères de filtrage que vous spécifiez.
Éditions requises
| Disponible avec : Salesforce Classic |
Disponible à l'achat dans : Enterprise Edition, Performance Edition et Unlimited Edition Disponible (avec des limitations) dans : Developer Edition |
| Autorisations utilisateur requises | |
|---|---|
| Pour créer, modifier et gérer des sites Site.com : | Champ Utilisateur Site.com Publisher activé dans la page de détail de l'utilisateur ET Rôle d'administrateur ou de concepteur de site attribué au niveau du site |
| Pour modifier le profil d'utilisateur invité : | Champ Utilisateur Site.com Publisher activé dans la page de détail de l'utilisateur ET Rôle d'administrateur ou de concepteur de site attribué au niveau du site ET Gérer les profils et les ensembles d'autorisations ET Personnaliser l'application |
Vous pouvez vous connecter à des objets Salesforce standard ou personnalisés, ou à des listes de contenus ou à des catégories dans votre site. Lorsque vous combinez un répétiteur de données avec des éléments de données, un code personnalisé ou des blocs de contenu, vous pouvez créer un « modèle de répétition » qui affiche un ou plusieurs enregistrements sur la page.
Pour ajouter un répétiteur de données à une page :
- À partir du volet Éléments de page, faites glisser un répétiteur de données vers la page.
-
Sélectionnez l'objet auquel vous souhaitez vous connecter.
Remarque- Pour les utilisateurs Site.com, la liste déroulante affiche uniquement les objets disponibles pour les utilisateurs invités car les visiteurs du site accèdent à votre site public via la licence Utilisateur invité. Pour autoriser l'accès à d'autres objets, accédez au profil utilisateur invité, activez l'autorisation « Lire » de l'objet approprié, puis actualisez la liste.
- Pour les utilisateurs de communauté, la liste déroulante affiche les objets qui ne sont pas toujours disponibles pour les visiteurs du site. L'accès de visiteurs authentifiés à un objet dans des pages publiques et privées est contrôlé par leur profil utilisateur. L'accès de visiteurs non authentifiés à un objet dans des pages publiques et privées est contrôlé par le profil utilisateur invité du site.
-
Dans Filtres, vous pouvez également sélectionner des critères de filtrage de votre jeu de données. Si vous ne sélectionnez aucun critère, toutes les données de l'élément sont renvoyées.
- Sélectionnez le champ auquel les critères de filtrage s'appliquent. La liste déroulante Champ affiche les champs de l'objet, suivis des champs de tous les objets parents, qui utilisent le format parent_object_name.field_name.
- Sélectionnez l'opérateur qui contrôle le filtrage des résultats. Par exemple, sélectionnez Égal à pour renvoyer une correspondance exacte.
- Sélectionnez la source de la valeur de filtrage. Par exemple, sélectionnez Valeur fixe pour spécifier une valeur explicite ou Chaîne de requête d'URL pour utiliser les valeurs transmises à la page via une chaîne de requête.
- Sélectionnez la valeur de filtrage. Si vous utilisez une chaîne de requête, vous pouvez également spécifier l'action exécutée si la chaîne de requête est manquante.
- Si nécessaire, ajoutez des critères de filtrage supplémentaires pour affiner davantage vos résultats. Chaque élément de filtrage est combiné à un opérateur ET.
Remarque Si vous utilisez une valeur fixe pour filtrer les résultats, vous pouvez afficher les enregistrements renvoyés dans la section Aperçu de la connexion. Pour actualiser la liste d'enregistrements, cliquez sur Recharger l'aperçu. - Dans Tri, vous pouvez spécifier le tri des résultats par un ou plusieurs champs dans l'ordre ascendant ou descendant. Par exemple, si vous utilisez un objet contenant des données d'utilisateur, vous pouvez trier vos résultats par genre, puis par nom.
- Dans Limites, vous pouvez limiter le nombre de résultats renvoyés. Par exemple, si seuls les cinq premiers résultats vous intéressent, saisissez 5 dans le champ Limiter les résultats à.
- Si vous ajoutez une pagination, spécifiez le nombre de résultats à afficher par page dans le champ Résultats par page.
- Cliquez sur Enregistrer.
Vous devez ensuite ajouter des éléments de données, un code personnalisé ou des blocs de contenu au répétiteur de données pour afficher les données récupérées.
- Affichage de données ou de contenus en utilisant des éléments de données
Vous pouvez utiliser un élément de données pour afficher les données récupérées par une connexion aux données d'une page ou un répétiteur de données. L'élément de données est lié à un champ de l'objet. Il agit en tant qu'espace réservé qui est remplacé par les données du champ lors du chargement de la page. - Affichage de données ou de contenus en utilisant un code personnalisé
En plus des éléments de données et des blocs de contenu, vous pouvez également utiliser un code personnalisé comme alternative d'affichage de données dans un répétiteur de données ou une connexion aux données de page. Ce code est particulièrement utile pour afficher des données de champ en rapport avec le texte. - Affichage de blocs de contenu utilisant des données
En plus des éléments de données et d'un code personnalisé, vous pouvez également utiliser des blocs de contenu comme alternative d'affichage de données dans un répétiteur de données ou une connexion aux données de page. Ce code est particulièrement utile pour afficher des données de champ en rapport avec le texte. - Récupération dynamique de données avec des tables de données
Utilisez une table de données pour vous connecter à un objet Salesforce standard ou personnalisé, pour récupérer un jeu de données basé sur les critères de filtrage que vous spécifiez, et pour afficher un ou plusieurs enregistrements dans des lignes de la table. - Modification des colonnes dans une table de données
Les colonnes d'une table de données sont liées au champ de l'objet auquel elles sont connectées. Chaque cellule de colonne agit en tant qu'espace réservé qui est remplacé par les données du champ lors du chargement de la page. - Ajout d'une pagination à des répétiteurs de données et à des tables de données
Les événements permettent d'ajouter des effets interactifs et animés aux pages et aux éléments de votre site Web. Lors de l'utilisation de répétiteurs de données et de tables de données, vous pouvez ajouter des événements de pagination afin de faciliter la navigation des utilisateurs dans les données affichées. Cette fonctionnalité est particulièrement utile lors de l'utilisation de quantités importantes de données. - Utilisation de fonctions de données
Une fonction de données permet de se connecter à un objet Salesforce standard ou personnalisé, d'effectuer des calculs sur les résultats renvoyés et d'afficher le calcul sur la page. Par exemple, pour un champ spécifique d'un objet, vous pouvez utiliser une fonction de données afin de calculer la valeur totale ou le montant moyen de tous les enregistrements renvoyés. - Présentation des connexions aux données de page
Pour les administrateurs et les concepteurs de sites, les connexions aux données de page facilitent la création d'une page de détail pour un enregistrement unique en utilisant des objets Salesforce. - Récupération de données à l'aide de connexions aux données d'une page
Utilisez une connexion aux données d'une page afin de créer une page de détail pour un enregistrement unique lorsque vous utilisez des objets Salesforce. - Présentation de l'accès aux données dans des objets associés
Les objets standard et personnalisés ont des relations qui définissent l'association entre des enregistrements d'un objet à l'autre. Par exemple, l'objet Comptes à une relation un-à-plusieurs avec l'objet Contacts, c.-à-d. que chaque compte peut avoir un ou plusieurs contacts associés. Cette relation est également connue en tant que relation parent-enfant ou principal-détails. - Affichage de données à partir d'objets associés à l'aide de répétiteurs de données imbriqués
Vous pouvez récupérer des données à partir de n'importe quel objet enfant d'un objet parent, en utilisant un répétiteur de données qui contient un autre répétiteur de données, une table de données ou une fonction de données. - Amélioration des performances avec la mise en cache
Lorsque vous utilisez des éléments de page basés sur des données, tels que des répétiteurs de données, des tables de données et des fonctions de données, vous pouvez améliorer les performances et l'affichage des pages de votre site Web avec la mise en cache. La mise en cage contrôle la fréquence à laquelle une page contenant une connexion à des données demande des données à Salesforce. - Filtres de données
Lorsque vous ajoutez un répétiteur de données, une table de données ou une fonction de données à une page, il n'est pas nécessaire de limiter les enregistrements récupérés. Cependant, si vous utilisez un objet Salesforce contenant des milliers d'enregistrements, vous pouvez limiter les résultats renvoyés à l'aide de critères de filtrage. - À propos de l'affichage dynamique de données en utilisant des expressions
Site.com utilise un langage d'expression (langage de script) pour afficher les données de façon dynamique. Les expressions servent d'espace réservé pour les données qui sont remplacées par des informations au chargement de la page. Lors de l'utilisation d'éléments de page associés à des données ou de propriétés personnalisées de widget, vous pouvez utiliser des expressions pour personnaliser l'affichage des données sur la page. - Exemples de filtres de données
Lors de l'utilisation de répétiteurs de donner, de tables de données et de fonctions de données, vous pouvez filtrer les données récupérées de plusieurs façons. Dans cette rubrique, nous explorons deux options (valeurs fixes et chaînes de requête d'URL) pour illustrer certaines techniques de filtrage courantes.
