CMDBTransformUtil : global

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 28 minutes de lecture

    • L’include de script CMDBTransformUtil utilise le cadre de travail Identification et rapprochement (IRE) pour minimiser la création d’éléments de configuration (CI) en double.

    Le cadre de travail IRE réconcilie également les attributs de CI en acceptant uniquement des informations provenant de sources autorisées lors de la mise à jour des CMDB scripts de carte de transformation in onBefore . Vous ne pouvez pas utiliser cette classe dans d’autres scripts. Pour plus d’informations sur le fonctionnement du cadre de travail IRE, consultez Identification et réconciliation CMDB.

    CMDBTransformUtil : CMDBTransformUtil()

    Crée un objet CMDBTransformUtil.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun 
    var cmdbUtil = new CMDBTransformUtil();

    CMDBTransformUtil : getError()

    Renvoie toutes les erreurs générées par l’appel de méthode précédent identifyAndReconcile() ou identifyAndReconcileEnhanced().

    Utilisez cette méthode dans les scripts de carte de transformation onBefore pour obtenir des erreurs. Utilisez la méthode hasError() pour détecter d’abord les erreurs de la méthode identifyAndReconcile() ou identifyAndReconcileEnhanced().

    Tableau 2. Paramètres
    Nom Type Description
    Aucun
    Tableau 3. Renvoie
    Type Description
    Chaîne Message d’erreur de identifyAndReconcile() ou identifyAndReconcileEnhanced(). 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Équivalent dans le champ d’application

    Il n’existe pas d’équivalent dans le champ d’application pour cette méthode.

    CMDBTransformUtil : getOutputPayload()

    Renvoie la charge utile JSON à partir de l’appel de méthode précédent identifyAndReconcile() ou identifyAndReconcileEnhanced().

    Utilisez cette méthode dans les scripts de carte de transformation onBefore.

    Tableau 4. Paramètres
    Nom Type Description
    Aucun
    Tableau 5. Renvoie
    Type Description
    <chaîne> Chaîne au format JSON qui est une liste de résultats pour les éléments de configuration dans la chaîne d’entrée. Chaque chaîne de résultat est au format 'items : [{}], relations :[{}]', où chaque élément des listes items et relations contient des paires nom-valeur.

    Type de données : chaîne
    <chaîne>.additionalCommittedItems Aucune valeur n’est actuellement renvoyée.
    <chaîne>.additionalCommittedRelations Aucune valeur n’est actuellement renvoyée.
    <chaîne>.items Description des CI créés ou mis à jour.

    Type de données : objet

    "items": { 
  "additionalRelatedItems": [Array],
  "className": "String",
  "duplicateIndices": [Array],
  "errorCount": Number,
  "errors": [Array],
  "identificationAttempts": [Array],
  "identifierEntrySysId": "String",
  "info": [Array],
  "inputIndices": [Array],
  "maskedAttributes": [Array],
  "operation": "String",
  "relatedItems": [Array],
  "relatedSysIds": [Array],
  "sysId": "String"
}
    <chaîne>.éléments.additionalRelatedItems Liste des informations sur la recherche supplémentaire et les éléments connexes qui ont été traités mais non fournis dans le cadre de la charge utile entrée. Ces éléments proviennent de charges utiles partielles.

    Ces informations ne sont pas renvoyées actuellement.

    Type de données : tableau d’objets

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <chaîne>.éléments.additionalRelatedItems.className Nom de classe/table (sys_class_name) du CI créé ou mis à jour.

    Type de données : chaîne
    <chaîne>.éléments.additionalRelatedItems.inputIndices Index de l’élément d’entrée correspondant. Pour les éléments de niveau supérieur, il s’agit d’une liste de nombres entiers. Pour les éléments connexes ou de recherche, il s’agit d’une liste d’objets JSON.

    Type de données : tableau de nombres ou tableau d’objets

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <chaîne>.items.additionalRelatedItems.inputIndices.mainIndex Valeur d’index du tableau du corps items de la demande qui correspond au parent CI de l’élément connexe supplémentaire.

    Type de données : nombre
    <chaîne>.items.additionalRelatedItems.inputIndices.subIndex Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe supplémentaire.

    Type de données : nombre
    <chaîne>.éléments.additionalRelatedItems.operation Type d’opération.

    Valeurs possibles :

    • INSERT : un nouveau CI a été inséré dans la base de données.
    • NO_CHANGE : Aucun changement de CI n’a été apporté.
    • MISE À JOUR : le CI existant a été mis à jour.

    Type de données : chaîne
    <chaîne>.éléments.additionalRelatedItems.sysId Sys_id des éléments connexes supplémentaires.

    Type de données : chaîne
    <chaîne>.items.className Nom de classe/table (sys_class_name) du CI créé ou mis à jour.

    Type de données : chaîne
    <chaîne>.éléments.duplicateIndices Liste des index de CI qui sont des doublons de l’élément actuel.

    Type de données : tableau
    <chaîne>.éléments.errorCount Nombre d’erreurs.

    Type de données : nombre
    <chaîne>.éléments.erreurs Liste des erreurs rencontrées lors du traitement de ce CI.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.éléments.errors.error Type d’erreur survenue lors du traitement du CI.

    Type de données : chaîne
    <chaîne>.éléments.errors.message Message d’erreur associé à l’erreur.

    Type de données : chaîne
    <chaîne>.items.identificationAttempts Liste des tentatives d’identification des CI.

    Type de données : tableau d’objets

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <chaîne>.items.identificationAttempts.AttemptResult Résultats de la tentative d’identification du CI.

    Valeurs possibles :

    • CORRESPONDANT : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateurs lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateurs.
    • IGNORÉ : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée.

    Type de données : chaîne
    <chaîne>.éléments.identificationTentatives.attributs Liste des attributs d’entrée d’identificateur de CI qui ont été utilisés pendant le processus d’identification.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.items.identificationAttempts.hybridEntryCiAttributes Aucune valeur n’est actuellement renvoyée.
    <chaîne>.éléments.identificationTentatives.identifierName Règle d’identificateur utilisée pour cette tentative d’identification de CI.

    Type de données : chaîne
    <String>.items.identificationAttempts.searchOnTable Nom de la table dans laquelle la recherche a été effectuée au cours du processus d’identification.

    Type de données : chaîne
    <String>.items.identifierEntrySysId Sys_id de la règle d’identificateur utilisée pour identifier le CI. Situé dans la table Entrée d’identificateur [cmdb_identifier_entry].

    Type de données : chaîne
    <chaîne>.items.info Liste contenant des informations supplémentaires sur le traitement de l’élément.

    Type de données : tableau d’objets

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    <chaîne>.items.info.code Type de reclassification qui a été ignoré.
    Valeurs possibles :
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    Type de données : chaîne
    <chaîne>.items.info.message Message qui fournit des informations supplémentaires sur le motif de l’omission de la reclassification.

    Type de données : chaîne
    <chaîne>.items.info.ruleSysId Sys_id de la règle de restriction de reclassification qui a été mise en correspondance. Applicable uniquement lorsque IRE ignore la reclassification en raison de la règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global.

    Type de données : chaîne
    <chaîne>.items.inputIndices Valeurs d’index des CI provenant du tableau du corps items de la demande qui correspondent à ce CI.

    Type de données : tableau
    <chaîne>.éléments.maskedAttributes Liste des attributs dont la mise à jour par une source de données ne faisant pas autorité a été ignorée, tel que défini par les règles de rapprochement.

    Type de données : tableau
    <chaîne>.éléments.élémentsconnexes Liste fournissant des informations sur les éléments connexes traités.

    Type de données : tableau d’objets

    "relatedItems": [
  { 
    "className": "String",
    "errors": [Array],
    "errorCount": Number, 
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    <Chaîne>.éléments.élémentsconnexes.nomdeclasse Nom de classe/table (sys_class_name) de l’élément connexe.

    Type de données : chaîne
    <chaîne>.éléments.élémentsconnexes.erreurs Liste des erreurs qui se sont produites pendant le traitement.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.éléments.élémentsconnexes.errorCount Nombre d’erreurs détectées pendant le traitement.

    Type de données : nombre
    <chaîne>.items.relatedItems.inputIndices Index des éléments connexes correspondants.

    Type de données : tableau ou nombres

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <chaîne>.items.relatedItems.inputIndices.mainIndex Valeur entière du tableau du corps items de la demande qui correspond au parent CI de l’élément connexe.

    Type de données : nombre
    <chaîne>.items.relatedItems.inputIndices.subIndex Valeur entière du tableau du corps items.lookup de la demande qui correspond à l’élément connexe.

    Type de données : nombre
    <chaîne>.items.relatedItems.operation Type d’opération.

    Valeurs possibles :

    • INSERT : un nouveau CI a été inséré dans la base de données.
    • NO_CHANGE : Aucun changement de CI n’a été apporté.
    • MISE À JOUR : le CI existant a été mis à jour.

    Type de données : chaîne
    <chaîne>.items.relatedSysIds Liste des valeurs sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Valeurs notables : nul : aucune sys_id n’a été identifiée pour cet élément connexe.

    Type de données : tableau
    <chaîne>.items.sys_id Sys_id du CI qui a été mis à jour ou créé.

    Type de données : chaîne
    <chaîne>.relations Informations sur les relations traitées.

    Type de données : tableau d’objets

    "relations":[
  { 
    "className": "String",
    "errorCount": Number,
    "inputIndices": [Array],
    "operation": "String",
    "sysId": "String" 
  }
]
    <chaîne>.relations.nomdeclasse Sys_class_name de ce CI de relation dépendante.

    Seule valeur prise en charge : cmdb_rel_ci : table de relations CI.

    Type de données : chaîne
    <chaîne>.relations.errorCount Nombre d’erreurs.

    Type de données : nombre
    <chaîne>.relations.inputIndices Index des relations d’entrée correspondantes.

    Type de données : tableau
    <chaîne>.relations.opération Type d’opération effectuée.

    Valeurs possibles :

    • INSÉRER
    • METTRE À JOUR
    • NO_CHANGE

    Type de données : chaîne
    <chaîne>.relations.sysId Sys_id du CI de relation dépendante.

    Type de données : chaîne

    		 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Équivalent dans le champ d’application

    Il n’existe pas d’équivalent dans le champ d’application pour cette méthode.

    CMDBTransformUtil : getOutputRecordSysId()

    Renvoie la sys_id de l’élément de configuration (CI) qui a été inséré ou mis à jour.

    Utilisez cette méthode dans les scripts de carte de transformation onBefore.

    Tableau 6. Paramètres
    Nom Type Description
    Aucun
    Tableau 7. Renvoie
    Type Description
    Chaîne Sys_id du CI qui a été inséré ou mis à jour. 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Équivalent dans le champ d’application

    Il n’existe pas d’équivalent dans le champ d’application pour cette méthode.

    CMDBTransformUtil : getPayload(source de l’objet, carte d’objets, journal d’objets)

    Renvoie la charge utile JSON générée à partir de l’entrée spécifiée.

    Vous pouvez ensuite modifier la charge utile et utiliser la méthode setPayload() pour stocker la charge utile mise à jour. Une fois que la charge utile est modifiée et stockée, utilisez identifyAndReconcile() ou identifyAndReconcileEnhanced() pour traiter la charge utile.

    Tableau 8. Paramètres
    Nom Type Description
    source Objet Objet global disponible dans les scripts de carte de transformation qui contient l’enregistrement entrant.
    carte Objet Objet de carte disponible dans les scripts de carte de transformation qui détient l’enregistrement de carte de transformation actuel.
    journal Objet Objet de journal disponible dans les scripts de carte de transformation.
    Tableau 9. Renvoie
    Paramètre Description
    <chaîne> Chaîne au format JSON qui est une liste de résultats pour les éléments de configuration dans la chaîne d’entrée.

    Type de données : chaîne

    { 
  "additionalCommittedItems": [Array],  
  "additionalCommittedRelations": [Array], 
  "hasError": Boolean, 
  "hasWarning": Boolean,
  "items": [Array],  
  "relations": [Array], 
  "summary": {Object} 
}
    <chaîne>.additionalCommittedItems Liste des CI qui ont été validés pendant le traitement IRE de la charge utile actuelle, mais qui n’étaient pas présents dans la charge utile d’entrée actuelle.

    Type de données : tableau d’objets

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "operation": "String",
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "sysId": "String"
  }
]
    <chaîne>.additionalCommittedItems.className Sys_class_name de ce CI supplémentaire.

    Type de données : chaîne
    <chaîne>.additionalCommittedItems.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : nombre
    <chaîne>.additionalCommittedItems.errors Tableau d’objets décrivant les erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : tableau

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.additionalCommittedItems.errors.error Type d’erreur rencontrée lors du traitement du CI supplémentaire.

    Type de données : chaîne
    <chaîne>.additionalCommittedItems.errors.message Un message d’erreur s’est produit lors du traitement du CI supplémentaire.

    Type de données : chaîne
    <chaîne>.additionalCommittedItems.identificationAttempts Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    <chaîne>.additionalCommittedItems.identificationAttempts.attemptResult Résultat de cette tentative d’identification de CI supplémentaire.

    Type de données : chaîne

    Valeurs possibles :
    • CORRESPONDANT : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateurs lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateurs.
    • IGNORÉ : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée.
    <chaîne>.additionalCommittedItems.identificationAttempts.attributes Attributs d’entrée d’identificateur de CI utilisés lors de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes Tableau des attributs d’entrée d’identificateur de CI utilisés lors de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <chaîne>.additionalCommittedItems.identificationAttempts.identifierName Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire.

    Type de données : chaîne
    <chaîne>.additionalCommittedItems.identificationAttempts.searchOnTable Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire.

    Type de données : chaîne
    <String>.additionalCommittedItems.identifierEntrySysId Sys_id de la règle d’identificateur utilisée pour identifier ce CI supplémentaire.

    Valeurs notables : inconnues : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.
    <chaîne>.additionalCommittedItems.inputIndices Valeurs d’index des CI du tableau du corps items de la demande qui correspondent à ce CI supplémentaire.

    Type de données : tableau de nombres

    "inputIndices": [
  {
    Number
  }
]
    <chaîne>.additionalCommittedItems.markers Valeurs de marqueur pour une utilisation interne.

    Type de données : tableau

    "markers": []
    <chaîne>.additionalCommittedItems.mergedPayloads Sys_id les valeurs des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    <chaîne>.additionalCommittedItems.operation Opération exécutée pour ce CI supplémentaire.

    Type de données : chaîne

    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI supplémentaire.
    • METTRE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (ancienne classe).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est ni une classe ancêtre ni une classe descendante.
    • UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante).
    <chaîne>.additionalCommittedItems.sysId Sys_id trouvé pour ce CI supplémentaire via l’identification.

    Type de données : chaîne

    Valeurs notables : inconnues : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.
    <chaîne>.additionalCommittedItems.warnings Description des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.additionalCommittedItems.warnings.error Type d’avertissement rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    <chaîne>.additionalCommittedItems.warnings.message Un message d’avertissement s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    <chaîne>.additionalCommittedRelations Description d’un CI de relation dépendante qui n’a pas été inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String"
  }
]
    <chaîne>.additionalCommittedRelations.className Le sys_class_name de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne

    Seule valeur prise en charge : cmdb_rel_ci : table de relations CI.
    <String>.additionalCommittedRelations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : nombre
    <chaîne>.additionalCommittedRelations.errors Description des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.additionalCommittedRelations.errors.error Type d’erreur rencontrée lors du traitement du CI de relation dépendante supplémentaire.

    Type de données : chaîne
    <chaîne>.additionalCommittedRelations.errors.message Un message d’erreur s’est produit pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    <chaîne>.additionalCommittedRelations.inputIndices Valeurs d’index pour les objets CI de relation dépendante dans le tableau du corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire.

    Type de données : tableau

    "inputIndices": [
  Number
]
    <chaîne>.additionalCommittedRelations.markers Valeurs de marqueur pour une utilisation interne.

    Type de données : tableau

    "markers": []
    <chaîne>.additionalCommittedRelations.mergedPayloadIds Sys_id les valeurs des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pour ce CI et qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    <chaîne>.additionalCommittedRelations.operation Opération qui a été effectuée pour le CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendant est inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : Le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.
    • INSERT_AS_PARTIAL : Le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendant.
    • METTRE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour.

    Type de données : chaîne
    <chaîne>.hasError Marqueur indiquant si un élément ou une relation comporte des erreurs.

    Type de données : booléennes
    <chaîne>.hasWarning Marqueur indiquant si un élément ou une relation a des avertissements.

    Type de données : booléennes
    <chaîne>.items Description des CI créés ou mis à jour.

    Type de données : tableau d’objets

    "items": [
  {  
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateIndices": [Array],
    "errorCount": Number, 
    "errors": [Array], 
    "identificationAttempts": [Array], 
    "identifierEntrySysId": "String",  
    "incompleteSysIds": "String",
    "info": [Array],
    "inputIndices": [Array], 
    "maskedAttributes": [Array],
    "operation": "String", 
    "partialSysIds": "String", 
    "relatedItems": [Array], 
    "relatedSysIds": [Array], 
    "sysId": "String" 
  }
]
    <chaîne>.éléments.additionalRelatedItems Informations sur la recherche supplémentaire et les éléments connexes qui ont été traités mais non fournis dans le cadre de la charge utile entrée. Ces éléments proviennent de charges utiles partielles.

    Type de données : tableau d’objets

    "additionalRelatedItems": [ 
  {
    "className": "String", 
    "inputIndices": [Array],
    "mergedPayloadIds": [Array], 
    "operation": "String",
    "sysId": "String"
  }
]
    <chaîne>.éléments.additionalRelatedItems.className Nom de classe/table (sys_class_name) du CI créé ou mis à jour.

    Type de données : chaîne
    <chaîne>.éléments.additionalRelatedItems.inputIndices Valeurs d’index des CI du tableau du corps items de la demande qui correspondent à cet élément connexe.

    Type de données : tableau de nombres
    <chaîne>.items.additionalRelatedItems.mergedPayloadIds Liste des sys_ids des charges utiles partielles qui ont été fusionnées dans l’élément connexe. Situé dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB.

    Type de données : tableau
    <chaîne>.éléments.additionalRelatedItems.operation Type d’opération.

    Valeurs possibles :

    • INSERT : un nouveau CI a été inséré dans la base de données.
    • NO_CHANGE : Aucun changement de CI n’a été apporté.
    • MISE À JOUR : le CI existant a été mis à jour.

    Type de données : chaîne
    <chaîne>.éléments.additionalRelatedItems.sysId Sys_id du CI qui a été mis à jour ou créé.

    Type de données : chaîne
    <chaîne>.items.className Nom de classe/table (sys_class_name) du CI créé ou mis à jour.

    Type de données : chaîne
    <chaîne>.éléments.duplicateIndices Liste des index de CI qui sont des doublons de l’élément actuel.

    Type de données : tableau
    <chaîne>.éléments.errorCount Nombre d’erreurs rencontrées lors du traitement de l’élément.

    Type de données : nombre
    <chaîne>.éléments.erreurs Liste des erreurs rencontrées lors du traitement de ce CI.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.éléments.errors.error Type d’erreur survenue lors du traitement du CI.

    Type de données : chaîne
    <chaîne>.éléments.errors.message Message d’erreur associé à l’erreur.

    Type de données : chaîne
    <chaîne>.items.identificationAttempts Liste des tentatives d’identification des CI.

    Type de données : tableau d’objets

    "identificationAttempts": [
  { 
    "attemptResult": "String", 
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identifierName": "String",
    "searchOnTable": "String" 
  }
]
    <chaîne>.items.identificationAttempts.AttemptResult Résultats de la tentative d’identification du CI.

    Valeurs possibles :

    • CORRESPONDANT : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateurs lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateurs.
    • IGNORÉ : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée.

    Type de données : chaîne
    <chaîne>.éléments.identificationTentatives.attributs Liste des attributs d’entrée d’identificateur de CI qui ont été utilisés pendant le processus d’identification.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    <String>items.identificationAttempts.hybridEntryCiAttributes Liste des attributs d’entrée d’identificateur de CI qui ont été utilisés pendant le processus d’identification.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    <chaîne>.éléments.identificationTentatives.identifierName Règle d’identificateur utilisée pour cette tentative d’identification de CI.

    Type de données : chaîne
    <String>.items.identificationAttempts.searchOnTable Nom de la table dans laquelle la recherche a été effectuée au cours du processus d’identification.

    Type de données : chaîne
    <String>.items.identifierEntrySysId Sys_id de la règle d’identificateur utilisée pour identifier le CI. Situé dans la table Entrée d’identificateur [cmdb_identifier_entry].

    Type de données : chaîne
    <chaîne>.items.incompleteSysIds Si l’élément comporte des erreurs et a été enregistré en tant que charge utile incomplète, ce paramètre contient la sys_id de l’enregistrement dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.

    Type de données : chaîne
    <String>.items.info Informations supplémentaires sur le traitement de l’élément.

    Type de données : tableau d’objets

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    <chaîne>.items.info.code Type de reclassification qui a été ignoré.
    Valeurs possibles :
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE

    Type de données : chaîne
    <chaîne>.items.info.message Message qui fournit des informations supplémentaires sur le motif de l’omission de la reclassification.

    Type de données : chaîne
    <chaîne>.items.info.ruleSysId Sys_id de la règle de restriction de reclassification qui a été mise en correspondance. Applicable uniquement lorsque IRE ignore la reclassification en raison de la règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global.

    Type de données : chaîne
    <chaîne>.items.inputIndices Index du CI d’entrée correspondant. Pour les éléments de niveau supérieur, il s’agit d’une liste de nombres entiers. Pour les CI associés ou de recherche, il s’agit d’une liste d’objets JSON.

    Type de données : tableau de nombres
    <chaîne>.éléments.maskedAttributes Liste des attributs dont la mise à jour par une source de données ne faisant pas autorité a été ignorée, tel que défini par les règles de rapprochement.

    Type de données : tableau
    <chaîne>.éléments.opération Opération qui a eu lieu.

    Valeurs possibles :

    • INSERT : un nouveau CI a été inséré dans la base de données.
    • INSERT_AS_INCOMPLETE : L’élément a été enregistré dans cmdb_ire_incomplete_payloads table.
    • INSERT_AS_PARTIAL : l’élément a été enregistré dans cmdb_ire_partial_payloads table.
    • MISE À JOUR : le CI existant a été mis à jour.
    • UPDATE_WITH_DOWNGRADE : le CI a été mis à jour et la classe a été remplacée par une classe plus générique (ancienne classe).
    • UPDATE_WITH_SWITCH : le CI a été mis à jour et la classe a été changée en une classe qui n’est ni ancêtre ni descendant.
    • UPDATE_WITH_UPDRADE : Le CI a été mis à jour et la classe est passée à une classe plus spécialisée (classe descendante).

    Type de données : chaîne
    <chaîne>.items.partialSysIds Si l’élément comporte des erreurs et a été enregistré en tant que charge utile partielle, ce paramètre contient la sys_id de l’enregistrement de charge utile partielle.

    Type de données : chaîne
    <chaîne>.éléments.élémentsconnexes Liste des objets JSON qui décrivent un CI associé (CI de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau d’objets

    "relatedItems": [
  { 
    "className": "String",
    "errors": [Array],
    "errorCount": Number, 
    "incompleteSysIds": [Array],
    "inputIndices": [Array],
    "mergePayloadIds": [Array],
    "operation": "String",
    "partialSysIds": [Array], 
    "sysId": "String",
    "warningCount": Number,
    "warnings": [Array]
  }
]
    <Chaîne>.éléments.élémentsconnexes.nomdeclasse Nom de classe/table (sys_class_name) de l’élément connexe.

    Type de données : chaîne
    <chaîne>.éléments.élémentsconnexes.erreurs Liste des erreurs qui se sont produites lors du traitement de l’élément connexe.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.éléments.élémentsconnexes.erreurs.erreur Type d’erreur rencontrée lors du traitement de l’élément connexe.

    Type de données : chaîne
    <chaîne>.éléments.élémentsconnexes.errors.message Message d’erreur associé à l’erreur.

    Type de données : chaîne
    <chaîne>.éléments.élémentsconnexes.errorCount Nombre d’erreurs détectées lors du traitement des éléments connexes.

    Type de données : nombre
    <chaîne>.items.relatedItems.incompleteSysIds Si la relation comporte des erreurs et a été enregistrée en tant que charge utile incomplète, cette valeur est la sys_id de l’enregistrement dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.

    Type de données : chaîne
    <chaîne>.items.relatedItems.inputIndices Index de l’élément d’entrée correspondant. Pour les éléments de niveau supérieur, il s’agit d’une liste de nombres entiers. Pour les éléments connexes ou de recherche, il s’agit d’une liste d’objets JSON.

    Type de données : tableau de nombres ou tableau d’objets

    "inputIndices": [
  { 
   "mainIndex": Number, 
   "subIndex": Number 
  }
]
    <chaîne>.items.relatedItems.inputIndices.mainIndex Valeur d’index du tableau du corps items de la demande qui correspond au parent CI de l’élément connexe.

    Type de données : nombre
    <chaîne>.items.relatedItems.inputIndices.subIndex Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe.

    Type de données : nombre
    <chaîne>.items.relatedItems.mergedPayloadIds Liste des sys_ids des charges utiles partielles qui ont été fusionnées dans le CI pendant le traitement.

    Type de données : tableau
    <chaîne>.items.relatedItems.operation Opération qui a eu lieu.

    Valeurs possibles :

    • INSERT : un nouveau CI associé a été inséré dans la base de données.
    • INSERT_AS_INCOMPLETE : L’élément a été enregistré dans cmdb_ire_incomplete_payloads table.
    • INSERT_AS_PARTIAL : l’élément a été enregistré dans cmdb_ire_partial_payloads table.
    • NO_CHANGE : Aucun changement de CI connexe n’a été apporté.
    • MISE À JOUR : le CI associé existant a été mis à jour.
    • UPDATE_WITH_DOWNGRADE : le CI associé a été mis à jour et la classe a été changée en classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : le CI associé a été mis à jour et la classe a été changée en une classe qui n’est ni ancêtre ni descendant.
    • UPDATE_WITH_UPDRADE : le CI associé a été mis à jour et la classe a été changée en une classe plus spécialisée (classe descendante).

    Type de données : chaîne
    <chaîne>.items.relatedItems.partialSysIds Si l’élément connexe comporte des erreurs et a été enregistré en tant que charge utile partielle, il contient une liste des sys_ids des enregistrements associés dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads].

    Type de données : tableau
    <chaîne>.éléments.relatedItems.sysId Sys_id de l’élément connexe.

    Type de données : chaîne
    <chaîne>.éléments.relatedItems.warningCount Nombre d’avertissements rencontrés lors du traitement des éléments connexes.

    Type de données : nombre
    <chaîne>.éléments.élémentsconnexes.avertissements Description des avertissements rencontrés lors du traitement des éléments connexes.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.éléments.élémentsconnexes.avertissements.erreur Type d’avertissement rencontré lors du traitement de l’élément connexe.

    Type de données : chaîne
    <chaîne>.éléments.élémentsconnexes.avertissements.message Message associé à l’avertissement.

    Type de données : chaîne
    <chaîne>.items.relatedSysIds Liste des valeurs sys_id des CI utilisées lors de l’identification basée sur la recherche d’éléments connexes.

    Type de données : chaîne
    <chaîne>.items.sys_id Sys_id du CI qui a été mis à jour ou créé.

    Type de données : chaîne
    <chaîne>.relations Description d’un CI de relation dépendante à partir du tableau du corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [ 
  { 
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "incompleteSysIds": "String",
    "inputIndices": [Array],
    "operation": "String",
    "partialSysIds": "String",
    "sysId": "String" 
  }
]
    <chaîne>.relations.nomdeclasse Sys_class_name de ce CI de relation dépendante.

    Seule valeur prise en charge : cmdb_rel_ci : table de relations CI.

    Type de données : chaîne
    <chaîne>.relations.errorCount Nombre d’erreurs rencontrées lors du traitement du CI de relation dépendante.

    Type de données : nombre
    <chaîne>.relations.erreurs Liste décrivant les erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    <chaîne>.relations.erreurs.erreur Type d’erreur rencontrée lors du traitement du CI de relation dépendante.

    Type de données : chaîne
    <chaîne>.relations.erreurs.message Message d’erreur rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    <chaîne>.relations.incompleteSysIds Si la relation comporte des erreurs et a été enregistrée en tant que charge utile incomplète, cette valeur est la sys_id de l’enregistrement dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.

    Type de données : chaîne
    <chaîne>.relations.inputIndices Index pour les objets CI de relation dépendante dans le tableau du corps relations de la demande qui correspondent à ce CI de relation dépendante.

    Type de données : tableau
    <chaîne>.relations.opération Type d’opération effectuée.

    Valeurs possibles :

    • INSÉRER : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.
    • INSERT_AS_PARTIAL : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’a été effectuée.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour.

    Type de données : chaîne
    <chaîne>.relations.partialSysIds Si la relation comporte des erreurs et a été enregistrée en tant que charge utile partielle, cette valeur correspond au sys_id de l’enregistrement dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB.

    Type de données : chaîne
    <chaîne>.relations.sysId Sys_id du CI de relation dépendante.

    Type de données : chaîne
    <chaîne>.summary Liste des propriétés JSON qui fournissent des statistiques sur le nombre d’éléments insérés, mis à jour, etc., par classe.

    Type de données : tableau
    <chaîne>.résumé.<class_name> Statistiques pour une classe spécifique.

    Type de données : objet

    <class_name>: {
 "additionalInsertedItemCount": Number, 
 "errorCount": Number,
 "incompleteItemCount": Number,
 "insertedItemCount": Number,
 "partialItemCount": Number,
 "skippedItemCount": Number,
 "unchangedItemCount": Number,
 "updatedItemCount": Number,
 "warningCount": Number 
}
    <String>.summary.<class_name>.additionalInsertedItemCount Nombre d’éléments insérés en raison du traitement de charges utiles partielles.

    Type de données : nombre
    <Chaîne>.summary.<class_name>.errorCount Nombre d’erreurs rencontrées lors du traitement des éléments.

    Type de données : nombre
    <chaîne>.summary.<class_name>.incompleteItemCount Nombre d’éléments insérés dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].

    Type de données : nombre
    <String>.summary.<class_name>.insertedItemCount Nombre d’éléments créés.

    Type de données : nombre
    <chaîne>.summary.<class_name>.partialItemCount Nombre d’éléments enregistrés dans la table Charge utile partielle [cmdb_ire_partial_payloads].

    Type de données : nombre
    <chaîne>.summary.<class_name>.skippedItemCount Nombre d’éléments qui ont été ignorés.

    Type de données : nombre
    <chaîne>.summary.<class_name>.unchangedItemCount Nombre d’éléments qui avaient des entrées mais qui n’ont pas été modifiés.

    Type de données : nombre
    <String>.summary.<class_name>.updatedItemCount Nombre d’éléments mis à jour.

    Type de données : nombre
    <String>.summary.<class_name>.warningCount Nombre d’éléments ayant généré un avertissement lors du traitement.

    Type de données : nombre

    Cet exemple de code montre comment obtenir la charge utile d’un ImportSet, où vous pouvez ensuite mettre à jour la charge utile, puis définir la nouvelle charge utile avant d’appeler la méthode cmdbUtil.identifyAndReconcileEnhanced() pour traiter la charge utile.

    // Add this code to the onBefore transform map script
