DCManager – Global

Mit der DCManager-API können Sie Daten nach Typ gruppieren.

Mit der DCManager-APIkönnen Sie:

• Weisen Sie vorhandenen Dictionary-Einträgen Datenklassifizierungen zu.
• Suchen Sie in den Datenklassifizierungen nach bestimmten Wörterbucheinträgen.
• Entfernen Sie alle Datenklassifizierungen, die bestimmten Wörterbucheinträgen zugeordnet sind.
• Ruft eine Liste aller Datenklassifizierungen ab, die in der aktuellen Domäne verfügbar sind.

Diese API erfordert das Plugin „Data Classification“ [com.glide.data_classification].

Weitere Informationen finden Sie unter Datenklassifizierung.

DCManager – classify(String dictEntries, String dataClasses)

Weist vorhandenen Wörterbucheinträgen vordefinierte oder benutzerdefinierte Datenklassifizierungen zu.

Erfordert die Rolle „admin“ oder „data_classification_admin“.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
dictEntries	Zeichenfolge	Die sys_ids der Datensätze, die Sie klassifizieren möchten. Die sys_ids stammen aus der Wörterbuchtabelle [sys_dictionary]. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben.
dataClasses	Zeichenfolge	Die sys_ids der Datenklassifizierungen, die Sie zuweisen möchten. Die sys_ids stammen aus der Datenklassifizierungstabelle [data_classification]. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Nachricht, die das Ergebnis des Vorgangs beschreibt.

In diesem Beispiel werden Datensätze mit Sozialversicherungsnummern gesucht und als vertraulich klassifiziert.

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);

Ausgabe:

"Successfully stored the data classification configurations"

DCManager – clearClassification(String dictEntries)

Entfernt alle Datenklassifizierungen für die angegebenen Wörterbucheinträge.

Erfordert die Rolle „admin“ oder „data_classification_admin“.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
dictEntries	Zeichenfolge	Die sys_ids der Datensätze, aus denen Sie Klassifizierungen entfernen möchten. Die sys_ids stammen aus der Wörterbuchtabelle [sys_dictionary]. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben.

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Nachricht, die das Ergebnis des Vorgangs beschreibt.

In diesem Beispiel wird die Datenklassifizierung für einen Wörterbucheintrag entfernt.

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

Ausgabe:

"Classifications removed for the specified dictionary entries"

DCManager – getAllDataClasses()

Gibt eine Liste aller Datenklassifizierungen zurück, die in der aktuellen Domäne verfügbar sind.

Erfordert die Rolle „admin“, „data_classification_admin“ oder „data_classification_auditor“.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
<Array>	Ergebnis der Anforderung. Gibt die sys_id und den Namen für jede verfügbare Datenklassifizierung zurück. Wenn keine Datenklassifizierungen vorhanden sind, wird ein leeres Array zurückgegeben. Datenklassifizierungen können in Übergeordnet-Untergeordnet-Beziehungen organisiert werden. Wenn übergeordnete Datenklassifizierungen vorhanden sind, werden sie im Ergebnis identifiziert. Datentyp: Array [ { "parent": {Object}, "sys_id": "String", "name": "String" } ]
<Array>.übergeordnet	Eintrag für eine übergeordnete Datenklassifizierung. Datentyp: Objekt "parent": { "sys_id": "String", "name": "String" }
<Array>.übergeordnet.sys_id	Sys_id der übergeordneten Datenklassifizierung aus der Datenklassifizierungstabelle [data_classification]. Datentyp: Zeichenfolge
<Array>.übergeordnet.name	Name der übergeordneten Datenklassifizierung. Datentyp: Zeichenfolge
<Array>.sys_id	Sys_id der Datenklassifizierung aus der Datenklassifizierungstabelle [data_classification]. Datentyp: Zeichenfolge
<Array>.name	Name der Datenklassifizierung. Datentyp: Zeichenfolge

In diesem Beispiel wird eine Liste aller verfügbaren Datenklassifizierungen abgerufen.

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

Ausgabe:

[
  {
    "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)

Ruft alle Datenklassifizierungen für die angegebenen Wörterbucheinträge ab.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
dictEntries	Zeichenfolge	Die sys_ids der Datensätze, für die Sie Klassifizierungen abrufen möchten. Die sys_ids stammen aus der Wörterbuchtabelle [sys_dictionary]. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben.

Tabelle : 8. Ergebnisse

Typ	Beschreibung
<Object>	JSON-Objekt, das die sys_id jedes Wörterbucheintrags mit einem Array der zugehörigen Datenklassen enthält. Wenn keine zugeordneten Datenklassifizierungen vorhanden sind, wird eine Nachricht zurückgegeben, die das Ergebnis des Vorgangs beschreibt. Datenklassifizierungen können in Übergeordnet-Untergeordnet-Beziehungen organisiert werden. Wenn übergeordnete Datenklassifizierungen vorhanden sind, werden sie im Ergebnis identifiziert. Datentyp: Objekt { <sys_dictionary_sys_id>: [ { "parent": {Object}, "sys_id": "String", "name": "String" } ] }
<Object>.übergeordnet	Eintrag für eine übergeordnete Datenklassifizierung. Datentyp: Objekt "parent": { "sys_id": "String", "name": "String" }
<Object>.übergeordnet.sys_id	Sys_id der übergeordneten Datenklassifizierung aus der Datenklassifizierungstabelle [data_classification]. Datentyp: Zeichenfolge
<Object>.übergeordnet.name	Name der übergeordneten Datenklassifizierung. Datentyp: Zeichenfolge
<Object>.sys_id	Sys_id der Datenklassifizierung aus der Datenklassifizierungstabelle [data_classification]. Datentyp: Zeichenfolge
<Object>.name	Name der Datenklassifizierung. Datentyp: Zeichenfolge

In diesem Beispiel werden die Datenklassifizierungen für einen Wörterbucheintrag abgerufen.

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

Ausgabe:

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