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. 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 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