Paramètres de rendu public

Les détails de programmation pour les paramètres de rendu publics sont définis dans Java Portlet Specification 2.0. Ils sont lus comme des paramètres de demande et définis dans des URL de rendu ou la réponse à une action. Le plus souvent, les paramètres de rendu publics se comportent exactement comme des paramètres de rendu "normaux" ou privés. La seule différence est que l'identificateur de paramètre est explicitement déclaré par le programmeur dans le descripteur de déploiement portlet.xml avec un ou plusieurs noms publics à espace de nom. De cette façon, le portail peut décider quels paramètres des deux portlets doivent être mappés vers les mêmes informations.

<portlet-app xmlns:x="http://www.cntserv_exmp.com/portlet">
   <portlet>
      ...
      <supported-public-render-parameter>custID</supported-public-render-parameter>
   </portlet>
   <public-render-parameter>
   	  <identifier>custID</identifier>
   	  <qname>x:customerID</qname>
   </public-render-parameter>
</portlet-app>

String customerID = renderRequest.getParameter("custID");

Le paramètre est partagé avec le nom complet, lequel est composé de l'espace de nom et du nom local et de customerID dans l'espace de nom http://www.cntserv_exmp.com/portlet. Par conséquent, si un autre portlet déclare un paramètre avec le même nom complet, quel que soit l'identificateur local utilisé, ce paramètre peut être mappé vers les mêmes données par le portail.

Les portlets peuvent déclarer des noms affichés globalisés et des descriptions pour les paramètres de rendu publics dans le regroupement de ressources de l'application. Toutefois, HCL Portal version 8.5 ne possède pas d'interface utilisateur demandant ces informations.

Pour certains cas d'utilisation, il peut être nécessaire de limiter le partage des paramètres. Ce peut être le cas, par exemple, si vous avez deux paires de navigateurs ou de portets d'afficheur dans deux pages différentes, où chaque paire doit être coordonnée. Cependant, les paires ne doivent pas interférer entre les pages afin que le navigateur de la première page n'ait pas d'influence sur l'afficheur de la deuxième page. Dans ces cas, le portail vous permet de limiter la portée de partage pour les paramètres de rendu publics en fonction des pages. La portée de partage des paramètres pour une page est contrôlée par un paramètre de page param.sharing.scope. Vous pouvez le définir dans la vue Propriétés des pages sous Options avancées > Je souhaite définir des paramètres. Si vous définissez une valeur pour ce paramètre, les portlets dans la page partagent leurs paramètres de rendu publics uniquement avec les autres portlets dans la même page ou dans des pages ayant la même portée.

Pour empêcher le partage avec d'autres pages des paramètres de rendu utilisés sur une page, vous pouvez associer le paramètre param.sharing.scope à la valeur réservée ibm.portal.sharing.scope.page. L'indication de cette valeur produit le même résultat que si vous utilisiez l'ID objet unique de la page, généré en interne par le portail, comme valeur du paramètre param.sharing.scope.