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


---

# Guide du développeur de l'API ScopedCacheManager

# Guide du développeur de l'API ScopedCacheManager {#ariaid-title1}

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

Les caches inclus dans le champ d'application permettent aux clients de stocker des données personnalisées en mémoire pour un accès plus rapide et de définir quand elles sont invalidées. Cela peut être utile lorsque l'utilisation de données prend plus de temps à être obtenue à partir de zéro, comme les résultats d'une requête dans plusieurs tables. Utilisez l'API ScopedCacheManager pour récupérer, définir et vider les données de cache pour les applications incluses dans le périmètre.

Ce guide comprend des instructions pour créer un cache inclus dans le champ d'application et une paire de tables à utiliser avec [l'API ScopedCacheManager](https://servicenow-prod.fluidtopics.net/eM3vpX3rgl1Ve6hrxZEt3Q#ScopedCacheManagerAPI "L’API ScopedCacheManager fournit des méthodes de récupération, de définition et de vidage des données de cache pour les applications incluses dans le périmètre.").  
Vous pouvez affecter les types de paires de tables suivants à un cache inclus dans le champ d'application :

* Cache de paire de tables : lorsque vous devez effectuer une opération de mise à jour dans la table, toutes les entrées du cache sont également vidées.
* Cache des paires de lignes de table : lorsque vous devez effectuer une opération de mise à jour dans la table, seules les entrées qui ont la même sys_id que l'enregistrement modifié sont vidées du cache. Les autres entrées restent les mêmes.
* Cache de paire de colonnes de table : lorsque vous modifiez un champ dans la liste des colonnes sélectionnées, l'intégralité du cache est vidée.
* Cache des paires de colonnes et de lignes de la table : lorsque vous modifiez un champ dans la liste des colonnes sélectionnées, les entrées qui ont le même sys_id que l'enregistrement modifié sont vidées du cache.
{#scoped-caches__ul_knb_qxr_w5b}

## Création d'un cache inclus dans le champ d'application et d'une paire de tables {#ariaid-title2}

Créez un cache inclus dans le champ d'application et définissez sa paire de caches.

### Avant de commencer

Rôle requis : administrateur

### Procédure

1. Créez un cache inclus dans le champ d'application. Accéder à ToutDéfinition du systèmeCaches inclus dans le champ d'application.
2. Cliquez sur Nouveau et entrez un nom significatif dans le champ Nom du cache .
3. Entrez un nombre dans le champ Nombre maximal d'entrées . Cette valeur représente le nombre maximum d'entrées autorisées pour ce cache. La valeur maximale est 100.  
   Remarque :  
   Le champ Application doit automatiquement inclure le nom de l'application incluse dans le périmètre pour laquelle ce cache est créé.
4. Assurez-vous que la case Actif est cochée.
5. Cochez la case Toujours compresser si vous souhaitez que les valeurs du cache inclus dans le périmètre occupent moins d'espace mémoire en les compressant.
6. Cliquez sur Envoyer.  
   Le cache inclus dans le champ d'application a été créé.
7. Créez une paire de caches. Accéder à ToutDéfinition du systèmePaires de caches incluses dans le champ d'application.
8. Cliquez sur Nouveau , puis cliquez sur la loupe pour sélectionner un cache dans le champ Cache inclus dans le périmètre .
9. Sélectionnez une table dans le menu Table .
10. Sélectionnez une option dans le menu Type de paire .  
    * Cache de paire de tables : lorsque vous devez effectuer une opération de mise à jour dans la table, toutes les entrées du cache sont également vidées.
    * Cache des paires de lignes de table : lorsque vous devez effectuer une opération de mise à jour dans la table, seules les entrées qui ont la même sys_id que l'enregistrement modifié sont vidées du cache. Les autres entrées restent les mêmes.
    * Cache de paire de colonnes de table : lorsque vous modifiez un champ dans la liste des colonnes sélectionnées, l'intégralité du cache est vidée.
    * Cache des paires de colonnes et de lignes de la table : lorsque vous modifiez un champ dans la liste des colonnes sélectionnées, les entrées qui ont le même sys_id que l'enregistrement modifié sont vidées du cache.
    {#sc-creating-scoped-cache__ul_dyb_n1s_w5b}
11. Cliquez sur Envoyer.  
    La paire de table du cache inclus dans le périmètre a été créée et est prête à être utilisée avec l'API ScopedCacheManager .