模板变量
模板变量的实例 (由 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 类型) 或 图片 (的图片变量 类型) 。 Lists最多可以包含五个链接项、五个文本项或五张图片。
Outlook Social Connector (OSC) 根据 Windows 系统区域设置本地化链接或文本列表项。
若要在活动源项中正确分析和显示图片，必须在列表中包括图片。 所有图片的大小调整为 52 像素高。 图片的宽度不会调整大小。
模板变量元素
本部分介绍每种类型的模板变量支持的必需元素和可选元素。
entityVariable
| 元素 | 说明 |
|---|---|
|
名称 |
变量的名称。 必需。 |
|
id |
用户的唯一 ID。 必需。 |
|
nameHint |
要显示在源项中的名称。 可选。 |
|
profileUrl |
将用作源项中人员姓名超链接的人员个人资料的 URL（如果该人员的姓名存在）。 可选。 |
|
emailAddress |
用于在 Outlook 中更新此人联系信息的电子邮件地址。 可选。 |
linkVariable
| 元素 | 说明 |
|---|---|
|
名称 |
变量的名称。 必需。 |
|
value |
此链接的 URL。 必填。 |
|
text |
要显示的链接文本，而不是 URL 本身。 可选。 |
listVariable
| 元素 | 说明 |
|---|---|
|
名称 |
变量的名称。 必填。 |
|
listItems |
列表中项的容器。 必填。 |
pictureVariable
| 元素 | 说明 |
|---|---|
|
名称 |
变量的名称。 必需。 |
|
value |
图片的 URL。 必填。 |
|
altText |
当用户将鼠标指针移到图片上时，为辅助功能以及要显示的备用文本。 可选。 |
|
href |
当用户单击图片时要使用的超链接（如果所需目标不是 由 value 元素指定的图片 URL）。 可选。 |
publisherVariable
| 元素 | 说明 |
|---|---|
|
名称 |
变量的名称。 必填。 |
|
id |
用户的唯一 ID。 必填。 |
|
nameHint |
要显示在源项中的名称。 可选。 |
|
profileUrl |
将用作源项中人员姓名超链接的人员个人资料的 URL（如果该人员的姓名存在）。 可选。 |
|
emailAddress |
用于在 Outlook 中更新此人联系信息的电子邮件地址。 可选。 |
textVariable
| 元素 | 说明 |
|---|---|
|
名称 |
变量的名称。 必需。 |
|
value |
要显示的文本。 可选。 |