Configuration de valeurs de filtre Digital Data Connector dynamiques
HCL Digital Data Connector (DDC) for HCL Portal defines a dedicated public render parameter that can be used by DDC plug-ins for filtering lists.
Vous pouvez définir la valeur du paramètre de rendu public de filtre DDC en soumettant un formulaire avec l'URI
ddc:filter à l'aide d'une méthode get HTTP. Vous pouvez créer le formulaire HTML à l'aide de composants de conception HCL Web Content Manager. Le fragment HTML suivant illustre un formulaire de recherche simple :<form action="." method="get">
<input type="hidden" name="uri" value="ddc:filter" />
<input type="hidden" name="prefix" value="<your DDC filter prefix>" />
<input type="hidden" name="action" value="set" />
<input name="value" type="text" value="Enter keywords" title="Search keywords" />
<input type="submit" value="Submit" name="submitButton" />
</form>Lorsque vous définissez un tel formulaire HTML, vous devez tenir compte des aspects suivants : - Définissez l'attribut d'action de formulaire sur un point (
.) et l'attribut de méthode de formulaire surget. - Ajoutez un paramètre de formulaire avec le nom
uriet définissez-le sur la valeurddc:filter. - Ajoutez un formulaire avec le nom
filteret indiquez le préfixe de valeur qui est reconnu par le plug-in DDC cible. L'utilisation d'un préfixe permet à différents plug-ins DDC de suivre leurs paramètres de filtre si plusieurs plug-ins sont actifs sur la même page de portail. Pour déterminer la valeur de préfixe appropriée, reportez-vous à la documentation relative au plug-in DDC que vous utilisez. - Ajoutez un paramètre de formulaire avec le nom
actionet indiquez l'action que vous voulez exécuter. Pour définir la valeur, indiquezset. Pour retirer la valeur, indiquezremove. - Ajoutez un paramètre de formulaire avec le nom
valuepour indiquer la valeur de filtre à définir. Avec l'actionremove, ce paramètre est ignoré.
prefix et du paramètre value. Vous pouvez accéder à l'intégralité de la valeur concaténée dans vos composants de conception Web Content Manager à l'aide du plug-in RenderParam. Pour accéder à la valeur pour un préfixe particulier vous pouvez utiliser le plug-in ListRenderingContext avec l'attribut d'action défini sur getFilter. Les plug-ins DDC peuvent évaluer la valeur du paramètre de filtre actif à l'aide de l'interface com.ibm.portal.wcm.plr.ListRenderState définie par l'API Digital Data Connector publique.