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 de cet enregistrement de transformation. Cette valeur n’est donnée qu’à titre indicatif et n’est utilisée dans aucun traitement.
   Table	Sélectionnez la ServiceNow table contenant le champ en cours de transformation. Il est important de comprendre la hiérarchie de table lors de la configuration d’une transformation de champ. Par exemple, si vous configurez la transformation pour un champ de 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 (nombre 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/Time. 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 champs pour le champ de date est modifié vers le même format de date que le processus de transformation.
   Mode	Les trois modes disponibles sont Off, Test et Active. Tous les enregistrements de transformation sont créés par défaut en mode test. Ne changez pas de mode avant d’avoir soigneusement testé la transformation. Lorsque le test est terminé, passez 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) seront 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 à la section Créer un champ brut.

5. Cliquez sur Envoyer.

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

Créer un ou plusieurs enregistrements de transformation connexes

Chaque enregistrement de transformation connexe effectue un type de transformation spécifique, par exemple 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 d’ordre pour cette transformation.
   Remarque :

   Les conditions des transformations sont exécutées en fonction des numéros d’ordre attribué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 ITSM Engineering.

   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 les tests ne sont pas terminés.

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 les appliquer à des enregistrements existants dans la base de données.

Pourquoi et quand exécuter cette tâche

Remarque :

Les utilisateurs doivent disposer du rôle normalization_tester pour créer des enregistrements de test.

Les nouveaux enregistrements de transformation s’ouvrent par défaut en mode Test . Ils permettent aux administrateurs de tester minutieusement les transformations avant de les appliquer aux enregistrements existants dans la base de données. En mode test, les contrôles de démarrage ne sont pas disponibles pour la tâche de transformation des 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 des données existantes.

Procédure

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

  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 qui en résulte.

  Cette fonctionnalité permet à un testeur de normalisation de transformer les valeurs de champ à la volée 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. Lorsque le test est terminé, passez le mode en actif et exécutez la tâche de données.