CMDBDuplicateTemplateUtil : global

Le script include CMDBDuplicateTemplateUtil fournit des méthodes permettant d’ajouter et de supprimer des tâches de déduplication d’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
Néant

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 journalise les valeurs précédentes pour 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 à 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 GlideRecord de la colonne de modèle de 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 que l’on a tenté d’associer 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": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
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
failed.message	Message décrivant pourquoi 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
ignoré	Liste des tâches qui n’ont pas échoué, mais qui n’étaient pas associées au modèle (ignoré). Type de données : tableau d’objets "skipped": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
ignoré.taskId	Sys_id d’une tâche associée au modèle que la méthode a ignorée. Type de données : chaîne
message.ignoré	Message décrivant le motif d’omission de la tâche. Type de données : chaîne
skipped.messageType	Motif de l’omission de la tâche. 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": [ { "taskId": "String", "message": "String", "messageType: "String" } ]
success.taskId	Sys_id d’une tâche qui était associée au modèle. Type de données : chaîne
message réussite	Non utilisé actuellement. Type de données : chaîne
success.messageType	Non utilisé actuellement. 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âches de déduplication spécifiés. En effaçant 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 GlideRecord de la colonne de modèle de 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 correctement supprimé 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 en supprimant 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