Ajouter une page Web pour afficher une liste d'enregistrements

Une liste d'entités est une configuration orientée données qui offre la possibilité d'ajouter une page Web qui affiche une liste d'enregistrements sans qu'il soit nécessaire qu'un développeur apprête la grille dans le portail. À l'aide d'une liste d'entités, vous pouvez exposer les enregistrements Dynamics 365 à l'affichage sur les portails.

La grille prend en charge le tri et sera paginée si le nombre d'enregistrements est supérieur à la taille de page spécifiée. Si la page Web pour la vue Détails a été spécifiée, chaque enregistrement contiendra un lien vers la page et l'ID de l'enregistrement sera ajouté à la chaîne de requête, avec le nom du paramètre de chaîne de requête d'ID. La liste d'entités prend également en charge plusieurs vues. Si plusieurs vue ont été spécifiées, une liste déroulante s'affichera pour permettre à l'utilisateur de basculer entre les différentes vues.

Les données peuvent être également filtrées par utilisateur du portail actuel, par client parent de l'utilisateur du portail actuel, et par site Web du portail actuel. S'il existe une valeur pour les deux conditions de filtre Attribut d'utilisateur du portail et Attribut de compte, le portail affichera un menu déroulant pour permettre à l'utilisateur d'afficher « ses » données ou les données de son compte client parent.

Ajouter une liste d'entités au portail

La liste des entités contient les relations vers des pages Web et des propriétés diverses en vue de contrôler l'initialisation de la liste d'enregistrements dans le portail. La relation avec la page Web permet la récupération dynamique de la définition de la liste pour un nœud de page donné dans le site Web. Pour afficher les vues d'entité existantes ou créer des vues d'entité, accédez à Portails > Listes d'entités.

Note

Une liste d'entités doit être associée à une page Web pour un site Web donné pour que la liste soit visible dans le site.

Les pages Web associées à la liste des entités peuvent être affichées en cliquant sur le lien Pages Web répertorié dans les liens de navigation Associés dans le menu à l'extrémité gauche. Quand vous créer votre liste d'entités, la première étape consiste à sélectionner l'entité pour laquelle vous souhaitez afficher une liste sur le portail. Vous choisirez ensuite une ou plusieurs vues Dynamics 365 pour l'affichage.

Lors de la création ou de la modification d'une page Web, une liste d'entités peut être spécifiée dans le champ de recherche fourni sur le formulaire de page Web. Le modèle de page sera généralement le modèle de « page », mais il peut s'agir de l'un des autres modèles conçus pour le contenu, car les principaux modèles contiennent la logique nécessaire pour déterminer s'il convient d'afficher une liste d'entités.

Attributs et relations d'une liste d'entités

Nom Description
Nom Nom descriptif de l'enregistrement. Ce champ est obligatoire.
Nom de l’entité Nom de l'entité à partir de laquelle la vue Requête enregistrée est chargée. Ce champ est obligatoire.
Vue Vue(s) Requête enregistrée de l'entité cible à afficher. Ce champ est obligatoire. Si plusieurs vues ont été spécifiées, la page Web contiendra une liste déroulante pour permettre à l'utilisateur de basculer entre les différentes vues.
Taille de la page Nombre entier qui indique le nombre d'enregistrements par page. Ce champ est obligatoire. Valeur par défaut : 10
Page Web pour vue Détails Page Web facultative de liaison pour chaque enregistrement. Le nom du paramètre de chaîne de requête d'ID et l'ID d'enregistrement sont ajoutés à la chaîne de requête de l'URL de cette page Web.
Étiquette du bouton Détails Texte affiché pour le bouton Détails si la page Web pour la vue Détails a été spécifiée. Valeur par défaut : Afficher les détails Pour chaque module linguistique installé et activé pour l'organisation Dynamics 365, un champ est disponible pour entrer le message dans la langue associée.
Page web pour création Page Web facultative qui sera la cible du bouton Créer.
Créer une étiquette de bouton Texte affiché pour le bouton Créer si la page Web pour création a été spécifiée. Valeur par défaut : Créer Pour chaque module linguistique installé et activé pour l'organisation Dynamics 365, un champ est disponible pour entrer le message dans la langue associée.
Nom du paramètre de chaîne de requête d'ID Nom de paramètre fourni dans la chaîne de requête de l'URL de la page Web pour la vue Détails. Valeur par défaut : ID
Texte de liste vide Message affiché lorsqu'il n'existe aucun enregistrement. Pour chaque module linguistique installé et activé pour l'organisation Dynamics 365, un champ est disponible pour entrer le message dans la langue associée.
Attribut d'utilisateur du portail Attribut de recherche facultatif sur l'entité principale qui représente l'enregistrement de l'utilisateur du portail (contact ou utilisateur système) auquel l'ID de l'utilisateur actuel peut être appliqué pour filtrer les données affichées dans la liste.
Attribut de compte Attribut de recherche facultatif sur l'entité principale qui représente un enregistrement de compte auquel la valeur Client parent du contact de l'utilisateur actuel peut être appliquée pour filtrer les données affichées dans la liste.
Attribut de site Web Attribut de recherche facultatif sur l'entité principale qui représente le site Web auquel l'ID du site Web actuel peut être appliqué pour filtrer les données affichées dans la liste.
Recherche activée Valeur booléenne facultative indiquant si la recherche doit être activée ou non. Une zone de texte s'affiche pour permettre aux utilisateurs d'effectuer une recherche rapide d'enregistrements. Utilisez un astérisque (*) pour effectuer une recherche sur une partie de texte. La recherche ajoute des filtres de condition « ou » pour chaque colonne de la vue aux conditions de filtre prédéfinies existantes de la vue pour créer une requête et retourner les enregistrements obtenus.
Texte d'espace réservé de recherche Chaîne facultative utilisée comme étiquette qui s'affiche dans la zone de texte lors du chargement initial.
Texte d'info-bulle de recherche Chaîne facultative utilisée comme info-bulle qui s'affiche lorsque la souris est positionnée sur la zone de texte de recherche.

