---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DCManager - Global

# DCManager - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

A API DCManager permite agrupar dados por tipo.  
Usando esta API, você pode:

* Atribua classificações de dados a entradas de dicionário existentes.
* Pesquise as classificações de dados para entradas de dicionário específicas.
* Remova todas as classificações de dados associadas a entradas de dicionário específicas.
* Recupere uma lista de todas as classificações de dados disponíveis no domínio atual.
{#DCManagerAPIGlobal__ul_fnm_qrm_xnb}

Esta API requer o plug-in Classificação de dados \[com.glide.data_classification\].

Para obter mais informações, consulte [Classificação de dados](https://www.servicenow.com/docs/access?context=data-classification&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).

## DCManager - classificar (cadeia de caracteres dictEntries, cadeia de caracteres dataClasses) {#ariaid-title2}

Atribui classificações de dados predefinidas ou definidas pelo usuário a entradas de dicionário existentes.
Requer a função admin ou data_classification_admin.
{#DCM-classify_S_S__table_wkc_j5c_snb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dictEntries | Cadeia de caracteres | Os sys_ids dos registros que você deseja classificar. Os sys_ids são da tabela Dicionário \[sys_dictionary\]. Inserido como uma lista separada por vírgulas entre uma cadeia de caracteres. |
| dataClasses | Cadeia de caracteres | Os sys_ids das classificações de dados que você deseja atribuir. Os sys_ids são da tabela Classificação de dados \[data_classification\]. Inserido como uma lista separada por vírgulas entre uma cadeia de caracteres. |
[Tabela 1. Parâmetros]

{#DCM-classify_S_S__table_wkc_j5c_snb} {#DCM-classify_S_S__table_xkc_j5c_snb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Mensagem que descreve o resultado da operação. |
[Tabela 2. Retorna]

{#DCM-classify_S_S__table_xkc_j5c_snb}  
Este exemplo encontra registros que contêm números de previdência social e os classifica como confidenciais.

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

Saída:

    "Successfully stored the data classification configurations"

## DCManager - clearClassification(String dictEntries) {#ariaid-title3}

Remove todas as classificações de dados das entradas de dicionário especificadas.
Requer a função admin ou data_classification_admin.
{#DCM-clearClassification_S__table_jls_l5c_snb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dictEntries | Cadeia de caracteres | Os sys_ids dos registros dos quais você deseja remover classificações. Os sys_ids são da tabela Dicionário \[sys_dictionary\]. Inserido como uma lista separada por vírgulas entre uma cadeia de caracteres. |
[Tabela 3. Parâmetros]

{#DCM-clearClassification_S__table_jls_l5c_snb} {#DCM-clearClassification_S__table_kls_l5c_snb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Mensagem que descreve o resultado da operação. |
[Tabela 4. Retorna]

{#DCM-clearClassification_S__table_kls_l5c_snb}  
Este exemplo remove a classificação de dados de uma entrada de dicionário.

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

Saída:

    "Classifications removed for the specified dictionary entries"

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

Retorna uma lista de todas as classificações de dados disponíveis no domínio atual.
Requer a função admin, data_classification_admin ou data_classification_auditor.
{#DCM-getAllDataClasses__table_qyt_m5c_snb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 5. Parâmetros]

{#DCM-getAllDataClasses__table_qyt_m5c_snb} {#DCM-getAllDataClasses__table_ryt_m5c_snb__entry__2}

| Tipo | Descrição |
|-|-|
| \<Array\> | Resultado da solicitação. Retorna o sys_id e o nome de cada classificação de dados disponível. Se não houver classificações de dados, ele retornará uma matriz vazia. As classificações de dados podem ser organizadas em relacionamentos primário-secundário. Se houver classificações de dados primários, elas serão identificadas no resultado. Tipo de dados: matriz [ { "parent": {Object}, "sys_id": "String", "name": "String" } ] |
| \<Array\>.primário | Entrada para uma classificação de dados primária. Tipo de dados: objeto "parent": { "sys_id": "String", "name": "String" } |
| \<Array\>.parent.sys_id | Sys_id da classificação de dados primária da tabela Classificação de dados \[data_classification\]. Tipo de dados: cadeia de caracteres |
| \<Array\>.parent.name | Nome da classificação de dados primária. Tipo de dados: cadeia de caracteres |
| \<Array\>.sys_id | Sys_id da classificação de dados da tabela Classificação de dados \[data_classification\]. Tipo de dados: cadeia de caracteres |
| \<Array\>.nome | Nome da classificação de dados. Tipo de dados: cadeia de caracteres |
[Tabela 6. Retorna]

{#DCM-getAllDataClasses__table_ryt_m5c_snb}  
Este exemplo recupera uma lista de todas as classificações de dados disponíveis.

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

Saída:

    [
      {
        "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(cadeia de caracteres dictEntries) {#ariaid-title5}

Recupera todas as classificações de dados das entradas de dicionário especificadas.
{#DCM-getClassification_S__table_mfh_k5c_snb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dictEntries | Cadeia de caracteres | Os sys_ids dos registros para os quais você deseja recuperar classificações. Os sys_ids são da tabela Dicionário \[sys_dictionary\]. Inserido como uma lista separada por vírgulas entre uma cadeia de caracteres. |
[Tabela 7. Parâmetros]

{#DCM-getClassification_S__table_mfh_k5c_snb} {#DCM-getClassification_S__table_nfh_k5c_snb__entry__2}

| Tipo | Descrição |
|-|-|
| \<Object\> | Objeto JSON que contém o sys_id de cada entrada do dicionário com uma matriz de suas classes de dados associadas. Se não houver classificações de dados associadas, ele retornará uma mensagem descrevendo o resultado da operação. As classificações de dados podem ser organizadas em relacionamentos primário-secundário. Se houver classificações de dados primários, elas serão identificadas no resultado. Tipo de dados: objeto { <sys_dictionary_sys_id>: [ { "parent": {Object}, "sys_id": "String", "name": "String" } ] } |
| \<Object\>.primário | Entrada para uma classificação de dados primária. Tipo de dados: objeto "parent": { "sys_id": "String", "name": "String" } |
| \<Object\>.parent.sys_id | Sys_id da classificação de dados primária da tabela Classificação de dados \[data_classification\]. Tipo de dados: cadeia de caracteres |
| \<Object\>.parent.name | Nome da classificação de dados primária. Tipo de dados: cadeia de caracteres |
| \<Object\>.sys_id | Sys_id da classificação de dados da tabela Classificação de dados \[data_classification\]. Tipo de dados: cadeia de caracteres |
| \<Object\>.nome | Nome da classificação de dados. Tipo de dados: cadeia de caracteres |
[Tabela 8. Retorna]

{#DCM-getClassification_S__table_nfh_k5c_snb}  
Este exemplo recupera as classificações de dados para uma entrada de dicionário.

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

Saída:

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