Переменные шаблонов
Экземпляры переменных шаблона (представленные элементом templateVariable ) указывают данные элемента веб-канала действия в шаблоне действия.
Пример XML веб-канала действий см. в разделе Пример XML веб-канала действий.
В следующей таблице показаны типы поддерживаемых переменных шаблона, каждый из которых представлен соответствующим значением перечисления XML.
| Тип переменной шаблона | Описание |
|---|---|
|
entityVariable |
Человек, группа или вещь. |
|
linkVariable |
Ссылка. |
|
listVariable |
Группа объектов. |
|
pictureVariable |
Рисунок. |
|
publisherVariable |
Издатель элемента веб-канала действий. |
|
textVariable |
Блок текста. |
Каждый тип переменной шаблона содержит обязательные элементы для указания данных об этой переменной. Переменные шаблона указываются следующим образом:
<templateVariable type="variable type">
Переменная шаблона списка
Переменные шаблона, содержащиеся в списке (разделенные элементами listVariable и listItems ), можно указать следующим образом:
<simpleTemplateVariable type="variable type of text, link, or picture">
Переменная шаблона типа listVariable — это контейнер для объектов. Он может содержать элементы с разделителями-запятыми (типа linkVariable или textVariable ) или рисунки (типа pictureVariable ). Списки может содержать до пяти элементов ссылки, пяти текстовых элементов или пяти рисунков.
Outlook Social Connector (OSC) локализует ссылки или текстовые элементы списка в соответствии с языковым стандартом системы Windows.
Чтобы правильно анализировать и отображать изображения в элементе веб-канала действий, необходимо включить рисунки в список. Размер всех рисунков до 52 пикселей в высоту. Ширина рисунка не изменена.
Элементы переменных шаблона
В этом разделе рассматриваются обязательные и необязательные элементы, поддерживаемые для каждого типа переменной шаблона.
entityVariable
| Элемент | Описание |
|---|---|
|
name |
Имя переменной. Обязательно. |
|
id |
Уникальный идентификатор пользователя. Обязательно. |
|
nameHint |
Имя, отображаемое в элементе веб-канала. Необязательный параметр. |
|
profileUrl |
URL-адрес профиля пользователя, который будет использоваться в качестве гиперссылки для имени пользователя в элементе веб-канала, если имя пользователя присутствует. Необязательный параметр. |
|
emailAddress |
Адрес электронной почты, используемый для обновления контактных данных этого человека в Outlook. Необязательный параметр. |
linkVariable
| Элемент | Описание |
|---|---|
|
name |
Имя переменной. Обязательно. |
|
value |
URL-адрес этой ссылки. Обязательно. |
|
text |
Текст ссылки для отображения вместо самого URL-адреса. Необязательный параметр. |
listVariable
| Элемент | Описание |
|---|---|
|
name |
Имя переменной. Обязательно. |
|
listItems |
Контейнер для элементов в списке. Обязательно. |
pictureVariable
| Элемент | Описание |
|---|---|
|
name |
Имя переменной. Обязательно. |
|
value |
URL-адрес рисунка. Обязательно. |
|
altText |
Замещающий текст, отображаемый для специальных возможностей и при наведении указателя мыши на рисунок. Необязательный параметр. |
|
href |
Гиперссылка, используемая, когда пользователь щелкает рисунок, если нужный целевой объект не является URL-адресом рисунка, заданным элементом value . Необязательный параметр. |
publisherVariable
| Элемент | Описание |
|---|---|
|
name |
Имя переменной. Обязательно. |
|
id |
Уникальный идентификатор пользователя. Обязательно. |
|
nameHint |
Имя, отображаемое в элементе веб-канала. Необязательный параметр. |
|
profileUrl |
URL-адрес профиля пользователя, который будет использоваться в качестве гиперссылки для имени пользователя в элементе веб-канала, если имя пользователя присутствует. Необязательный параметр. |
|
emailAddress |
Адрес электронной почты, используемый для обновления контактных данных этого человека в Outlook. Необязательный параметр. |
textVariable
| Элемент | Описание |
|---|---|
|
name |
Имя переменной. Обязательно. |
|
value |
Отображаемый текст. Необязательный параметр. |