Ajouter du code JavaScript personnalisé

L'onglet Options du formulaire contient une zone de texte dans laquelle vous pouvez entrer du code JavaScript personnalisé et, si votre page contient une bibliothèque jQuery, vous pouvez également l'inclure. Le bloc de script est ajouté au bas de la page Web juste avant la balise de fermeture de la page.

Exemple de code [!INCLUDE[pn-javascript](../includes/pn-javascript.md)] personnalisé

La liste obtient ses données de façon asynchrone et, une fois l'opération terminée, elle déclenche un événement « loaded » que votre code JavaScript personnalisé peut suivre afin d'agir sur les éléments de la grille. Voici un exemple simple :

$(document).ready(function (){
$(".entitylist.entity-grid").on("loaded", function () {
$(this).children(".view-grid").find("tr").each(function (){
// do something with each row
$(this).css("background-color", "yellow");
});
});
}); 

Recherchez un champ d'attribut spécifique et obtenez sa valeur pour modifier éventuellement le rendu de la valeur. L'exemple suivant obtient chaque cellule de l'attribut nommé « accountnumber ». Remplacez « accountnumber » par un attribut approprié à votre entité et vue.

$(document).ready(function (){
   $(".entitylist.entity-grid").on("loaded", function () {
      $(this).children(".view-grid").find("td[data-attribute='accountnumber']").each(function (i, e){
         var value = $(this).data("value");
         // now that you have the value you can do something to the value
      });
   });
});

Configuration d'une liste d'entités

Vous pouvez facilement activer et configurer des actions pour les enregistrements d'une liste d'entités (créer, modifier, supprimer, etc.) Il est également possible de remplacer les étiquettes, les tailles et les autres attributs par défaut de manière à ce que la liste des entités soit affichée exactement comme vous le souhaitez.

Ces paramètres se trouvent dans la section Configuration du formulaire Liste des entités. Par défaut, seuls les Paramètres de base sont affichés. Sélectionnez Paramètres avancés pour afficher les paramètres supplémentaires.

Configurer une liste d'entités

Attributs

Nom Description
Paramètres de base
Afficher les actions Vous permet d'ajouter des boutons d'action pour les actions qui s'appliquent à l'ensemble d'entités et apparaîtront au-dessus de la grille. Les actions disponibles sont :
  • Créer une action
  • Action de téléchargement
La sélection de l'une de ces options affiche une zone de configuration pour cette action.
Actions sur l'élément Vous permet d'ajouter des boutons d'action pour les actions qui s'appliquent à un enregistrement individuel et apparaîtront pour chaque ligne de la grille à condition que le privilège approprié ait été accordé par les autorisations d'entité. Les actions généralement disponibles sont :
  • Action détails
  • Action Modifier
  • Action Supprimer
  • Action de Workflow
  • Action Activer
  • Action Désactiver
La sélection de l'une de ces options affiche une zone de configuration pour cette action. Voir ci-dessous pour plus d'informations sur chaque action. En outre, certaines entités ont des actions spéciales qui sont disponibles pour chaque entité :
  • Calculer la valeur de l'opportunité (opportunité)
  • Action Annuler un incident (incident)
  • Action Fermer (résoudre) un incident (incident)
  • Convertir un devis en commande (devis)
  • Convertir une commande en facture (commande client)
  • Créer un devis à partir de l'opportunité (opportunité)
  • Action Perdre une opportunité (opportunité)
  • Action Conclure une opportunité (opportunité)
  • Action Rouvrir un incident (incident)
  • Mettre une opportunité en attente (opportunité)
Remplacer les attributs de colonne Vous permet de remplacer les paramètres d'affichage de priorité pour différentes colonnes de la grille.
  • Attribut : nom logique de la colonne que vous souhaitez remplacer
  • Nom complet : nouvel en-tête de colonne pour remplacer la valeur par défaut
  • Largeur : largeur (en pourcentage ou en pixels) de la colonne pour remplacer la valeur par défaut. Voir aussi Style de largeur de colonne de grille
Pour remplacer les paramètres d'une colonne, cliquez sur « + Colonne » et saisissez les détails.
Paramètres avancés
Message de chargement Remplace le message HTML par défaut qui apparaît pendant le chargement de la grille.
Message d\'erreur Remplace le message HTML par défaut qui apparaît lorsqu'une erreur survient pendant le chargement de la grille.
Message d\'accès refusé Remplace le message HTML par défaut qui apparaît lorsqu'un utilisateur ne dispose pas d'autorisations d'entité suffisantes pour afficher la liste des entités.
Message vide Remplace le message HTML par défaut qui apparaît lorsque la grille ne contient aucune donnée.
Dialogue de formulaire de détails Contrôle les paramètres de la boîte de dialogue qui apparaît lorsqu'un utilisateur active l'action Détails.
Dialogue de modification de formulaire Contrôle les paramètres de la boîte de dialogue qui apparaît lorsqu'un utilisateur active l'action Modifier.
Dialogue de création de formulaire Contrôle les paramètres de la boîte de dialogue qui apparaît lorsqu'un utilisateur active l'action Créer.
Dialogue de suppression Contrôle les paramètres de la boîte de dialogue qui apparaît lorsqu'un utilisateur active l'action Supprimer.
Dialogue d\'erreur Contrôle les paramètres du dialogue qui apparaît lorsqu'une erreur survient au cours d'une action.
Classe CSS Spécifiez une classe CSS ou des classes CSS qui seront appliquées à l'élément HTML qui contient la zone entière de la grille, notamment les boutons de grille et d'action.
Classe CSS de la grille Spécifiez une ou des classes CSS qui seront appliquées à l'élément HTML <table> de la liste des entités.
Style de largeur de colonne de grille Configure si les valeurs de Largeur de l'option Remplacer les attributs de colonne sont spécifiées en pixels ou en pourcentage

