Rule 要素

[アーティクル]
01/19/2024

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

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

重要

エンティティベースのコンテキスト Outlook アドインは、2024 年第 2 四半期に廃止される予定です。この機能を廃止する作業は 5 月に開始され、6 月末まで継続されます。 6 月以降、コンテキストアドインはメールアイテム内のエンティティを検出してタスクを実行できなくなります。次の API も廃止されます。

中断の可能性を最小限に抑えるために、エンティティベースのコンテキストアドインが廃止された後も、次の機能がサポートされます。

オンライン会議アドインによってアクティブ化される [会議に参加 ] ボタンの代替実装が開発されています。エンティティベースのコンテキストアドインのサポートが終了すると、オンライン会議アドインは自動的に別の実装に移行して [ 会議に参加 ] ボタンをアクティブ化します。
エンティティベースのコンテキストアドインが廃止された後も、正規表現ルールは引き続きサポートされます。代替ソリューションとして正規表現ルールを使用するように、コンテキストアドインを更新することをお勧めします。これらのルールを実装する方法のガイダンスについては、「正規表現アクティブ化ルールを使用して Outlook アドインを表示する」を参照してください。

詳細については、「エンティティベースのコンテキスト Outlook アドインの廃止」を参照してください。

含まれる場所

属性

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

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

ItemIs
ItemHasAttachment
ItemHasKnownEntity
ItemHasRegularExpressionMatch
RuleCollection

ItemIs ルール

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

属性

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

例

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

ItemHasAttachment ルール

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

例

<Rule xsi:type="ItemHasAttachment" />

ItemHasKnownEntity ルール

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

属性

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

使用例

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

ItemHasRegularExpressionMatch ルール

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

属性

属性	必須	説明
RegExName	はい	アドインのコードで参照できるように、正規表現の名前を指定します。
RegExValue	はい	メールアドインを表示するかどうかを判断するために評価する正規表現を指定します。
PropertyName	はい	正規表現の評価対象となるプロパティの名前を指定します。 `SubjectBodyAsPlaintext`、、`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	はい	このルールコレクションの評価時に使用する論理演算子を指定します。またはのいずれか `AndOr`です。

使用例

<Rule xsi:type="RuleCollection" Mode="And">
  <Rule xsi:type="ItemIs" ItemType="Message" />
  <Rule xsi:type="ItemHasKnownEntity" EntityType="MeetingSuggestion" />
  <Rule xsi:type="ItemHasKnownEntity" EntityType="Address" Highlight="none" />
</Rule>