Поделиться через

Элемент Rule

  • Статья

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

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

Важно!

Контекстные надстройки Outlook на основе сущностей теперь сняты с учета. В качестве альтернативного решения реализуйте правила регулярных выражений в контекстной надстройке. Инструкции по реализации этих правил см. в разделе Контекстные надстройки Outlook.

Содержится в

Атрибуты

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

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

Правило ItemIs

Определяет правило, которое оценивает значение true, если выбранный элемент в форме чтения или создания имеет указанный тип. В манифесте можно указать несколько ItemIs правил.

Атрибуты

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

ItemType

В следующей таблице описаны Appointment типы элементов и Message , которые можно указать в атрибуте ItemType .

Значение Описание
Встреча Указывает элемент в календаре Outlook. Сюда входит элемент собрания, на который ответили организатор и участники, или встреча, которая не имеет организатора или участника и является просто элементом в календаре. Соответствует классу сообщений IPM.Appointment в Outlook.
Сообщение Указывает один из следующих элементов, получаемых обычно в папке "Входящие".

  • Сообщение электронной почты. Соответствует классу сообщений IPM.Note в Outlook.

  • Запрос на собрание, ответ или отклонение. Это соответствует следующим классам сообщений в 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 .

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

Атрибуты

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

Определяет правило, которое оценивается как true, если соответствие указанному регулярному выражению можно найти в указанном свойстве элемента в форме чтения.

Сведения о реализации ItemHasRegularExpressionMatch правила см. в статье Контекстные надстройки Outlook.

Атрибуты

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

См. также