Compartilhar via


Atualizar seu conector certificado

Este artigo explica como atualizar conectores certificados para Microsoft Copilot Studio, Microsoft Power Automate, Microsoft Power Apps e Aplicativos Lógicos do Azure. Verifique se você tem um conector certificado liberado com a Microsoft antes de seguir estas etapas.

Para atualizar o conector certificado, envie um novo conjunto de artefatos do conector para certificação. Siga as mesmas instruções que você usou quando certificou o seu conector pela primeira vez.

Além disso, verifique se a nova versão do conector ainda respeita diretrizes e requisitos.

A Microsoft analisa suas atualizações e implanta a versão atualizada do conector. Este artigo descreve os critérios para atualizações.

Enviar uma atualização

Importante

Abra o conector antes que a Microsoft o adicione ao portal de certificação para reduzir as inconsistências. Consulte o processo de certificação do editor verificado.

  1. Verifique se você atende aos requisitos de envio antes de enviar sua atualização. Caso contrário, o processo de atualização poderá ser adiado.

  2. (Para editores verificados) Quando os novos artefatos do conector estiverem prontos, vá para o Partner Center.

    Você precisa já ter enviado artefatos para o Partner Center no Microsoft 365 e no Copilot Program. Reabra a mesma oferta e atualize a guia relevante na Visão Geral do Produto.

    Você deve ter enviado artefatos anteriormente para o Partner Center no Microsoft 365 e no Copilot Program. Reabra a mesma oferta e atualize a guia relevante em Visão Geral do Produto da oferta.

  3. Não crie uma nova oferta para atualizar seu conector certificado existente.

  4. Depois de enviar seus artefatos, a Microsoft certifica a nova versão e a envia de volta para você para teste. Teste o conector como você fez para a primeira versão.

    Para saber mais, veja Teste o conector na certificação. Confirme a publicação de lançamento no Partner Center, e a Microsoft implantará seu conector.

    Importante

    A implantação leva 15 dias, não importa o tamanho ou a complexidade do conector, seja ele novo ou uma atualização. Para proteger a integridade, a Microsoft executa as mesmas tarefas de validação para testar a funcionalidade e o conteúdo de cada implantação.

    Saiba mais em agenda de produção.

** Notificar seus clientes sobre mudanças disruptivas

Se a nova versão do conector alterar a funcionalidade das operações, por exemplo, alterar um caminho de operação, a atualização introduzirá alterações interruptivas. O conector precisa de tratamento especial e você precisa informar seus clientes.

Muitos cenários de atualização podem introduzir alterações significativas. Aqui estão exemplos comuns.

Nome Description
MétodoDeAutenticaçãoRemovido Não remova os métodos de autenticação existentes. Não é permitido alterar o tipo de autenticação do conector em uma atualização.
ParâmetrosDeConexãoRemovidos Não remova parâmetros de conexão de campo. Essa alteração pode interromper os fluxos existentes porque suas conexões ainda estão usando esse campo.
CampoDeEntradaDeletado O campo de entrada é excluído.
VisibilidadeDoCampoDeEntradaAlteradaParaInterno A visibilidade do campo de entrada é alterada para interna. Essa alteração pode fazer com que o valor padrão substitua os valores existentes ou os valores existentes sejam removidos para fluxos existentes após a atualização.
OperaçãoDeletada A operação é excluída. Essa alteração pode interromper os fluxos existentes.
OperationHidden A operação está oculta. Essa alteração pode comprometer a funcionalidade do editor para os fluxos já existentes.
CampoSaídaAdicionadoQuandoRestrito O campo de saída é adicionado quando propriedades adicionais não são permitidas. Essa alteração pode interromper a validação para fluxos existentes.
CampoDeSaídaAlteradoParaOpcionalDeObrigatório O campo de saída é alterado de obrigatório para opcional. Essa alteração pode interromper os fluxos existentes que dependem desse campo, conforme necessário.
OutputFieldDeleted O campo de saída é excluído. Essa alteração poderá interromper os fluxos existentes se eles estiverem usando esse campo e a carga útil for alterada.
TipoDeCampoDeSaídaAlterado O tipo do campo de saída é modificado. Essa alteração poderá interromper os fluxos existentes se eles estiverem usando esse campo e o conteúdo real for alterado.
FormatoDoTipoDoCampoDeSaídaAlterado O formato de tipo é alterado para o campo de saída. Essa alteração poderá interromper os fluxos existentes se eles estiverem usando esse campo e o conteúdo real for alterado.
OutputSchemaRemoved A definição do esquema de saída é removida. Essa alteração pode interromper os fluxos existentes que usam essa saída e a carga útil atual é alterada.
VisibilidadeDoParâmetroMudouParaInterno A visibilidade é alterada para interna para o parâmetro. Essa alteração pode fazer com que o valor padrão substitua os valores existentes ou os valores existentes sejam removidos para fluxos existentes após a atualização.
Cabeçalho de Resposta Removido (ResponseHeaderRemoved) O cabeçalho de resposta é removido. Essa alteração pode interromper todos os fluxos existentes que usam esse cabeçalho e a carga real é alterada.
ResponseHeaderTypeChanged O tipo de cabeçalho de resposta é alterado. Essa alteração pode interromper os fluxos existentes que usam esse cabeçalho e a carga real é alterada.
FormatoDoTipoDoCabeçalhoDeRespostaAlterado O formato de tipo de cabeçalho de resposta é alterado. Essa alteração pode interromper os fluxos existentes que usam esse cabeçalho e o conteúdo real foi alterado.
AlteraçãoDeNívelParaPremium A camada do conector é alterada para Premium. Essa alteração significa que os clientes com planos gratuitos não podem mais usar o conector.

Certifique-se de detalhar todas as atualizações do conector e quaisquer alterações significativas no arquivo intro.md em seu pacote de certificação. A documentação pública gerada a partir do arquivo intro.md ajuda você a informar seus clientes sobre mudanças disruptivas. Saiba mais em Criar um artefato intro.md.

Como prática recomendada, siga o controle de versão operacional para lidar com alterações interruptivas. Isso permite que os fluxos de trabalho existentes continuem funcionando e introduz novas versões de operações conforme necessário. Algumas alterações de ruptura não exigem versionamento operacional. Conecte-se com seu contato da Microsoft para discutir esses casos.