テンプレート変数

  • [アーティクル]

テンプレート変数のインスタンス ( 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 型) を含めることができます。 Listsには、最大 5 つのリンク項目、5 つのテキスト項目、または 5 つの画像を含めることができます。

Outlook Social Connector (OSC) は、Windows システム ロケールに従ってリンクまたはテキスト リスト項目をローカライズします。

アクティビティ フィード項目の画像を正しく解析して表示するには、一覧に画像を含める必要があります。 すべての画像のサイズが高い 52 ピクセルに変更されます。 画像の幅はサイズ変更されません。

テンプレート変数要素

このセクションでは、テンプレート変数の種類ごとにサポートされる必須要素と省略可能な要素について説明します。

entityVariable

要素 説明
name
変数の名前。 必須です。
id
ユーザーの一意の ID。 必須です。
nameHint
フィード項目に表示する名前。 省略可能です。
profileUrl
ユーザーの名前が存在する場合、フィード アイテム内のユーザーの名前のハイパーリンクとして使用されるユーザーのプロファイルの URL。 省略可能です。
emailAddress
Outlook でこのユーザーの連絡先情報を更新するために使用される電子メール アドレス。 省略可能です。

linkVariable

要素 説明
name
変数の名前。 必須です。
value
このリンクの URL。 必須です。
text
URL 自体の代わりに表示するリンク テキスト。 省略可能です。

listVariable

要素 説明
name
変数の名前。 必須です。
listItems
リスト内の項目のコンテナー。 必須です。

pictureVariable

要素 説明
name
変数の名前。 必須です。
value
画像の URL。 必須です。
altText
アクセシビリティとユーザーが画像の上にマウス ポインターを移動したときに表示する代替テキスト。 省略可能です。
href
目的のターゲットが value 要素で指定された画像 URL でない場合に、ユーザーが画像をクリックしたときに使用するハイパーリンク。 オプション。

publisherVariable

要素 説明
name
変数の名前。 必須です。
id
ユーザーの一意の ID。 必須です。
nameHint
フィード項目に表示する名前。 省略可能です。
profileUrl
ユーザーの名前が存在する場合、フィード アイテム内のユーザーの名前のハイパーリンクとして使用されるユーザーのプロファイルの URL。 省略可能です。
emailAddress
Outlook でこのユーザーの連絡先情報を更新するために使用される電子メール アドレス。 省略可能です。

textVariable

要素 説明
name
変数の名前。 必須です。
value
表示するテキスト。 省略可能です。

関連項目