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

Подготовьте и отправьте соединитель на сертификацию

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

Заметка

Эта статья предоставляет информацию для сертификации пользовательских соединителей в Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps и их использования в Microsoft Copilot Studio. Перед выполнением шагов в этой статье, ознакомьтесь со статьей Сертификация соединителя.

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

Предварительные требования

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

Шаг 1: Убедитесь, что соединитель еще не собран

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

Используйте эту таблицу, чтобы узнать, что можно делать с соединителем в зависимости от его состояния:

Если предлагаемый вами соединитель: Вариант:
Уже существует для Copilot Studio и Power Platform. Вы не можете построить соединитель.
Уже существует как соединитель независимого издателя. Вы можете добавить дополнительные функции к соединителю.
В настоящее время является запросом на вытягивание и предложением. Вы можете связаться с независимым издателем для совместной работы над соединителем.
В настоящее время является запросом на вытягивание и не является предложением. Подождите, пока соединитель не будет сертифицирован и развернут. Затем добавьте обновление к этому соединителю.

Шаг 2: Поделитесь предложением соединителя с Microsoft

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

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

  • Назовите запрос на вытягивание Предложение - Имя соединителя (Независимый издатель). Например: Proposal - HubSpotCRM (Independent Publisher).
  • Зафиксируйте файл intro.md с как можно большим количеством сведений. Если вы готовы найти соавтора, укажите свой контактный адрес электронной почты.

Примечание.

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

Шаг 3. Разработайте соединитель

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

Ознакомьтесь со всеми шагами, описанными в статье Подготовка файлов соединителей для сертификации.

Шаг 4. Отправка артефактов соединителя

Когда вы будете готовы отправить артефакты соединителя на проверку, сертификацию и развертывание Microsoft, убедитесь, что:

  • Отправьте артефакты соединителя в запрос на вытягивание, созданный на шаге 2.
  • Заполните контрольный список в шаблоне запроса на вытягивание.
  • Удалите Proposal - из заголовка запроса на вытягивание.

Шаг 5: Пройдите процесс проверки и сертификации соединителя

После отправки соединителя на проверку вы можете ожидать ответа от инженера по сертификации Microsoft в течение 1–2 недель.

  • Если в отзыве требуется обновление соединителя, отправьте обновление напрямую в свой исходный запрос на вытягивание. Выделите для этого еще 1–2 недели. Возможно, потребуется исправить ошибки проверки Swagger.
  • Во время этого процесса роль владельца соединителя останется за вами, и вы сможете принимать или отклонять любые изменения в нем.
  • После того как Microsoft утвердит и объединит запрос на вытягивание, соединитель пройдет сертификацию. Во время процесса сертификации ваше контактное лицо Microsoft свяжется с вами в течение 1–2 недель.
  • Когда ваш соединитель завершит сертификацию, мы также обсудим с вами маркетинговую возможность для вашего соединителя в блоге Power Automate.

Шаг 6. Ожидайте развертывания соединителя

После завершения процесса проверки и сертификации Microsoft подготавливает и развертывает файлы сертифицированных соединителей в регионе предварительной версии. Регион предварительной версии позволяет протестировать соединитель после сертификации для развертывания и подтвердить ввод в эксплуатацию для Microsoft. Тестовая среда предварительной версии доступна только в течение двух дней.

Внимание!

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

  • Графики развертывания: графики развертывания соединителей для производства начинаются в пятницу утром по тихоокеанскому времени. Заранее сообщите своему контактному лицу в Microsoft как минимум за 24 часа, когда вы будете готовы к производственному развертыванию, чтобы ваш соединитель был включен в следующее запланированное развертывание.

  • Развертывание в регионе: Microsoft уведомляет вас по электронной почте с указанием названий регионов, в которых развертывается соединитель, поскольку развертывание в регионах выполняется поэтапно. В случае задержки или зависания развертывания вы получите уведомление по электронной почте. Дополнительные сведения см. в разделе Развертывание в регионе.

Следуйте рекомендациям по отправке

Следуйте передовым методам для успешной отправки соединителя:

  • Отправляйте только один соединитель для каждого запроса на вытягивание, чтобы обеспечить бесперебойную работу процесса проверки.
  • Следуйте шаблону Connector Name (Independent Publisher)в запросе на вытягивание соединителя.
  • Добавьте свой адрес электронной почты в раздел электронной почты поддержки. Это на случай, если нам понадобится с вами связаться.
  • Укажите в параметре политики конфиденциальности политику конфиденциальности для конечной службы.
  • Составьте подробное описание операции, чтобы пользователи могли понять вашу операцию.
  • Если ваш соединитель использует OAuth, предоставьте подробные инструкции по созданию приложения в вашем readme.md. Если вы этого не сделаете, сертификация будет отложена. Чтобы получить пример документации, которую нужно включить, см. пример Readme.md.
  • Добавьте схемы ответа к своим действиям, если схема ответа не является динамической. Это поможет соединителю чаще использоваться.
  • Проверьте Контрольный список перед отправкой.

Гарантии Microsoft

Microsoft обязуется соблюдать следующие гарантии:

  • Если есть обновление соединителя, мы снова запустим инструмент критических изменений и все другие инструменты проверки.​
  • Если для соединителя нет обновлений, мы гарантируем, что он работает, за исключением случаев изменения или обновления API или проблем с платформой.​
  • При наличии каких-либо проблем платформы и безопасности, Microsoft изучит их по мере возникновения и откажется от сломанных соединителей независимых издателей.​

Следующий шаг

Перемещение соединителя из предварительной версии в общедоступную (GA)