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


Ограничения на активацию и API JavaScript для надстроек Outlook

Чтобы предоставить пользователям удобные возможности работы в надстройках Outlook, следует помнить об определенных рекомендациях по активации и использованию интерфейса API и разрабатывать надстройки в соответствии с ними. Эти рекомендации существуют для того, чтобы отдельная надстройка не могла требовать от Exchange Server или Outlook необычно длительного времени для обработки правил активации или вызовов API JavaScript для Office, что влияет на общий пользовательский интерфейс Outlook и других надстроек. Эти ограничения применяются к разработке правил активации в манифесте надстройки и использованию пользовательских свойств, перемещаемых параметров, получателей, запросов и ответов веб-служб Exchange (EWS) и асинхронных вызовов.

Примечание.

Также необходимо убедиться, что надстройка работает в пределах определенных ограничений на использование ресурсов среды выполнения. Дополнительные сведения см. в разделе Среды выполнения в надстройках Office.

Где активируются надстройки

Дополнительные сведения о том, где надстройки выполняют и не активируются, см. в разделе "Элементы почтовых ящиков, доступные для надстроек" статьи Обзор надстроек Outlook.

Ограничения для API JavaScript

Каждый клиент Outlook применяет определенные ограничения в объектной модели JavaScript, как описано в следующей таблице.

Функция Ограничение Связанный API Описание
Настраиваемые свойства 2500 символов Объект CustomProperties

Метод Item.loadCustomPropertiesAsync
Ограничение для всех настраиваемых свойств элемента встречи или сообщения. Все клиенты Outlook возвращают ошибку, если общий размер всех настраиваемых свойств надстройки превышает это ограничение.
Перемещаемые параметры 32 КБ символов Объект RoamingSettings

Свойство Context.roamingSettings
Ограничение для всех параметров перемещения надстройки. Все клиенты Outlook возвращают ошибку, если параметры превышают это ограничение.
Заголовки Интернета 256 КБ на сообщение в Exchange Online

Ограничение на размер заголовка определяется администраторами организации в локальной среде Exchange
Метод InternetHeaders.setAsync Общий размер заголовков, которые можно применить к сообщению.
Веб-службы Exchange 5 МБ символов в Outlook в Интернете, в Windows (начиная с версии 2303 (сборка 16225.10000)), в Mac (начиная с версии 16.73 (23042601)) и в новом Outlook в Windows

1 МБ символов в более ранних версиях Outlook в Windows (классической) и на Mac
Метод Mailbox.makeEwsRequestAsync Ограничение для запроса или ответа на Mailbox.makeEwsRequestAsync вызов.
Элемент с несколькими выборами 100 сообщений Метод Mailbox.getSelectedItemsAsync Максимальное количество выбранных сообщений, для которых может активироваться надстройка Outlook.
Recipients Отличается в разных клиентах Outlook Свойство Item.requiredAttendees

Свойство Item.optionalAttendees

свойство Item.to

свойство Item.cc

Метод Recipients.addAsync

Метод Recipients.getAsync

Метод Recipients.setAsync
Ограничение для получателей, указанных в каждом свойстве или методе. Сведения об ограничениях получателей для определенного клиента Outlook см. в документации по API для свойства или метода.
Отображаемое имя 255 символов Свойство EmailAddressDetails.displayName

Объект Recipients

Свойство Item.requiredAttendees

Свойство Item.optionalAttendees

свойство Item.to

свойство Item.cc
Ограничение длины отображаемого имени в сообщении или встрече.
Установка темы 255 символов DisplayedSubject.setAsync (предварительная версия)

Метод Mailbox.displayNewAppointmentForm

Метод Subject.setAsync
Ограничение для темы в форме новой встречи или для настройки темы встречи или сообщения.
Установка места проведения 255 символов Метод Location.setAsync Ограничение для установки расположении встречи или приглашения на собрание.
Текст в форме новой встречи 32 КБ символов Метод Mailbox.displayNewAppointmentForm Ограничение текста в форме новой встречи.
Отображение текста существующего элемента 32 КБ символов Метод Mailbox.displayAppointmentForm

Метод Mailbox.displayMessageForm
Для Outlook в Интернете, мобильных устройств и нового Outlook в Windows: ограничение текста в существующей форме встречи или сообщения.
Настройка текста 1 МБ символов Метод Body.prependAsync

Body.setAsync

Метод Body.setSelectedDataAsync

DisplayedBody.setAsync (предварительная версия)
Ограничение для установки текста элемента встречи или сообщения.
Установка сигнатуры 30 000 символов Метод Body.setSignatureAsync Ограничение длины подписи в встрече или сообщении.
Число вложений 499 файлов в Outlook в Интернете и новый Outlook в Windows Метод Item.addFileAttachmentAsync Ограничение количества файлов, которые можно вложить в отправляемый элемент. Outlook в Интернете и новые outlook в Windows обычно ограничивают присоединение до 499 файлов с помощью пользовательского интерфейса и addFileAttachmentAsync метода. Outlook в Windows (классической версии) и на Mac специально не ограничивает количество файловых вложений. Однако все клиенты Outlook соблюдают ограничение на размер вложений (см. строку "Размер вложений" в этой таблице).
Размер вложений Зависит от Exchange Server в классической версии Outlook в Windows и Outlook на Mac

