CMDBDuplicateTemplateUtil : global

L’include de script CMDBDuplicateTemplateUtil fournit des méthodes pour ajouter et 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, tableau 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 et est ensuite marquée comme ignorée ou ayant échoué :

• Le modèle spécifié n’est pas dans 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 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 tenté 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" } ]
Échec.Message	Message qui décrit 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
échec.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’étaient pas associées au modèle (ignorées). Type de données : tableau d’objets "skipped": [ { "message": "String", "messageType: "String", "taskId": "String" } ]
message.ignoré	Message qui décrit pourquoi la tâche a été ignorée. Type de données : chaîne
typemessage.skipped	Motif pour lequel la tâche est ignorée. Type de données : chaîne
ID de tâche.ignorée	Sys_id d’une tâche que la méthode a ignorée 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" } ]
success.message	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 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 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 du 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 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âches 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 ignorées par la méthode 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 du modèle de déduplication des enregistrements de tâche 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