Explorar conectores personalizados certificados

  • 6 minutos

Para disponibilizar um conector personalizado para todos os usuários nos Aplicativos Lógicos, no Power Automate e no Power Apps como um conector certificado, você precisa enviar seu conector à Microsoft para certificação. A Microsoft analisará o conector e, se ele atender aos critérios de certificação, o aprovará para publicação. Depois que o conector é publicado, ele ingressa na lista completa de conectores disponíveis publicamente.

Esta unidade examina cada etapa do processo de certificação, inclusive algumas etapas de alto nível. Essas mesmas etapas também se aplicam a atualizações posteriores, mas, dependendo do escopo da atualização, podem ser consideravelmente mais rápidas.

Planejamento

O planejamento é a primeira etapa no processo de certificação, à medida que você começa a imaginar a aparência que o conector terá. A criação de um conector que outras pessoas usarão deve envolver algum planejamento.

A primeira etapa no processo de planejamento é verificar se um conector ainda não existe. Se já existir um conector, considere contribuir com suas alterações propostas para o conector existente, pois a Microsoft não certifica vários conectores para a mesma API.

Alguns dos principais fatores de planejamento a serem considerados são:

  • Identifique quais gatilhos e ações estarão disponíveis inicialmente. Você não precisa ter 100% de sua API abrangida, mas o conjunto inicial de gatilhos e ações deve ser útil. Se você limitar demais o que a versão inicial oferece, os usuários poderão ficar frustrados com a falta de funcionalidade em cenários comuns. Considere escrever ou esboçar um ou mais fluxos de trabalho que você pode criar no Power Automate usando seu conector. Essa abordagem pode ajudá-lo a decidir quais APIs incluir no conector.

  • Avalie quais alterações podem ser necessárias na API para dar suporte a gatilhos ou melhorar a capacidade de fornecer um conector amigável.

  • Considere como a autenticação será tratada e a adaptação necessária entre como sua API realiza a autenticação no momento e os recursos com suporte de conectores personalizados.

  • Considere como as pessoas que desejam usar o conector obterão uma chave, se a API usar chaves de API.

  • Examine os modelos de política de conector para determinar se a implementação de modelos ajudaria na usabilidade do conector.

  • Examine as extensões de OpenAPI com suporte para aplicabilidade. Por exemplo, conectores certificados geralmente implementam a conexão de teste. Além disso, o uso de extensões de valor dinâmico poderá ser útil se você tiver parâmetros com listas de valores dentre os quais escolher.

Para a certificação de um novo conector, não é necessário esperar até terminar de desenvolver o conector para se registrar para a certificação. Para obter mais informações, consulte a documentação do Processo de Certificação de Editor Verificado ou o Processo de Certificação de Editores Independentes. Espere receber uma comunicação de um representante da Microsoft que pode auxiliar a entender melhor seu conector personalizado, explicar seu progresso de desenvolvimento e orientá-lo no processo de certificação.

Para atualizações de um conector certificado, a parte mais importante do planejamento é não afetar os usuários existentes. Essa questão é discutida em mais detalhes em uma unidade posterior.

Desenvolvimento

O foco principal na etapa de desenvolvimento é preparar a API e a definição do conector personalizado para envio. Antes de ir para a próxima etapa, verifique se sua definição de conector personalizado foi refinada e tem toda a nomenclatura adequada que você deseja publicar.

Criar um software livre

A unidade de introdução abordou uma visão geral de alto nível de como criar um conector de software livre. Nesse processo, você coloca o conector certificado do editor verificado na pasta certified-connectors e os conectores do editor independente na pasta independent-publisher-connectors. Antes de enviar uma solicitação pull, conclua as seguintes tarefas:

  • Edite os arquivos do conector para adicionar os metadados específicos necessários. Os arquivos do conector devem conter metadados específicos que descrevam o conector e seu serviço final.

  • Execute o comando paconn validate no conector baixado e resolva os erros.

Para executar a validação, use o seguinte comando:

paconn validate --api-def [Location of apiDefinition.swagger.json]

Após passar na validação, você pode enviar sua solicitação de pull para a ramificação dev do repositório GitHub. Essa ação inicia um processo automatizado que conduz a validação inicial de sua solicitação pull e garante que você tenha um contrato de contribuição adequado. Quando a validação automatizada é concluída, o sistema a atribui à Microsoft para revisão inicial. Se os revisores encontrarem problemas que precisam ser corrigidos, eles inserirão comentários na solicitação pull e, depois disso, você deverá resolvê-los e reenviar a solicitação pull. Quando tudo parece aceitável, o revisor mescla sua solicitação pull no repositório.

Envio de editor independente

Se você está publicando um conector de editor independente, suas próximas etapas são:

  1. Enviar os artefatos do conector para a solicitação pull que você criou quando propôs o conector.

  2. Preencher a lista de verificação no modelo de solicitação de pull.

  3. Remover "Proposta -" do título de sua solicitação de pull.

Um engenheiro de certificação da Microsoft fornecerá comentários dentro de 1 a 2 semanas após sua solicitação inicial. Se os comentários exigirem uma atualização do conector, você precisará enviar uma atualização para a solicitação de pull.

Envio de editor verificado

A próxima etapa é enviar seu conector para certificação no Microsoft Power Platform ISV Studio depois que seu contato da Microsoft solicitar isso. O ISV Studio é um portal para gerenciar o restante do processo de certificação e fornece a integridade do conector após a implantação.

Como parte do processo de envio ao ISV Studio para certificação, você deve estar preparado para fornecer os seguintes detalhes:

  • Informações de teste do conector, como uma chave de API, outros detalhes de autenticação ou detalhes que ajudem um testador a usar o conector.

  • Um arquivo Intro.md que contém informações a serem incluídas na documentação pública do conector. O modelo está na documentação Enviar para o ISV Studio.

À medida que a certificação avançar, você obterá atualizações no portal e receberá um email do contato principal. Caso sejam encontrados problemas, espera-se que você os resolva antes de prosseguir com a certificação. Depois que o conector passa pela certificação, é agendado para implantação na região "Versão preliminar" para teste.

Testes

Como parte do processo de certificação, o conector é implantado na região de "Versão preliminar" para testes. Agora é sua oportunidade de garantir que o conector implantado funcione corretamente antes de ser implantado em todas as regiões do mundo. Teste todas as funcionalidades do conector no Power Apps, no Power Automate e nos Aplicativos Lógicos.

Para obter mais informações, consulte Instruções sobre como testar seu conector na certificação.

Implantação

Após a conclusão do teste, seu conector é implantado em todas as regiões públicas. Espere que esse processo leve de 7 a 10 dias úteis, pois a Microsoft implanta de forma incremental em suas regiões em todo o mundo. Você receberá notificações à medida que cada região for implantada.

Dê suporte

Agora que seu conector foi lançado publicamente, para conectores de editores verificados, você pode monitorar seu desempenho no ISV Studio. Verifique se sua equipe de suporte está ciente de como o conector pode ser usado com o Power Apps ou o Power Automate para que possa dar suporte a usuários que enfrentarem problemas.