Partilhar via


Atualizar o conector certificado

Este artigo explica como atualizar conectores certificados para Microsoft Copilot Studio, Microsoft Power Automate, Microsoft Power Apps e Azure Logic Apps. Certifique-se de que tem um conector certificado disponibilizado com a Microsoft antes de seguir estes passos.

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

Além disso, certifique-se de que sua nova versão do conector ainda esteja de acordo com nossas diretrizes e requisitos.

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

Submeter uma atualização

Importante

Abra o código-fonte do conector antes que a Microsoft o adicione ao portal de certificação para reduzir inconsistências. Consulte Processo de certificação de editor verificado.

  1. Certifique-se de atender aos requisitos de envio antes de enviar sua atualização. Caso contrário, o processo de atualização pode ser atrasado.

  2. (Para editores verificados) Quando os seus novos componentes de conector estiverem prontos, vá para 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 em Visão geral do produto.

    Você deve ter enviado previamente artefatos para o Partner Center in Microsoft 365 and Copilot Program. Reabra a mesma oferta e atualize a guia relevante em Visão geral do produto da sua 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 fez para a primeira versão.

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

    Importante

    A implantação leva 15 dias, não importa o tamanho ou a complexidade do seu 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 cronograma deprodução.

Notifique os seus clientes de alterações significativas

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 de quebra. O conector precisa de manuseio especial, e você precisa informar seus clientes.

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

Nome Description
Método de Autenticação Removido 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 os parâmetros de conexão de campo. Esta alteração pode interromper os fluxos existentes porque essas conexões ainda estão usando este campo.
CampoDeEntradaEliminado O campo de entrada é excluído.
VisibilidadeDoCampoDeEntradaAlteradaParaInterna 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çãoEliminada A operação é excluída. Esta alteração pode quebrar os fluxos existentes.
Operação Oculta A operação está oculta. Essa alteração pode causar falhas no designer para fluxos existentes.
CampoDeSaídaAdicionadoQuandoRestrito O campo de saída é adicionado quando propriedades adicionais não são permitidas. Esta alteração pode interromper a validação dos fluxos existentes.
OCampoDeSaídaAlteradoParaOpcionalDeObrigatório O campo de saída é alterado de obrigatório para opcional. Essa alteração pode quebrar os fluxos existentes que dependem desse campo, conforme necessário.
CampoDeSaídaEliminado O campo de saída é excluído. Esta alteração pode quebrar os fluxos existentes se estiverem a utilizar este campo e a carga útil real for alterada.
OutputFieldTypeChanged O tipo do campo de saída é alterado. Esta alteração pode interromper os fluxos existentes se estiverem a utilizar este campo e a carga útil real for alterada.
FormatoDoTipoDoCampoDeSaídaAlterado O formato de tipo é alterado para o campo de saída. Essa alteração pode interromper os fluxos existentes se eles estiverem usando esse campo e a carga útil real for alterada.
EsquemaDeSaídaRemovido A definição do esquema de saída é removida. Essa alteração pode quebrar os fluxos existentes que usam essa saída e a carga útil real é alterada.
VisibilidadeDoParâmetroAlteradaParaInterna 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çalhoDeRespostaRemovido O cabeçalho de resposta é removido. Essa alteração pode quebrar quaisquer fluxos existentes que usam esse cabeçalho e a carga útil real é alterada.
TipoDeCabeçalhoDeRespostaAlterado O tipo de cabeçalho de resposta é alterado. Essa alteração pode quebrar os fluxos existentes que usam esse cabeçalho e a carga útil real é alterada.
TipoDeCabeçalhoDeRespostaFormatoAlterado O formato do tipo de cabeçalho de resposta é alterado. Essa alteração pode quebrar os fluxos existentes que usam esse cabeçalho e a carga útil real foi alterada.
NívelAlteradoParaPremium A camada de conector é alterada para Premium. Essa mudança 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 alterações disruptivas. Saiba mais em Criar um artefato intro.md.

Como prática recomendada, siga o versionamento operacional para lidar com alterações disruptivas. Isso permite que os fluxos de trabalho existentes continuem funcionando e introduz novas versões de operações, conforme necessário. Algumas alterações disruptivas não exigem versionamento operacional. Contacte o seu contacto da Microsoft para falar destes casos.