---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ScopedDCManager - Dans le champ d'application

# ScopedDCManager - Dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

L'API ScopedDCManager vous permet de regrouper des données par type.  
À l'aide de cette API, vous pouvez :

* Affectez des classifications de données aux entrées de dictionnaire existantes.
* Recherchez les classifications de données pour des entrées de dictionnaire spécifiques.
* Supprimez toutes les classifications de données associées à des entrées de dictionnaire spécifiques.
* Récupère une liste de toutes les classifications de données disponibles dans le domaine actuel.
{#DCManagerAPIScoped__ul_j2t_srm_xnb}

Cette API nécessite le module d'extension Data Classification \[com.glide.data_classification\].

Pour plus d'informations, consultez [Classification des données](https://www.servicenow.com/docs/access?context=data-classification&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).

## ScopedDCManager -- classify(String dictEntries, String dataClasses) {#ariaid-title2}

Affecte des classifications de données prédéfinies ou définies par l'utilisateur aux entrées de dictionnaire existantes.
Nécessite un rôle administrateur ou data_classification_admin.
{#DCMS-classify_S_S__table_bhh_45c_snb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Entrées de dicte | Chaîne | La sys_ids des enregistrements que vous souhaitez classer. Les sys_ids proviennent de la table Dictionnaire \[sys_dictionary\]. Saisie sous la forme d'une liste séparée par des virgules entourée d'une chaîne. |
| Classes de données | Chaîne | Le sys_ids des classifications de données que vous souhaitez affecter. Les sys_ids proviennent de la table de classification des données \[data_classification\]. Saisie sous la forme d'une liste séparée par des virgules entourée d'une chaîne. |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Message décrivant le résultat de l'opération. |
[Tableau 2. Renvoie]

{#DCMS-classify_S_S__table_chh_45c_snb}  
Cet exemple trouve des enregistrements contenant des numéros de sécurité sociale et les classe comme confidentiels.

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

Sortie :

    "Successfully stored the data classification configurations"

## ScopedDCManager : clearClassification(String dictEntries) {#ariaid-title3}

Supprime toutes les classifications de données pour les entrées de dictionnaire spécifiées.
Nécessite un rôle administrateur ou data_classification_admin.
{#DCMS-clearClassification_S__table_jbr_q5c_snb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Entrées de dicte | Chaîne | La sys_ids des enregistrements dont vous souhaitez supprimer les classifications. Les sys_ids proviennent de la table Dictionnaire \[sys_dictionary\]. Saisie sous la forme d'une liste séparée par des virgules entourée d'une chaîne. |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Message décrivant le résultat de l'opération. |
[Tableau 4. Renvoie]

{#DCMS-clearClassification_S__table_kbr_q5c_snb}  
Cet exemple supprime la classification des données d'une entrée de dictionnaire.

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

Sortie :

    "Classifications removed for the specified dictionary entries"

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

Renvoie une liste de toutes les classifications de données disponibles dans le domaine actuel.
Nécessite un rôle administrateur, data_classification_admin ou data_classification_auditor.
{#DCMS-getAllDataClasses__table_c2s_s5c_snb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| \<tableau\> | Résultat de la demande. Renvoie le sys_id et le nom de chaque classification de données disponible. S'il n'y a pas de classifications de données, renvoie un tableau vide. Les classifications de données peuvent être organisées en relations parent-enfant. S'il existe des classifications de données parentes, elles sont identifiées dans le résultat. Type de données : tableau [ { "parent": {Object}, "sys_id": "String", "name": "String" } ] |
| \<Tableau\>.parent | Entrée pour une classification de données parente. Type de données : objet "parent": { "sys_id": "String", "name": "String" } |
| \<Tableau\>.parent.sys_id | Sys_id de la classification des données parente à partir de la table Classification des données \[data_classification\]. Type de données : chaîne |
| \<Array\>.parent.name | Nom de la classification des données parente. Type de données : chaîne |
| \<Tableau\>.sys_id | Sys_id de la classification des données à partir de la table Classification des données \[data_classification\]. Type de données : chaîne |
| \<tableau\>.name | Nom de la classification des données. Type de données : chaîne |
[Tableau 6. Renvoie]

{#DCMS-getAllDataClasses__table_d2s_s5c_snb}  
Cet exemple récupère une liste de toutes les classifications de données disponibles.

    var dcm = new global.ScopedDCManager();
    gs.info(dcm.getAllDataClasses());

Sortie :

    [
      {
        "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) {#ariaid-title5}

Récupère toutes les classifications de données pour les entrées de dictionnaire spécifiées.
Nécessite un rôle administrateur, data_classification_admin ou data_classification_auditor.
{#DCMS-getClassification_S__table_bgq_p5c_snb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Entrées de dicte | Chaîne | La sys_ids des enregistrements pour lesquels vous souhaitez récupérer les classifications. Les sys_ids proviennent de la table Dictionnaire \[sys_dictionary\]. Saisie sous la forme d'une liste séparée par des virgules entourée d'une chaîne. |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| \<Object\> | Objet JSON contenant les sys_id de chaque entrée de dictionnaire avec un tableau des classes de données associées. S'il n'y a pas de classifications de données associées, renvoie un message décrivant le résultat de l'opération. Les classifications de données peuvent être organisées en relations parent-enfant. S'il existe des classifications de données parentes, elles sont identifiées dans le résultat. Type de données : objet { <sys_dictionary_sys_id>: [ { "parent": {Object}, "sys_id": "String", "name": "String" } ] } |
| \<Object\>.parent | Entrée pour une classification de données parente. Type de données : objet "parent": { "sys_id": "String", "name": "String" } |
| \<Object\>.parent.sys_id | Sys_id de la classification des données parente à partir de la table Classification des données \[data_classification\]. Type de données : chaîne |
| \<Object\>.parent.name | Nom de la classification des données parente. Type de données : chaîne |
| \<Object\>.sys_id | Sys_id de la classification des données à partir de la table Classification des données \[data_classification\]. Type de données : chaîne |
| \<Object\>.nom | Nom de la classification des données. Type de données : chaîne |
[Tableau 8. Renvoie]

{#DCMS-getClassification_S__table_cgq_p5c_snb}  
Cet exemple récupère les classifications de données pour une entrée de dictionnaire.

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

Sortie :

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