Paramètres de l'action Général

En général, les actions d'entité ont des paramètres qui peuvent être configurés. Dans tous les cas, cela vous offre plus d'options en termes de personnalisation, et les champs ne sont pas obligatoires. Le simple ajout de l'action permet d'afficher l'action sur le portail, à condition que le privilège approprié ait été accordé par les autorisations d'entité.

En général, vous pouvez configurer la boîte de dialogue correspondante pour chaque action, qui s'affiche uniquement si vous sélectionnez Confirmation requise.

Nom Description
Paramètres de base
Confirmation requise ? Détermine si un message de confirmation invitera l'utilisateur à confirmer l'activation de l'action.
Paramètres avancés
Confirmation Remplace le message de confirmation HTML affiché lorsque l'utilisateur active l'action.
Étiquette de bouton Remplace l'étiquette HTML pour cette action affichée dans la ligne Liste des entités.
Info-bulle de bouton Remplace le texte d'info-bulle qui apparaît lorsque la souris est pointée sur le bouton pour cette action affichée dans la ligne Liste des entités.
Classe CSS du bouton Ajoute une classe CSS au bouton. Conçu pour être utilisé conjointement avec
Rediriger vers la page Web Certaines actions (pas toutes) autorisent la redirection lorsque l'action est terminée. Fortement recommandé pour l'action Supprimer, facultatif dans la plupart des autres cas. Cela vous permet de choisir une page Web de redirection lorsque l'action est terminée.
URL de redirection Alternative à l'option Rediriger vers la page Web, elle permet de rediriger vers une URL spécifique.

Paramètres (avancés) de la boîte de dialogue Général

Nom Description
Fonction Remplace le texte HTML qui apparaît dans la barre de titre de la boîte de dialogue.
Texte du bouton Principal Remplace le texte HTML qui apparaît dans le bouton Principal (« Supprimer ») de la boîte de dialogue.
Texte du bouton Fermer Remplace le texte HTML qui apparaît dans le bouton Fermer (« Annuler ») de la boîte de dialogue.
Texte pour lecteur d\'écran bouton Ignorer Remplace le texte de lecteur d'écran associé au bouton Ignorer de la boîte de dialogue.
Taille Spécifie la taille de la boîte de dialogue Supprimer. Les options sont Par défaut, Grand et Petit. Pour la boîte de dialogue Supprimer, la taille par défaut est Défaut.
Classe CSS Spécifiez une ou plusieurs classes CSS qui sont appliquées à la boîte de dialogue qui s'affiche.
Classe CSS du titre Spécifiez une ou plusieurs classes CSS qui sont appliquées à la barre de titre de la boîte de dialogue qui s'affiche.
Classe CSS du texte du bouton Principal Spécifiez une ou plusieurs classes CSS qui sont appliquées au bouton Principal (« Supprimer ») de la boîte de dialogue.
Classe CSS du bouton Fermer Spécifiez une ou plusieurs classes CSS qui sont appliquées au bouton Fermer (« Annuler ») de la boîte de dialogue.

Paramètres de l'action Créer

L'activation d'une Action Créer affiche un bouton au-dessus de la liste des entités qui, d'un clic, affiche une boîte de dialogue avec un formulaire d'entité permettant à un utilisateur de créer un enregistrement, à condition que le privilège « Créer » ait été accordé par les autorisations d'entité.

Nom Description
Paramètres de base
Formulaire d\'entité Spécifie le formulaire d'entité qui est utilisé pour créer le nouvel enregistrement. La liste déroulante comporte tous les formulaires d'entités qui sont configurés pour le type d'entité de la liste des entités.
Remarque : si le type d'entité de la liste des entités n'a pas de formulaires d'entité, la liste déroulante apparaîtra vide. Si aucun formulaire d'entité n'est fourni pour l'Action Créer, elle sera ignorée et le bouton ne s'affichera pas dans la liste des entités.
Paramètres avancés
Étiquette de bouton Remplace l'étiquette HTML affichée dans le bouton Action Créer au-dessus de la liste.
Info-bulle de bouton Remplace le texte d'info-bulle qui s'affiche lorsque le curseur pointe sur le bouton Action Créer.

Paramètres (avancés) de la boîte de dialogue de création de formulaire

Nom Description
Message de chargement Remplace le message qui apparaît pendant le chargement de la boîte de dialogue
Fonction Remplace le texte HTML qui apparaît dans la barre de titre de la boîte de dialogue
Texte pour lecteur d\'écran bouton Ignorer Remplace le texte de lecteur d'écran associé au bouton Ignorer de la boîte de dialogue.
Taille Spécifie la taille de la boîte de dialogue Créer un formulaire. Les options sont Par défaut, Grand et Petit. Pour la boîte de dialogue de création de formulaire, la taille par défaut est Large.
Classe CSS Spécifiez une ou plusieurs classes CSS qui sont appliquées à la boîte de dialogue qui s'affiche.
Classe CSS du titre Spécifiez une ou plusieurs classes CSS qui sont appliquées à la barre de titre de la boîte de dialogue qui s'affiche.

Paramètres de l'action Télécharger

L'activation d'une Action Télécharger affiche un bouton au-dessus de la liste des entités qui, d'un clic, télécharge les données de la liste dans un fichier Excel (.xlsx).

Nom Description
Paramètres de base
Aucun
Paramètres avancés
Étiquette de bouton Remplace l'étiquette HTML affichée dans le bouton Action Télécharger au-dessus de la liste des entités.
Info-bulle de bouton Remplace le texte d'info-bulle qui apparaît lorsque la souris est pointée sur le bouton Action de téléchargement.

