Параметры описания в Microsoft Marketplace для надстройки на основе событий

Когда вы будете готовы опубликовать надстройку активации на основе событий в Microsoft Marketplace, вы можете указать надстройку как ограниченную или неограниченную. Эта статья поможет вам понять эти варианты перечисления и выбрать правильный подход для вашей надстройки.

Важно!

Надстройки, использующие функцию смарт-оповещений , могут публиковаться в Microsoft Marketplace только в том случае, если свойству режима отправки манифеста задан параметр пользователя илиобратимого блока запроса. Если свойство режима отправки надстройки имеет значение блокировать, оно может быть развернуто только администратором организации, так как оно не пройдет проверку Microsoft Marketplace.

Параметры списка надстроек

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

Перечисление функций Restricted Без ограничений
Поддержка активации на основе событий Надстройка должна быть развернута администратором организации, чтобы функция активации на основе событий работала. Активация на основе событий выполняется сразу после установки пользователем или администратором без необходимости развертывания администратором.
Возможности поиска в магазине Надстройка не поддерживает поиск по имени или идентификатору в Microsoft Marketplace. Пользователи и администраторы должны использовать определенный URL-адрес кода полета для установки надстройки. Надстройка доступна для поиска по имени или идентификатору и отображается в результатах поиска Microsoft Marketplace. Пользователи и администраторы могут установить надстройку непосредственно из магазина.
Необходимые компоненты При публикации надстройки в Microsoft Marketplace необходимо указать код тестирования. Ваша надстройка должна иметь сертификат Microsoft 365 и соответствовать определенным требованиям к использованию.
Поддерживаемые приложения Office
  • Excel
  • Outlook
  • PowerPoint
  • Word
  • Outlook

Чтобы получить дополнительные сведения о том, как добавить надстройку на основе событий как ограниченную или не ограниченную в Microsoft Marketplace, выберите вкладку соответствующего параметра листинга.

Надстройки с ограниченным списком в Microsoft Marketplace должны развертываться администраторами организации, чтобы пользователи пользовались функциями активации на основе событий. Активация на основе событий ограничена, если пользователь приобрел надстройку непосредственно из Microsoft Marketplace. Например, если надстройка Contoso включает функцию на основе событий, автоматический вызов надстройки происходит только в том случае, если надстройка была установлена для пользователя администратором организации. В противном случае автоматический вызов надстройки блокируется.

Чтобы включить это ограничение, можно предоставить URL-адреса кода для надстроек в Microsoft Marketplace. Благодаря коду полетов доступ к списку могут получить только пользователи с этими специальными URL-адресами. Ниже приведен пример URL-адреса.

https://marketplace.microsoft.com/product/office/WA200002862?flightCodes=EventBasedTest1

Если для надстройки включен код полета, ее невозможно найти по имени или идентификатору в Microsoft Marketplace или в магазине Microsoft 365 и Copilot в приложении. Как создатель надстройки вы можете в частном порядке предоставлять доступ к этим кодам тестов с администраторами организации для развертывания надстроек.

Примечание.

Хотя пользователи могут установить надстройку на основе событий с помощью тестового кода, надстройка не будет включать активацию на основе событий. Однако пользователи могут использовать другие компоненты надстройки, например команду области задач или функции.

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

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

Пример запроса на код тестовой версии на экране Примечания для сертификации во время публикации.

Развертывание надстройки с помощью кода тестирования

После установки кодов полета вы получите URL-адрес от группы сертификации приложений. Затем вы можете предоставить доступ к URL-адресу администраторам в частном порядке.

Примечание.

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

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

  1. Войдите в https://admin.microsoft.com или https://marketplace.microsoft.com с помощью учетной записи администратора Microsoft 365. Если в надстройке включен единый вход, потребуются учетные данные глобального администратора.
  2. Откройте URL-адрес кода полета в веб-браузере.
  3. На странице описания надстройки выберите Получить сейчас. Вы должны быть перенаправлены на портал интегрированных приложений.

Обновление существующих надстроек для включения активации на основе событий

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

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

Уведомления об обновлении приложений на экране

Примечание.

Для пользователей, которые установили надстройку, указанную как ограниченная, функция активации на основе событий не будет работать даже после обновления надстройки.

Каждый раз, когда надстройка на основе событий развертывается на экране Интегрированные приложения , администратор получает сведения о возможностях активации надстройки на основе событий в мастере развертывания. Сведения отобразятся в разделе Разрешения и возможности приложения . Администратор должен увидеть все события, в которых надстройка может активироваться автоматически.

Экран

Аналогичным образом, при обновлении существующей надстройки до функциональных возможностей на основе событий администратор видит состояние "Ожидание обновления" в надстройке. Обновленная надстройка развертывается только в том случае, если администратор соглашается на изменения, отмеченные в разделе Разрешения и возможности приложения , включая набор событий, в которых надстройка может активироваться автоматически.

Каждый раз, когда вы добавляете в надстройку новую функцию активации на основе событий, администраторы увидят поток обновлений на портале администрирования и должны предоставить согласие на дополнительные события. Дополнительные сведения о процессе обновления и предоставления согласия см. в статье Управление приложениями на портале интегрированных приложений.

Поток

См. также

  • Last updated on