Transformer un champ

Transformez le contenu d’un champ à l’aide d’un ensemble de règles et de conditions.

Avant de commencer

Rôle requis : admin ou normalisateur

Procédure

1. Créez un enregistrement de transformation.
2. Créez un ou plusieurs enregistrements de transformation connexes.
3. Testez la transformation.
4. Exécute des tâches de données.

Que faire ensuite

Si vous souhaitez également afficher la valeur d’entrée d’origine (brute) avant la transformation, créez un champ brut pour stocker cette valeur.

Créer un enregistrement de transformation

La création d’un enregistrement de transformation est la première étape de la transformation d’un champ.

Procédure

1. Activez le module d’extension Normalisation de champ.
2. Accédez à la Normalisation de champ > Configurations > Transformations.
3. Cliquez sur Nouveau.
4. Créez un enregistrement de transformation.

   Tableau 1. Champs d’enregistrement de transformation

   Champ	Description
   Nom	Nom unique pour cet enregistrement de transformation. Cette valeur est fournie à titre indicatif et n’est utilisée dans aucun traitement.
   Table	Sélectionnez la ServiceNow table contenant le champ à transformer. Il est important de comprendre la hiérarchie des tables lors de la configuration d’une transformation de champ. Par exemple, si vous configurez la transformation d’un champ dans la table Ordinateur [cmdb_ci_computer], ce champ sera transformé pour tous les ordinateurs de station de travail, Windows serveurs, Linux serveurs et UNIX serveurs.
   Champ	Sélectionnez le champ à transformer. La liste présentée contient uniquement les types de champs (entier et chaîne) de la table sélectionnée qui peuvent être transformés. Remarque : Le format de date de l’enregistrement sys_user qui lance le processus de transformation doit être défini sur le format par défaut « aaaa-MM-jj ». Tout autre format de date provoque une erreur lors de la transformation. Ce problème est uniquement spécifique à la transformation des champs TO TARGET de type Date/Heure. Ce problème n’est pas un problème si le type de champ cible est de type chaîne ou si le mappage de champ pour le champ de date est modifié au même format de date que le processus de transformation.
   Mode	Les trois modes disponibles sont Désactivé, Test et Actif. Tous les enregistrements de transformation sont créés en mode test par défaut. Ne changez pas de mode tant que vous n’avez pas soigneusement testé la transformation. Lorsque le test est terminé, changez le mode en Actif. Pour désactiver cette transformation, basculez le mode sur Désactivé.
   Normaliser la requête	Cochez cette case pour appliquer la valeur de champ transformée par cet enregistrement à toutes les requêtes impliquant ce champ. Les requêtes émises avec la valeur de champ brute (d’origine) sont modifiées pour utiliser la valeur de transformation.
   Champ brut	Sélectionnez le champ à utiliser pour afficher les valeurs d’entrée d’origine (non normalisées) sur un formulaire dans lequel une valeur de champ a été normalisée. Pour que la sélection apparaisse dans la liste déroulante, ajoutez un champ personnalisé au formulaire pour la table sélectionnée. Pour obtenir des instructions sur l’ajout d’un champ pour les données brutes, reportez-vous à Créer un champ brut.

5. Cliquez sur Envoyer.

   Les listes connexes Transformations et Tâches de données s’affichent sur le formulaire.

Créer un ou plusieurs enregistrements de transformation connexes

Chaque enregistrement de transformation connexe effectue un type de transformation spécifique, tel que l’ajout de caractères au début de la valeur ou le remplacement d’une chaîne par une autre. Vous devrez peut-être créer plusieurs enregistrements de transformation connexes pour générer une valeur de champ de sortie préférée.

Procédure

1. Dans l’enregistrement Transformation, sélectionnez la liste connexe Transformations .
2. Cliquez sur Nouveau.

   Une liste de sélection de types de transformation s’affiche, affichant uniquement les transformations appropriées pour le type de champ sélectionné.

   Figure 1. Types de transformation

   

3. Sélectionnez un type de transformation et fournissez les paramètres appropriés.
4. Sélectionnez un numéro de commande pour cette transformation.
   Remarque :

   Les conditions des transformations sont exécutées en fonction des numéros d’ordre affectés.
5. Cochez la case Finale pour arrêter le traitement avec cette transformation si la condition est évaluée comme vraie.
6. Cochez la case Sensible à la casse pour forcer la sensibilité à la casse dans l’instruction de condition.

   L’exemple de transformation suivant remplace l’INC au début d’un numéro d’incident par la chaîne ENG si le groupe d’affectation est Ingénierie ITSM.

   Figure 2. Enregistrement de transformation

   

7. Cliquez sur Envoyer.

   La nouvelle transformation apparaît dans la liste connexe de l’enregistrement de transformation.

   Lorsque la transformation est créée, une tâche de données d’application de transformation est également créée. Cette tâche de données applique cette transformation aux enregistrements appropriés dans l’ensemble de la base de données et ne doit pas être exécutée tant que le test n’est pas terminé.

8. Facultatif : Répétez les étapes 2 à 8 jusqu’à ce que la valeur de sortie réponde aux critères souhaités.

Tester une transformation

Vérifiez que la transformation modifie la valeur du champ comme vous le souhaitez avant de l’appliquer aux enregistrements existants dans la base de données.

Pourquoi et quand exécuter cette tâche

Remarque :

Les utilisateurs doivent avoir le rôle normalization_tester pour créer des enregistrements de tests.

Les nouveaux enregistrements de transformation s’ouvrent en mode test par défaut, ce qui permet aux administrateurs de tester les transformations de manière approfondie avant de les appliquer aux enregistrements existants dans la base de données. En mode test, les commandes Démarrer ne sont pas disponibles pour la tâche Transformer les données de l’application . Il existe deux méthodes, répertoriées ci-dessous, pour tester les transformations avant de valider les transformations dans les données existantes.

Procédure

• Créez ou mettez à jour manuellement des enregistrements de tests.

  En mode test, seuls les enregistrements qui ont été créés ou mis à jour par un utilisateur disposant du rôle normalization_tester sont transformés. Accordez les rôles de normalisateur et de normalization_tester au même utilisateur ou accordez-les à des utilisateurs distincts.

• Utilisez l’utilitaire Tester les transformations pour entrer une valeur brute et voir la valeur transformée résultante.

  Cette fonctionnalité permet à un testeur de normalisation de transformer les valeurs de champ instantanément sans ouvrir ni mettre à jour les enregistrements. Cet utilitaire teste toutes les transformations configurées pour ce champ.

  1. Ouvrez un enregistrement de transformation.
  2. Cliquez sur le lien connexe Tester les transformations .

     Une boîte de dialogue s’affiche pour tester les valeurs de champ.

  3. Saisissez une valeur à transformer dans le champ Données brutes .

     

  4. Cliquez sur OK.

     La plateforme transforme la valeur brute dans le champ Données transformées .

     

  5. Saisissez de nouvelles données brutes pour tester d’autres transformations.
  6. Cliquez sur Annuler pour terminer le test.
  7. Une fois le test terminé, passez le mode sur Actif et exécutez la tâche de données.