Элемент Rule
Указывает правила активации, которые должны быть оценены для этой контекстной почтовой надстройки.
Тип надстройки: Почта (контекстная)
Важно!
Контекстные надстройки Outlook на основе сущностей будут прекращены во 2-м квартале 2024 г. Работа по прекращению использования этой функции начнется в мае и продолжится до конца июня. После июня контекстные надстройки больше не смогут обнаруживать сущности в почтовых элементах для выполнения задач над ними. Следующие 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
Определяет правило, которое оценивается как истинное, если выбранный элемент относится к указанному типу.
Атрибуты
Атрибут | Обязательный | Описание |
---|---|---|
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>
См. также
Office Add-ins
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по