ScopedDCManager : Bereichsbezogen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

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

    Mit dieser API können Sie:
    • Weisen Sie vorhandenen Wörterbucheinträgen Datenklassifizierungen zu.
    • Sucht in den 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 – klassifiziert(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
    dictEntries Zeichenfolge
    Sys_ids der Datensätze, die Sie klassifizieren möchten. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben.

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

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

    In diesem Beispiel wird nach Datensätzen gesucht, die Sozialversicherungsnummern enthalten, und als vertraulich klassifiziert.

    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
    dictEntries Zeichenfolge
    Sys_ids der Datensätze, aus denen Sie Klassifizierungen entfernen möchten. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben.

    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 in der aktuellen Domäne verfügbaren Datenklassifizierungen zurück.

    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 Beziehungen mit über- und untergeordneten Elementen 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>.parent.sys_id Sys_id der übergeordneten Datenklassifizierung aus der Datenklassifizierungstabelle [data_classification].

    Datentyp: Zeichenfolge
    <Array>.parent.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 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
    dictEntries Zeichenfolge
    Sys_ids der Datensätze, für die Sie Klassifizierungen abrufen möchten. Wird als kommagetrennte Liste in einer Zeichenfolge eingegeben.

    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 Beziehungen mit über- und untergeordneten Elementen 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 Datenklassifizierungstabelle [data_classification].

    Datentyp: Zeichenfolge
    <Object>.parent.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 global.ScopedDCManager();
gs.info(dcm.getClassification("445de0a6dba30300efc57416bf9619b0"));

    Ausgabe:

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