ScopedDCManager - Inclus dans le périmètre

L’API ScopedDCManager vous permet de regrouper des données par type.

Avec l’API ScopedDCManager, vous pouvez :

• Affectez des classifications de données aux 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érez 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.

ScopedDCManager - classify(String dictEntries, String dataClasses)

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

Nécessite le rôle administrateur ou data_classification_admin.

Tableau 1. Paramètres

Nom	Type	Description
Entrées de dictée	Chaîne	La sys_ids des enregistrements que vous souhaitez classer. Les sys_ids proviennent de la table du dictionnaire [sys_dictionary]. Saisie sous la forme d’une liste séparée par des virgules entourée d’une chaîne.
Classes de données	Chaîne	La sys_ids des classifications de données que vous souhaitez affecter. Les sys_ids proviennent de la table Classification des données [data_classification]. Saisie sous la forme d’une liste séparée par des virgules entourée d’une chaîne.

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 classe les enregistrements comme confidentiels.

var dcm = new global.ScopedDCManager();
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 the 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"

ScopedDCManager : clearClassification(String dictEntries)

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

Nécessite le rôle administrateur ou data_classification_admin.

Tableau 3. Paramètres

Nom	Type	Description
Entrées de dictée	Chaîne	La sys_ids des enregistrements dont vous souhaitez supprimer les classifications. Les sys_ids proviennent de la table du dictionnaire [sys_dictionary]. Saisie sous la forme d’une liste séparée par des virgules entourée d’une chaîne.

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 global.ScopedDCManager();
gs.info(dcm.clearClassification("445de0a6dba30300efc57416bf9619b0"));

Sortie :

"Classifications removed for the specified dictionary entries"

ScopedDCManager : 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’existe aucune classification de données, 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" } ]
<Tableau>.parent	Entrée pour une classification de données parent. 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
<Tableau>.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>.name	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 global.ScopedDCManager();
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"
  }
]

ScopedDCManager : getClassification(String dictEntries)

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

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

Tableau 7. Paramètres

Nom	Type	Description
Entrées de dictée	Chaîne	La sys_ids des enregistrements pour lesquels vous souhaitez récupérer les classifications. Les sys_ids proviennent de la table du dictionnaire [sys_dictionary]. Saisie sous la forme d’une liste séparée par des virgules entourée d’une chaîne.

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. S’il n’y a pas de classifications de données associées, 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 parent. 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 global.ScopedDCManager();
gs.info(dcm.getClassification("445de0a6dba30300efc57416bf9619b0"));

Sortie :

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