// Ability to modify the payload using get and set APIs
// Call cmdbUtil API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
var payload = cmdbUtil.getPayload(source, map, log);
// Modify the payload here
cmdbUtil.setPayload(payload);
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;
 
if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    CMDBTransformUtil : hasError()

    Détermine si une erreur s’est produite lors de l’appel de méthode précédent identifyAndReconcile() ou identifyAndReconcileEnhanced().

    Utilisez cette méthode dans les scripts de carte de transformation onBefore.

    Tableau 10. Paramètres
    Nom Type Description
    Aucun
    Tableau 11. Renvoie
    Type Description
    Booléen Marqueur qui indique si une erreur s’est produite dans la méthode précédemment appelée identifyAndReconcile() ou identifyAndReconcileEnhanced().
    Valeurs possibles :
    • true : une erreur s’est produite
    • faux : aucune erreur ne s’est produite
    		 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Équivalent dans le champ d’application

    Il n’existe pas d’équivalent dans le champ d’application pour cette méthode.

    CMDBTransformUtil : identifyAndReconcile(source de l’objet, carte d’objets, journal des objets)

    Insère ou met à jour un élément de configuration (CI) dans le Base de données de gestion des configurations (CMDB)fichier .

    Utilisez cette méthode dans les scripts de carte de transformation onBefore. L’utilisation de cette méthode au lieu de compter sur la transformation pour insérer ou mettre à jour l’enregistrement d’élément de configuration réduit les entrées en double dans la CMDB. Pour plus d’informations, reportez-vous à la rubrique Application de l’identification et du rapprochement des CI aux jeux d’importation.

    Pour empêcher la transformation d’ajouter ou de mettre à jour l’enregistrement une deuxième fois, définissez ignore = true.

    Tableau 12. Paramètres
    Nom Type Description
    source Objet Objet global disponible dans les scripts de carte de transformation qui contient l’enregistrement entrant.
    carte Objet Objet de carte disponible dans les scripts de carte de transformation qui détient l’enregistrement de carte de transformation actuel.
    journal Objet Objet de journal disponible dans les scripts de carte de transformation.
    Tableau 13. Renvoie
    Type Description
    nul

    Cet exemple de code montre comment appeler la méthode identifyAndReconcile() pour traiter la ligne actuelle de la charge utile entrée.

    // Add this code to the onBefore transform map script
