Aceder a atributos de apresentação de listas e propriedades de listas

Ao definir um novo contexto de apresentação de listas, pode utilizar o parâmetro attribute para adicionar pares nome-valor arbitrários a esse contexto de apresentação de listas. Poderá então extrair estes pares nome-valor do contexto de apresentação de listas noutros locais, utilizando o controlo [Plugin:ListRenderingContext action="getAttribute"]. Se utilizar esta técnica em contextos imbricados, é sempre endereçado o contexto de apresentação de listas actualmente activo. Por exemplo, pode estabelecer um contexto de apresentação de listas tal como o seguinte:

[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“]

Nesse caso, pode obter os valores das propriedades source e myValue posteriormente na concepção, do seguinte modo:

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

Pode utilizar este mecanismo para transmitir informações de um contexto de apresentação de listas ascendente para um contexto de apresentação de listas imbricado. Após um contexto de apresentação de listas imbricado ter sido estabelecido, as informações do contexto de apresentação de listas ascendentes não estão disponíveis através do controlo [AttributeResource]. Por conseguinte, ao definir um contexto de apresentação de listas imbricado, pode disponibilizar atributos ascendentes para o contexto imbricado do seguinte modo:

[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“]

Também pode utilizar o suplemento [Plugin:ListRenderingContext] para aceder a propriedades de listas individuais baseadas nas informações que são carregadas pelo suplemento do DDC endereçado. Esse procedimento é efectuado especificando o valor getListProperty para o parâmetro action. Exemplo: Para obter a propriedade de lista nextLink da lista de beans carregada para o contexto de apresentação de listas actual, utilize o seguinte controlo:

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

Ao escrever atributos de contexto de apresentação de listas ou propriedades de listas de beans na marcação, pode utilizar os parâmetros format, separator e escape para controlar a conversão em marcação:

• Os parâmetros format e separator funcionam do mesmo modo que com o controlo [AttributeResource]. Para obter mais informações, consulte o tópico Definir o contexto de apresentação de listas.
• Para estar em conformidade com o tipo de marcação circundante, pode utilizar o parâmetro escape para efectuar uma mudança de código da cadeia devolvida pelo suplemento. Os valores suportados são xml, json, javascript e none.