Accès aux attributs de rendu de liste et aux propriétés de liste

Lorsque vous définissez un nouveau contexte de rendu de liste vous pouvez utiliser le paramètre attribute pour ajouter des paires de nom-valeur à ce contexte de rendu de liste. Vous pouvez alors extraire ces paires nom-valeur à partir du contexte de rendu de liste à l'aide de la balise [Plugin:ListRenderingContext action="getAttribute"]. Si vous utilisez cette technique dans des contextes imbriqués, l'action porte toujours sur le contexte de rendu de liste actif. Par exemple, vous pouvez établir un contexte de rendu de liste comme suit :

[Plugin:ListRenderingContext action="set" extension-id="ibm.portal.ddc.xml"
   profile="ibm.portal.atom"
   attribute="source=https://www.ibm.com/connections/communities/service/atom/catalog/public"
   attribute="myKey=myValue" compute=“always“]

Ceci permet d'extraire les valeurs pour les propriétés source et myValue ultérieurement dans la conception comme suit :

[Plugin:ListRenderingContext action="getAttribute" key="source"]
[Plugin:ListRenderingContext action="getAttribute" key="myKey"]

Vous pouvez utiliser ce mécanisme pour envoyer des informations à partir d'un contexte de rendu de liste parent imbriqué dans un contexte de rendu de liste imbriqué. Après qu'un contexte de rendu de liste imbriqué a été établi, les informations du contexte de rendu de liste parent ne sont pas disponibles via la balise [AttributeResource]. Par conséquent, lorsque vous définissez un contexte de rendu de liste imbriqué, vous pouvez mettre les attributs parent à disposition du contexte imbriqué comme suit :

[Plugin:ListRenderingContext action="set" extension-id="ibm.portal.ddc.xml"
     profile="ibm.portal.atom"
     attribute="source=[AttributeResource key=“catalogItemDetailsLink“]
     attribute="myKey=[AttributeResource key=“catalogItemFromParentContext“]“ 
     compute=“always“]

Vous pouvez également utiliser le plug-in [Plugin:ListRenderingContext] pour accéder à des propriétés de liste individuelles basées sur l'information chargée par le plug-in DDC concerné. Pour cela, indiquez la valeur getListProperty pour le paramètre action. Exemple : pour extraire la propriété de liste nextLink à partir de la liste de beans chargée pour le contexte de rendu de liste actuel, utilisez la balise suivante :

[Plugin:ListRenderingContext action="getListProperty" key="nextLink"]

Lorsque vous écrivez des attributs de contexte de rendu de liste ou des propriétés de liste de beans dans le marquage, vous pouvez utiliser les paramètres format, separator, et escape pour contrôler la transformation en marquage :

• Les paramètres format et separator fonctionnent comme avec la balise [AttributeResource]. Pour plus d'informations, voir Définition du contexte de rendu de liste.
• Pour respecter le type de marquage contextuel vous pouvez utiliser le paramètre escape afin de définir une séquence d'échappement pour la chaîne renvoyée par le plug-in. Les valeurs prises en charge sont xml, json, javascript et none.