Параметры описания AppSource для надстройки Outlook на основе событий
Надстройки должны быть развернуты администраторами организации, чтобы конечные пользователи пользовались функцией активации на основе событий . Активация на основе событий ограничена, если пользователь получил надстройку непосредственно из AppSource. Например, если надстройка Contoso включает функцию на основе событий, автоматический вызов надстройки происходит только в том случае, если надстройка была установлена для конечного пользователя администратором организации. В противном случае автоматический вызов надстройки блокируется.
Конечный пользователь или администратор может приобретать надстройки через AppSource или в microsoft 365 и Магазине Copilot в приложении. Если основной сценарий или рабочий процесс надстройки требует активации на основе событий, может потребоваться ограничить надстройку только развертыванием администрирования. Чтобы включить это ограничение, можно предоставить URL-адреса кода для тестового кода для надстроек в AppSource. Благодаря кодам полетов доступ к списку могут получить только пользователи с этими специальными URL-адресами. Ниже приведен пример URL-адреса.
https://appsource.microsoft.com/product/office/WA200002862?flightCodes=EventBasedTest1
Пользователи и администраторы не могут явным образом искать надстройку по ее имени в AppSource или в хранилище Microsoft 365 и Copilot в приложении, когда для нее включен код полета. Как создатель надстройки вы можете в частном порядке предоставлять доступ к этим кодам тестов с администраторами организации для развертывания надстроек.
Примечание.
Хотя конечные пользователи могут установить надстройку с помощью тестового кода, надстройка не будет включать активацию на основе событий.
Важно!
Надстройки, использующие функцию смарт-оповещений , могут публиковаться в AppSource только в том случае, если свойству режима отправки манифеста задан параметр "пользователь с запросом " или параметром обратимого блока . Если свойство режима отправки надстройки имеет значение блокировать, оно может быть развернуто только администратором организации, так как оно не пройдет проверку AppSource.
Указание кода тестовой проверки
Чтобы указать код для вашей надстройки, поделитесь кодом в заметках для сертификации при публикации надстройки. Важно! Коды полетов чувствительны к регистру.
Развертывание надстройки с помощью кода тестирования
После установки кодов полета вы получите URL-адрес от группы сертификации приложений. Затем вы можете предоставить доступ к URL-адресу администраторам в частном порядке.
Чтобы развернуть надстройку, администратор может выполнить следующие действия.
- Войдите в admin.microsoft.com или AppSource.com с учетной записью администратора Microsoft 365. Если в надстройке включен единый вход, потребуются учетные данные глобального администратора.
- Откройте URL-адрес кода полета в веб-браузере.
- На странице описания надстройки выберите Получить сейчас. Вы должны быть перенаправлены на портал интегрированных приложений.
Неограниченный список AppSource
Если надстройка не использует активацию на основе событий для критических сценариев (то есть надстройка хорошо работает без автоматического вызова), рассмотрите возможность добавления надстройки в AppSource без специальных кодов тестирования. Если пользователь получает надстройку из AppSource, автоматическая активация для пользователя не будет выполнена. Однако они могут использовать другие компоненты надстройки, например область задач или команду функции.
Важно!
Это временное ограничение. В будущем мы планируем включить активацию надстройки на основе событий для конечных пользователей, которые напрямую получают надстройку.
Обновление существующих надстроек для включения активации на основе событий
Вы можете обновить существующую надстройку, чтобы включить активацию на основе событий, а затем повторно отправить ее для проверки и решить, хотите ли вы получить ограниченный или неограниченный список AppSource.
После утверждения обновленной надстройки администраторы организации, которые ранее развернули надстройку, получат сообщение об обновлении в разделе Интегрированные приложения Центра администрирования. В этом сообщении администратору сообщается об изменениях активации на основе событий. После того как администратор примет изменения, обновление будет развернуто для конечных пользователей. Дополнительные сведения о процессе предоставления согласия администратора см. в разделе Администратор согласия на установку надстроек на основе событий.
Для пользователей, которые установили надстройку самостоятельно, функция активации на основе событий не будет работать даже после обновления надстройки.
Администратор согласие на установку надстроек на основе событий
Каждый раз, когда надстройка на основе событий развертывается с экрана интегрированных приложений , администратор получает сведения о возможностях активации надстройки на основе событий в мастере развертывания. Сведения отобразятся в разделе Разрешения и возможности приложения . Администратор должен увидеть все события, в которых надстройка может активироваться автоматически.
Аналогичным образом, при обновлении существующей надстройки до функциональных возможностей на основе событий администратор видит состояние "Ожидание обновления" в надстройке. Обновленная надстройка развертывается только в том случае, если администратор соглашается на изменения, отмеченные в разделе Разрешения и возможности приложения , включая набор событий, в которых надстройка может активироваться автоматически.
Каждый раз, когда вы добавляете в надстройку новую функцию активации на основе событий, администраторы увидят поток обновлений на портале администрирования и должны предоставить согласие на дополнительные события. Дополнительные сведения о процессе обновления и предоставления согласия см. в статье Управление приложениями на портале интегрированных приложений.
См. также
Office Add-ins