コンテンツのキャッシュ制御を使用すると、ブラウザのキャッシュ動作を変更できます。キャッシュ制御は、リポジトリ サービスによって処理されるエンドポイントで使用されます。この機能はデフォルトで無効になっており、ファイル Repository.exe.conf と capabilities.json を変更して有効にできます。その後、Qlik Sense Service Dispatcher と Qlik Sense Repository Service を再起動します。
次の手順を実行します。
-
C:\Program Files\Qlik\Sense\Repository\Repository.exe.conf を開き、次のキーを true に設定します。
<add key="ContentCacheControl" value="true" />
-
C:\Program Files\Qlik\Sense\CapabilityService\capabilities.json を開き、次のフラグを追加します。
{"contentHash":"2ae4a99c9f17ab76e1eeb27bc4211874","originalClassName":"FeatureToggle","flag":"QMC_CONTENT_CACHE_CONTROL","enabled":true}
コンテンツ キャッシュ制御は、Qlik 管理コンソール (QMC) のコンテンツ ライブラリ関連項目セクションで追加または変更されます。コンテンツ ライブラリ: 関連するアイテム を参照してください。構成が完了すると、コンテンツ キャッシュ制御は特定のコンテンツ ライブラリに自動的に関連付けられ、そのコンテンツをターゲットとするリクエストにのみ影響します。他のリクエストを対象とするコンテンツ キャッシュ制御、いわゆる一般的なコンテンツ キャッシュ制御を作成するには、コンテンツ ライブラリへの参照を削除する必要があります。これを行うには、利用可能な API PUT メソッドを使用して contentLibrary 値を null に設定します。次の例を参照してください。コンテンツ キャッシュ制御は、POST メソッドを使用して API 要求から直接作成することもできます。
PUT /qrs/contentcachecontrol/33774a23-ad86-44f7-96bc-0e346c062cc2
{
"id": "33774a23-ad86-44f7-96bc-0e346c062cc2",
"createdDate": "2021-12-09T11:59:20.728Z",
"modifiedDate": "2021-12-09T11:59:20.728Z",
"modifiedByUserName": "RDLUND\\svc-silver",
"name": "api",
"contentLibrary": null,
"filter": "test",
"maxAge": 3600,
"cachePolicy": 0,
"privileges": null,
"schemaPath": "ContentCacheControl"
}定義されたコンテンツ キャッシュ制御に該当するリクエストは、QMC で見られるユーザー定義の正規表現 (正規表現フィルター)、または ContentCacheControl モデルで見られるフィルター 項目の値に基づいてフィルター処理されます。例については コンテンツ ライブラリ: 関連するアイテム を参照してください。評価される URI の要求の一部は、ホスト名の後のテキストで構成され、仮想プロキシのプレフィックスは含まれません。Qlik Sense Repository Service が一致を探す場合、コンテンツ ライブラリに関連付けられたコンテンツ ライブラリ コントロールが一般的なものよりも優先されます。それらはスタックに実装されます。つまり、最初の一致でそれ以降のルックアップが終了します。複数のコントロールがユーザー定義のフィルターに一致する場合、最新の変更日 (modifiedDate) との一致が優先されます。規定のセキュリティ ルール セットでは、RootAdmin ロールのみがコンテンツ キャッシュ制御への完全な CRUD アクセス権を持っています。さらに、ContentAdmin および SecurityAdmin ロールには、すべてのコンテンツ キャッシュ制御への読み取りアクセス権があります。対応するコンテンツ ライブラリに対する読み取り権限を持つユーザーは、それらのコンテンツ ライブラリに関連付けられたコンテンツ キャッシュ制御への読み取りアクセス権を持ちます。Qlik Sense に含まれるセキュリティ ルール の ReadContentCacheControl ルールを参照してください。
URI に api を含むハブ固有のリクエストのコンテンツ キャッシュ制御は、Hub サービスの起動時に取得されます。新しく追加または変更されたコンテンツ キャッシュ制御の場合、これらのリクエストを適用することを目的として、Qlik Sense Service Dispatcher を再起動するか、対応する node.js プロセス - "..\HubService\index.jsを終了することにより、Hub サービスを再起動する必要があります。他のタイプのリクエストの場合、新しいエントリを作成した後、または既存のエントリを変更した後に再起動する必要はありません。
Repository Main API の Open API 仕様に基づく新しいメソッドについては、以下を参照してください。Contentcachecontrol (英語のみ)。
Repository Main API の Open API 仕様に従って対応するモデルについては、以下を参照してください。ContentCacheControl (英語のみ) および ContentCacheControlCondensed (英語のみ)。