CMDBDuplicateTemplateUtil : global

L’include de script CMDBDuplicateTemplateUtil fournit des méthodes permettant d’ajouter et de supprimer des tâches de déduplication vers/depuis un modèle de déduplication.

Pour plus d’informations sur la déduplication des CI, les tâches de déduplication et les modèles de déduplication, reportez-vous à la section Duplicate CIs remediation.

CMDBDuplicateTemplateUtils : CMDBDuplicateTemplateUtils()

Crée une instance de la classe CMDBDuplicateTemplateUtils .

Tableau 1. Paramètres

Nom	Type	Description
Aucun

L’exemple de code suivant montre comment appeler cette méthode pour créer un objet CMDBDuplicateTemplateUtils.

var dupTemp = new CMDBDuplicateTemplateUtils();

CMDBDuplicateTemplateUtils : addTasksToTemplate(String templateId, Array taskIds)

Ajoute une ou plusieurs tâches de déduplication à un modèle de déduplication spécifié.

Cette méthode remplace toutes les valeurs de modèle existantes, mais consigne les valeurs précédentes de chaque modèle dans les journaux système.

La liste suivante décrit les scénarios dans lesquels une tâche n’est pas ajoutée à un modèle, puis est marquée comme ignorée ou échouée :

• Le modèle spécifié n’est pas à l’état Publié. Toutes les tâches sont marquées comme ignorées.
• Le modèle spécifié est en cours d’exécution. Toutes les tâches sont marquées comme ignorées.
• La tâche n’est pas dans l’état ouvert. La tâche est marquée comme ignorée.
• La tâche n’est pas compatible avec le modèle spécifié. Par exemple, le modèle spécifié peut être créé pour le serveur d’applications Tomcat, mais la tâche de déduplication spécifiée est créée pour le serveur Linux. La tâche est marquée comme ignorée.
• Le modèle spécifié n’existe pas. Toutes les tâches sont marquées comme ayant échoué.
• La mise à jour de GlideRecord pour la colonne de modèle sur la tâche échoue. La tâche est marquée comme ayant échoué.

Tableau 2. Paramètres

Nom	Type	Description
ID de modèle	Chaîne	Sys_id du modèle de déduplication à associer à la tâche de déduplication.
taskIds	Tableau	Liste des sys_ids des tâches de déduplication à associer au modèle spécifié.

Tableau 3. Renvoie

