---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ScopedCacheManager API 開発者ガイド

# ScopedCacheManager API 開発者ガイド {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

スコープ済みキャッシュを使用すると、カスタムデータをメモリーに格納してアクセスを高速化し、さらにいつ無効にするかを定義できます。これは、複数のテーブルにわたるクエリーの結果など、データを最初から取得するのに時間がかかる場合に便利です。ScopedCacheManager API を使用して、スコープ対象アプリケーションのキャッシュデータを取得、設定、およびフラッシュします。

このガイドには、 [ScopedCacheManager API](https://servicenow-prod.fluidtopics.net/2rblWTakHX0R_nziTJzC~Q#ScopedCacheManagerAPI "ScopedCacheManager API は、スコープ対象のアプリケーションのキャッシュデータを取得、設定、およびフラッシュするためのメソッドを提供します。") で使用するスコープ済みキャッシュとテーブルのペアを作成する手順が含まれています。  
スコープ指定キャッシュに割り当てることのできるテーブルペアのタイプは次のとおりです。

* テーブルペアキャッシュ：テーブルで更新操作を実行する必要がある場合、キャッシュ内のすべてのエントリもフラッシュされます。
* テーブル行ペアキャッシュ:テーブルで更新操作を実行する必要がある場合、編集されたレコードと同じsys_idを持つエントリのみがキャッシュからフラッシュされます。他のエントリは同じままです。
* テーブルと列のペアのキャッシュ：選択した列のリスト内のフィールドを編集すると、キャッシュ全体がフラッシュされます。
* テーブルの列と行のペアのキャッシュ:選択した列のリストのフィールドを編集すると、編集されたレコードと同じsys_idを持つエントリがキャッシュからフラッシュされます。
{#scoped-caches__ul_knb_qxr_w5b}

## スコープ指定キャッシュとテーブルのペアの作成 {#ariaid-title2}

スコープ指定キャッシュを作成し、そのキャッシュのペアを定義します。

### 始める前に

必要なロール：admin

### 手順

1. スコープ指定キャッシュを作成します。検索項目 すべてシステム定義スコープ済みキャッシュ.
2. \[新規\] をクリックし、\[キャッシュ名\] フィールドにわかりやすい名前を入力します。
3. \[最大エントリー\] フィールドに数字を入力します。この値は、このキャッシュに入力できるエントリーの最大数を表します。最大値は 100 です。  
   注:  
   \[アプリケーション\] フィールドには、このキャッシュが作成されるスコープ対象のアプリケーションの名前が自動的に入力されます。
4. \[ アクティブ \] チェックボックスがオンになっていることを確認します。
5. スコープ対象のキャッシュ値を圧縮することで占有するメモリ容量を少なくする場合は、\[ 常に圧縮(Always Compress )\] チェックボックスをオンにします。
6. \[送信\] をクリックします。  
   スコープ指定キャッシュが作成されました。
7. キャッシュのペアを作成します。検索項目 すべてシステム定義スコープ済みキャッシュペア.
8. \[新規\] をクリックし、虫眼鏡をクリックして \[スコープ指定キャッシュ\] フィールドでキャッシュを選択します。
9. \[テーブル\] メニューからテーブルを選択します。
10. \[ペアタイプ\] メニューからオプションを選択します。  
    * テーブルペアキャッシュ：テーブルで更新操作を実行する必要がある場合、キャッシュ内のすべてのエントリもフラッシュされます。
    * テーブル行ペアキャッシュ:テーブルで更新操作を実行する必要がある場合、編集されたレコードと同じsys_idを持つエントリのみがキャッシュからフラッシュされます。他のエントリは同じままです。
    * テーブルと列のペアのキャッシュ：選択した列のリスト内のフィールドを編集すると、キャッシュ全体がフラッシュされます。
    * テーブルの列と行のペアのキャッシュ:選択した列のリストのフィールドを編集すると、編集されたレコードと同じsys_idを持つエントリがキャッシュからフラッシュされます。
    {#sc-creating-scoped-cache__ul_dyb_n1s_w5b}
11. \[送信\] をクリックします。  
    スコープ指定キャッシュテーブルのペアが作成され、ScopedCacheManager API で使用できるようになりました。