DCManager : global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • L’API DCManager vous permet de regrouper les données par type.

    À l’aide de cette API, vous pouvez :
    • Affectez des classifications de données à des entrées de dictionnaire existantes.
    • Recherchez les classifications de données pour des entrées de dictionnaire spécifiques.
    • Supprimez toutes les classifications de données associées à des entrées de dictionnaire spécifiques.
    • Récupère une liste de toutes les classifications de données disponibles dans le domaine actuel.

    Cette API nécessite le module d’extension Data Classification [com.glide.data_classification].

    Pour plus d’informations, consultez Classification des données.

    DCManager : classify(String dictEntries, String dataClasses)

    Affecte des classifications de données prédéfinies ou définies par l’utilisateur à des entrées de dictionnaire existantes.

    Nécessite un rôle administrateur ou data_classification_admin.

    Tableau 1. Paramètres
    Nom Type Description
    dictEntrées Chaîne
    Sys_ids des enregistrements que vous souhaitez classer. Saisie sous la forme d’une liste séparée par des virgules entourée d’une chaîne.

    Table : Table du dictionnaire [sys_dictionary]
    classes de données Chaîne
    Sys_ids des classifications de données que vous souhaitez affecter. Saisie sous la forme d’une liste séparée par des virgules entourée d’une chaîne.

    Table : Classification des données [data_classification]
    Tableau 2. Renvoie
    Type Description
    Chaîne Message décrivant le résultat de l’opération.

    Cet exemple trouve des enregistrements contenant des numéros de sécurité sociale et les classe comme confidentiels.

    var dcm = new SNC.DCManager();
var confidentialClass = {};
var ssnFields = [];
var dataClasses = JSON.parse(dcm.getAllDataClasses());

// Get the Confidential data class record
dataClasses.forEach(function (dataClass) {
  if (dataClass.name == "Confidential")
    confidentialClass = dataClass;
});

// Find fields that seem to be strong social security numbers
var dictionaryGR = new GlideRecord("sys_dictionary");
dictionaryGR.addQuery("element", "ssn").addOrCondition("element", "social_security_number");
dictionaryGR.query();
while (dictionaryGR.next())
  ssnFields.push(dictionaryGR.getUniqueValue());

// Classify any found entries as Confidential
if (ssnFields.length > 0)
  dcm.classify(ssnFields.join(), confidentialClass.sys_id);
    Sortie :
    "Successfully stored the data classification configurations"

    DCManager : clearClassification(String dictEntries)

    Supprime toutes les classifications de données pour les entrées de dictionnaire spécifiées.

    Nécessite un rôle administrateur ou data_classification_admin.

    Tableau 3. Paramètres
    Nom Type Description
    dictEntrées Chaîne
    Sys_ids des enregistrements dont vous souhaitez supprimer les classifications. Saisie sous la forme d’une liste séparée par des virgules entourée d’une chaîne.

    Table : Dictionnaire [sys_dictionary]
    Tableau 4. Renvoie
    Type Description
    Chaîne Message décrivant le résultat de l’opération.

    Cet exemple supprime la classification des données pour une entrée de dictionnaire.

    var dcm = new SNC.DCManager();
gs.info(dcm.clearClassification("445de0a6dba30300efc57416bf9619b0"));

    Sortie :

    "Classifications removed for the specified dictionary entries"

    DCManager : getAllDataClasses()

    Renvoie une liste de toutes les classifications de données disponibles dans le domaine actuel.

    Nécessite un rôle administrateur, data_classification_admin ou data_classification_auditor.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    <Tableau>

    Résultat de la demande. Renvoie le sys_id et le nom de chaque classification de données disponible. S’il n’y a pas de classifications de données, il renvoie un tableau vide.

    Les classifications de données peuvent être organisées en relations parent-enfant. S’il existe des classifications de données parentes, elles sont identifiées dans le résultat.

    Type de données : tableau

    [
  {
    "parent": {Object},
    "sys_id": "String",
    "name": "String"
  }
]
    <Array>.parent Entrée pour une classification de données parente.

    Type de données : objet

    "parent": {
  "sys_id": "String",
  "name": "String"
}
    <Tableau>.parent.sys_id Sys_id de la classification des données parente à partir de la table Classification des données [data_classification].

    Type de données : chaîne
    <Array>.parent.name Nom de la classification des données parente.

    Type de données : chaîne
    <Tableau>.sys_id Sys_id de la classification des données à partir de la table Classification des données [data_classification].

    Type de données : chaîne
    <Tableau>.nom Nom de la classification des données.

    Type de données : chaîne

    Cet exemple récupère une liste de toutes les classifications de données disponibles.

    var dcm = new SNC.DCManager();
gs.info(dcm.getAllDataClasses());

    Sortie :

    [
  {
    "parent": {
      "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
      "name": "Confidential"
    },
    "sys_id": "348107b951d71010f877f3f178e7dd0d",
    "name": "Personally identifiable information"
  },
  {
    "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
    "name": "Confidential"
  },
  {
    "sys_id": "59b7070b73fc1010ae8dd21efaf6a764",
    "name": "Restricted"
  },
  {
    "sys_id": "11d60fc773fc1010ae8dd21efaf6a744",
    "name": "Internal"
  },
  {
    "sys_id": "f5b4cf4773fc1010ae8dd21efaf6a766",
    "name": "Public"
  }
]

    DCManager : getClassification(String dictEntries)

    Récupère toutes les classifications de données pour les entrées de dictionnaire spécifiées.

    Tableau 7. Paramètres
    Nom Type Description
    dictEntrées Chaîne
    Sys_ids des enregistrements pour lesquels vous souhaitez récupérer les classifications. Saisie sous la forme d’une liste séparée par des virgules entourée d’une chaîne.

    Table : Dictionnaire [sys_dictionary]
    Tableau 8. Renvoie
    Type Description
    <Object>

    Objet JSON contenant les sys_id de chaque entrée de dictionnaire avec un tableau de ses classes de données associées. Si aucune classification de données n’est associée, elle renvoie un message décrivant le résultat de l’opération.

    Les classifications de données peuvent être organisées en relations parent-enfant. S’il existe des classifications de données parentes, elles sont identifiées dans le résultat.

    Type de données : objet

    {
  <sys_dictionary_sys_id>: [
    {
      "parent": {Object},
      "sys_id": "String",
      "name": "String"
    }
  ]
}
    <Object>.parent Entrée pour une classification de données parente.

    Type de données : objet

    "parent": {
  "sys_id": "String",
  "name": "String"
}
    <Object>.parent.sys_id Sys_id de la classification des données parente à partir de la table Classification des données [data_classification].

    Type de données : chaîne
    <Object>.parent.name Nom de la classification des données parente.

    Type de données : chaîne
    <Object>.sys_id Sys_id de la classification des données à partir de la table Classification des données [data_classification].

    Type de données : chaîne
    <Object>.nom Nom de la classification des données.

    Type de données : chaîne

    Cet exemple récupère les classifications de données pour une entrée de dictionnaire.

    var dcm = new SNC.DCManager();
gs.info(dcm.getClassification("445de0a6dba30300efc57416bf9619b0"));

    Sortie :

    {
  "445de0a6dba30300efc57416bf9619b0": [
    {
      "parent": {
        "sys_id": "a9670fc773fc1010ae8dd21efaf6a735",
        "name": "Confidential"
      },
      "sys_id": "348107b951d71010f877f3f178e7dd0d",
      "name": "Personally identifiable information"
    }
  ]
}