Развертывание и установка надстроек Outlook для тестирования

Статья
03/29/2023

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

Создание файла манифеста, в котором описывается надстройка.
Развертывание файлов пользовательского интерфейса надстройки на веб-сервере.
Установка надстройки в почтовом ящике пользователя.
Тестирование надстройки с внесением соответствующих изменений в пользовательский интерфейс или файлы манифеста и повторение этапов 2 и 3 для тестирования изменений.

Примечание.

Поскольку настраиваемые области устарели, следует убедиться, что вы используете поддерживаемую точку расширения надстройки.

Создание файла манифеста для надстройки

Каждая надстройка описывается манифестом, документом, который предоставляет сведения о сервере о надстройке, предоставляет описательные сведения о надстройке для пользователя и определяет расположение HTML-файла пользовательского интерфейса надстройки. Вы можете хранить манифест в локальной папке или на сервере. Его расположение должно быть доступным для сервера Exchange Server проверяемого почтового ящика. Сведения о создании файла манифеста см. Сведения о создании файла манифеста см. в разделе Манифесты надстроек Office.

Развертывание надстройки на веб-сервере

Для создания надстройки можно использовать HTML и JavaScript. Полученные исходные файлы хранятся на веб-сервере, доступ к которому может получить сервер Exchange Server, на котором размещена надстройка. После первоначального развертывания исходных файлов для надстройки можно обновить пользовательский интерфейс и поведение надстройки, заменив HTML-файлы или файлы JavaScript, хранящиеся на веб-сервере, новой версией HTML-файла.

Установка надстройки

После подготовки файла манифеста и развертывания пользовательского интерфейса надстройки на доступном веб-сервере, вы можете загрузить неопубликованную надстройку для почтового ящика на сервере Exchange Server, используя клиент Outlook, или установить ее с помощью командлетов Windows PowerShell.

Загрузка неопубликованной надстройки

Вы можете установить надстройку, если почтовый ящик находится в Exchange. Для загрузки неопубликованных надстроек требуется как минимум роль "Мои пользовательские приложения" для Exchange Server. Чтобы проверить надстройку или иметь возможность устанавливать надстройки, указывая URL-адрес или имя файла манифеста, попросите своего администратора Exchange предоставить вам необходимые разрешения.

Чтобы назначить одному пользователю необходимые разрешения, администратор Exchange может выполнить указанный ниже командлет PowerShell. В этом примере wendyri — это псевдоним электронной почты пользователя.

New-ManagementRoleAssignment -Role "My Custom Apps" -User "wendyri"

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

$users = Get-Mailbox *$users | ForEach-Object { New-ManagementRoleAssignment -Role "My Custom Apps" -User $_.Alias}

Дополнительные сведения об упомянутой роли см. в статье Роль My Custom Apps.

Если для разработки надстроек вы используете Microsoft 365 или Visual Studio, вам назначается роль администратора организации, позволяющая устанавливать надстройки с помощью файла или URL-адреса в Центре администрирования Exchange, а также с помощью командлетов PowerShell.

Установка надстройки с помощью удаленного сеанса PowerShell

После создания удаленного сеанса Windows PowerShell на сервере Exchange Server вы можете установить надстройку Outlook, используя командлет New-App и следующую команду PowerShell.

New-App -URL:"http://<fully-qualified URL">

Полный URL-адрес — это расположение подготовленного файла манифеста надстройки.

Используйте следующие дополнительные командлеты PowerShell для управления надстройками для почтового ящика.

Get-App: отображает надстройки, включенные для почтового ящика.
Set-App: включает или отключает надстройку для почтового ящика.
Remove-App: удаляет ранее установленную надстройку с сервера Exchange Server.

Версии клиента

Выбор версии клиента Outlook для тестирования зависит от ваших требований к разработке.

Если вы разрабатываете надстройку для частного использования или только для членов организации, важно протестировать версии Outlook, используемые вашей компанией. Помните, что некоторые пользователи могут использовать Outlook в Интернете, поэтому тестирование стандартных версий браузера вашей компании также важно.
Если вы разрабатываете надстройку для размещения в AppSource, необходимо протестировать версии, указанные в политиках сертификации коммерческой платформы 1120.3. К ним относятся:
- Последнюю и предпоследнюю версии Outlook для Windows.
- Последнюю версию Outlook для Mac.
- Последнюю версию Outlook для iOS и Android (если надстройка поддерживает мобильный формат).
- Версии браузеров, указанные в политике проверки коммерческой платформы Marketplace 1120.3.

Примечание.

Если ваша надстройка не поддерживает один из указанных выше клиентов, так как запрашивает набор обязательных элементов API, не поддерживаемый клиентом, его тестировать не нужно.

Outlook в Интернете и версии Exchange Server

Потребители и пользователи учетной записи Microsoft 365 видят современную версию интерфейса при обращении к Outlook в Интернете и больше не видят классическую версию, поддержка которой прекращена. Однако локальные серверы Exchange Server продолжают поддерживать классическую версию Outlook в Интернете. Поэтому во время проверки ваша отправка может получить предупреждение о том, что надстройка несовместима с классической версией Outlook в Интернете. В этом случае рекомендуется проверить надстройку в локальной среде Exchange. При этом предупреждение не блокирует отправку в AppSource, но для ваших пользователей могут быть ограничены возможности, если они используют Outlook в Интернете в локальной среде Exchange.

Чтобы устранить эту проблему, рекомендуем проверить надстройку в Outlook в Интернете, подключенном к собственной приватной локальной среде Exchange. Дополнительные сведения см. в руководстве о том, как создать тестовую среду Exchange 2016 или Exchange 2019, и о том, как управлять Outlook в Интернете в Exchange Server.

Вы также можете выбрать вариант с оплатой и использовать службу, размещающую локальные серверы Exchange Server и управляющую ими. Несколько вариантов:

Кроме того, если вы не хотите, чтобы ваши надстройки были доступны для пользователей, подключенных к локальной среде Exchange, вы можете настроить для набора обязательных элементов в манифесте надстройки версию 1.6 или более позднюю. Такие надстройки не будут проверяться в классическом интерфейсе Outlook в Интернете.

См. также

Устранение ошибок, с которыми сталкиваются пользователи при работе с надстройками Office

Share via