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 sur get.
  • Ajoutez un paramètre de formulaire avec le nom uri et définissez-le sur la valeur ddc:filter.
  • Ajoutez un formulaire avec le nom filter et 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 action et indiquez l'action que vous voulez exécuter. Pour définir la valeur, indiquez set. Pour retirer la valeur, indiquez remove.
  • Ajoutez un paramètre de formulaire avec le nom value pour indiquer la valeur de filtre à définir. Avec l'action remove, ce paramètre est ignoré.
Une fois ce formulaire soumis par l'utilisateur, le paramètre de rendu public de filtre DDC est mis à jour dans l'état de rendu de l'utilisateur, et le portail affiche maintenant la page avec son nouvel état. La valeur de paramètre définie est concaténée à partir des valeurs du paramètre 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.