// Call CMDBTransformUtil API to do Identification and Reconciliation of the current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.identifyAndReconcile(source, map, log);
ignore = true;

    CMDBTransformUtil : identifyAndReconcileEnhanced(source de l’objet, carte d’objets, journal d’objets)

    Insère ou met à jour un élément de configuration (CI) dans le Base de données de gestion des configurations (CMDB)fichier .

    En plus de fournir la fonctionnalité de la méthode CMDBTransformUtil.identifyAndReconcile(), cette méthode prend également en charge les éléments suivants :

    • Gestion des charges utiles partielles
    • Gestion des validations partielles
    • Suppression des éléments en double dans une charge utile
    • Génération de résumés de sortie

    Pour plus d’informations sur l’identification et le rapprochement et des explications plus détaillées sur les données utilisées par cette méthode, voir Identification et rapprochement (IRE).

    Tableau 14. Paramètres
    Nom Type Description
    source Objet Objet global disponible dans les scripts de carte de transformation qui contient l’enregistrement entrant.
    carte Objet Objet de carte disponible dans les scripts de carte de transformation qui détient l’enregistrement de carte de transformation actuel.
    journal Objet Objet de journal disponible dans les scripts de carte de transformation.
    Tableau 15. Renvoie
    Type Description
    Aucun

    Cet exemple de code montre comment appeler la méthode identifyAndReconcileEnhanced() pour traiter la charge utile transmise.

    // Add this code to the onBefore transform map script
