次の方法で共有

Rule 要素

  • [アーティクル]

このコンテキスト メール アドインに対して評価する必要があるアクティブ化ルールを指定します。

アドインの種類: メール (コンテキスト)

重要

エンティティベースのコンテキスト Outlook アドインは廃止されました。 別のソリューションとして、コンテキスト アドインに正規表現ルールを実装します。 これらのルールを実装する方法のガイダンスについては、「 コンテキスト Outlook アドイン」を参照してください。

含まれる場所

属性

属性 必須 説明
xsi:type はい 定義されているルールの種類。

ルールの種類は、次のいずれかです。

ItemIs ルール

選択したアイテムが指定した種類である場合に true と評価するルールを定義します。

属性

属性 必須 説明
ItemType はい 照合するアイテムの種類を指定します。 または Message になります。Appointment のアイテムの種類には、電子メール、会議出席依頼、会議出席依頼の返信、および会議のキャンセルが含まれます。
FormType いいえ (ExtensionPoint 内)、いいえ (OfficeApp 内) アプリがアイテムの読み取りまたは編集フォームで表示されるかどうかを指定します。 Read、Edit、ReadOrEditのいずれかを指定できます。 ExtensionPoint内のRuleで指定した場合、この値はReadする必要があります。
ItemClass いいえ 照合するカスタム メッセージ クラスを指定します。 詳細については、「特定のメッセージ クラスに対して Outlook のメール アドインをアクティブにする」を参照してください。
IncludeSubClasses いいえ アイテムが指定したメッセージ クラスのサブクラスである場合に、このルールは true と評価する必要があるかどうかを指定します。既定値は false です。

例

<Rule xsi:type="ItemIs" ItemType= "Message" />

ItemHasAttachment ルール

アイテムに添付ファイルがある場合に true と評価するルールを定義します。

例

<Rule xsi:type="ItemHasAttachment" />

ItemHasKnownEntity ルール (非推奨)

警告

<ItemHasKnownEntity> 要素は非推奨になりました。 代わりに ItemHasRegularExpressionMatch 要素を使用して正規表現ルールを指定します。

指定したエンティティ型のテキストがアイテムの件名または本文に含まれている場合に true と評価するルールを定義します。

属性

属性 必須 説明
EntityType はい このルールが true と評価するために見つける必要のあるエンティティの型を指定します。 MeetingSuggestion、TaskSuggestion、Address、Url、PhoneNumber、EmailAddress、Contactのいずれかです。
RegExFilter いいえ このエンティティに対してアクティブ化を実行するための正規表現を指定します。
FilterName いいえ 正規表現フィルターの名前を指定します。指定すると、以後このフィルターをアドインのコード内で参照できます。
IgnoreCase いいえ RegExFilter 属性で指定された正規表現のマッチングで大文字と小文字の違いを無視するかどうかを指定します。
Highlight いいえ 注: これは、<ExtensionPoint> 要素内の <Rule> 要素にのみ適用されます。 クライアントが一致するエンティティを強調表示にする方法を指定します。 all または none のいずれかになります。 指定のない場合、既定値は all に設定されます。

使用例

<Rule xsi:type="ItemHasKnownEntity" EntityType="EmailAddress" />

ItemHasRegularExpressionMatch ルール

アイテムの指定したプロパティの中を検索し、指定した正規表現と一致するものがある場合に true と評価するルールを定義します。

属性

属性 必須 説明
RegExName はい アドインのコードで参照できるように、正規表現の名前を指定します。
RegExValue はい メール アドインを表示するかどうかを判断するために評価する正規表現を指定します。
PropertyName はい 正規表現の評価対象となるプロパティの名前を指定します。 Subject、BodyAsPlaintext、BodyAsHTML、またはSenderSMTPAddressのいずれかを指定できます。

BodyAsHTML を指定した場合、アイテムの本文が HTML の場合にのみ Outlook は正規表現を適用します。 HTML 以外の場合、Outlook はその正規表現に対して一致を返しません。

BodyAsPlaintext を指定すると、Outlook はアイテムの本文に対して正規表現を常に適用します。

大事な：<Rule> 要素の Highlight 属性を指定する必要がある場合は、PropertyName 属性を BodyAsPlaintext に設定する必要があります。
IgnoreCase いいえ RegExName 属性で指定された正規表現の一致で大文字と小文字の違いを無視するかどうかを指定します。
Highlight いいえ クライアントが一致するテキストを強調表示にする方法を指定します。 この属性は、<ExtensionPoint> 要素内の<Rule>要素にのみ適用できます。 all または none のいずれかになります。 指定のない場合、既定値は all に設定されます。

大事な：<Rule> 要素で Highlight 属性を指定するには、PropertyName 属性を BodyAsPlaintext に設定する必要があります。

例

<Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="SupportArticleNumber" RegExValue="(\W|^)kb\d{6}(\W|$)" PropertyName="BodyAsPlaintext" IgnoreCase="true" Highlight="all" />

RuleCollection

ルールのコレクション、およびそれらのルールの評価時に使用する論理演算子を定義します。

属性

属性 必須 説明
Mode はい このルール コレクションの評価時に使用する論理演算子を指定します。 AndまたはOrのいずれかです。

使用例

<ExtensionPoint xsi:type="DetectedEntity">
  <Label resid="Context.Label"/>
  <SourceLocation resid="DetectedEntity.URL" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Message"/>
    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="videoURL" RegExValue="http://www\.youtube\.com/watch\?v=[a-zA-Z0-9_-]{11}" PropertyName="BodyAsPlaintext"/>
  </Rule>
</ExtensionPoint>

関連項目