Mapper les colonnes de table

Vous pouvez mapper des colonnes, également appelées attributs, entre des tables qui ont une relation de table un-à-plusieurs ou plusieurs-à-un. Le mappage de colonnes vous permet de définir des valeurs par défaut pour une ligne créée dans le contexte d’une autre ligne.

Disons que des utilisateurs souhaitent ajouter une ligne de contact pour une personne employée d’un compte spécifique. Ils ont le choix entre deux méthodes.

• La méthode la plus difficile est celle où les utilisateurs peuvent simplement parcourir l’application pour créer entièrement une ligne de contact. Mais ils doivent ensuite définir le compte parent et saisir plusieurs informations, telles que l’adresse et le numéro de téléphone, qui sont probablement les mêmes que ceux du compte parent, ce qui peut nécessiter beaucoup de temps et introduire des opportunités d’erreur.
• La méthode la plus simple consiste à commencer avec la table de compte et, à l’aide de la sous-grille Contacts sur le formulaire, à sélectionner le signe + pour ajouter un contact. L’interface guide d’abord les personnes à rechercher les contacts associés existants, de manière à ne pas créer de ligne dupliquée accidentellement. S’ils ne trouvent pas le ligne existante, ils peuvent sélectionner Nouveau et créer une ligne de contact. Le nouveau formulaire de ligne de contact inclut ensuite toutes les valeurs d’attributs mappées à partir du compte, par exemple, l’adresse et le numéro de téléphone, en tant que valeurs par défaut. Les utilisateurs peuvent modifier ces valeurs avant d’enregistrer la ligne.

Lorsque vous mappez des colonnes de table pour une relation de table 1 à N, certains éléments de données de la ligne de table principale seront copiés dans le nouveau formulaire de table associé pour définir les valeurs par défaut que les utilisateurs peuvent modifier avant d’enregistrer.

Nonte

• Ces mappages définissent uniquement les valeurs par défaut d’une ligne avant son enregistrement. Les utilisateurs peuvent modifier les valeurs avant d’enregistrer. Les données qui sont transférées sont celles qui existent à ce stade. Les données ne sont pas synchronisées si les données sources changent ultérieurement.
• Ces mappages ne sont pas appliqués aux lignes associées créés à l’aide d’un processus de workflow ou de dialogue. Ils ne sont pas appliqués automatiquement aux nouveaux enregistrements créés à l’aide de code, mais les développeurs peuvent utiliser un message spécifique appelé InitializeFrom (Fonction InitializeFrom ou Classe InitializeFromRequest) pour créer une ligne à l’aide des mappages disponibles.
• Ces mappages ne sont pas appliqués pour les nouveaux formulaires de table associés qui sont ouverts lorsqu’une application n’a pas de connexion réseau active à Microsoft Dataverse, à l’exception des colonnes de recherche parentes.
• Le mappage des colonnes entre les tables n’est pas pris en charge lorsque vous utilisez une application en mode hors connexion. Pour plus d’informations, consultez les limitations répertoriées dans Limitations Mobile Offline pour les applications pilotées par modèle.

Afficher les colonnes mappables

Le mappage de colonnes s’effectue dans le contexte d’une relation de table 1 à N ou N à 1, vous devez donc d’abord afficher les relations de table 1 à N ou N à 1.

La seule façon d’afficher et de mapper des colonnes de table consiste à utiliser l’explorateur de solutions classique.

