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


---

# Guia do desenvolvedor da API ScopedCacheManager

# Guia do desenvolvedor da API ScopedCacheManager {#ariaid-title1}

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

Os caches com escopo permitem que os clientes armazenem dados personalizados na memória para acesso mais rápido e definam quando eles serão invalidados. Isso pode ser útil quando o trabalho com dados leva mais tempo para obterisso do zero, como os resultados de uma consulta em várias tabelas. Use a API ScopedCacheManager para recuperar, definir e liberar dados de cache para aplicações com escopo.

Este guia inclui instruções para criar um cache com escopo e um par de tabelas para usar com a [API ScopedCacheManager](https://servicenow-prod.fluidtopics.net/1~T5XtQa2anolL8l7RTDRQ#ScopedCacheManagerAPI "A API ScopedCacheManager fornece métodos para recuperar, definir e liberar dados de cache para aplicações com escopo.").  
Você pode atribuir os seguintes tipos de pares de tabelas a um cache com escopo:

* Cache de par de tabelas: quando você precisa executar qualquer operação de atualização na tabela, todas as entradas no cache também são liberadas.
* Cache de par de linhas da tabela: quando você precisa executar qualquer operação de atualização na tabela, somente as entradas que têm o mesmo sys_id do registro editado são limpas do cache. As outras entradas permanecem as mesmas.
* Cache de par de colunas da tabela: quando você edita um campo na lista de colunas selecionadas, o cache inteiro é liberado.
* Cache de par de colunas e linhas da tabela: quando você edita um campo na lista de colunas selecionadas, as entradas que têm o mesmo sys_id do registro editado são limpas do cache.
{#scoped-caches__ul_knb_qxr_w5b}

## Como criar um par de cache e tabela com escopo {#ariaid-title2}

Crie um cache com escopo e defina seu par de caches.

### Antes de Iniciar

Função necessária: administrador

### Procedimento

1. Crie um cache com escopo. Ir para TodosDefinição do SistemaCaches com escopo.
2. Clique em Novo e insira um nome significativo no campo Nome do cache.
3. Insira um número no campo Máximo de entradas. Este valor representa o número máximo de entradas permitidas para este cache. O valor máximo é 100.  
   Nota:  
   O campo Aplicação deve incluir automaticamente o nome da aplicação com escopo para a qual este cache está sendo criado.
4. Certifique-se de que a caixa de seleção Ativo esteja marcada.
5. Marque a caixa de seleção Sempre compactar se quiser que os valores de cache com escopo ocupem menos espaço na memória ao serem compactados.
6. Clique em Enviar.  
   O cache com escopo foi criado.
7. Crie um par de caches. Ir para TodosDefinição do SistemaPares de cache com escopo.
8. Clique em Novo e clique na lupa para selecionar um cache no campo Cache com escopo.
9. Selecione uma tabela no menu Tabela.
10. Selecione uma opção no menu Tipo de par.  
    * Cache de par de tabelas: quando você precisa executar qualquer operação de atualização na tabela, todas as entradas no cache também são liberadas.
    * Cache de par de linhas da tabela: quando você precisa executar qualquer operação de atualização na tabela, somente as entradas que têm o mesmo sys_id do registro editado são limpas do cache. As outras entradas permanecem as mesmas.
    * Cache de par de colunas da tabela: quando você edita um campo na lista de colunas selecionadas, o cache inteiro é liberado.
    * Cache de par de colunas e linhas da tabela: quando você edita um campo na lista de colunas selecionadas, as entradas que têm o mesmo sys_id do registro editado são limpas do cache.
    {#sc-creating-scoped-cache__ul_dyb_n1s_w5b}
11. Clique em Enviar.  
    O par de tabelas de cache com escopo foi criado e está pronto para uso com a API ScopedCacheManager.