---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ScopedDCManager -- Umfang

# ScopedDCManager -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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

* Weisen Sie Datenklassifizierungen vorhandenen Wörterbucheinträgen 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.
{#DCManagerAPIScoped__ul_j2t_srm_xnb}

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

Weitere Informationen finden Sie unter [Datenklassifizierung](https://www.servicenow.com/docs/access?context=data-classification&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).

## ScopedDCManager -- klassifizieren(Zeichenfolge dictEntries, Zeichenfolge dataClasses) {#ariaid-title2}

Weist vorhandenen Wörterbucheinträgen vordefinierte oder anwenderdefinierte Datenklassifizierungen zu.
Erfordert die Rolle admin oder Data_classification_admin.
{#DCMS-classify_S_S__table_bhh_45c_snb__entry__3}

| 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 : 1. Parameter]

{#DCMS-classify_S_S__table_bhh_45c_snb} {#DCMS-classify_S_S__table_chh_45c_snb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Nachricht, die das Ergebnis des Vorgangs beschreibt. |
[Tabelle : 2. Rückgaben]

{#DCMS-classify_S_S__table_chh_45c_snb}  
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(Zeichenfolge dictEntries) {#ariaid-title3}

Entfernt alle Datenklassifizierungen für die angegebenen Wörterbucheinträge.
Erfordert die Rolle admin oder Data_classification_admin.
{#DCMS-clearClassification_S__table_jbr_q5c_snb__entry__3}

| 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 : 3. Parameter]

{#DCMS-clearClassification_S__table_jbr_q5c_snb} {#DCMS-clearClassification_S__table_kbr_q5c_snb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Nachricht, die das Ergebnis des Vorgangs beschreibt. |
[Tabelle : 4. Rückgaben]

{#DCMS-clearClassification_S__table_kbr_q5c_snb}  
Dieses Beispiel entfernt die Datenklassifizierung für einen Wörterbucheintrag.

    var dcm = new global.ScopedDCManager();
    gs.info(dcm.clearClassification("445de0a6dba30300efc57416bf9619b0"));

Ausgabe:

    "Classifications removed for the specified dictionary entries"

## ScopedDCManager -- getAllDataClasses() {#ariaid-title4}

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.
{#DCMS-getAllDataClasses__table_c2s_s5c_snb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

{#DCMS-getAllDataClasses__table_c2s_s5c_snb} {#DCMS-getAllDataClasses__table_d2s_s5c_snb__entry__2}

| 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 untergeordneten 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 |
[Tabelle : 6. Rückgaben]

{#DCMS-getAllDataClasses__table_d2s_s5c_snb}  
Dieses Beispiel ruft eine Liste aller verfügbaren Datenklassifizierungen ab.

    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(Zeichenfolge dictEntries) {#ariaid-title5}

Ruft alle Datenklassifizierungen für die angegebenen Wörterbucheinträge ab.
Erfordert die Rolle admin, Data_classification_admin oder Data_classification_Auditor.
{#DCMS-getClassification_S__table_bgq_p5c_snb__entry__3}

| 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 : 7. Parameter]

{#DCMS-getClassification_S__table_bgq_p5c_snb} {#DCMS-getClassification_S__table_cgq_p5c_snb__entry__2}

| Typ | Beschreibung |
|-|-|
| \<Object\> | JSON-Objekt, das die sys_ID jedes Wörterbucheintrags mit einem Array der zugehörigen Datenklassen enthält. Wenn keine Datenklassifizierungen zugeordnet sind, wird eine Nachricht zurückgegeben, die das Ergebnis des Vorgangs beschreibt. Datenklassifizierungen können in über- und untergeordneten 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 |
[Tabelle : 8. Rückgaben]

{#DCMS-getClassification_S__table_cgq_p5c_snb}  
Dieses Beispiel ruft die Datenklassifizierungen für einen Wörterbucheintrag ab.

    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"
        }
      ]
    }


