Atualizar o conector certificado

Nota

Este tópico contém informações para certificar conectores personalizados no Azure Logic Apps, no Power Automate e no Power Apps. Certifique-se de que tem um conector certificado e lançado com a Microsoft antes de seguir estes passos.

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

Além disso, certifique-se de que a sua nova versão de conector ainda adere às nossas diretrizes e requisitos.

O tempo que demora a concluir o processo de atualização da certificação para o conector depende se este tiver atualizações importantes ou secundárias. Uma atualização importante irá demorar cerca de 6 a 10 semanas para ser implementada. Uma atualização secundária irá demorar apenas de 4 a 5 semanas. Os engenheiros da Microsoft irão avaliar as suas atualizações e tomar a decisão final. Este artigo descreve os critérios para atualizações secundárias. Se o conector não cumprir nenhum dos critérios, será considerado uma atualização importante.

Submeter uma atualização

Importante

Tem de abrir o conector de open source antes de ser adicionado ao portal de certificação para reduzir inconsistências.

Para obter instruções, vá a Submeter o seu conector para certificação da Microsoft.

  1. Certifique-se de que validou os ficheiros do conector antes de prosseguir com a submissão da atualização. Se não o fizer, pode resultar em atrasos no processo de atualização.

  2. Para editores verificados, excluindo editores independentes: depois de ter os novos artefactos de conector prontos a submeter, volte ao separador Certificação de conector no ISV Studio.

    Pode já ter submetido anteriormente artefactos para o Portal de Certificação de Conectores, a experiência encontra-se agora no ISV Studio.

  3. Não crie uma nova submissão para uma atualização para um conector certificado existente.

    Em vez disso, selecione a submissão existente na lista e, em seguida, selecione Submeter uma nova versão. Isto fará com que regresse à área de envio de artefactos do conector, onde poderá enviar a nova versão dos seus artefactos do conector.

  4. Depois de submeter os artefactos, iremos implementar e testar o conector da mesma forma que fizemos para a primeira versão. Para mais informações, aceda a Testar o seu conector na certificação.

    Importante

    São necessários entre quinze dias para a implementação independentemente do tamanho ou complexidade do seu conector, seja novo ou uma atualização. Para proteger a integridade, o conector será submetido às mesmas tarefas de validação para testar a funcionalidade e o conteúdo que são seguidas em todas as implementações.

    Para mais informações, consulte a agenda de produção.

  5. Certifique-se de que o ambiente de testes em Pré-visualização ainda está acessível. Se o seu ambiente era do tipo Avaliação, pode ter expirado e nesse caso terá de criar um novo ambiente.

Notificar o cliente de alterações interruptivas

Se a sua nova versão de conector alterar a funcionalidade das operações dentro do seu conector (por exemplo, alterar um caminho de operação), a atualização irá introduzir alterações interruptivas. O conector necessitará de um processamento especial.

Terá de fornecer aos clientes as alterações interruptivas que vai utilizar na nova atualização. Isto irá garantir que os clientes que estão a utilizar a sua versão de conector publicada atualmente receberão atualizações para a nova versão atualizada.

Geralmente, sugerimos controlo de versões operacional como uma solução para alterações interruptivas. Isto permite que os fluxos de trabalho existentes continuem a funcionar e introduz novas versões de operações, conforme necessário. Existem alguns casos de alterações interruptivas que podem não requerer o controlo de versões operacional. Contacte o seu contacto da Microsoft para falar destes casos.

Nota

Não é permitido alterar o tipo de autenticação do seu conector numa atualização.

Fale com o seu contacto da Microsoft se tiver questões a colocar ou se verificar a ocorrência de erros inesperados quando tentar submeter uma atualização.

Critérios de uma atualização secundária

A Microsoft poderá considerar o seu pedido de conector uma atualização secundária. Isto iria qualificá-la para um tempo de conclusão rápido de 4 a 5 semanas para o processo de certificação. Uma atualização secundária será considerada apenas para conectores certificados existentes. Não se aplica a novos pedidos de certificação de conectores.

As alterações a um ou mais dos seguintes artefactos irão qualificar o conector como uma atualização secundária.

Artefacto Campo Definição
ApiDefinition.swagger.json Informações de conector
  • Descrição
  • Contacto
  • ApiDefinition.swagger.json Ações
  • Descrição
  • Resumo
  • ApiDefinition.swagger.json Respostas
  • Descrição
  • Descrição da mensagem
  • ApiProperties.json
  • Descrição
  • Descrição
  • iconBrandColor
  • Editor
  • StackOwner
  • Ficheiro Leia-me Alterações de conteúdo
    Ícone Substituição

    Enviar comentários

    Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para enviar comentários, aceda a Submeter problemas ou obter ajuda com conectores e selecione o tipo de comentários.