Type	Description
Objet	Objet de résultat contenant l’état de toutes les tâches qui ont été tentées d’être associées au modèle spécifié. Type de données : objet { "failed": [Array], "skipped": [Array], "success": [Array], "summary": "String" }
échoué	Liste des tâches qui n’ont pas pu être associées au modèle. Type de données : tableau d’objets "failed": [ { "message": "String", "messageType: "String", "taskId": "String" } ]
message.échec	Message décrivant la raison pour laquelle la tâche n’a pas pu être associée au modèle. Type de données : chaîne
failed.messageType	Motif de l’échec. Type de données : chaîne
failed.taskId	Sys_id d’une tâche qui n’a pas pu être associée au modèle. Type de données : chaîne
ignoré	Liste des tâches qui n’ont pas échoué, mais qui n’ont pas été associées au modèle (ignoré). Type de données : tableau d’objets "skipped": [ { "message": "String", "messageType: "String", "taskId": "String" } ]
message.ignoré	Message décrivant pourquoi la tâche a été ignorée. Type de données : chaîne
skipped.messageType	Motif pour lequel la tâche est ignorée. Type de données : chaîne
skipped.taskId	Sys_id d’une tâche que la méthode a ignorée et qui est associée au modèle. Type de données : chaîne
succès	Liste des tâches qui ont été associées avec succès au modèle. Type de données : tableau d’objets "success": [ { "message": "String", "messageType: "String", "taskId": "String" } ]
message.réussite	Non utilisé actuellement. Type de données : chaîne
success.messageType	Non utilisé actuellement. Type de données : chaîne
success.taskId	Sys_id d’une tâche qui était associée au modèle. Type de données : chaîne
résumé	Brève description de toutes les erreurs de traitement globales qui se sont produites, par exemple si le modèle spécifié n’existe pas. Type de données : chaîne

L’exemple de code suivant montre comment appeler cette méthode pour ajouter des tâches de déduplication à un modèle de déduplication.

// Add tasks to template
var taskIds = [];
taskIds.push("96d2d25113152200eef2dd828144b0a4");
taskIds.push("f785a2c3d7012201de92a5f75e610398");
taskIds.push("635dd3dbc128ce0100655f1ec66ed41d");

var result = new CMDBDuplicateTemplateUtils().addTasksToTemplate("6b43105c37301000deeabfc8bcbe5db2", taskIds);
); 
gs.info('Success: ' + result.success);
gs.info('Failed: ' + result.failed);
gs.info('Skipped: ' + result.skipped);
gs.info(Summary: ' + result.summary);

Sortie :

Success: [
    {
      "taskId": "f785a2c3d7012201de92a5f75e610398",
      "message": "",
      "messageType": ""
    }
  ]
Failed: [
    {
      "taskId": "96d2d25113152200eef2dd828144b0a4",
      "message": "Failed to add task 96d2d25113152200eef2dd828144b0a4 to template 6b43105c37301000deeabfc8bcbe5db2 because there were update errors.",
      "messageType": "update_failed"
    }
  ]
Skipped: [
    {
      "taskId": "635dd3dbc128ce0100655f1ec66ed41d",
      "message": "Cannot add de-duplication task(s) to template 6b43105c37301000deeabfc8bcbe5db2 because the template is not published. Publish the template before adding tasks.",
      "messageType": "unpublished_template"
    }
  ]
Summary:

CMDBDuplicateTemplateUtils : removeTemplateFromTask(Array taskIds)

Efface la valeur du modèle de déduplication dans les enregistrements de tâche de déduplication spécifiés. En désactivant cette valeur, l’association entre un modèle et la tâche est supprimée.

La liste suivante décrit les scénarios dans lesquels la valeur de modèle n’est pas supprimée de l’enregistrement de tâche et est marquée comme ignorée ou échouée :

• Le modèle de déduplication associé à la tâche est en cours d’exécution. La tâche est marquée comme ignorée.
• L’état de la tâche est « travail en cours » ou la tâche est introuvable. La tâche est marquée comme ignorée.
• La mise à jour de GlideRecord pour la colonne de modèle sur la tâche échoue. La tâche est marquée comme ayant échoué.

Tableau 4. Paramètres

Nom	Type	Description
taskIds	Tableau	Liste des sys_ids des enregistrements de tâche de déduplication à partir desquels effacer la valeur du modèle de déduplication.

Tableau 5. Renvoie

Type	Description
Objet	Objet de résultat contenant le nombre de tâches pour lesquelles la suppression de la valeur de modèle a réussi, ignoré ou échoué. { "failed": Number, "success": Number, "skipped": Number }
échoué	Nombre de tâches qui n’ont pas réussi à supprimer la valeur du modèle de déduplication. Type de données : nombre
succès	Nombre de tâches qui ont réussi à supprimer la valeur du modèle de déduplication. Type de données : nombre
ignoré	Nombre de tâches que la méthode a ignorées lors de la suppression de la valeur du modèle de déduplication. Type de données : nombre

L’exemple de code suivant montre comment appeler cette méthode pour supprimer les valeurs de modèle de déduplication des enregistrements de tâches de déduplication.

// Remove tasks from template
var taskIds = [];
taskIds.push("96d2d25113152200eef2dd828144b0a4");
taskIds.push("f785a2c3d7012201de92a5f75e610398");
taskIds.push("635dd3dbc128ce0100655f1ec66ed41d");

var result = new CMDBDuplicateTemplateUtils().removeTemplateFromTasks(taskIds);
); 
gs.info('Success: ' + result.success);
gs.info('Failed: ' + result.failed);
gs.info('Skipped: ' + result.skipped);

Sortie :

Success: 2
Failed: 0
Skipped: 1