25 МБ в Outlook в Интернете и новый Outlook в Windows
Метод Item.addFileAttachmentAsync Ограничение размера всех вложений, добавленных в почтовый элемент. В классической версии Outlook в Windows и Outlook на Mac ограничение настраивается администратором на Exchange Server почтового ящика пользователя. В этих клиентах это также ограничивает количество вложений элемента. Для Outlook в Интернете и нового Outlook в Windows меньшее из двух ограничений — количество вложений и размер всех вложений — ограничивает фактические вложения элемента.
Имя файла вложения 255 символов Метод Item.addFileAttachmentAsync Ограничение длины имени файла вложения, добавляемого в элемент.
URI вложения 2048 символов Метод Item.addFileAttachmentAsync

Метод Item.addFileAttachmentFromBase64Async
Ограничение URI имени файла, добавляемого в элемент как вложение.
Строка вложения в кодировке Base64 27 892 122 символа (около 25 МБ) Метод Item.addFileAttachmentFromBase64Async Ограничение строки в кодировке Base64, добавляемой в качестве вложения к элементу.
Идентификатор вложения 100 символов Метод Item.addItemAttachmentAsync

Метод Item.removeAttachmentAsync
Ограничение длины идентификатора вложения, добавляемого в элемент или удаляемого из него.
Асинхронные вызовы 3 вызова Метод Item.addFileAttachmentAsync

Метод Item.addItemAttachmentAsync

Метод Item.removeAttachmentAsync

Метод Body.getTypeAsync

Метод Body.prependAsync

Метод Body.setSelectedDataAsync

Метод CustomProperties.saveAsync

Метод Item.LoadCustomPropertiesAsync

Метод Location.getAsync

Метод Location.setAsync

Метод Mailbox.getCallbackTokenAsync

Метод Mailbox.getUserIdentityTokenAsync

Метод Mailbox.makeEwsRequestAsync

Метод Recipients.addAsync

Метод Recipients.getAsync

Метод Recipients.setAsync

Метод RoamingSettings.saveAsync

Метод Subject.getAsync

Метод Subject.setAsync

Метод Time.getAsync

Метод Time.setAsync
Для Outlook в Интернете и на мобильных устройствах, а также нового Outlook в Windows: ограничение числа одновременных асинхронных вызовов в любой момент времени, так как браузеры разрешают только ограниченное количество асинхронных вызовов к серверам.
Добавление при отправке 5000 символов Метод Body.appendOnSendAsync Ограничение содержимого, добавляемого в сообщение или текст встречи при отправке.
Prepend-on-send 5000 символов Метод Body.prependOnSendAsync Ограничение содержимого, которое добавляется к сообщению или тексту встречи при отправке.

Ограничения правил активации для контекстных надстроек Outlook

Важно!

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

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

  • Размер манифеста не должен превышать 256 КБ. Вы не сможете установить надстройку Outlook для почтового ящика Exchange, если превысите это ограничение.

    Примечание.

    Функции надстройки Outlook, зависящие от правил активации, не поддерживаются, если надстройка использует унифицированный манифест приложения для Microsoft 365.

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

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

    • Укажите только пять регулярных выражений в правилах активации в надстройке. Вы не сможете установить надстройку, если превысите это ограничение.
    • Укажите регулярные выражения таким образом, чтобы ожидаемые результаты возвращались вызовом getRegExMatches метода в течение первых 50 совпадений.
    • Важно! Текст выделяется на основе строк, которые являются результатом сопоставления регулярного выражения. Однако выделенные вхождения могут не точно соответствовать тому, что должно быть результатом фактических утверждений регулярных выражений, таких как отрицательный взгляд вперед (?!text), просмотр за спиной (?<=text)и отрицательный просмотр позади (?<!text). Например, если вы используете регулярное выражение under(?!score) "Like under, under score, and подчеркивание", строка "under" выделяется для всех вхождений, а не только для первых двух.

Различия в поддержке регулярных выражений

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

Outlook в Интернете, в новом клиенте Windows и на мобильных устройствах Outlook в Windows (классическая версия) и на Mac
Клиенты используют вычисление регулярных выражений, которое является частью JavaScript. Он предоставляется браузером и поддерживает надмножество ECMAScript 5. Клиенты используют обработчик регулярных выражений C++, предоставляемый как часть стандартной библиотеки шаблонов Visual Studio. Этот обработчик выполняет компиляцию в соответствии со стандартами ECMAScript 5.
Необходимо тщательно протестировать каждый регулярный экземпляр на каждом клиенте Outlook. Если регулярное выражение возвращает другие результаты, перепишите его. Из-за различных обработчиков регулярных выражений регулярное выражение, включающее пользовательский класс символов, основанный на стандартных классах символов, может возвращать разные результаты в Outlook в Windows (классической) и на Mac по сравнению с Outlook в Интернете, на мобильных устройствах и в новом Outlook в Windows.

