Assistência ao utilizador para autores de conteúdo

Suplemento RequestAttribute

Utilize o suplemento de apresentação RequestAttribute para obter, definir ou remover atributos no pedido subjacente.

A sintaxe deste suplemento é a seguinte:

[Plugin:RequestAttribute key="" value="" defaultValue="" escape=""]

Este suplemento utiliza os seguintes atributos:

key

Este atributo é obrigatório. Utilize este atributo para especificar o nome utilizado para obter ou definir um atributo para o pedido.

mode

Utilize este atributo para especificar a operação que pretende realizar:

get: Obtenha o atributo especificado do pedido e devolva o valor do atributo.
set: Defina o atributo especificado para o pedido.

eliminar: Elimine o atributo especificado do pedido.
remove: Remova o atributo especificado do pedido e devolva o valor do atributo definido anteriormente.

Value

Utilize este atributo para especificar o valor do atributo que pretende que seja definido. Se um atributo com o mesmo nome existir no pedido, esse atributo é substituído pelo novo valor. Se pretender definir um atributo no pedido, esse atributo é obrigatório.

defaultValue

Este atributo é opcional. Utilize este atributo para especificar o valor utilizado quando um atributo do pedido não é definido ou tem um valor de null.

escape

Utilize este atributo para definir a mudança de código que pretende que seja utilizada para escrever o URL. Especifique um dos valores xml, json, javascript ou none. O valor predefinido é none. Este valor apenas é avaliado se o atributo mode estiver definido como get ou remove.

Nota: O suplemento RequestAttribute está disponível com a Versão 8.0.0.1 do IBM® Web Content Manager.

Exemplos

Para divulgar a representação de cadeias do atributo de pedido denominado key1, utilize o seguinte controlo do suplemento:
```
[Plugin:RequestAttribute key="key1"]
```
Para divulgar apenas o value1 quando o atributo key1 não existe no pedido ou o valor do atributo é null, utilize o seguinte controlo do suplemento. Caso contrário, o valor real do atributo key1 é utilizado.
```
[Plugin:RequestAttribute key="key1" defaultValue="value1"]
```

Para definir o atributo de pedido key1 com o valor value1, utilize o seguinte controlo do suplemento:

[Plugin:RequestAttribute key="key1" value="value1"]
[Plugin:RequestAttribute mode="set" key="key1" value="value1"]

Para remover o atributo de pedido key1, transmitindo um atributo de valor vazio, utilize o seguinte controlo do suplemento:
```
[Plugin:RequestAttribute key="key1" mode="delete"]
[Plugin:RequestAttribute key="key1" value=""]
```
retorno remover o atributo com a chave key1 do pedido da portlet e devolver o valor definido anteriormente, utilize o seguinte controlo do suplemento:
```
[Plugin:RequestAttribute key="key1" mode="remove"]
```