Partager via


Ajouter les mappages de transformation pour l’importation

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

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).