// Call CMDBTransformUtil API to do Identification and Reconciliation
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

    CMDBTransformUtil : logTransformStats(journal d’objet)

    Consigne le nombre d’éléments de configuration (CI) insérés, mis à jour, ignorés ou présentant des erreurs.

    Utilisez cette méthode dans les scripts de carte de transformation onComplete.

    Tableau 16. Paramètres
    Nom Type Description
    journal Objet Objet de journal disponible dans les scripts de carte de transformation.
    Tableau 17. Renvoie
    Type Description
    nul 
    var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.logTransformStats(log);

    Équivalent dans le champ d’application

    Il n’existe pas d’équivalent dans le champ d’application pour cette méthode.

    CMDBTransformUtil : setDataSource(String source)

    Définit la source de données à utiliser lorsque la méthode identifyAndReconcile() ou identifyAndReconcileEnhanced() est appelée .

    Utilisez cette méthode dans les scripts de carte de transformation onBefore . Si cette méthode n’est pas appelée, la valeur par défaut est ImportSet.

    Tableau 18. Paramètres
    Nom Type Description
    source Chaîne Source de données pour l’enregistrement de l’élément de configuration source.
    Tableau 19. Renvoie
    Type Description
    nul 
    // Add this code to the onBefore transform map script
// Call CMDB API to do Identification and Reconciliation of current row
var cmdbUtil = new CMDBTransformUtil();
cmdbUtil.setDataSource('ImportSet');
cmdbUtil.identifyAndReconcileEnhanced(source, map, log);
ignore = true;

if (cmdbUtil.hasError()) {
  var errorMessage = cmdbUtil.getError();
  log.error(errorMessage);
} else {
  log.info('IE Output Payload: ' + cmdbUtil.getOutputPayload());
  log.info('Imported CI: ' + cmdbUtil.getOutputRecordSysId());
}

    Équivalent dans le champ d’application

    Il n’existe pas d’équivalent dans le champ d’application pour cette méthode.