L’utilitaire d’assistant de mappage fournit un environnement visuellement intuitif pour spécifier le mappage entre les champs de jeu d’importation et les champs de table de production. L’utilitaire d’assistant de mappage permet de mapper un seul champ source (champ sur une table de jeu d’importation) sur plusieurs champs de destination (champs sur une table de production).

Si le format de date du champ source ne correspond pas au format du champ cible, vous pouvez définir un mappage de format de date pour transformer les dates d’un format à un autre. Par exemple, ce mappage spécifie que le format de date du fichier source CSV utilise le format MM-jj-aaaa .

Les options de format de date sont les suivantes :

Tableau 1. Options de mappage

Format de date	Description
jj-mm-aaaa	Jour-mois-année
jj-MM-aaaa hh :mm :ss	Jour-mois-année heures-minutes-secondes
jj-MM-aaaa hh :mm :ss z	Jour-mois-année heures-minutes-secondes fuseau horaire
mm-jj-aaaa	Mois-jour-année
MM-jj-aaaa hh :mm :ss	Mois-jour-année heures-minutes-secondes
MM-jj-aaaa hh :mm :ss z	Mois-jour-année heures-minutes-secondes fuseau horaire
aaaa-jj-MM	Année-jour-mois
aaaa-MM-jj	Année-mois-jour
aaaa-MM-jj hh :mm :ss	Année-mois-jour heures-minutes-secondes

ServiceNow Les champs Durée utilisent un type de données spécial qui indique le nombre de millisecondes de la valeur de durée. Pour mapper des données importées à un champ de durée, utilisez l’une des méthodes suivantes pour transformer les valeurs sources en durée.

• Calculer la durée à partir des dates de début et de fin
• Convertir une valeur de durée existante en valeur ServiceNow de durée

Si la source d’importation a une date de début et une date de fin, vous pouvez calculer une durée avec JavaScript.

1. Accédez à la Ensembles de données système à importer > Cartes de transformation.
2. Sélectionnez la carte de transformation pour laquelle vous souhaitez calculer une valeur de durée. Par exemple, la carte de transformation de notification qui importe dans la table Incident.
3. Cochez la case Exécuter le script .
4. Entrez JavaScript pour transformer les dates de début et de fin en une durée. Voir l’exemple de script.
5. Cliquez sur Mettre à jour.

Cet exemple de script transforme les champs source.u_start et source.u_end en une valeur de durée dans le champ target.duration. Modifiez les noms de champs pour qu’ils correspondent à vos champs source et cible, selon vos besoins.

target.duration = gs.dateDiff(source.u_start.getDisplayValue(), source.u_end.getDisplayValue(), false);

Si la source d’importation contient déjà une date de début et une valeur de durée, vous pouvez convertir la durée existante en ServiceNow durée. Par exemple, vous pouvez avoir une source de données Excel qui indique une durée en secondes. ServiceNow S’attend à ce que les durées aient des valeurs en millisecondes.

1. Accédez à la Ensembles de données système à importer > Cartes de transformation.
2. Sélectionnez une carte de transformation.

   Par exemple, la carte de transformation de notification qui importe dans la table Incident.

3. Cochez la case Exécuter le script .
4. Entrez JavaScript pour convertir des valeurs de durée existantes en valeurs de ServiceNow durée. Voir l’exemple de script.
5. Cliquez sur Mettre à jour.

Cet exemple de script convertit une durée en secondes (à partir du source.u_duration champ) en une durée en millisecondes (sur le target.duration terrain). Modifiez les noms de champs pour qu’ils correspondent à vos champs source et cible, selon vos besoins.

//Transform the value in source.u_duration from seconds to milliseconds
target.duration.setDateNumericValue(source.u_duration * 1000);

Cet exemple de script convertit une durée déjà exprimée en millisecondes (à partir source.u_duration du champ) en une ServiceNow durée (dans le target.duration champ). Modifiez les noms de champs pour qu’ils correspondent à vos champs source et cible, selon vos besoins.

//Transform the value in source.u_duration to ServiceNow format
target.duration.setDateNumericValue(source.u_duration);

Vous pouvez utiliser un script source au lieu du champ Source lorsque :

• La valeur source n’est pas au format de la valeur cible mappée.
• Vous souhaitez rechercher une valeur avant de la mapper au champ cible.
• La valeur source doit être calculée à partir de plusieurs champs.
• Vous devez créer une valeur de fusion composée ou calculée dans le champ cible.

Par exemple, cet exemple de script source calcule la valeur du champ user_name lorsqu’il est vide dans la source.

Pour qu’une carte de transformation accède à la pièce jointe, utilisez l’API GlideRecord dans un script onAfter . Le script doit s’exécuter dans un événement onAfter, car l’objet target.sys_id n’est disponible qu’une fois les données placées dans la table de jeux d’importation. Par exemple, pour mapper la pièce jointe résultante à l’enregistrement de transformation cible, vous pouvez utiliser le script suivant.

var agr = new GlideRecord("sys_attachment");
  agr.addQuery("sys_id", source.u_blob_field);
  // the source field needs to be mapped to the source that is the BLOB
  agr.query();
   if(agr.next()) {
    agr.table_name = "cmdb_ci"; // the target table of the transform map
    agr.table_sys_id = target.sys_id; // the target record
    agr.content_type = source.u_contentype; 
    // the content type string if available,  
    // this becomes the mime encoding when clicking an attachment link
    agr.update(); // finally, move/re-attach the attachment to the target row }

Si vous effectuez un mappage directement sur la table db_image , exécutez le script onAfter suivant pour afficher l’image :

var strTemp = source.u_file_name; 
var fType = strTemp.substr(- 3); 
var iCont = "" ;
 
 if(fType == 'jpg') {
  iCont = 'jpeg' ; } 
 else {
  iCont = fType; }
 
 var agr = new GlideRecord("sys_attachment");
 agr.addQuery("sys_id", source.u_blob_field);
 agr.query();
 
 if(agr.next()) {
  agr.table_name = "ZZ_YYdb_image";
  agr.table_sys_id = target.sys_id;
  agr.content_type = 'image/' + iCont;
  agr.file_name = 'image';
  agr.update(); }