詳細情報:
OmniStudio Integration Procedure のキャッシュ (管理パッケージ)
管理パッケージランタイムの場合、OmniStudio にはインテグレーション手順のパフォーマンスを向上させ、不要なデータ処理を最小限に抑えるための複数のキャッシュオプションが用意されています。Integration Procedure Designer で使用できる、ユーザーが設定できる 2 つの主なキャッシュ種別は組織キャッシュとセッションキャッシュです。これらのキャッシュメカニズムは Salesforce Platform キャッシュの一部であり、管理パッケージランタイムを使用する OmniStudio の Vlocity Cache を介して実装されます。それぞれの目的が異なっており、設定に関する特定の考慮事項があります。
この情報は、OmniStudio for Managed Packages 用です。標準ランタイムの OmniStudio については、OmniStudio ヘルプを参照してください。
Integration Procedure メタデータと Integration Procedure データのキャッシュは、Summer '19 以降のリリースで使用できます。
OmniStudio には、内部使用のみのメタデータキャッシュも用意されています。ユーザーが設定することはできません。実際のデータではなく、OmniStudio コンポーネントのメタデータまたは定義が保存されます。最大 48 ～ 72 時間キャッシュにデータを保持するように設定できます。
OmniStudio では、次の 2 つの異なる種別のコンテンツがキャッシュされます。
- メタデータ: インテグレーション手順とデータマッパーの構造と設定 (ステップ、マッピング、数式など) を含む定義。これはメタデータキャッシュに保存され、読み込み時間を短縮するために使用されます。
- データ: セッションキャッシュまたは組織キャッシュにキャッシュされているデータマッパーまたは Integration Procedure の応答。毎回、同じ要求入力が入力または提供されると、キャッシュされたデータが返されます。
Integration Procedure のデータキャッシュの種別は次のとおりです。
- 組織キャッシュ: キャッシュされたデータは、同じ組織のすべてのユーザーで共有されます。組織のキャッシュは、データが機密ではない、またはユーザー固有ではない場合にのみお勧めします。たとえば、アクセス制限のない選択リスト、設定、オブジェクトデータなどです。最大 48 時間データをキャッシュ (存続可能時間) に保持するように設定できます。
重要組織キャッシュは、機密性の低いデータにのみ使用します。
- セッションキャッシュ: ユーザー固有のデータが保存され、有効なユーザーセッションに制限されます。パーソナライズされたデータの方が安全で、ユーザープロファイルや権限によって異なるデータの重複処理を減らすことができます。最大 8 時間データをキャッシュ (存続可能時間) に保持するように設定できます。
Integration Procedure では、次の 3 つの方法でキャッシュを使用できます。
-
Integration Procedure 全体のメタデータをキャッシュできます。
-
最上位データと呼ばれる Integration Procedure 全体の応答をキャッシュできます。
-
[キャッシュブロック] 内にステップを配置することで、特定のステップセットの結果をキャッシュできます。
Integration Procedure の一部でデータが更新される場合や、異なるキャッシュデータを異なるタイミングで期限切れにする必要がある場合は、キャッシュブロックを使用します。たとえば、現在の気象データはユーザーセッションデータよりも頻繁に変更されます。
キャッシュされたデータのレコードレベルセキュリティチェックを実行することもできます。
Integration Procedure のメタデータキャッシュ
Integration Procedure メタデータをプラットフォームキャッシュにキャッシュする前に、VlocityMetadata キャッシュパーティションに領域を割り当てる必要があります。「プラットフォームキャッシュパーティションでの領域の割り当て」を参照してください。Integration Procedure メタデータはデフォルトでキャッシュされ、データマッパーメタデータは自動的にキャッシュされます。
Integration Procedure のメタデータキャッシュを無効にするには、[Procedure Configuration (プロシージャ設定)] に移動して、[Disable Definition Cache (定義キャッシュを無効化)] チェックボックスをオンにします。
![[キャッシュ設定] で、[定義キャッシュを無効化] がオンになっている。](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-omnistudio_for_managed_packages-260-0-0-production-jajp/a04145d1-5af2-48c6-93c5-d0f805cb32c1/omnistudio_for_managed_packages/images/disabledefinitioncache.png)
メタデータキャッシュのパフォーマンス上のメリットをテストするには、[定義キャッシュを無効化] をオンおよびオフにして、[プレビュー] タブで Integration Procedure を実行します。Browser、Server、および Apex CPU の値を比較します。
このチェックボックスの背後には、DisableDefinitionCache__c Boolean 項目があり、デフォルトは false です。
Integration Procedure Cache からメタデータをクリアする方法
Integration Procedure メタデータはキャッシュからクリアできます。このトピックを参照してください。ただし、代わりに Integration Procedure の Type と Subtype を指定して、次のコード行を実行します。
namespace.IntegrationProcedureService.clearMetadataCache('Type_Subtype');Integration Procedure のすべてのキャッシュデータ (セッションキャッシュデータ、組織キャッシュデータ、メタデータなど) をクリアできます。このトピックの手順に従いますが、代わりに Integration Procedure の Type と Subtype を指定して次のコード行を実行してください。
namespace.IntegrationProcedureService.clearAllCache('Type_Subtype');スケールキャッシュからデータをクリアする方法
Integration Procedure では、プラットフォームキャッシュではなくスケールキャッシュが使用されます。スケール キャッシュをクリアするには、上記のメソッドまたは次の ScaleCacheService メソッドを使用できます。
スケールキャッシュから Integration Procedure データをクリアする必要がある場合は、このトピックの手順に従いますが、代わりに次の形式のコード行を実行します。
namespace.ScaleCacheService.invalidateCacheValue(new Map<String, String>{'VIPId' => Type_SubType}); たとえば、Type_SubType が LoopList_ContactNames の Integration Procedure からデータをクリアするには、次のコード行を使用します。
omnistudio.ScaleCacheService.invalidateCacheValue(new Map<String, String>{'VIPId' => 'LoopList_ContactNames'}); - 最上位インテグレーション手順データのキャッシュ (管理パッケージ)
管理パッケージランタイムの場合、キャッシュを使用して、頻繁にアクセスされる更新頻度の低い Integration Procedure データを保存すると、データベースへの往復が節約され、パフォーマンスが向上します。次の手順で Integration Procedure のすべてのデータをキャッシュすることも、キャッシュブロックを使用してその一部のみをキャッシュすることもできます。 - Integration Procedure (管理パッケージ) の最上位キャッシュの設定
管理パッケージランタイムの場合、Integration Procedure の最上位キャッシュを設定するには、[Procedure Configuration (手順の設定)] に移動して、[Salesforce Platform Cache Type (Salesforce Platform キャッシュ種別)] プロパティと [Time To Live In Minutes (分)] プロパティを設定します。 - 最上位キャッシュの作成例 (管理パッケージ)
管理パッケージランタイムの場合、インテグレーション手順では名または姓のリストを受け入れ、それらの名前を持つ取引先責任者を取得します。VlocityAPIResponse パーティションへの最上位キャッシュにより、取引先責任者の取得パフォーマンスが向上します。
