Assistência ao utilizador para autores de conteúdo

Suplemento de apresentação do contexto do Connections

Pode utilizar o suplemento de apresentação ConnectionsContext para aceder às informações relacionadas com o contexto de integração actual do IBM® Connections.

Este suplemento tem a seguinte sintaxe:

[Plugin:ConnectionsContext type="service|portal|context|config" 
                           key="" defaultValue="" context=""]

O suplemento utiliza os seguintes atributos:

key

Este atributo identifica uma parte específica do contexto de integração do Connections que deverá ser obtida.

tipo

Este atributo identifica o tipo de informações ao qual a chave se refere. Este atributo pode suportar os seguintes valores:

config

Este valor especifica que a chave se refere a uma definição de configuração, como especificado no Fornecedor de ambiente de recursos do WP Connections Integration Service no WebSphere Integrated Solutions Console. O tipo config suporta os seguintes valores de chaves: Pode obter os valores de propriedades personalizados arbitrários a partir deste Fornecedor de ambiente de recursos, especificando o nome da propriedade personalizada. O valor do tipo predefinido é context.

context

Este valor especifica que a chave se refere a uma propriedade de contexto do Connections dinâmica fornecida através do parâmetro de apresentação público do Connections. Este parâmetro é definido quando um utilizador faz clique numa ligação de vista de um item numa lista social. O tipo context suporta os seguintes valores de chaves:

id: Este valor devolve o valor do parâmetro de apresentação público do Connections que representa o objecto social actualmente seleccionado.
serviço: Este valor devolve o nome do serviço que aloja este objecto social.
url: Este valor devolve o URL do Connections que remete para o recurso Atom do objecto social actual. Pode utilizar este URL para gerar uma vista de detalhes deste item baseada numa apresentação social.
userID: Este valor devolve o ID do utilizador representado pelo perfil de utilizador do Connections seleccionado. O valor do ID de utilizador é definido pelo servidor Connections. Se o objecto social seleccionado não corresponder a um perfil de utilizador, o suplemento devolve um valor vazio.
userObjectID: Este valor devolve o ID de objecto do utilizador representado pelo perfil de utilizador do Connections seleccionado. Se o objecto social seleccionado não corresponder a um perfil de utilizador ou se tiver um CF 03 instalado e o integrar com o Connections em execução no Smart Cloud for Social Business, o suplemento devolve um valor vazio.
userUID: Este valor devolve o ID exclusivo do utilizador representando pelo perfil de utilizador do Connections seleccionado. Se o objecto social seleccionado não corresponder a um perfil de utilizador ou se tiver um CF 03 instalado e o integrar com o Connections em execução no Smart Cloud for Social Business, o suplemento devolve um valor vazio.

portal

Este valor especifica que a chave se refere a um contexto do portal. O tipo portal suporta os seguintes valores de chaves:

communityID: Se a página actual for uma página de comunidade, é devolvido o GUID da comunidade associada. Exemplo: 5f6ce586-a0c6-42fd-8201-c12d338b4c20
userID: Este valor aplica-se ao V 8.5 CF 02 e versões anteriores. Este valor devolve o ID de utilizador externo (extID) do utilizador actual. Exemplo: 8e0c7940-04c8-102a-9a9a-f713c20becf7
userID: A partir da V 8.5 CF 03 e das versões posteriores, este valor foi alterado. O valor original userID foi substituído pelo valor portalUserID, que é apresentado em seguida. O valor userID devolve o ID do utilizador actual. O valor userID é definido pelo servidor do Connections.
Nota: Se integrar o Connections em execução no Smart Cloud for Social Business, este ID pode ser diferente do ID de utilizador externo (extID) do utilizador actual conforme definido pelo IBM WebSphere Portal. Pode aceder ao ID de utilizador externo (extID) do utilizador actual, utilizando o valor portalUserID, que é apresentado em seguida.
portalUserID: Este valor aplica-se à V 8.5 CF 03 e versões posteriores. Este valor devolve o ID de utilizador externo (extID) do utilizador actual. Exemplo: 8e0c7940-04c8-102a-9a9a-f713c20becf7

serviço

Este valor especifica que a chave se refere a um URL de base de serviço. O tipo service pode aceitar os valores de títulos como fornecidos pelo documento de serviço do Connections. Por exemplo, estes valores de títulos podem ser search, communities, wikis, blogs, forums, profiles. O suplemento de contexto do Connections devolve o URL de base do serviço correspondente. Pode utilizar este URL para criar URLs de consulta personalizados, acrescentando parâmetros de consulta de URLs e aplicando o controlo [Plugin:URLParam].

defaultValue

Utilize este atributo para identificar o valor que pretende que seja devolvido, se os dados identificados não estiverem disponíveis.

Exemplos:

Para obter o URL do serviço de fóruns, especifique do seguinte modo:
```
[Plugin:ConnectionsContext type="service" key="forums"]
```
Para obter o ID da comunidade à qual a selecção actual está associada, especifique do seguinte modo:
```
[Plugin:ConnectionsContext type="portal" key="communityID"]
```
Para obter o ID do utilizador actual, especifique do seguinte modo:
```
[Plugin:ConnectionsContext type="portal" key="userID"]
```
Para obter o URL de recurso Atom da ligação do item de lista social na qual um utilizador fez clique, especifique do seguinte modo:
```
[Plugin:ConnectionsContext type="context" key="url" defaultValue="no context available"]
```
Poderá querer obter o tipo de servidor do Connections. Por exemplo, pode pretender verificar se o portal integra um servidor local do Connections ou um servidor do Connectionsque é executado no Smart Cloud for Social Business. Neste caso, especifique do seguinte modo:
```
[Plugin:ConnectionsContext type="config" key="server.type]
```