Paramètres de l'action Détails

L'activation d'une Action Détails permet à un utilisateur d'afficher un formulaire d'entité en lecture seule d'une ligne sélectionnée dans la liste des entités.

Nom Description
Paramètres de base
Formulaire d\'entité Spécifie le formulaire d'entité qui sera utilisé pour afficher les détails de l'entité sélectionnée. La liste déroulante comporte tous les formulaires d'entités qui sont configurés pour le type d'entité de la liste des entités.
Remarque : si le type d'entité de la liste des entités n'a pas de formulaires d'entité, la liste déroulante apparaîtra vide. Si aucun formulaire d'entité n'est fourni pour l'Action Détails, elle sera ignorée et le bouton ne s'affichera pas dans la liste des entités.
Paramètres avancés
Nom du paramètre de chaîne de requête d\'ID d\'enregistrement Spécifie le nom du paramètre de chaîne de requête qui sera utilisé pour sélectionner l'entité à afficher dans le formulaire d'entité sélectionné. Cela devrait correspondre à la valeur du Nom du paramètre de chaîne de requête d'ID d'enregistrement du formulaire d'entité. La valeur par défaut pour ce champ, à la fois ici et dans la configuration du formulaire d'entité, est « ID ».
Étiquette de bouton Remplace l'étiquette HTML pour cette action affichée dans la ligne Liste des entités.
Info-bulle de bouton Remplace le texte d'info-bulle qui apparaît lorsque la souris est pointée sur le bouton pour cette action affichée dans la ligne Liste des entités.

Paramètres (avancés) de la boîte de dialogue de formulaire de détails

Nom Description
Message de chargement Remplace le texte HTML qui apparaît pendant le chargement de la boîte de dialogue.
Fonction Remplace le texte HTML qui apparaît dans la barre de titre de la boîte de dialogue.
Texte pour lecteur d\'écran bouton Ignorer Remplace le texte de lecteur d'écran associé au bouton Ignorer de la boîte de dialogue.
Taille Spécifie la taille de la boîte de dialogue Détails. Les options sont Par défaut, Grand et Petit. Pour la boîte de dialogue Détails, la taille par défaut est Large.
Classe CSS Spécifiez une ou plusieurs classes CSS qui sont appliquées à la boîte de dialogue qui s'affiche.
Classe CSS du titre Spécifiez une ou plusieurs classes CSS qui sont appliquées à la barre de titre de la boîte de dialogue qui s'affiche.

Paramètres de l'action Modifier

L'activation d'une Action Modifier permet à l'utilisateur d'afficher un formulaire d'entité modifiable qui est lié aux données de l'enregistrement de la ligne sélectionnée dans la liste des entités, à condition que le privilège « Écrire » ait été accordé par les autorisations d'entité.

Nom Description
Paramètres de base
Formulaire d\'entité Spécifie le formulaire d'entité qui est utilisé pour modifier l'entité sélectionnée. La liste déroulante comporte tous les formulaires d'entités qui sont configurés pour le type d'entité de la liste des entités.
Remarque : si le type d'entité de la liste des entités n'a pas de formulaires d'entité, la liste déroulante apparaîtra vide. Si aucun formulaire d'entité n'est fourni pour l'Action Modifier, elle sera ignorée et le bouton ne s'affichera pas dans la liste des entités.
Paramètres avancés
Nom du paramètre de chaîne de requête d\'ID d\'enregistrement Spécifie le nom du paramètre de la chaîne de requête qui sera utilisé pour sélectionner l'entité à modifier dans le formulaire d'entité sélectionné. Cela devrait correspondre à la valeur du Nom du paramètre de chaîne de requête d'ID d'enregistrement du formulaire d'entité. La valeur par défaut pour ce champ, à la fois ici et dans la configuration du formulaire d'entité, est « ID ».
Étiquette de bouton Remplace l'étiquette HTML pour cette action affichée dans la ligne Liste des entités.
Info-bulle de bouton Remplace le texte d'info-bulle qui apparaît lorsque la souris est pointée sur le bouton pour cette action affichée dans la ligne Liste des entités.

Paramètres (avancés) de la boîte de dialogue de modification de formulaire

Nom Description
Message de chargement Remplace le texte HTML qui apparaît pendant le chargement de la boîte de dialogue.
Fonction Remplace le texte HTML qui apparaît dans la barre de titre de la boîte de dialogue.
Texte pour lecteur d\'écran bouton Ignorer Remplace le texte de lecteur d'écran associé au bouton Ignorer de la boîte de dialogue.
Taille Spécifie la taille de la boîte de dialogue Modifier. Les options sont Par défaut, Grand et Petit. Pour la boîte de dialogue Modifier, la taille par défaut est Large.
Classe CSS Spécifiez une ou plusieurs classes CSS qui sont appliquées à la boîte de dialogue qui s'affiche.
Classe CSS du titre Spécifiez une ou plusieurs classes CSS qui sont appliquées à la barre de titre de la boîte de dialogue qui s'affiche.

Paramètres de l'action Supprimer

L'activation d'une Action Supprimer permet à un utilisateur de supprimer définitivement l'enregistrement de la ligne sélectionnée dans la liste des entités, à condition que le privilège « Supprimer » ait été accordé par les autorisations d'entité.

Nom Description
Paramètres de base
Aucun(e)
Paramètres avancés
Confirmation Remplace le message de confirmation HTML affiché lorsque l'utilisateur active l'action Supprimer.
Étiquette de bouton Remplace l'étiquette HTML pour cette action affichée dans la ligne Liste des entités.
Info-bulle de bouton Remplace le texte d'info-bulle qui apparaît lorsque la souris est pointée sur le bouton pour cette action affichée dans la ligne Liste des entités.

