ScopedDCManager – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Die ScopedDCManager Mit der API können Sie Daten nach Typ gruppieren.

    Mit dieser API können Sie:
    • Weisen Sie vorhandenen Wörterbucheinträgen Datenklassifizierungen zu.
    • Suchen Sie die Datenklassifizierungen für bestimmte Wörterbucheinträge.
    • Entfernen Sie alle Datenklassifizierungen, die bestimmten Wörterbucheinträgen zugeordnet sind.
    • Ruft eine Liste aller in der aktuellen Domäne verfügbaren Datenklassifizierungen ab.

    Diese API erfordert das Plugin „Datenklassifizierung“ [com.Glide.Data_classification].

    Weitere Informationen finden Sie unter Datenklassifizierung .

    ScopedDCManager – Classify(String dictEntries, String dataClasses)

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

    Erfordert die Rolle admin oder Data_classification_admin.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    DictEinträge Zeichenfolge
    SYS_IDs der Datensätze, die Sie klassifizieren möchten. Wird als kommagetrennte Liste eingegeben, die in einer Zeichenfolge eingeschlossen ist.

    Tabelle: Wörterbuchtabelle [sys_dictionary]
    Datenklassen Zeichenfolge
    SYS_IDs der Datenklassifizierungen, die Sie zuweisen möchten. Wird als kommagetrennte Liste eingegeben, die in einer Zeichenfolge eingeschlossen ist.

    Tabelle: Datenklassifizierung [Data_classification]
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Nachricht, die das Ergebnis des Vorgangs beschreibt.

    Dieses Beispiel sucht nach Datensätzen mit Sozialversicherungsnummern und klassifiziert die Datensätze als vertraulich.

    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);
    Ausgabe:
    "Successfully stored the data classification configurations"

    ScopedDCManager – 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
    DictEinträge Zeichenfolge
    SYS_IDs der Datensätze, aus denen Sie Klassifizierungen entfernen möchten. Wird als kommagetrennte Liste eingegeben, die in einer Zeichenfolge eingeschlossen ist.

    Tabelle: Wörterbuch [sys_dictionary]
    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 global.ScopedDCManager();
gs.info(dcm.clearClassification("445de0a6dba30300efc57416bf9619b0"));

    Ausgabe:

    "Classifications removed for the specified dictionary entries"

    ScopedDCManager – 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 über- und untergeordnete Beziehungen organisiert werden. Wenn übergeordnete Datenklassifizierungen vorhanden sind, werden sie im Ergebnis identifiziert.

    Datentyp: Array

    [
  {
    "parent": {Object},
    "sys_id": "String",
    "name": "String"
  }
]
    <Array>.übergeordnetes Element Eintrag für eine übergeordnete Datenklassifizierung.

    Datentyp: Objekt

    "parent": {
  "sys_id": "String",
  "name": "String"
}
    <Array>.parent.sys_ID SYS_ID der übergeordneten Datenklassifizierung aus der Tabelle „Datenklassifizierung“ [Data_classification].

    Datentyp: Zeichenfolge
    <Array>.parent.name Name der übergeordneten Datenklassifizierung.

    Datentyp: Zeichenfolge
    <Array>.sys_ID SYS_ID der Datenklassifizierung aus der Tabelle „Datenklassifizierung“ [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 global.ScopedDCManager();
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"
  }
]

    ScopedDCManager – getClassification(String dictEntries)

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

    Erfordert die Rolle admin, Data_classification_admin oder Data_classification_Auditor.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    DictEinträge Zeichenfolge
    SYS_IDs der Datensätze, für die Sie Klassifizierungen abrufen möchten. Wird als kommagetrennte Liste eingegeben, die in einer Zeichenfolge eingeschlossen ist.

    Tabelle: Wörterbuch [sys_dictionary]
    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 über- und untergeordnete 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>.Parent.sys_ID SYS_ID der übergeordneten Datenklassifizierung aus der Tabelle „Datenklassifizierung“ [Data_classification].

    Datentyp: Zeichenfolge
    <Object>.parent.name Name der übergeordneten Datenklassifizierung.

    Datentyp: Zeichenfolge
    <Object>.Sys_ID SYS_ID der Datenklassifizierung aus der Tabelle „Datenklassifizierung“ [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 global.ScopedDCManager();
gs.info(dcm.getClassification("445de0a6dba30300efc57416bf9619b0"));

    Ausgabe:

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