Ajouter les mappages de transformation pour l’importation

Article
06/23/2023

Utilisez le mappage de transformation pour modifier les données avant de les importer. Par exemple, fractionner un nom complet qui est contenu dans le fichier source en un prénom et nom pour correspondre aux colonnes cibles d’une table.

Pour implémenter le mappage de transformation, utilisez la table TransformationMapping et la table TransformationParameterMapping.

Les données transformées doivent être compatibles avec les types de colonne Microsoft Dataverse.

Le type de transformation est décrit par la propriété TransformationMapping.TransformationTypeName. Les valeurs correctes de cette propriété sont répertoriées dans le tableau suivant :

Colonne	active
`AddToCurrentDate`	`Microsoft.Crm.Transformations.AddToCurrentDate`
`AddToDate`	`Microsoft.Crm.Transformations.AddToDate`
`AdvancedAddToCurrentDate`	`Microsoft.Crm.Transformations.AdvancedAddToCurrentDate`
`AssignValue`	`Microsoft.Crm.Transformations.AssignValue`
`Concatenate`	`Microsoft.Crm.Transformations.Concatenate`
`Replace`	`Microsoft.Crm.Transformations.Replace`
`Split`	`Microsoft.Crm.Transformations.Split`
`Substring`	`Microsoft.Crm.Transformations.Substring`

Les sections suivantes présentent les transformations disponibles.

Concaténation

Concatène des chaînes et les sépare avec un délimiteur.

Paramètres d’entrée	Description
Préfixe	Chaîne qui est utilisée comme un préfixe dans la chaîne concaténée.
Suffixe	Chaîne qui est utilisée comme un suffixe dans la chaîne concaténée.
Délimiteur	Caractère ou combinaison de caractères qui sépare des sous-chaînes dans la chaîne concaténée. Le délimiteur n’est pas utilisé entre le préfixe et la sous-chaîne ou entre le suffixe et la sous-chaîne. N’utilisez pas les caractères de retour arrière (\b), de nouvelle ligne (\n) ni de retour (\r) en guise de délimiteur.
<Variable>	Tableau de longueur variable qui contient des sous-chaînes.

Paramètres de sortie	Description
Chaîne	Chaîne concaténée.

Fractionnement

Sépare une chaîne contenant un délimiteur en sous-chaînes. Il peut y avoir jusqu’à dix sous-chaînes.

Paramètres d’entrée	Description
Chaîne d’entrée	Chaîne contenant une ou plusieurs sous-chaînes séparée(s) par des délimiteurs.
Délimiteur	Caractère ou combinaison de caractères qui sépare des sous-chaînes dans la chaîne. N’utilisez pas les caractères de retour arrière (\b), de nouvelle ligne (\n) ni de retour (\r) ou des chaînes vides en guise de délimiteur.

Paramètres de sortie	Description
Variable	Sous-chaînes 1 jusqu’à 10 maximum.

Par exemple, si la chaîne d’entrée contient onze sous-chaînes, la sortie contiendra dix sous-chaînes comme illustré dans l’exemple suivant :

Chaîne d’entrée : a;b;c;d;e;f;g;h;i;j;k

Sortie :

 a  
 b  
 c  
 d  
 e  
 f 
 g
 h  
 i  
 j;k

Substring

Retourne une sous-chaîne d’une longueur donnée, en commençant à un point donné dans la chaîne.

Paramètres d’entrée	Description
Chaîne d’entrée	Chaîne contenant une sous-chaîne.
Index de début	Position de départ de la sous-chaîne.
Durée	Longueur de la sous-chaîne. Si la durée est null, renvoie un index complet de l’index de début.

Paramètres de sortie	Description
Sous-chaîne	Sous-chaîne retournée.

Remplacer

Remplace toutes les occurrences d’une chaîne donnée par une autre chaîne donnée.

Paramètres d’entrée	Description
Chaîne d’entrée	Chaîne contenant une chaîne de recherche.
Chaîne recherchée	Chaîne de recherche. N’utilisez pas les caractères de retour arrière (\b), de nouvelle ligne (\n) ni de retour (\r) en guise de chaîne de recherche.
Chaîne de remplacement.	Chaîne de remplacement. Utilisez une chaîne vide pour supprimer une chaîne de recherche. N’utilisez pas les caractères de retour arrière (\b), de nouvelle ligne (\n) ni de retour (\r) en guise de chaîne de remplacement.

Paramètres de sortie	Description
Valeur	Valeur de remplacement (identique à la valeur attribuée).

Attribuer une valeur

Remplace toutes les valeurs par une valeur donnée.

Paramètres d’entrée	Description
Valeur	Valeur que vous souhaitez attribuer.

Paramètres de sortie	Description
Valeur	Valeur de remplacement (identique à la valeur attribuée).

Notes

Les transformations de dates ne peuvent être utilisées que pour les dates correctement formatées. Pour plus d’informations sur la manière de présenter les dates, voir l’aide Dataverse.

Ajouter à la date

Ajoute un nombre spécifié de jours, mois et années à une date.

Paramètres d’entrée	Description
Date	Chaîne de date qui doit être modifiée.
Décalage de l’année	Valeur positive ou négative qui est ajoutée au composant de l’année d’une date d’entrée.
Décalage du mois	Valeur positive ou négative qui est ajoutée au composant du mois d’une date d’entrée.
Décalage du jour	Valeur positive ou négative qui est ajoutée au composant du jour d’une date d’entrée.

