Rule 要素
このコンテキスト メール アドインに対して評価する必要があるアクティブ化ルールを指定します。
アドインの種類: メール (コンテキスト)
重要
エンティティベースのコンテキスト Outlook アドインは、2024 年第 2 四半期に廃止される予定です。 この機能を廃止する作業は 5 月に開始され、6 月末まで継続されます。 6 月以降、コンテキスト アドインはメール アイテム内のエンティティを検出してタスクを実行できなくなります。 次の API も廃止されます。
- Office.context.mailbox.item.getEntities()
- Office.context.mailbox.item.getEntitiesByType(entityType)
- Office.context.mailbox.item.getFilteredEntitiesByName(name)
- Office.context.mailbox.item.getSelectedEntities()
中断の可能性を最小限に抑えるために、エンティティ ベースのコンテキスト アドインが廃止された後も、次の機能がサポートされます。
- オンライン会議アドインによってアクティブ化される [会議に参加 ] ボタンの代替実装が開発されています。 エンティティベースのコンテキスト アドインのサポートが終了すると、オンライン会議アドインは自動的に別の実装に移行して [ 会議に参加 ] ボタンをアクティブ化します。
- エンティティ ベースのコンテキスト アドインが廃止された後も、正規表現ルールは引き続きサポートされます。 代替ソリューションとして正規表現ルールを使用するように、コンテキスト アドインを更新することをお勧めします。 これらのルールを実装する方法のガイダンスについては、「 正規表現アクティブ化ルールを使用して Outlook アドインを表示する」を参照してください。
詳細については、「 エンティティ ベースのコンテキスト Outlook アドインの廃止」を参照してください。
含まれる場所
属性
属性 | 必須 | 説明 |
---|---|---|
xsi:type | はい | 定義されているルールの種類。 |
ルールの種類は、次のいずれかです。
ItemIs ルール
選択したアイテムが指定した種類である場合に true と評価するルールを定義します。
属性
属性 | 必須 | 説明 |
---|---|---|
ItemType | はい | 照合するアイテムの種類を指定します。 または Message になります。Appointment のアイテムの種類には、電子メール、会議出席依頼、会議出席依頼の返信、および会議のキャンセルが含まれます。 |
FormType | いいえ (ExtensionPoint 内)、いいえ (OfficeApp 内) | アプリがアイテムの読み取りまたは編集フォームで表示されるかどうかを指定します。 はRead Edit ReadOrEdit 、 のいずれかです。 内の で を Rule 指定する場合、 ExtensionPoint この値は にする必要があります Read 。 |
ItemClass | いいえ | 照合するカスタム メッセージ クラスを指定します。 詳細については、「特定のメッセージ クラスに対して Outlook のメール アドインをアクティブにする」を参照してください。 |
IncludeSubClasses | いいえ | アイテムが指定したメッセージ クラスのサブクラスである場合に、このルールは true と評価する必要があるかどうかを指定します。既定値は false です。 |
例
<Rule xsi:type="ItemIs" ItemType= "Message" />
ItemHasAttachment ルール
アイテムに添付ファイルがある場合に true と評価するルールを定義します。
例
<Rule xsi:type="ItemHasAttachment" />
ItemHasKnownEntity ルール
指定したエンティティ型のテキストがアイテムの件名または本文に含まれている場合に true と評価するルールを定義します。
属性
属性 | 必須 | 説明 |
---|---|---|
EntityType | はい | このルールが true と評価するために見つける必要のあるエンティティの型を指定します。 MeetingSuggestion Url Address PhoneNumber TaskSuggestion 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 です。 |
使用例
<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>
関連項目
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示