次の方法で共有

Rule 要素

  • [アーティクル]

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

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

重要

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

含まれる場所

属性

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

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

ItemIs ルール

読み取りまたは新規作成フォームで選択した項目が指定した型の場合に true と評価されるルールを定義します。 マニフェストでは、複数の ItemIs ルールを指定できます。

属性

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

ItemType

次の表では、ItemType属性で指定できるAppointmentとMessage項目の種類について説明します。

値 説明
Appointment Outlook の予定表内のアイテムを指定します。 これには、返信され、開催者と出席者が含まれる会議アイテム、または開催者または出席者を持たない予定が含まれます。これは、予定表上の単なるアイテムです。 これは Outlook の IPM.Appointment メッセージ クラスに対応します。
Message 通常、受信トレイで受信する次の項目のいずれかを指定します。

  • 電子メール メッセージ。 これは Outlook の IPM.Note メッセージ クラスに対応します。

  • 会議出席依頼、返信、または取り消し。 これは、Outlook の次のメッセージ クラスに対応します。

    IPM.Schedule.Meeting.Request

    IPM.Schedule.Meeting.Neg

    IPM.Schedule.Meeting.Pos

    IPM.Schedule.Meeting.Tent

    IPM.Schedule.Meeting.Canceled

例

<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 と評価されるルールを定義します。

ItemHasRegularExpressionMatch ルールを実装する方法については、「コンテキスト Outlook アドイン」を参照してください。

属性

属性 必須 説明
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>

関連項目