Ajouter les mappages de transformation pour l’importation
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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 attributs cibles d’une entité.
Pour implémenter le mappage de transformation, utilisez l’entité de mappage de transformation (TransformationMapping) et l’entité de mappage de transformation de paramètreTransformationParameterMapping.
Les données transformées doivent être compatibles avec les types d’attributs d’entité Microsoft Dynamics 365.
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 :
Champ |
Valeur |
|---|---|
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.
Contenu de la rubrique
Concaténation
Fractionnement
Sous-chaîne
Remplacer
Attribuer une valeur
Ajouter à la date
Régler la date et l’heure
Ajout avancé à la date actuelle
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
j
e
f
g
h
i
j ;k
Sous-chaîne
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 Microsoft Dynamics 365.
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. |
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 l’attribut 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 de liste déroulante pour cette entité.Pour afficher les métadonnées d'entité pour votre organisation, installez la solution Navigateur de métadonnées décrite dans l'article Parcourir les métadonnées de votre organisation. Vous pouvez également afficher les métadonnées d'une organisation non personnalisée dans un fichier Excel appelé EntityMetadata.xlsx dans le dossier de niveau supérieur du téléchargement du Kit de développement logiciel (SDK). |
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 l’attribut 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 de liste déroulante pour cette entité. |
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 l’attribut 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 de liste déroulante pour cette entité. |
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 les données
Créer des mappages de données pour l’importation
Configurer l’importation des données
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright