События
Мощная конференция разработчиков и хак вместе
12 февр., 23 - 28 февр., 23
Присоединяйтесь к онлайн-конференции и 2-недельным хакатоном, чтобы изучить создание мощных решений с помощью Power Platform.
ЗарегистрироватьсяЭтот браузер больше не поддерживается.
Выполните обновление до Microsoft Edge, чтобы воспользоваться новейшими функциями, обновлениями для системы безопасности и технической поддержкой.
Этот процесс предназначен как для проверенных, так и для независимых издателей.
По завершении разработки пользовательского соединителя и/или подключаемого модуля выполните приведенные ниже шаги, чтобы подготовить его к сертификации и создать файлы соединителя и/или подключаемого модуля для отправки в корпорацию Майкрософт.
Примечание
В этой статье представлена информация для сертификации пользовательских соединителей в Azure Logic Apps, Power Automate и Power Apps, а также подключаемых модулей в Copilot. Перед выполнением шагов в этой статье прочтите статью Сертификация соединителя и/или подключаемого модуля.
Этот раздел не относится к проверенным издателям.
Чтобы подать заявку на сертификацию, не обязательно завершать разработку пользовательского соединителя и/или подключаемого модуля. Чтобы начать процесс сертификации, зарегистрируйте свой соединитель и/или подключаемый модуль для сертификации, заполнив нашу форму регистрации.
В течение двух рабочих дней вы получите сообщение электронной почты от контактного лица Майкрософт, который:
Чтобы поддерживать высокий стандарт качества и согласованности среди наших сертифицированных соединителей, у Microsoft есть ряд требований и рекомендаций, которых должен придерживаться ваш пользовательский соединитель для сертификации.
Название должно удовлетворять следующим требованиям.
Connector and/or plugin Name (Independent Publisher)
.Примеры
Azure Sentinel*, *Office 365 Outlook
Azure Sentinel's Power Apps Connector
, Office 365 Outlook API
Описание должно удовлетворять следующим требованиям.
Этот раздел не относится к независимым издателям.
<icon>.png
.Сводки и описания должны удовлетворять следующим требованиям.
Отклики на операции должны удовлетворять следующим требованиям.
Свойства должны удовлетворять следующим требованиям.
Параметры должны удовлетворять следующим требованиям.
Убедитесь, что свойство обновлено соответствующими значениями для "UIDefinition" (отображаемое имя, описание).
Если в параметре подключения используется обычная проверка подлинности, убедитесь, что JSON имеет правильный формат, как показано в следующем примере.
{
"username": {
"type": "securestring",
"uiDefinition": {
"displayName": "YourUsernameLabel",
"description": "The description of YourUsernameLabel for this api",
"tooltip": "Provide the YourUsernameLabel tooltip text",
"constraints": {
"tabIndex": 2,
"clearText": true,
"required": "true"
}
}
},
"password": {
"type": "securestring",
"uiDefinition": {
"displayName": "YourPasswordLabel",
"description": "The description of YourPasswordLabel for this api",
"tooltip": "Provide the YourPasswordLabel tooltip text",
"constraints": {
"tabIndex": 3,
"clearText": false,
"required": "true"
}
}
}
}
Если в параметре подключения используется APIKey для проверки подлинности, убедитесь, что JSON имеет правильный формат, как показано в следующем примере.
{
"api_key": {
"type": "securestring",
"uiDefinition": {
"displayName": "YourApiKeyParameterLabel",
"tooltip": "Provide your YourApiKeyParameterLabel tooltip text",
"constraints": {
"tabIndex": 2,
"clearText": false,
"required": "true"
}
}
}
}
Если в параметре подключения используется универсальный протокол OAuth для проверки подлинности, убедитесь, что JSON имеет правильный формат, как показано в следующем примере.
{
"token": {
"type": "oAuthSetting",
"oAuthSettings": {
"identityProvider": "oauth2",
"scopes": [
"scope1"
],
"redirectMode": "GlobalPerConnector",
"customParameters": {
"AuthorizationUrl": {
"value": "https://contoso.com"
},
"TokenUrl": {
"value": "https://contoso.com"
},
"RefreshUrl": {
"value": "https://contoso.com"
}
},
"clientId": "YourClientID"
},
"uiDefinition": null
}
}
Если в параметре вашего соединения указан поставщик удостоверений OAuth2, убедитесь, что этот поставщик удостоверений входит в список поддерживаемых поставщиков OAuth2. Ниже приведен пример поставщика удостоверений OAuth2 в GitHub:
{
"token": {
"type": "oAuthSetting",
"oAuthSettings": {
"identityProvider": "github",
"scopes": [
"scope1"
],
"redirectMode": "GlobalPerConnector",
"customParameters": {},
"clientId": "YourClientId"
},
"uiDefinition": null
}
}
Если в параметре подключения в качестве механизма проверки подлинности используется Microsoft Entra ID, убедитесь, что JSON имеет правильный формат, как показано в следующем примере.
{
"token": {
"type": "oAuthSetting",
"oAuthSettings": {
"identityProvider": "aad",
"scopes": [
"scope1"
],
"redirectMode": "GlobalPerConnector",
"customParameters": {
"LoginUri": {
"value": "https://login.microsoftonline.com"
},
"TenantId": {
"value": "common"
},
"ResourceUri": {
"value": "resourceUri"
},
"EnableOnbehalfOfLogin": {
"value": false
}
},
"clientId": "AzureActiveDirectoryClientId"
},
"uiDefinition": null
}
}
Соединители локализуются в составе локализации Power Automate; поэтому, когда вы разрабатываете соединитель, качество строк на английском языке является ключом к качеству перевода. Вот несколько основных областей, на которых следует сосредоточиться при создании значений строк, которые вы предоставляете.
Чтобы убедиться, что все значения строк не содержат опечаток, выполните программу проверки орфографии. Если есть какая-либо неполная строка на английском языке, результат перевода является неполным или неверным в контексте.
Убедитесь, что предложение составлено полностью. Если предложение не закончено, это также может привести к снижению качества перевода.
Убедитесь, что смысл предложения ясен. Если значение предложения неоднозначно, это также может привести к снижению качества или неправильному переводу.
Убедитесь, что сводки, x-ms-summaries и описания грамматически правильны. Не копируйте и не вставляйте их. Чтобы узнать, как они отображаются в продукте, перейдите в раздел Руководство по строкам соединителя.
По возможности избегайте составных строк среды выполнения. Вместо этого используйте полностью сформированные предложения. Составные строки или предложения затрудняют перевод или могут вызвать неправильный перевод.
Если вы используете сокращения, обязательно пишите их с заглавной буквы, чтобы было понятно. Это снижает вероятность того, что его ошибочно примут за опечатку.
Строки в форме CaMel (например, minimizeHighways или MinimizeHighways) обычно считаются непереводимыми. Если вы хотите локализовать строковое значение, вы должны исправить строку формы CaMel.
Средство проверки решений — это механизм проведения статического анализа, позволяющий убедиться, что ваш соединитель соответствует стандартам, требуемым Microsoft для сертификации. Добавьте соединитель в решение в Power Automate или Power Apps и выполните проверку решение, следуя инструкциям в разделе Проверка пользовательского соединителя с помощью средства проверки решения.
Посмотрите это видео, чтобы узнать, как запустить средство проверки решений.
Артефакты (файлы) соединителя должны содержать конкретные метаданные, описывающие соединитель и его конечную службу. Информация, представленная в метаданных, опубликована в нашей документации по соединителю и доступна всем пользователям. Не предоставляйте какую-либо личную или конфиденциальную информацию и сообщите нам через контактное лицо в Microsoft, если возникнут какие-либо проблемы с предоставлением нам этой информации. Чтобы узнать, как метаданные документируются, посетите любую из страниц документации по соединителю в разделе Справочное руководство по соединителям.
Издатель | Описание | Пример |
---|---|---|
Проверено | Издатель и stackOwner являются одними и теми же, если только независимый поставщик программного обеспечения не создает соединитель от имени stackOwner. | "publisher": "Tesla", "stackOwner": "Tesla" |
Независимый | Вы должны указать владельца стека и владельца издателя. | "publisher": "Nirmal Kumar", "stackOwner": "ITGlue" |
Расположение файла: openapidefinition.json
Синтаксис: Свойства publisher и stackOwner существуют как свойства верхнего уровня в файле openapidefinition.json. Добавьте следующие выделенные строки, как показано. Убедитесь, что вы вводите имя свойства и схему точно так, как показано.
Код, показывающий блок, определяющий объект "контакт", выделен красным. Этот блок должен располагаться непосредственно под описанием. Другой блок, x-ms-connector-metadata, также выделен красным. Этот блок должен располагаться непосредственно под путями: {}.
Вы можете использовать следующие фрагменты кода, чтобы скопировать и ввести свою информацию. Убедитесь, что вы добавляете фрагменты в правильные файлы и в правильные места, как описано в предыдущем разделе.
"publisher": "_____",
"stackOwner": "_____"
"contact": {
"name": "_____",
"url": "_____",
"email": "_____"
}
"x-ms-connector-metadata": [
{
"propertyName": "Website",
"propertyValue": "_____"
},
{
"propertyName": "Privacy policy",
"propertyValue": "_____"
},
{
"propertyName": "Categories",
"propertyValue": "_____;_____"
}
]
Примечание
В настоящее время существует ограничение на использование свойства stackOwner и инструмента интерфейса командной строки Paconn. Подробнее читайте в разделе Ограничения в файле README.
Убедитесь, что ваши свойства правильно настроены.
Вставьте свой JSON в Visual Studio Code. Не стесняйтесь использовать расширения, такие как средства проверки орфографии, и подключаемые модули, такие как подключаемые модули JSON.
Файлы Swagger не должны превышать 1 МБ.
Например, на платформе есть три (3) разных соединителя HubSpot.
Этот раздел применим, если вы также отправляете связанный подключаемый модуль соединителя на сертификацию.
Примечание
Вы отправляете в Microsoft набор файлов, представляющий собой генерацию решения с портала maker или Microsoft Copilot Studio. Чтобы упаковать файлы, следуйте инструкциям в этом разделе.
Процедуры, описанные в этом разделе, помогут вам разобраться в различных сценариях упаковки. Если вы хотите упаковать только специальный соединитель, используйте первый сценарий. Если вы хотите упаковать как пользовательский коннектор , так и плагины, используйте второй сценарий. Если вы хотите упаковать существующий коннектор и плагины, используйте последний сценарий.
Запустите средство проверки решений в решении соединителя на шаге 1.
Экспортируйте решение соединителя.
Создайте поток (тестирование) с помощью нового созданного пользовательского соединителя и добавьте поток в решение.
Экспортируйте решение потока.
Создайте пакет с решениями из шагов 3 и 5.
Создайте окончательный пакет в виде ZIP-файла в следующем формате:
Примечание
The names of the folder and files outside the solution are only for reference—you can choose as per your requirements. However, don't manipulate the files inside the solution.
Выполните шаги с 1 по 5 в разделе Упаковка пользовательского соединителя и его отправка на сертификацию этой статьи.
Создайте подключаемый модуль на портале Microsoft Copilot Studio и экспортируйте его как решение.
Создайте пакет из следующего:
Создайте окончательный пакет в виде ZIP-файла в следующем формате.
Примечание
The names of the folder and files outside the solution are only for reference—you can choose as per your requirements. However, don't manipulate the files inside the solution.
Создайте решение в Power Automate и добавьте уже сертифицированный соединитель в него.
Выполните шаги с 2 по 4 в разделе Упаковка пользовательского соединителя и его отправка на сертификацию этой статьи.
Создайте подключаемый модуль в Copilot Studio и экспортируйте его как решение.
Экспортируйте подключаемый модуль как решение.
Создайте пакет из следующего:
Создайте окончательный пакет в виде ZIP-файла в следующем формате.
Примечание
The names of the folder and files outside the solution are only for reference—you can choose as per your requirements. However, don't manipulate the files inside the solution.
Как проверенные, так и независимые издатели загружают openapidefinition.json
свои артефакты. Вам нужно установить IconBrandColor в этом файле.
Файл intro.md необходим как для независимых, так и для проверенных издателей. Файл intro.md необходимо создать, чтобы задокументировать функции и возможности вашего соединителя. Чтобы получить пример документации, которую нужно включить, перейдите в пример Readme.md. Чтобы узнать о написании файла intro.md, посмотрите другие файлы intro.md (также называемые файлы Readme.md) в нашем репозитории GitHub.
Если вы являетесь независимым издателем и ваш соединитель использует OAuth, обязательно включите инструкции по получению учетных данных.
Совет
Известные проблемы и ограничения — это отличный раздел, который нужно поддерживать, чтобы держать ваших пользователей в курсе последних событий.
Скрипт проверки пакета проверяет структуру пакета и помогает вам сгенерировать пакет в приемлемом формате для сертификации. Загрузите скрипт валидатора пакетов по этой ссылке: ConnectorPackageValidator.ps1.
Чтобы запустить скрипт, выполните следующие действия:
Откройте Windows PowerShell в режиме администратора.
Измените местоположение диска, введя cd /
.
В следующем примере используется C:\
.
Перейдите по пути, куда вы скачали скрипт валидатора пакетов.
Например, если путь C:\Users\user01\Downloads
, введите cd .\Users\user01\Downloads\
.
Установите политику выполнения на «без ограничений», введя следующую команду:
Set-ExecutionPolicy -ExecutionPolicy Unrestricted
Эта команда позволяет запускать PowerShell без каких-либо ограничений.
Подтвердите свой ввод, введя Y, что означает Да.
Выполните ConnectorPackageValidator.ps1, выполнив следующие шаги:
Как показано в следующем примере, первый аргумент — это допустимый путь к ZIP-файлу, содержащему пакет. Второй аргумент yes
/y
указывает, что подключаемый модуль ИИ включен, или no
/n
указывает, что он отключен.
Если структура пакета правильная, отобразится следующее сообщение об успешном завершении:
Если возникает проблема со структурой пакета, скрипт предоставляет подробную информацию о проблеме, обнаруживая и выделяя дефекты в структуре пакета.
В процессе отправки вы отправите открытый код своего соединителя и/или подключаемого модуля в наш репозиторий соединителей Microsoft Power Platform.
(Для независимых издателей) Чтобы отправить пакет в Майкрософт на сертификацию, следуйте инструкциям в разделе Процесс сертификации для независимых издателей.
(Для проверенных издателей) Чтобы отправить пакет в Майкрософт на сертификацию в Центр партнеров, следуйте инструкциям в разделе Процесс сертификации проверенных издателей.
Если вы являетесь проверенным издателем, вам необходимо отправить файл script.csx, если вы используете собственный код.
Если ваш соединитель поддерживает OAuth, отправьте идентификатор клиента и секрет в Центр партнеров. Кроме того, получите имя API из запроса на отправку соединителя, чтобы обновить приложение.
В рамках отправки Майкрософт сертифицирует ваш соединитель и/или подключаемый модуль. Если вам нужно устранить ошибки Swagger, перейдите в Исправление ошибок средства проверки Swagger.
Прежде чем перейти к Отправьте соединитель на сертификацию Microsoft, обеспечьте следующее:
Ваш соединитель и/или подключаемый модуль соответствует всем стандартам, установленным в разделах Шаг 2. Выполните требования к отправке соединителей, Шаг 5. Выполните требования к отправке подключаемых модулей и Шаг 4. Добавьте метаданные.
Для всех операций есть сводка, описание или информация о видимости.
Вы протестировали свой пользовательский соединитель и/или подключаемый модуль, чтобы убедиться, что операции работают должным образом (не менее 10 успешных вызовов на операцию).
Ошибки времени выполнения или проверки схемы не появляются в тестовом разделе мастера пользовательского соединителя.
Совет
События
Мощная конференция разработчиков и хак вместе
12 февр., 23 - 28 февр., 23
Присоединяйтесь к онлайн-конференции и 2-недельным хакатоном, чтобы изучить создание мощных решений с помощью Power Platform.
ЗарегистрироватьсяОбучение
Модуль
Create a certified or independent publisher connector for Microsoft Power Platform - Training
Learn how to make your certified or independent publisher connector available to all users in Microsoft Power Platform GitHub repository.
Сертификация
Microsoft Certified: Power Platform Developer Associate - Certifications
Узнайте, как упростить, автоматизировать и преобразовать бизнес-задачи и процессы с помощью разработчика Microsoft Power Platform.