Asistencia al usuario para autores de contenido

El plugin de representación de contexto de Connections

Puede utilizar el plugin de representación ConnectionsContext para acceder a información relacionada con el contexto de integración actual de IBM® Connections.

Este plugin tiene la sintaxis siguiente:

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

El plugin utiliza los atributos siguientes:

key

Este atributo identifica una parte específica del contexto de integración de Connections que se va a recuperar.

type

Este atributo identifica a qué tipo de información hace referencia la clave. Este atributo puede tener los valores siguientes:

config

Este valor especifica que la clave hace referencia a un valor de configuración tal como lo especifica el proveedor de entorno de recursos WP Connections Integration Service en WebSphere Integrated Solutions Console. El tipo config admite los valores clave siguientes: puede recuperar valores arbitrarios de propiedades personalizadas desde este proveedor de entorno de recursos especificando el nombre de la propiedad personalizada. El valor del tipo predeterminado es context.

context

Este valor especifica que la clave hace referencia a una propiedad de contexto dinámica de Connections proporcionada a través del parámetro de representación público de Connections. Este parámetro se establece cuando un usuario pulsa sobre un enlace de visualización de un elemento de una lista social. El tipo context admite los valores clave siguientes:

id: Este valor devuelve el valor del parámetro de representación público de Connections que representa el objeto social seleccionado actualmente.
service: Este valor devuelve el nombre del servicio que alberga este objeto social.
url: Este valor devuelve el URL de Connections que hace referencia al recurso de átomo del objeto social actual. Puede utilizar este URL para generar una vista de detalles de este elemento que se basa en la representación social.
userID: Este valor devuelve el ID del usuario al que representa el perfil de usuario de Connections seleccionado. El valor del ID de usuario lo define el servidor de Connections. Si el objeto social seleccionado no es un perfil de usuario, el plugin devuelve un valor vacío.
userObjectID: Este valor devuelve el ID de objeto del usuario al que representa el perfil de usuario de Connections seleccionado. Si el objeto social seleccionado no es un perfil de usuario o si no tiene CF 03 instalado y realiza la integración con Connections que se ejecuta en Smart Cloud para Social Business, el plugin devuelve un valor vacío.
userUID: Este valor devuelve el ID exclusivo del usuario al que representa el perfil de usuario de Connections seleccionado. Si el objeto social seleccionado no es un perfil de usuario o si no tiene CF 03 instalado y realiza la integración con Connections que se ejecuta en Smart Cloud para Social Business, el plugin devuelve un valor vacío.

portal

Este valor especifica que la clave hace referencia al contexto de un portal. El tipo portal admite los valores clave siguientes:

communityID: Si la página actual es una página de comunidad, se devuelve el identificador exclusivo global de la comunidad asociada. Ejemplo: 5f6ce586-a0c6-42fd-8201-c12d338b4c20
userID: Este valor se aplica a la versión 8.5 CF 02 y versiones anteriores. Este valor devuelve el ID de usuario externo (extID) del usuario actual. Ejemplo: 8e0c7940-04c8-102a-9a9a-f713c20becf7
userID: A partir de V 8.5 CF 03 y versiones posteriores, este valor se ha cambiado. El valor original userID se ha sustituido por el valor portalUserID, que se lista al lado. El valor userID devuelve el ID de usuario del usuario actual. El valor userID lo define el servidor Connections.
Nota: Si integra Connections que se ejecuta en Smart Cloud for Social Business, este ID puede ser distinto al ID de usuario externo (extID) del usuario actual, según como se defina en IBM WebSphere Portal. Puede acceder al ID de usuario externo (extID) del usuario actual utilizando el valor portalUserID, que se lista al lado.
portalUserID: Este valor se aplica a la versión 8.5 CF 03 y versiones posteriores. Este valor devuelve el ID de usuario externo (extID) del usuario actual. Ejemplo: 8e0c7940-04c8-102a-9a9a-f713c20becf7

service

Este valor especifica que la clave hace referencia a un URL base de servicio. El tipo service puede tener los valores de título tal como los sirve el documento de servicio de Connections. Por ejemplo, estos valores de título pueden ser búsqueda, comunidades, wikis, blogs, foros, perfiles. El plugin de contexto de Connections devuelve el URL base del servicio correspondiente. Puede utilizar este URL para crear URL de consulta personalizados añadiendo parámetros de consulta de URL y aplicando el código [Plugin:URLParam].

defaultValue

Utilice este atributo para identificar el valor que desee que se devuelva si los datos identificados no están disponibles.

Ejemplos:

Para obtener el URL de servicio del servicio de foros, especifique lo siguiente:
```
[Plugin:ConnectionsContext type="service" key="forums"]
```
Para obtener el ID de comunidad de la comunidad con la que está asociada la selección actual, especifique lo siguiente:
```
[Plugin:ConnectionsContext type="portal" key="communityID"]
```
Para obtener el ID de usuario del usuario actual, especifique lo siguiente:
```
[Plugin:ConnectionsContext type="portal" key="userID"]
```
Para obtener el URL de recurso de átomo del enlace del elemento de la lista social que ha pulsado un usuario, especifique lo siguiente:
```
[Plugin:ConnectionsContext type="context" key="url" defaultValue="no context available"]
```
Es posible que desee obtener el tipo de servidor de Connections. Por ejemplo, es posible que desee comprobar si el portal integra un servidor de Connections bajo premisa o un servidor de Connections que se ejecuta en la Smart Cloud para Social Business. En este caso, especifique lo siguiente:
```
[Plugin:ConnectionsContext type="config" key="server.type]
```