Элемент Rule

  • Статья

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

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

Важно!

Контекстные надстройки 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 (не рекомендуется)

Предупреждение

Элемент <ItemHasKnownEntity> теперь устарел. Укажите правила регулярных выражений с помощью элемента ItemHasRegularExpressionMatch .

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

Атрибуты

Атрибут Обязательный Описание
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.

Пример

<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>

См. также