Например, регулярное выражение [\s\S]{0,100} соответствует любому числу (от 0 до 100) отдельных символов, которые являются пробелами или не пробелами. Этот регулярный результат возвращает разные результаты в зависимости от клиента Outlook.

В качестве обходного решения следует переписать регулярное выражение как (\s\|\S){0,100}. Эта регулярность соответствует любому числу (от 0 до 100) пробелов или небелых пробелов.

Необходимо тщательно протестировать каждый регулярный экземпляр на каждом клиенте Outlook. Если регулярное выражение возвращает другие результаты, перепишите его.
Параметры мониторинга ресурсов и реестра, поддерживаемые в Outlook в Windows (классической версии) и на Mac, не поддерживаются в Outlook в Интернете, на мобильных устройствах и в новых приложениях Outlook для Windows. Однако надстройки с регулярными выражениями, для которых требуется слишком много времени оценки в Outlook для Windows (классическая модель) и на Mac, отключены для одного и того же почтового ящика на всех клиентах Outlook. По умолчанию оценка всех регулярных выражений для надстройки ограничена одной секундой. Превышение этого предела приводит к повторной вычислении до трех раз. За пределы переоценки Outlook в Windows (классической) и на Mac не позволяют запускать надстройку для одного почтового ящика в любом из клиентов Outlook.

Администраторы могут переопределить эти ограничения оценки с помощью OutlookActivationAlertThreshold разделов реестра и OutlookActivationManagerRetryLimit .

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

В следующей таблице перечислены ограничения и описаны различия в части текста элемента, к которой каждый клиент Outlook применяет регулярное выражение. Некоторые из этих ограничений зависят от типа устройства и основного текста элемента, если регулярное выражение применяется к основному тексту элемента.

Outlook в Интернете и на новом клиенте Windows Outlook в Windows (классическая версия) и на Mac Outlook на мобильных устройствах
Конструктивные параметры Любые поддерживаемые устройства, кроме смартфонов Android, iPad и iPhone. Любое поддерживаемого устройства. Смартфоны Android, iPad или iPhone.
Основной текст элемента в виде обычного текста Активирует надстройку только в том случае, если текст < содержит 500 000 символов. Регулярное выражение применяется к первому мегабайту данных в основном тексте. К остальной части основного текста свыше этого ограничения регулярное выражение не применяется. Активирует надстройку только в том случае, если текст < содержит 16 000 символов.
Основной текст элемента в формате HTML Активирует надстройку только в том случае, если текст < содержит 500 000 символов. Применяет регулярное выражение к первым 512 КБ данных основного текста, но не к остальной части текста сверх этого предела. (Фактическое количество символов зависит от кодировки, которая может варьироваться от 1 до 4 байт на символ.) Регулярное выражение применяется к первым 64 000 знаков (включая знаки HTML-тегов). К остальной части основного текста свыше этого ограничения регулярное выражение не применяется.

Ограничения возвращаемых соответствий

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

Outlook в Интернете, в новом клиенте Windows и на мобильных устройствах Outlook в Windows (классическая версия) и на Mac
Порядок возвращаемых соответствий Предположим, getRegExMatches что метод возвращает разные совпадения для одного регулярного выражения, применяемого к одному и тому же почтовому элементу в Outlook в Windows (классическая модель) и в Mac, а также в Outlook в Интернете, на мобильных устройствах и в новом Outlook в Windows. Предположим, getRegExMatches что метод возвращает разные совпадения для одного регулярного выражения, применяемого к одному и тому же почтовому элементу в Outlook в Windows (классическая модель) и в Mac, а также в Outlook в Интернете, на мобильных устройствах и в новом Outlook в Windows.
Основной текст элемента в виде обычного текста getRegExMatches возвращает все совпадения длиной до 3072 символов (3 КБ) для не более 50 совпадений. Метод getRegExMatches возвращает все совпадения длиной до 1536 (1,5 КБ) для не более 50 совпадений.

Примечание. getRegExMatches Не возвращает совпадения в определенном порядке в возвращаемом массиве. Как правило, предположим, что порядок совпадений для одного регулярного выражения, применяемого к одному и тому же почтовому элементу в Outlook в Windows (классическая версия) и на Mac, отличается от порядка совпадений в Outlook в Интернете, на мобильных устройствах и в новом Outlook для Windows.
Основной текст элемента в формате HTML getRegExMatches возвращает все совпадения длиной до 3072 символов (3 КБ) для не более 50 совпадений. getRegExMatches возвращает все совпадения длиной до 3072 символов (3 КБ) для не более 50 совпадений.

Примечание. getRegExMatches Не возвращает совпадения в определенном порядке в возвращаемом массиве. Как правило, предположим, что порядок совпадений для одного регулярного выражения, применяемого к одному и тому же почтовому элементу в Outlook в Windows (классическая версия) и на Mac, отличается от порядка совпадений в Outlook в Интернете, на мобильных устройствах и в новом Outlook для Windows.

См. также