Compartir a través de

Variables de plantilla

  • Artículo

Las instancias de variables de plantilla (representadas por un elemento templateVariable ) especifican los datos de un elemento de fuente de actividad en una plantilla de actividad.

Para obtener un ejemplo de XML de fuente de actividad, vea Ejemplo XML de fuente de actividad.

En la tabla siguiente se muestran los tipos de variables de plantilla admitidas, cada una representada por el valor de enumeración XML correspondiente.

Tipo de variable de plantilla Descripción
entityVariable
Una persona, un grupo o algo así.
linkVariable
Un vínculo.
listVariable
Un grupo de objetos.
pictureVariable
Imagen.
publisherVariable
Publicador del elemento de fuente de actividad.
textVariable
Bloque de texto.

Cada tipo de variable de plantilla tiene elementos necesarios para especificar los datos sobre esa variable. Las variables de plantilla se especifican de la siguiente manera:

<templateVariable type="variable type">

Variable de plantilla de lista

Puede especificar variables de plantilla contenidas en una lista (delimitadas por los elementos listVariable y listItems ) como se indica a continuación:

<simpleTemplateVariable type="variable type of text, link, or picture">

Una variable de plantilla del tipo listVariable es un contenedor para objetos. Puede contener elementos delimitados por comas (del tipo linkVariable o textVariable ) o imágenes (del tipo pictureVariable ). Listas puede contener hasta cinco elementos de vínculo, cinco elementos de texto o cinco imágenes.

Outlook Social Connector (OSC) localiza los elementos de vínculo o lista de texto según la configuración regional del sistema de Windows.

Para analizar y mostrar imágenes correctamente en un elemento de fuente de actividad, debe incluir imágenes en una lista. Todas las imágenes tienen un tamaño de 52 píxeles de alto. No se cambia el tamaño del ancho de la imagen.

Elementos de variable de plantilla

En esta sección se tratan los elementos obligatorios y opcionales admitidos para cada tipo de variable de plantilla.

entityVariable

Elemento Descripción
name
El nombre de la variable. Obligatorio.
id
Identificador único del usuario. Obligatorio.
nameHint
Nombre que se va a mostrar en el elemento de fuente. Opcional.
profileUrl
Dirección URL del perfil de la persona que se usará como hipervínculo para el nombre de la persona en el elemento de fuente, si el nombre de la persona está presente. Opcional.
emailAddress
Dirección de correo electrónico que se usa para actualizar la información de contacto de esta persona en Outlook. Opcional.

linkVariable

Elemento Descripción
name
El nombre de la variable. Obligatorio.
value
Dirección URL de este vínculo. Obligatorio.
text
Texto del vínculo que se va a mostrar en lugar de la propia dirección URL. Opcional.

listVariable

Elemento Descripción
name
El nombre de la variable. Obligatorio.
listItems
Contenedor de elementos de la lista. Obligatorio.

pictureVariable

Elemento Descripción
name
El nombre de la variable. Obligatorio.
value
Dirección URL de la imagen. Obligatorio.
altText
Texto alternativo que se va a mostrar para la accesibilidad y cuando el usuario mueve el puntero del mouse sobre la imagen. Opcional.
href
Hipervínculo que se va a usar cuando el usuario hace clic en la imagen, si el destino deseado no es la dirección URL de imagen especificada por el elemento value . Opcional.

publisherVariable

Elemento Descripción
name
El nombre de la variable. Obligatorio.
id
Identificador único del usuario. Obligatorio.
nameHint
Nombre que se va a mostrar en el elemento de fuente. Opcional.
profileUrl
Dirección URL del perfil de la persona que se usará como hipervínculo para el nombre de la persona en el elemento de fuente, si el nombre de la persona está presente. Opcional.
emailAddress
Dirección de correo electrónico que se usa para actualizar la información de contacto de esta persona en Outlook. Opcional.

textVariable

Elemento Descripción
name
El nombre de la variable. Obligatorio.
value
Texto que se va a mostrar. Opcional.

Vea también