Элемент Rule

Указывает правила активации, которые должны быть оценены для этой контекстной почтовой надстройки.

Тип надстройки: Почта (контекстная)

Важно!

Контекстные надстройки Outlook на основе сущностей будут прекращены во 2-м квартале 2024 г. Работа по прекращению использования этой функции начнется в мае и продолжится до конца июня. После июня контекстные надстройки больше не смогут обнаруживать сущности в почтовых элементах для выполнения задач над ними. Следующие API также будут прекращены.

Чтобы свести к минимуму возможные перебои, после прекращения использования контекстных надстроек на основе сущностей будет по-прежнему поддерживаться следующее.

  • Разрабатывается альтернативная реализация кнопки "Присоединиться к собранию ", которая активируется надстройками собраний по сети. После завершения поддержки контекстных надстроек на основе сущностей надстройки собраний по сети автоматически переходят на альтернативную реализацию для активации кнопки Присоединиться к собранию .
  • Правила регулярных выражений будут поддерживаться после прекращения использования контекстных надстроек на основе сущностей. Мы рекомендуем обновить контекстную надстройку, чтобы использовать правила регулярных выражений в качестве альтернативного решения. Инструкции по реализации этих правил см. в статье Использование правил активации регулярных выражений для отображения надстройки Outlook.

Дополнительные сведения см. в разделе Прекращение использования контекстных надстроек Outlook на основе сущностей.

Содержится в

Атрибуты

Атрибут Обязательный Описание
xsi:type Да Тип определяемого правила.

Тип правила может быть одним из следующих:

Правило ItemIs

Определяет правило, которое оценивается как истинное, если выбранный элемент относится к указанному типу.

Атрибуты

Атрибут Обязательный Описание
ItemType Да Задает сопоставляемый тип элемента. Допустимые значения: Message и Appointment. К типу элементов Message относятся электронные письма, приглашения на собрания, ответы на них и уведомления об их отмене.
FormType Нет (в ExtensionPoint), да (в OfficeApp) Указывает, должно ли приложение отображаться в форме чтения или редактирования элемента. Допустимые значения: Read, Edit, ReadOrEdit. Если задано в Rule в ExtensionPoint, это значение ДОЛЖНО иметь значение Read.
ItemClass Нет Указывает пользовательский класс сообщения для сопоставления. Дополнительные сведения см. в разделе Активация почтовой надстройки в Outlook для определенного класса сообщений.
IncludeSubClasses Нет Указывает, должно ли правило оцениваться как истинное (true), если элемент принадлежит к подклассу указанного класса сообщений; по умолчанию используется значение false.

Пример

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

Правило ItemHasAttachment

Определяет правило, которое оценивается как истинное, если элемент содержит вложение.

Пример

<Rule xsi:type="ItemHasAttachment" />

Правило ItemHasKnownEntity

Определяет правило, которое оценивается как истинное, если элемент содержит текст указанного типа сущности в теме или основном тексте.

Атрибуты

Атрибут Обязательный Описание
EntityType Да Задает тип сущности, который должен быть обнаружен, чтобы правило было оценено как истинное. Допустимые значения: MeetingSuggestion, TaskSuggestion, Address, Url, PhoneNumber, EmailAddress и Contact.
RegExFilter Нет Задает регулярное выражение, которое должно выполняться в этой сущности для активации.
FilterName Нет Задает имя фильтра регулярных выражений, чтобы на этот фильтр можно было ссылаться в коде надстройки.
IgnoreCase Нет Указывает, следует ли игнорировать регистр при сравнении регулярного выражения, заданного атрибутом RegExFilter.
Highlight Нет Примечание. Это относится только к <элементам Rule> в <элементах ExtensionPoint> . Указывает, как клиент должен выделять соответствующие сущности. Допустимые значения: all и none. Если этот атрибут не задан, по умолчанию используется значение all.

Пример

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

Правило ItemHasRegularExpressionMatch

Задает правило, которое оценивается как истинное, если в указанном свойстве элемента обнаруживается соответствие для указанного регулярного выражения.

Атрибуты

Атрибут Обязательный Описание
RegExName Да Указывает имя регулярного выражения, чтобы на него можно было ссылаться в коде надстройки.
RegExValue Да Указывает регулярное выражение, которое будет вычислено, чтобы определить, требуется ли отображать надстройку.
PropertyName Да Указывает имя свойства, которое будет использоваться для вычисления регулярного выражения. Допустимые значения: Subject, BodyAsPlaintext, BodyAsHTML и SenderSMTPAddress.

Если вы укажете BodyAsHTML, Outlook будет применять регулярное выражение, только если текст элемента представлен в формате HTML. В противном случае Outlook возвращает отсутствие совпадений для этого регулярного выражения.

Если вы укажете BodyAsPlaintext, Outlook всегда будет применять регулярное выражение для текста элемента.

Важно: Если необходимо указать атрибут Highlight для <элемента Rule> , необходимо задать для атрибута PropertyName значение BodyAsPlaintext.
IgnoreCase Нет Указывает, следует ли игнорировать регистр при сравнении регулярного выражения, заданного атрибутом RegExName.
Highlight Нет Указывает, как клиент должен выделять соответствующий текст. Этот атрибут можно применять только к <элементам Rule> в элементах <ExtensionPoint> . Допустимые значения: all и none. Если этот атрибут не задан, по умолчанию используется значение all.

Важно: Чтобы указать атрибут Highlight в элементе <Rule> , необходимо задать для атрибута 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>

См. также