Cache des données de la procédure d'intégration de niveau supérieur

Pour configurer la mise en cache de niveau supérieur pour une procédure d'intégration, accédez à Configuration de la procédure, puis définissez les propriétés Type de cache Salesforce Platform et Temps de vie en minutes. Consultez Configuration de la mise en cache de niveau supérieur pour une procédure d'intégration.

Options dans Aperçu pour la mise en cache de niveau supérieur

Lorsque vous testez une procédure d'intégration qui utilise la mise en cache de niveau supérieur sous l'onglet Aperçu, vous pouvez utiliser deux paramètres de mise en cache dans la section JSON Options. Ces paramètres contrôlent les données de niveau supérieur et n'ont aucun effet sur le cache des métadonnées.

• ignoreCache : n'efface pas et n'enregistre pas les données dans le cache. La valeur par défaut est true. Utilisez ce paramètre pour tester les étapes de la procédure d'intégration sans interférence possible des effets de mise en cache.

• resetCache : force l'enregistrement des données dans le cache. La valeur par défaut est false. Utilisez ce paramètre dans le cadre du test de la mise en cache.

Remarque

Pour tester la mise en cache, assurez-vous de définir ignoreCache sur false. Consultez Exemple de création d'une mise en cache de niveau supérieur.

Vous pouvez transmettre ignoreCache et resetCache en tant que paramètres lorsque vous invoquez une procédure d'intégration qui utilise la mise en cache en utilisant une API REST. Vous pouvez par exemple inclure des ?resetCache=true dans l'URL pour forcer la mise en cache. Consultez Invocation de procédures d'intégration en utilisant POST.

Nœuds JSON et en-têtes REST de mise en cache de niveau supérieur

Si la mise en cache de niveau supérieur est configurée et que la procédure d'intégration est active, le JSON Procédure d'intégration peut inclure les nœuds suivants sous le nœud racine :

• vlcCacheKey : clé de toutes les données stockées dans le cache

• vlcCacheResult : inclus et défini sur true si les données sont récupérées à partir du cache

• vlcCacheEnabled : inclus et défini sur false si le paramètre ignoreCache désactive la mise en cache

• vlcCacheException — Toute erreur de mise en cache

Ces nœuds sont renvoyés en tant qu'en-têtes si vous invoquez une procédure d'intégration qui utilise la mise en cache de niveau supérieur en utilisant une API REST. Consultez Invocation de procédures d'intégration utilisant POST.

Méthodes d'effacement des données de niveau supérieur

Pour effacer les données de la Procédure d'intégration de niveau supérieur du cache, exécutez les API Connect suivantes dans la Developer Console.

Remarque À compter de la version Summer ‘25, remplacez les méthodes clearSessionCache, clearOrgCache et clearAllCache par les API Connect pour effacer les principales données de la Procédure d'intégration du cache.

• Vider le cache de la session :

  À compter de la version Summer ‘25, remplacez la méthode IntegrationProcedureService.clearSessionCache('Type_Subtype', new Map<String, Object>{'key' => 'value'}) par cette API :

  ConnectApi.IntegrationProcedureCacheInputRepresentation finalInput = new ConnectApi.IntegrationProcedureCacheInputRepresentation();
  ConnectApi.IntegrationProcedureCacheInputData apexInput = new ConnectApi.IntegrationProcedureCacheInputData();
  apexInput.ipKey = ipKey;
  apexInput.inputData = JSON.serialize(inputData);
  List l = new List();
  l.add(apexInput);
  finalInput.ipInput = l;
  finalInput.cacheStorageType = ConnectApi.CacheStorageType.Session;
  ConnectApi.IntegrationProcedureCacheOutputRepresentation test = ConnectApi.OmniDesignerConnect.ClearIntegrationProcedureCache(finalInput);

  ipKey : Spécifie la procédure d'intégration à invoquer sous le format Type_Subtype.

  inputData : Spécifie l'entrée sous le format Map<chaîne,objet>.

• Vider le cache de session avec vlcCacheKey :

  À compter de la version Summer ‘25, remplacez la méthode IntegrationProcedureService.clearSessionCache('vlcCacheKey') par cette API :

  ConnectApi.IntegrationProcedureCacheInputRepresentation apexInput = new ConnectApi.IntegrationProcedureCacheInputRepresentation();
  List cacheKeyList = new List();
  cacheKeyList.add(vlcCacheKey);
  apexInput.cacheKeys= cacheKeyList;
  apexInput.cacheStorageType = ConnectApi.CacheStorageType.Session;
  ConnectApi.IntegrationProcedureCacheOutputRepresentation test = ConnectApi.OmniDesignerConnect.ClearIntegrationProcedureCache(apexInput);
  

• Vider le cache de l'organisation :

  À compter de la version Summer ‘25, remplacez la méthode IntegrationProcedureService.clearOrgCache('Type_Subtype', new Map<String, Object>{'key' => 'value'}) par cette API :

  ConnectApi.IntegrationProcedureCacheInputRepresentation finalInput = new ConnectApi.IntegrationProcedureCacheInputRepresentation();
  ConnectApi.IntegrationProcedureCacheInputData apexInput = new ConnectApi.IntegrationProcedureCacheInputData();
  apexInput.ipKey = ipKey;
  apexInput.inputData = JSON.serialize(inputData);
  List<ConnectApi.IntegrationProcedureCacheInputData> l = new List<ConnectApi.IntegrationProcedureCacheInputData>();
  l.add(apexInput);
  finalInput.ipInput = l;
  finalInput.cacheStorageType = ConnectApi.CacheStorageType.Org;
  ConnectApi.IntegrationProcedureCacheOutputRepresentation test = ConnectApi.OmniDesignerConnect.ClearIntegrationProcedureCache(finalInput);

• Vider le cache de l'organisation avec vlcCacheKey :

  À compter de la version Summer ‘25, remplacez la méthode IntegrationProcedureService.clearOrgCache('vlcCacheKey') par cette API :

  ConnectApi.IntegrationProcedureCacheInputRepresentation apexInput = new ConnectApi.IntegrationProcedureCacheInputRepresentation();
  List<String> cacheKeyList = new List<String>();
  cacheKeyList.add(vlcCacheKey);
  apexInput.cacheKeys= cacheKeyList;
  apexInput.cacheStorageType = ConnectApi.CacheStorageType.Org;
  ConnectApi.IntegrationProcedureCacheOutputRepresentation test = ConnectApi.OmniDesignerConnect.ClearIntegrationProcedureCache(apexInput);

• Effacez toutes les données mises en cache d'une procédure d'intégration, y compris les données de cache de session, les données de cache d'organisation et les métadonnées :

  À compter de la version Summer ‘25, remplacez la méthode IntegrationProcedureService.clearAllCache('Type_Subtype') par cette API :

  ConnectApi.IntegrationProcedureCacheInputRepresentation finalInput = new ConnectApi.IntegrationProcedureCacheInputRepresentation();
  ConnectApi.IntegrationProcedureCacheInputData apexInput = new ConnectApi.IntegrationProcedureCacheInputData();
  apexInput.ipKey = ipKey;
  List<ConnectApi.IntegrationProcedureCacheInputData> l = new List<ConnectApi.IntegrationProcedureCacheInputData>();
  l.add(apexInput);
  finalInput.ipInput = l;
  finalInput.cacheStorageType = ConnectApi.CacheStorageType.All;
  ConnectApi.IntegrationProcedureCacheOutputRepresentation test = ConnectApi.OmniDesignerConnect.ClearIntegrationProcedureCache(finalInput);