Обновление сертифицированного соединителя

В этой статье объясняется, как обновить сертифицированные соединители для Microsoft Copilot Studio, Microsoft Power Automate, Microsoft Power Apps и Azure Logic Apps. Перед выполнением этих действий убедитесь, что у вас есть сертифицированный соединитель, выпущенный корпорацией Майкрософт.

Внимание!

  • Если соединитель использует OAuth, регулярно отслеживайте и обновляйте идентификатор клиента и учетные данные секрета клиента, чтобы клиенты могли продолжать использовать соединитель.
  • При обновлении секрета клиента обновите версию swagger.
  • Отправьте обновление соединителя через месяц до истечения срока действия идентификатора клиента и секрета клиента.

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

Также убедитесь, что ваша новая версия соединителя соответствует нашим рекомендациям и требованиям.

Корпорация Майкрософт проверяет обновления и развертывает обновленную версию соединителя. В этой статье описаны критерии для обновлений.

Отправление обновления

Внимание!

Опубликуйте код соединителя как open source до того, как корпорация Майкрософт добавит его на портал сертификации, чтобы уменьшить несоответствия. См. процедуру сертификации проверенного издателя.

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

  2. (Для проверенных издателей) Когда артефакты нового соединителя будут готовы, перейдите в Центр партнеров.

    Ваши артефакты должны быть уже отправлены в Центр партнеров в рамках программы Microsoft 365 и Copilot. Откройте то же предложение и обновите соответствующую вкладку в обзоре продукта.

    Ранее вы должны были представить артефакты в Центре партнеров Microsoft 365 и в программе Copilot. Снова откройте то же предложение и обновите соответствующую вкладку в разделе Обзор продукта предложения.

  3. Не создавайте новое предложение для обновления существующего сертифицированного соединителя.

  4. После отправки артефактов корпорация Майкрософт сертифицирует новую версию и отправляет ее обратно на тестирование. Протестируйте соединитель, как вы сделали для первой версии.

    Дополнительные сведения см. в статье "Тестирование соединителя в сертификации". Подтвердите публикацию активации в Центре партнеров, и Майкрософт развернет ваш соединитель.

    Внимание!

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

    Подробнее см. в производственном графике.

Уведомление клиентов о критических изменениях

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

Сохраните более ранние apiProperties.json версии ConnectionParameters при переходе на многопотоковую проверку подлинности, ConnectionParameterSets чтобы существующие подключения не прерывались.

Многие сценарии обновления могут привести к критическим изменениям. Ниже приведены распространенные примеры.

Имя Description
МетодАутентификацииУдален Не удаляйте существующие методы проверки подлинности. Изменение типа проверки подлинности соединителя в обновлении запрещено.
Параметры подключения удалены Не удаляйте параметры подключения поля. Это изменение может нарушить работу существующих потоков, поскольку в их подключениях это поле все еще используются.
УдаленоПолеВвода Поле ввода удаляется.
InputFieldVisibilityChangedToInternal Видимость поля ввода изменяется на внутреннюю. Это изменение может привести к замене существующих значений на значение по умолчанию или к удалению существующих значений для текущих потоков после обновления.
OperationDeleted Операция удаляется. Это изменение может нарушить существующие потоки.
OperationHidden Операция скрыта. Это изменение может нарушить работу конструктора для существующих потоков.
ПолеВыходныхДанныхДобавляетсяПриОграничении Поле вывода добавляется, если дополнительные свойства не допускаются. Это изменение может нарушить проверку существующих потоков.
Выходное_полеИзмененоНаНеобязательноеИзОбязательного Поле вывода изменяется с обязательногона необязательное. Это изменение может нарушить работу существующих потоков, в которых используется это поле.
ВыходноеПолеУдалено Поле вывода удаляется. Это изменение может нарушить работу существующих потоков, если в них используется это поле, и фактическая полезная нагрузка меняется.
ИзменёнТипПоляВыходныхДанных Тип изменяется для поля вывода. Это изменение может нарушить существующие потоки, если они используют это поле и действительная нагрузка изменяется.
OutputFieldTypeFormatChanged Изменился формат типа для поля выходных данных. Это изменение может нарушить работу существующих потоков, если в них используется это поле, и фактическая полезная нагрузка меняется.
OutputSchemaRemoved Определение выходной схемы удаляется. Это изменение может нарушить работу существующих потоков, в которых используются эти выходные данные, и фактическая полезная нагрузка меняется.
ParameterVisibilityChangedToInternal Видимость изменяется на внутреннюю для параметра. Это изменение может привести к замене существующих значений на значение по умолчанию или к удалению существующих значений для текущих потоков после обновления.
ЗаголовокОтветаУдалён Заголовок ответа удален. Это изменение может нарушить работу существующих потоков, в которых используется этот заголовок, и фактическая полезная нагрузка меняется.
ТипЗаголовкаОтветаИзменён Тип заголовка ответа изменен. Это изменение может нарушить работу существующих потоков, в которых используется этот заголовок, и фактическая полезная нагрузка меняется.
ФорматТипаЗаголовкаОтветаИзменён Формат типа заголовка ответа изменен. Это изменение может нарушить существующие потоки, использующие этот заголовок, потому что полезная нагрузка была изменена.
Уровень изменен на Премиум Уровень соединителя меняется на Premium. Это изменение означает, что клиенты с бесплатными планами больше не могут использовать соединитель.

Убедитесь, что вы подробно описали все обновления соединителя и критические изменения (если они есть) в файле intro.md своего пакета сертификации. Общедоступная документация, созданная из файла intro.md, помогает сообщить клиентам о критических изменениях. Дополнительные сведения см. в разделе "Создание артефакта intro.md".

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

  • Last updated on