Atualizar seu conector certificado
Observação
Este tópico contém informações para a certificação de conectores personalizados nos Aplicativos Lógicos do Azure, no Power Automate e Power Apps. Certifique-se de ter um conector certificado e lançado com a Microsoft antes de seguir essas etapas.
Para atualizar seu conector certificado, você precisará enviar um novo conjunto de artefatos de conector para certificação. Siga as mesmas instruções que você usou ao certificar seu conector pela primeira vez.
- Se você for um editor verificado, vá para Processo de certificação de editor verificado para obter instruções.
- Se você não for um editor independente, vá para Processo de certificação de editor independente para obter instruções.
Além disso, verifique se a nova versão do conector ainda respeita diretrizes e requisitos.
O tempo necessário para concluir o processo de atualização de certificação para seu conector depende se ele possui atualizações grandes ou pequenas. Uma atualização grande levará cerca de 6 a 10 semanas para implantação. Uma atualização pequena levará apenas 4 a 5 semanas. Os engenheiros da Microsoft avaliarão suas atualizações e tomarão a decisão final. Este artigo descreve os critérios para atualizações secundárias. Se o seu conector não atender a nenhum dos critérios, ele será considerado uma atualização grande.
Enviar uma atualização
Importante
Você deve abrir o código do conector antes que ele seja adicionado ao portal de certificação para reduzir inconsistências.
Para obter instruções, vá para Enviar seu conector para certificação da Microsoft.
Verifique se você validou os arquivos do conector antes de continuar com seu envio de atualização. Não fazer isso pode resultar em atrasos no processo de atualização.
Para editores verificados, excluindo editores independentes: depois de preparar os novos artefatos do conector para envio, volte para a guia Certificação de conector em ISV Studio.
Talvez você tenha enviado artefatos para o Portal de Certificação do Conector; a experiência agora está no ISV Studio.
Não crie um novo envio para uma atualização de um conector certificado existente.
Em vez disso, selecione seu envio existente na lista e escolha Enviar uma nova versão. Com isso, você será direcionado à área de envio de artefatos do conector, onde será possível carregar a nova versão dos artefatos do conector.
Depois que você enviar os artefatos, vamos implantar e testar o conector da mesma forma como fizemos na primeira versão. Para obter mais informações, acesse Testar o conector na certificação.
Importante
São necessários sete a 15 dias para a implantação, independentemente do tamanho ou da complexidade do seu conector, seja ele novo ou uma atualização. Para proteger a integridade, o conector estará sujeito às mesmas tarefas de validação para testar a funcionalidade e o conteúdo que são seguidos em cada implantação.
Para obter mais informações, acesse a agenda de produção.
Verifique se o ambiente de teste na Versão preliminar ainda esteja acessível. Caso seja do tipo Teste, o ambiente pode ter expirado, quando você vai precisar criar um novo.
Notifique seu cliente sobre alterações interruptivas
Se a nova versão do conector alterar a funcionalidade das operações dentro do conector — por exemplo, alterando o caminho da operação—, a atualização apresentará alterações da falha. O conector precisará de cuidado especial.
Você precisará fornecer aos clientes as alterações importantes que usará na nova atualização. Isso garantirá que os clientes que estão usando sua versão de conector publicada no momento recebam atualizações para a nova versão atualizada.
Geralmente, sugerimos controle de versão operacional como uma solução para alterações da falha. Isso permite que os fluxos de trabalho existentes continuem a funcionar e apresenta novas versões de operações, conforme necessário. Existem alguns casos de alterações da falha que talvez não exijam controle de versão operacional. Conecte-se com seu contato da Microsoft para discutir esses casos.
Observação
Não é permitido alterar o tipo de autenticação do conector em uma atualização.
Fale com o seu contato da Microsoft caso tenha perguntas ou se você encontrar algum erro inesperado ao tentar enviar uma atualização.
Critérios de uma atualização pequena
A Microsoft pode considerar sua solicitação de conector uma atualização pequena. Isso a qualificaria para um tempo de conclusão acelerado de 4 a 5 semanas para o processo de certificação. Uma atualização pequena será considerada apenas para conectores certificados existentes. Não se aplica a novas solicitações de certificação de conector.
Alterações em um ou mais dos artefatos a seguir qualificarão seu conector como uma atualização pequena.
| Artefato | Campo | Definição |
|---|---|---|
| ApiDefinition.swagger.json | Informações do conector | |
| ApiDefinition.swagger.json | Ações | |
| ApiDefinition.swagger.json | Respostas | |
| ApiProperties.json | — | |
| Arquivo Readme | — | Alterações de conteúdo |
| Ícone | — | Substituição |
Enviar comentários
Agradecemos muito os comentários sobre problemas com nossa plataforma de conectores ou novas ideias de recursos. Para fornecer comentários, acesseEnviar problemas ou obter ajuda com conectores e selecione o tipo de comentário.