Rule 要素

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

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

重要

この要素または属性値は、開発者が既存のコンテキスト Outlook アドインのトラブルシューティングを行うのを支援するために文書化されています。新しいコンテキスト Outlook アドインを作成しないことをお勧めします。

  • エンティティベースのコンテキスト Outlook アドインは廃止されました。
  • 以前はコンテキスト アドインに正規表現のルールが必要だったシナリオを、 イベントベースの Outlook アドインで実装できるようになりました。アドインは、新しいメッセージや会議の作成などのイベントに応答して自動的にアクティブ化されます。 JavaScript には正規表現のサポートが組み込まれており、高度な正規表現機能を提供する JavaScript ライブラリを参照することもできます。 コンテキスト アドインとは異なり、イベント ベースのアドインは作成コンテキストでも読み取りモードでも動作できます。

含まれる場所

属性

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

関連項目

  • 最終更新: