Зарегистрируйте ваш соединитель с помощью панели разработчиков соединителей Office

  • Статья

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

Создание собственного соединителя

Регистрация соединителя

Перейдите на портал разработчика соединителя и войдите с учетными данными Microsoft 365. Если у вас нет клиента Microsoft 365, вы можете претендовать на него в рамках Программы разработчиков Microsoft 365. Дополнительные сведения см. в разделе Вопросы и ответы. Кроме того, вы можете зарегистрироваться для получения бесплатной пробной версии на 1 месяц или приобрести план Microsoft 365.

Выберите пункт New Connector (Создать соединитель) и заполните форму. После нажатия кнопки Save (Сохранить) новые параметры отобразятся на странице.

  • Кнопка Sideload to Outlook (Загрузка неопубликованного соединителя в Outlook) временно добавит ваш соединитель в интерфейс Outlook для вошедшего в систему пользователя. Этот пользователь сможет настроить соединитель в своей папке "Входящие" или в любой группе, участником которой он является.
  • Кнопка Publish to Store (Опубликовать в Магазине) запустит процесс публикации, в том числе проверку корпорацией Майкрософт на размещение в Магазине.

Добавление встроенного интерфейса настройки

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

Дополнительные сведения см. в статье Интеграция интерфейса настройки.

Примечание.

Документ Интеграция интерфейса настройки относится к Microsoft Teams, но описанные в нем методы работают аналогично в Outlook.

Требования к настройке, характерные для Outlook

Если для настройки необходима проверка подлинности, существуют дополнительные требования, чтобы включить поток проверки подлинности в Outlook для Windows.

Outlook для Windows передает дополнительный параметр запроса для начальной страницы проверки подлинности соединителей.

callbackUrl=<connectors url>

Ваше приложение должно сохранить это значение и передать его в виде дополнительного параметра для методов microsoftTeams.authentication.notifySuccess или microsoftTeams.authentication.notifyFailure после завершения проверки подлинности.

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

Публикация соединителя в Магазине

После тщательного тестирования соединителя и его готовности к добавлению в каталог соединителей Office можно отправить на проверку с помощью кнопки Опубликовать в Магазине . После проверки и утверждения соединитель будет добавлен в каталог соединителей.

Контрольный список для отправки соединителя

  • Перед отправкой в Store убедитесь, что ваш соединитель полностью функционален и тщательно протестирован.
  • Проверьте карточки соединителей в различных клиентах, в которых пользователи будут их применять: Outlook в Интернете, Outlook 2016 и более поздних версиях и мобильных приложениях Outlook Groups.
  • Убедитесь, что для оформления текста используется строго Markdown, а в полезные данные карточки соединителя не отправляется HTML.
  • Придерживайтесь меры при добавлении возможностей, чтобы не перегрузить ими. Пользователь не должен увязнуть в слишком большом количестве уведомлений.
  • Определите нужные события, для которых будут отправляться карточки соединителя. Убедитесь, что информация, оправляемая группе, полезна для ее членов.
  • При отправке отчетов или сводок используйте формат дайджеста и позвольте пользователю выбрать время и частоту их получения.
  • При отправке карточек соединителя для выделения их важных частей эффективно используйте Markdown.
  • Обеспечьте возможность выполнять определенные действия в связи с карточками соединителя там, где это допустимо.
  • Процент сбоев вызываемых действий должен быть очень низким, соответствующий отклик от конечной точки — быстрым.
  • Предусмотрите для пользователей возможность приостановки или удаления конфигурации.
  • Подготовьте понятную документацию для пользователей, описывающую возможности соединителей.
  • При регистрации соединителя:
    • Убедитесь, что использование имени и логотипа вашего соединителя не нарушает авторские права или права на товарные знаки, связанные с другими продуктами или службами.
    • Предоставьте высококачественный логотип в формате JPG, JPEG, PNG или GIF размером не более 60 КБ.
    • Предоставьте краткое описание приложения (например, "Contoso Help Desk сближает компании и клиентов").
    • Предоставьте подробное описание соединителя (например, "Соединитель Contoso Help Desk уведомляет вашу группу Office 365 о действиях, связанных с запросами клиентов в службу поддержки").
  • При публикации соединителя в Магазине:
    • Не забудьте предоставить пошаговые инструкции и сведения о тестовой учетной записи, чтобы мы могли протестировать соединитель.

Дальнейшие действия

  • Если у вас возникли вопросы, проблема с кодом или вам нужна помощь, задайте вопрос сообществу разработчиков на сайте Microsoft Q&A.
  • Вы также можете опубликовать свой вопрос или проблему на сайте Stack Overflow. Поставьте вопросу тег в соответствии со связанной технологией:
  • Если вы хотите предложить функцию, опубликуйте свою идею на нашем форуме идей платформы разработчиков Microsoft 365 и проголосуйте за свое предложение.