Paramètres (avancés) de la boîte de dialogue Supprimer

Nom Description
Fonction Remplace le texte HTML qui apparaît dans la barre de titre de la boîte de dialogue.
Texte du bouton Principal Remplace le texte HTML qui apparaît dans le bouton Principal (« Supprimer ») de la boîte de dialogue.
Texte bouton Fermer Remplace le texte HTML qui apparaît dans le bouton Fermer (« Annuler ») de la boîte de dialogue.
Texte pour lecteur d\'écran bouton Ignorer Remplace le texte de lecteur d'écran associé au bouton Ignorer de la boîte de dialogue.
Taille Spécifie la taille de la boîte de dialogue Supprimer. Les options sont Par défaut, Grand et Petit. Pour la boîte de dialogue Supprimer, la taille par défaut est Défaut.
Classe CSS Spécifiez une ou plusieurs classes CSS qui sont appliquées à la boîte de dialogue qui s'affiche.
Classe CSS du titre Spécifiez une ou plusieurs classes CSS qui sont appliquées à la barre de titre de la boîte de dialogue qui s'affiche.
Classe CSS du texte du bouton Principal Spécifiez une ou plusieurs classes CSS qui sont appliquées au bouton Principal (« Supprimer ») de la boîte de dialogue.
Classe CSS du bouton Fermer Spécifiez une ou plusieurs classes CSS qui sont appliquées au bouton Fermer (« Annuler ») de la boîte de dialogue.

Paramètres de l'action Workflow

L'activation d'une Action Workflow permet à l'utilisateur d'exécuter un workflow à la demande sur l'enregistrement de la ligne sélectionnée dans la liste des entités. Vous pouvez ajouter autant d'actions de workflow que vous le souhaitez à la liste des entités.

Nom Description
Paramètres de base
Workflow Spécifie le workflow à la demande qui sera exécuté lorsque l'utilisateur active cette action.
Remarque : si le type d'entité de la liste des entités n'a pas de workflows, la liste déroulante apparaîtra vide. Si aucun workflow n'est fourni pour l'Action Workflow, elle sera ignorée et le bouton ne s'affichera pas dans la liste des entités.
Étiquette de bouton Définit l'étiquette HTML pour cette action affichée dans la ligne Liste des entités. Ce paramètre est obligatoire.
Paramètres avancés
Info-bulle de bouton Remplace le texte d'info-bulle qui apparaît lorsque la souris est pointée sur le bouton pour cette action affichée dans la ligne Liste des entités.

Protection des listes d'entités

Pour protéger une liste d'entités, vous devez configurer des autorisations d'entité pour l'entité pour laquelle des enregistrements sont affichés, mais aussi définir la valeur booléenne « Activer les autorisations d'entité » sur l'enregistrement de liste d'entités dans Dynamics 365 sur true.

La protection d'une liste d'entités permet de s'assurer que, lorsqu'un client accède à la page, seuls les enregistrements auxquels il est autorisé à accéder sont visibles. À cet effet, un filtre supplémentaire est ajouté aux vues Dynamics 365 disponibles via la liste. Ce filtre s'applique uniquement aux enregistrements qui sont accessibles à l'utilisateur, via une autorisation de Lecture.

En outre, les actions définies pour la liste respecteront les autorisations correspondantes pour chaque enregistrement. Ainsi, si vous disposez de l'autorisation Modifier pour un enregistrement, l'action Modifier est activée pour cet enregistrement. Il en va de même pour les actions Supprimer, Créer, etc.

Si aucun enregistrement n'est disponible, un message correspondant s'affiche lorsque la liste est chargée.