1. Connectez-vous à Power Apps, puis sélectionnez l’environnement souhaité.
2. Sélectionnez Solutions dans le volet de gauche, puis ouvrez la solution souhaitée.
3. Sélectionnez Basculer vers la vue classique dans la barre de commandes. La solution s’ouvre dans l’explorateur de solutions classique.
4. Développez Entités, développez la table de votre choix, puis développez le type de relation, soit Relations 1 à N soit Relations N à 1, puis ouvrez la relation dans laquelle vous souhaitez afficher ou modifier les mappages de colonnes.
5. Les mappages de colonnes ne sont pas réellement configurés dans les relations de table, mais ils sont exposés dans l’interface utilisateur de la relation de l’explorateur de solutions classique. Toutes les relations de table 1 à N n’en bénéficient pas. Dans la liste déroulante Type, sélectionnez Mappable pour afficher uniquement les relations avec les colonnes qui peuvent être mappées.
6. Double-cliquez sur la relation dans laquelle vous souhaitez afficher ou modifier les mappages de colonnes. Une page de navigateur s’ouvre pour afficher les propriétés de la relation.
7. Sélectionnez l’onglet Mappages dans le volet de navigation de gauche. Les mappages de la relation s’affichent.

Ajouter de nouveaux mappages

1. Lors de l’affichage des colonnes mappables, sélectionnez Nouveau dans la barre de commandes. La boîte de dialogue Créer un mappage de champ s’affiche.
2. Sélectionnez une colonne de la table source et une colonne de la table cible avec les valeurs que vous souhaitez mapper, par exemple address1_city pour la relation de la table compte à contact.
3. Sélectionnez OK pour fermer la boîte de dialogue.
4. Étant donné que les mappages de colonnes ne sont pas des métadonnées, vous devez les publier pour que les modifications prennent effet.

Génération automatique de mappages de colonnes

Vous pouvez également générer automatiquement des mappages en sélectionnant Générer des mappages dans le menu Autres actions.

Utilisez Générer les mappages lorsque vous créez des tables personnalisées et que vous souhaitez utiliser le mappage. Cependant, soyez prudent lorsque vous générez automatiquement des mappages avec des tables système, car vous risquez d’introduire des problèmes car vous remplacez les mappages par défaut.

Avertissement 

La génération automatique des mappages à l’aide de l’option Générer les mappages supprime tous les mappages existants et les remplace par des mappages suggérés, qui sont basés uniquement sur les colonnes dont les noms et les types de données sont similaires. Si vous procédez ainsi sur une table système, vous risquez de perdre des mappages attendus. Pour les tables personnalisées, cela permet de gagner du temps, car vous pouvez plus facilement supprimer les mappages inutiles et en ajouter d’autres que l’action de mappage générée n’a pas créés.

Types de données et règles de mappage

Les règles suivantes montrent les types de données qui peuvent être mappées :

• Les deux colonnes doivent être du même type et du même format.
• La longueur de la colonne cible doit être supérieure ou égale à celle de la colonne source.
• La colonne cible ne peut pas être mappée à une autre colonne déjà mappée.
• La colonne source doit être visible sur le formulaire.
• La colonne cible doit être une colonne dans laquelle un utilisateur peut entrer des données.
• Les valeurs d’ID d’adresse ou les colonnes de type partylist ne peuvent pas être mappées.
• Si vous mappez sur ou à partir d’une colonne qui n’est pas affichée sur un formulaire, le mappage ne s’effectue pas tant que la colonne n’est pas ajoutée à un formulaire.
• Si les colonnes sont des choix, les valeurs entières de chaque option doivent être identiques.

Nonte

Si vous devez mapper des colonnes de choix, nous vous recommandons de configurer les deux colonnes pour utiliser le même choix global. Sinon, il peut être difficile de conserver deux groupes d’options distincts synchronisés manuellement. Si les valeurs d’entier de chaque option ne sont pas mappées correctement, vous pouvez introduire des erreurs dans vos données. Pour plus d’informations : Créer et modifier des choix globaux pour Microsoft Dataverse (listes de sélection)

Supprimer les mappages

S’il y a des mappages que vous ne souhaitez pas appliquer, vous pouvez les sélectionner, puis sélectionner .

Voir aussi

Créer et modifier les relations des tables 1:N (un-à-plusieurs) ou N:1 (plusieurs-à-un) à l’aide de l’explorateur de solutions
Documentation pour développeurs : Personnalisation de mappages d’attribut et de table
Documentation pour développeurs : API web Créer une table à partir d’une autre table