CacheControl indique si le cache de l'adaptateur de référentiel doit être effacé avant l'exécution d'une opération et le passage en mode effacement du cache.
Vous pouvez transmettre l'objet de données CacheControl aux méthodes get(), search() et update() de l'interface de programme d'application (API). L'adaptateur LDAP l'utilise pour effacer son cache ; les autres adaptateurs prêts à l'emploi l'ignorent car ils ne possèdent pas de cache. Si vous utilisez un adaptateur personnalisé, vous pouvez implémenter son propre traitement pour effacer le cache à l'aide de CacheControl.
L'objet de données CacheControl possède l'attribut suivant :
La définition de schéma XML pour l'objet de données CacheControl est la suivante :
<xsd:complexType name="CacheControl">
<xsd:complexContent>
<xsd:extension base="Control">
<xsd:sequence>
<xsd:element name="mode" type="xsd:string" />
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
L'exemple suivant illustre un objet de données CacheControl :
<wim:Root>
<wim:entities xsi:type="wim:PersonAccount">
<wim:identifier uniqueName="cn=testUser1,dc=yourco,dc=com"/>
</wim:entities>
<wim:controls xsi:type="wim:CacheControl">
<wim:mode>clearEntity</wim:mode>
</wim:controls>
<wim:controls xsi:type="wim:PropertyControl">
<wim:properties>sn</wim:properties>
</wim:controls>
</wim:Root>