Paramètres de sortie	Description
Nouvelle date	Chaîne de nouvelle date contenant le jour, le mois et l’année ajoutés dans cet ordre.

Régler la date et l’heure

Ajoute un nombre spécifique de jours, de mois et d’années à la date du jour et définit l’heure spécifiée. Les décalages peuvent être des nombres entiers.

Paramètres d’entrée	Description
Décalage de l’année	Valeur positive ou négative qui est ajoutée au composant de l’année d’une date actuelle.
Décalage du mois	Valeur positive ou négative qui est ajoutée au composant du mois d’une date actuelle.
Décalage du jour	Valeur positive ou négative qui est ajoutée au composant du jour d’une date actuelle.
heures	Valeur qui permet de régler le composant des heures d’une date du jour.
minutes	Valeur qui permet de régler le composant des minutes d’une date du jour.
Secondes	Valeur qui permet de régler le composant des secondes d’une date du jour.
Jour de la semaine	Jour de la semaine : Lundi, Mardi, Mercredi, Jeudi, Vendredi, Samedi, ou Dimanche. Les jours de la semaine sont représentés par des nombres entiers, commençant par la décimale 1 pour Lundi. Les valeurs des jours de la semaine sont contenues dans l’énumération `DayOfWeek`. Pour plus d’informations sur cette énumération, voir la rubrique MSDN DayOfWeekEnumeration. Si la date du jour calculé ne tombe pas le jour spécifié de la semaine, elle est ajustée à la date la plus proche du jour de la semaine spécifié. La date actuelle est toujours ajustée à une date dans le passé. Par exemple, si vous spécifiez mercredi comme jour de la semaine, et que la date nouvellement calculée tombe mardi 9 mars, la date sera ajustée au mercredi 3 mars.

Paramètres de sortie	Description
Nouvelle date	Chaîne de nouvelle date contenant le jour, le mois et l’année ajoutés dans cet ordre.

Ajout avancé à la date actuelle

Ajoute un nombre spécifique de jours, de mois et d’années à la date en cours. Vous pouvez spécifier si les décalages sont liés à la date actuelle ou à des valeurs absolues. Les décalages peuvent être des nombres entiers.

Par exemple, si vous utilisez une valeur absolue de 3 pour un décalage du mois, le mois nouvellement calculé est mars. Si vous définissez un rapport au mois de la date du jour de décalage à 3, et que le mois en cours est avril, le dernier mois calculé sera juillet.

Paramètres d’entrée	Description
Décalage de l’année	Valeur positive ou négative qui est ajoutée au composant de l’année d’une date actuelle ou d’une année absolue.
Mode de décalage de l’année	Indiquez si le décalage est en rapport avec la date du jour ou la valeur absolue en utilisant la colonne `TransformationParameterMapping.Data`. Si vous utilisez les types de liaison anticipée, utilisez l’énumération `TransformationOffsetMode` pour spécifier un décalage relatif ou absolu. Pour obtenir la liste des valeurs DataTypeCode, affichez les valeurs à sélectionner pour cette table. Pour afficher les métadonnées de votre organisation, installez la solution Navigateur de métadonnées décrite dans l’article Parcourir les définitions de table dans votre environnement. Vous pouvez également accéder à la documentation de référence pour les tables dans la Référence de table/d’entité Dataverse.
Décalage du mois	Valeur positive ou négative qui est ajoutée au composant du mois d’une date actuelle ou d’un mois absolu.
Mode de décalage du mois	Indiquez si le décalage est en rapport avec la date du jour ou la valeur absolue en utilisant la colonne `TransformationParameterMapping.Data`. Si vous utilisez les types de liaison anticipée, utilisez l’énumération `TransformationOffsetMode` pour spécifier un décalage relatif ou absolu. Pour obtenir la liste des valeurs DataTypeCode, affichez les valeurs à sélectionner pour cette table.
Décalage du jour	Valeur positive ou négative qui est ajoutée au composant du jour d’une date actuelle ou d’un jour absolu.
Mode de décalage du jour	Indiquez si le décalage est en rapport avec la date du jour ou la valeur absolue en utilisant la colonne `TransformationParameterMapping.Data`. Si vous utilisez les types de liaison anticipée, utilisez l’énumération `TransformationOffsetMode` pour spécifier un décalage relatif ou absolu. Pour obtenir la liste des valeurs DataTypeCode, affichez les valeurs à sélectionner pour cette table.
heures	Valeur qui définit le composant des heures d’une date du jour.
minutes	Valeur qui définit le composant des minutes d’une date du jour.
Secondes	Valeur qui définit le composant des secondes d’une date du jour.

Paramètres de sortie	Description
Nouvelle date	Chaîne de nouvelle date contenant le jour, le mois et l’année ajoutés dans cet ordre. D’abord, les composants relatifs sont ajoutés, puis les valeurs absolues sont utilisées pour former une date.

Voir aussi

Importer des données
Préparer les fichiers sources pour l’importation
Créer des mappages de données pour l’importation
Configurer l’importation des données
Exécuter l’importation des données
Entités d’importation de données
Exemple : exporter et importer un mappage de données
Exemple : Importer des données à l’aide d’un mappage de données complexe