Toutefois, une conception de site Web efficace détermine que, si un utilisateur ne dispose pas d'un rôle avec des autorisations pour l'entité (c'est-à-dire, il ne pourra en aucun cas afficher des enregistrements), il ne doit pas avoir accès à la page. Dans l'idéal, la page doit être protégée avec les autorisations d'accès à la page Web.

Ajout d'une page de détails

En définissant la recherche de page Web pour la vue Détails sur une page Web, les détails d'un enregistrement répertorié dans la grille peuvent être affichés en lecture seule ou modifiés, selon la configuration du formulaire ou de la page associé.

Cette page peut être un modèle de page entièrement personnalisé, créé peut-être avec Liquid. Le scénario le plus courant consiste probablement à définir comme page de détails une page Web contenant un formulaire d'entité ou un formulaire Web.

Il est important de savoir que chaque enregistrement répertorié dans la grille contiendra un lien hypertexte vers la page de détails, et le lien contiendra un paramètre de chaîne de requête nommé avec l'ID de l'enregistrement. Le nom du paramètre de chaîne de requête dépend du nom du paramètre de chaîne de requête d'ID spécifié sur la liste des entités. Enfin, notez que la page Web de détails ciblée doit également connaître le nom de ce paramètre de chaîne de requête pour obtenir l'ID de l'enregistrement pour lequel il doit créer une requête et charger les données.

Ajouter une page de détails

Utilisation d'un formulaire d'entité pour afficher les détails

Pour créer un formulaire d'entité, reportez-vous aux instructions disponibles sur la page Formulaire d'entité.

Vous devez tenir compte des paramètres importants ci-dessous pour vous assurer que l'enregistrement de la liste d'entités est chargé dans le formulaire d'entité.

Le nom du paramètre de chaîne de requête d'ID d'enregistrement sur le formulaire d'entité doit correspondre au nom du paramètre de chaîne de requête d'ID sur la liste des entités.

Le mode peut être Modifier ou Lecture seule selon vos besoins.

Utilisation d'un formulaire Web pour afficher les détails

Pour créer un formulaire Web, reportez-vous aux instructions disponibles sur la page Formulaire Web.

Vous devez tenir compte des paramètres importants ci-dessous pour vous assurer que l'enregistrement de la liste d'entités est chargé dans le formulaire Web.

Le nom du paramètre de chaîne de requête d'ID de clé primaire sur l'étape de formulaire Web doit correspondre au nom du paramètre de chaîne de requête d'ID sur la liste des entités.

Le mode peut être Modifier ou Lecture seule selon vos besoins.

Utilisation d'une page de détails pour la création

Vous pouvez utiliser une page personnalisée, un formulaire d'entité ou un formulaire Web, de la même façon pour la fonction Créer. Il s'agit d'une alternative à la définition d'une action Créer sur le formulaire. Vous ne pouvez pas définir une action Créer et une page personnalisée pour la création : la définition d'une action personnalisée est prioritaire.

Si vous attribuez une page Web à la recherche d'une action Créer sur la liste des entités, et si vous ne spécifiez pas une action Créer à l'aide de l'option Configuration, un bouton Créer sera affiché sur la liste et associera l'utilisateur à la page personnalisée que vous avez désignée pour la création.

Configuration du filtre de la liste des entités

L'ajout de la fonction de filtrage des enregistrements d'une liste d'entités est facile. Il suffit d'activer l'option de filtrage et de choisir un ou plusieurs types de filtre à afficher aux utilisateurs. Il est possible de filtrer en fonction d'un attribut correspondant au texte fourni par l'utilisateur, ou de choisir parmi une série d'options. Vous pouvez même créer quasiment n'importe quel type de filtre en utilisant la recherche avancée dans Dynamics 365.

Activer le filtre de la liste des entités

Dans la section Filtre de métadonnées, cochez la case Activé. La zone de filtre est alors ajoutée à la liste des entités lorsqu'elle est affichée. Tant que vous n'avez pas défini au moins un type de filtre, cette zone sera vide.

Vous pouvez définir la façon dont la zone de filtre est affichée sur la liste des entités à l'aide de l'option Orientation. La valeur par défaut, Horizontal, affiche la zone de filtre au-dessus de la liste des entités. L'orientation verticale affiche la zone de filtre sous forme de case à gauche de la liste des entités.

Paramètres de filtre de métadonnées

Types de filtre

Type de filtre Description
Filtrer le texte Filtrez la liste des entités en utilisant une zone de texte pour rechercher le texte correspondant dans un attribut sélectionné de l'entité donnée.
Jeu de filtres d\'attribut Filtrez la liste des entités à l'aide d'une série de cases à cocher, chacune essayant de faire correspondre sa condition avec un attribut particulier de l'entité donnée.
Jeu de recherche Filtrez la liste des entités à l'aide d'une série de cases à cocher, chacune représentant une relation entre un enregistrement de l'entité donnée et un enregistrement d'une entité associée.
Jeu de filtres de plage Similaire au jeu de filtres d'attribut, à ceci près que chaque case à cocher peut représenter deux conditions au lieu d'une (par exemple, « supérieur ou égal à 0 ET inférieur à 100 »).
Jeu de listes de sélection dynamique Similaire à la sélection d'une valeur de liste de sélection dans un jeu de filtres d'attribut. Le jeu de listes de sélection dynamique ne nécessite pas de spécifier les options de liste de sélection sur lesquelles appliquer le filtre ; il génère la liste complète des options lorsque la liste des entités est chargée.
Jeu de recherche dynamique Similaire au jeu de recherche. Le jeu de recherche dynamique ne nécessite pas de spécifier les options de recherche sur lesquelles appliquer le filtre ; il génère la liste complète des options lorsque la liste des entités est chargée.
Filtre FetchXML Filtrez la liste des entités à l'aide d'une condition de filtre FetchXML.

Filtre de texte

Le filtre de texte ajoute une zone de texte à la zone Filtre de la liste des entités qui est liée à un attribut du type d'entité de la liste des entités. Lorsqu'un utilisateur applique le filtre, la liste des entités affiche uniquement les enregistrements dont l'attribut sélectionné contient la valeur.

Pour ajouter un filtre de texte, cliquez sur « + Filtre de texte » :

Ajouter un filtre de texte

Le filtre de texte utilise les attributs suivants :

Nom Description
Attribut Nom de l'attribut du type d'entité sélectionné dans la liste des entités faisant l'objet du filtrage.Seuls les attributs de type « String » sont valides pour un filtre de texte.
Nom complet Remplace l'étiquette du filtre lorsque la liste des entités est affichée. Par défaut, il est automatiquement défini sur le nom de l'attribut sélectionné.

Jeu de filtres d'attribut

Le jeu de filtres d'attribut ajoute une série d'options de filtrage de la liste des entités, qui sont liées à un attribut unique du type d'entité sélectionné dans la liste des entités. Lorsqu'un utilisateur applique le filtre, la liste des entités affiche uniquement les enregistrements qui correspondent exactement à au moins une des options sélectionnées.

Paramètres de filtre d'attribut

Le jeu de filtres d'attribut utilise les attributs suivants :

Nom Description
Attribut Nom de l'attribut du type d'entité sélectionné dans la liste des entités faisant l'objet d'un filtrage. Seuls les attributs avec les types suivants sont valides pour un filtre de texte : String, BigInt, Decimal, Double, Integer, Money, Picklist, DateTime, Boolean
Nom complet Remplace l'étiquette du filtre lorsque la liste des entités est affichée. Par défaut, il est automatiquement défini sur le nom de l'attribut sélectionné.
Options Collection de valeurs de filtre possibles. Voir ci-dessous pour plus de détails.

Options du jeu de filtres d'attribut

Un jeu de filtres d'attribut peut généralement contenir autant d'options que vous le souhaitez, à l'exception des attributs Picklist et Boolean. Un jeu de filtres d'attribut de type Boolean ne peut contenir qu'une ou deux options : une option true et une option false. Un jeu de filtres d'attribut de type Picklist peut contenir au moins une option pour chaque valeur possible de la liste de sélection.

Les options ont les attributs suivants :

Nom Description
Opérateur Opérateur de comparaison utilisé pour filtrer les résultats, par exemple, Égal à, Inférieur à, etc. La liste des opérateurs de l'option dépend du type de l'attribut sélectionné pour le filtre. Par exemple, les types numériques (« Decimal ») ont des opérateurs comme « Inférieur à » ou « Supérieur à », tandis que les attributs de type « String » utilisent des opérateurs comme « Commence par » ou « Contient ». Les opérateurs Picklist et Boolean ont toujours la valeur « Égal à ».
Valeur Valeur réelle utilisée pour cette condition de filtre.
Nom complet Remplace le nom complet pour cette option dans la zone de filtre. Par défaut, il est automatiquement défini sur le même nom que l'attribut Value.

Jeu de recherche

Le jeu de recherche ajoute une série d'options de filtrage de la liste des entités, qui sont liées à une entité associée au type d'entité sélectionné dans la liste des entités. Lorsqu'un utilisateur applique le filtre, la liste des entités affiche uniquement les enregistrements qui correspondent exactement à au moins un des enregistrements associés.

Jeu de recherche

Le jeu de recherche utilise les attributs suivants :

Nom Description
Relation Nom de l'entité associée au type d'entité sélectionné dans la liste des entités faisant l'objet du filtrage. Seules les entités ayant des relations un-à-plusieurs ou plusieurs-à-plusieurs avec le type d'entité sélectionné dans la liste des entités s'affichent comme options pour ce type de filtre.
Nom complet Remplace l'étiquette du filtre lorsque la liste des entités est affichée. Par défaut, il est automatiquement défini sur le nom de la relation sélectionnée.
Options Collection de valeurs de filtre possibles. Voir ci-dessous pour plus de détails.

Options du jeu de recherche

Un jeu de recherche peut généralement contenir autant d'options que vous le souhaitez, la seule limite étant le nombre d'enregistrements associés du type sélectionné.

Les options ont les attributs suivants :

Nom Description
Valeur Enregistrement du type associé sélectionné faisant l'objet du filtrage.
Nom complet Remplace le nom complet pour cette option dans la zone de filtre. Par défaut, il est automatiquement défini sur le même nom que l'attribut Value.

Jeu de filtres de plage

Le jeu de filtres de plage ajoute à la zone de filtre une série d'options, chacune avec une ou deux conditions. Lorsqu'un utilisateur applique le filtre, la liste des entités affiche uniquement les enregistrements qui correspondent exactement à toutes les conditions pour au moins une des options sélectionnées.

Paramètres de filtre de plage

Le jeu de filtres de plage utilise les attributs suivants :

Nom Description
Attribut Nom de l'attribut du type d'entité sélectionné dans la liste des entités faisant l'objet du filtrage. Seuls les attributs avec les types suivants sont valides pour un filtre de texte : String, BigInt, Decimal, Double, Integer, Money, DateTime
Nom complet Remplace l'étiquette du filtre lorsque la liste des entités est affichée. Par défaut, il est automatiquement défini sur le nom de l'attribut sélectionné.
Options Collection de valeurs de filtre possibles. Voir ci-dessous pour plus de détails.

Options du jeu de filtres de plage

Un jeu de filtres de plage peut contenir autant d'options que vous le souhaitez. Chaque option produit une condition de filtre avec une ou deux sous-conditions, qui doivent être remplies pour que la condition ait la valeur true.

Les options ont les attributs suivants :

Nom Description
Opérateur 1 Premier opérateur de comparaison utilisé pour filtrer les résultats, par exemple « Égal à », « Inférieur à », etc. La liste des opérateurs pour l'option dépend du type de l'attribut sélectionné pour le filtre. Par exemple, les types numériques (« Decimal ») ont des opérateurs comme « Inférieur à » ou « Supérieur à », tandis que les attributs de type « String » utilisent des opérateurs comme « Commence par » ou « Contient ». Les opérateurs Picklist et Boolean ont toujours la valeur « Égal à ».
Valeur 1 Première valeur utilisée pour cette condition de filtre.
Opérateur 2 (facultatif) Second opérateur de comparaison utilisé pour filtrer les résultats, par exemple « Égal à », « Inférieur à », etc. La liste des opérateurs pour l'option dépend du type de l'attribut sélectionné pour le filtre. Par exemple, les types numériques (« Decimal ») ont des opérateurs comme « Inférieur à » ou « Supérieur à », tandis que les attributs de type « String » utilisent des opérateurs comme « Commence par » ou « Contient ». Les opérateurs Picklist et Boolean ont toujours la valeur « Égal à ».
Valeur 2 (facultative) Seconde valeur utilisée pour cette condition de filtre.
Nom complet Remplace le nom complet pour cette option dans la zone de filtre. Par défaut, cette option est définie dynamiquement selon les opérateurs et les valeurs sélectionnés.

Jeu de listes de sélection dynamique

Le jeu de listes de sélection dynamique ajoute une série d'options de filtrage qui représentent toutes les valeurs d'un champ de liste de sélection spécifique. Cette option est différente de la sélection d'une liste de sélection dans le jeu de filtres d'attribut. Dans le jeu de filtres d'attribut, vous devez spécifier un groupe d'options de filtrage qui seront accessibles à l'utilisateur. Dans le jeu de listes de sélection dynamique, vous devez uniquement spécifier le champ Liste de sélection pour faire apparaître automatiquement le groupe d'options. Si vous avez besoin de plus de contrôle, il est recommandé d'utiliser le jeu de filtres d'attribut.

Paramètres de liste de sélection dynamique

Le jeu de liste de sélection dynamique utilise les options suivantes :

Nom Description
Attribut Nom de l'attribut Picklist du type d'entité sélectionné dans la liste des entités faisant l'objet du filtrage.
Nom complet Remplace l'étiquette du filtre lorsque la liste des entités est affichée. Par défaut, il est automatiquement défini sur le nom de l'attribut sélectionné.

Jeu de recherche dynamique

Le jeu de recherche dynamique ajoute une série d'options de filtrage de la liste des entités, qui sont liées à une entité associée au type d'entité sélectionné dans la liste des entités. Lorsqu'un utilisateur applique le filtre, la liste des entités affiche uniquement les enregistrements qui correspondent exactement à au moins un des enregistrements associés.

Cette option est différente d'un jeu de recherche. Dans le jeu de recherche, vous devez spécifier manuellement les entités de filtre associées. Dans le jeu de recherche dynamique, vous devez uniquement spécifier la relation de filtre pour générer une liste d'options en fonction de la vue spécifiée des entités associées.

Paramètres de recherche dynamique

Le jeu de recherche dynamique utilise les options suivantes :

Nom Description
Relation Nom de l'entité associée au type d'entité sélectionné dans la liste des entités faisant l'objet du filtrage. Seules les entités ayant des relations un-à-plusieurs ou plusieurs-à-plusieurs avec le type d'entité sélectionné dans la liste des entités s'affichent comme options pour ce type de filtre.
Vue Vue (requête enregistrée) à utiliser comme source pour la liste dynamique d'entités de filtre
Étiqueter la colonne Champ de la vue qui fournit la valeur « Nom » de chaque entité.
Filtrer la recherche selon les relations Spécifie une relation entre l'entité spécifiée par le champ Relation et l'utilisateur connecté. Si l'entité spécifiée par le champ Relation possède également une relation avec un contact, vous pouvez éventuellement limiter la liste des options de filtre à celles associées à l'utilisateur connecté.
Nom complet Remplace l'étiquette du filtre lorsque la liste des entités est affichée. Par défaut, il est automatiquement défini sur le nom de la relation sélectionnée.

Filtre FetchXML

Le filtre de plage peut créer un filtre de zone de texte simple comme le filtre de texte, ou un groupe d'options comme les autres types de filtre. Il vous permet de créer manuellement pratiquement n'importe quel type de filtre pour la liste des entités à l'aide de FetchXML, le langage de requête utilisé par Dynamics 365.

Paramètres de filtre FetchXML

L'option Filtre FetchXML utilise un seul attribut :

Nom Description
FetchXML Instruction XML représentant le filtre.

Vue carte de la liste des entités

Avec les listes d'entités, il est possible d'activer et de configurer une vue carte des données, optimisée par Bing Maps avec la fonctionnalité de recherche pour rechercher des emplacements à proximité d'une adresse. En renseignant vos enregistrements avec les valeurs de coordonnées de latitude et de longitude et en spécifiant les options de configuration nécessaires répertoriées dans cette section, vos enregistrements peuvent être affichés sous forme de repères sur une carte. Un enregistrement qui n'a pas de valeur de latitude ou de longitude est exclus de la recherche. Le chargement initial de la page affiche tous les enregistrements compris dans la valeur initiale du champ Valeurs de distance (en miles ou km selon les unités de distance spécifiées) à partir des coordonnées Latitude du centre par défaut et Longitude du centre par défaut. La vue spécifiée est ignorée lorsque la vue carte est utilisée, et une requête de distance est appliquée à l'ensemble de données pour retourner les résultats mappables.

Note

Cette option n'est pas prise en charge dans l'environnement Cloud souverain allemand. La section Vue Carte ne sera pas visible dans cet environnement.

Vue calendrier de la liste des entités

La vue calendrier de la liste des entités permet d'afficher une liste d'entités sous forme de calendrier, avec chaque enregistrement individuel configuré pour agir comme un seul événement.

Pour que les enregistrements s'affichent à l'aide d'un calendrier, ceux-ci doivent contenir au minimum un champ de date. Pour que les événements aient des heures de début et de fin exactes, les champs appropriés doivent être en place, etc. En supposant que ces champs sont configurés, une vue calendrier des entités s'affiche sur le portail

Filtre de vue Dynamics 365 amélioré pour les listes d'entités

Si elle est activée, une entité peut être publiée sur un flux OData. Le protocole OData est un protocole au niveau de l'application qui interagit avec les données via les services Web RESTful. Pour les paramètres de configuration, reportez-vous à la page Liste des entités. Les données issues de ce flux peuvent être affichées dans un navigateur Web, utilisées par une application Web côté client ou importées dans Excel.

Flux OData de la liste des entités

Vous pouvez utiliser des autorisations d'entité si vous souhaitez protéger des enregistrements, mais si vous souhaitez simplement fournir un filtre dans le cadre du groupe d'options de filtre qui s'applique à l'utilisateur actuel du portail, la fonctionnalité Liste des entités prend en charge le filtrage de l'utilisateur actuel, du compte parent de l'utilisateur et/ou du site Web à n'importe quel niveau. Créez simplement le filtre de vue dans Dynamics 365 pour correspondre à un enregistrement de contact unique et le code remplacera sa valeur par la valeur réelle au moment de l'exécution. Il n'est pas nécessaire d'attribuer des valeurs aux champs de la section Conditions de filtre.

Note

Le flux oData publié est anonyme et ne comporte pas de vérifications d'autorisation. Par conséquent, il est important de ne pas activer les flux oData pour les données Dynamics 365 qui sont inappropriées pour un accès anonyme au portail.

Voir aussi

Configurer un portail Dynamics 365
Créer et exécuter des publicités sur un portail
Regrouper des commentaires en utilisant des sondages sur un portail
Évaluer ou voter sur une page Web ou un billet de blog sur un portail
Rediriger vers une nouvelle URL sur un portail