Introdução
Você pode criar um conector personalizado como software livre e certificá-lo. Com isso, ficará mais fácil disponibilizá-lo aos usuários. Um conector como software livre sempre será publicado no repositório GitHub do Microsoft Power Platform. No repositório, qualquer usuário pode importar sua definição de conector personalizado para um ambiente e usá-la ou sugerir uma contribuição ao conector, que você pode adotar. Quando você cria um conector personalizado, ele fica disponível apenas para você e os usuários com quem você o compartilha explicitamente. Para que um conector fique visível na lista de conectores oficiais para qualquer usuário de Aplicativos Lógicos do Microsoft Azure, Microsoft Power Automate ou Microsoft Power Apps, ele precisa ser certificado.
Quando certificar um conector personalizado
Existem muitas razões para certificar seu conector personalizado. As principais delas são a facilidade de uso, visibilidade e expansão do alcance da API. Certifique seu conector personalizado se ele oferecer acesso a uma API que é útil para um público-alvo amplo e não estiver voltada ao uso interno. Não é necessário hospedar o serviço subjacente da API nas tecnologias da Microsoft. Na verdade, os conectores ajudam a integrar as soluções do Microsoft Power Platform a soluções que não são da Microsoft. Você pode certificar conectores para APIs gratuitas ou pagas.
Antes da publicação, os conectores certificados passam por revisão para garantir conformidade com os critérios de certificação. Há dois tipos de editores de conectores verificados e independentes.
Editores Verificados: um requisito fundamental é que você deve ter o serviço subjacente ou deve apresentar direitos explícitos para usar a API e fornecer um cenário de usuário que se adeque apropriadamente aos produtos.
Editores Independentes: não têm o serviço subjacente por trás do conector. Por exemplo, um usuário de uma API que não seja afiliado à empresa pode enviar um conector para a API para certificação. Esse tipo permite que os membros da comunidade possam participar do ecossistema do conector do Power Platform.
A certificação inicial e as atualizações para o conector são gratuitas. A próxima unidade explicará melhor o processo de certificação.
Quando criar um conector personalizado como software livre
Todo conector personalizado que você cria é pode se tornar um software livre se você determinar que outras pessoas podem se beneficiar do seu uso. Para certificar um conector, a primeira etapa é fazer com a que definição seja open-source. Primeiro, verifique se existe uma definição de conector personalizado existente no repositório para a API que você está criando. Se você encontrar uma definição já existente, recomendamos que, em vez de criar um conector duplicado, você contribua com ela. Para isso, envie uma solicitação de pull.
A seguir, são apresentados exemplos mostrando quando é mais (e menos) indicado criar um conector personalizado open-source.
| Candidato ideal como software livre | Candidato ruim como software livre |
|---|---|
| Conector para uma API que está disponível publicamente | Conector para uma API privada que está disponível apenas na sua rede corporativa |
A maioria das contribuições exige que você concorde com um Contrato de Licença do Colaborador (CLA), declarando que você tem o direito para conceder, e de fato nos concede, os direitos para usar sua contribuição. Para obter mais informações, consulte o Contrato de Licença do Colaborador.
O repositório do GitHub tem três pastas principais que contêm os conectores: custom-connectors, independent-publisher-connectors e certified-connectors.
A pasta custom-connectors contém exemplos de conectores totalmente funcionais que podem ser implantados no Microsoft Power Platform para extensão e uso. Esses exemplos podem não ser de conectores certificados, mas eles foram criados e mantidos pela comunidade open-source para oferecer cenários úteis ou exemplos de conceitos de conectores.
A pasta independent-publisher-connectors contém conectores que são enviados por editores que não têm o serviço subjacente por trás do conector. Esses conectores são implantados e estão disponíveis no Power Platform como conectores premium. Qualquer pessoa pode enviar um novo conector para essa pasta, adicionar funcionalidade aos conectores nela e resolver problemas relacionados aos conectores na pasta. A pasta é gerenciada pela Comunidade de Conectores de Editores Independentes, que inclui Editores Independentes e Coordenadores de Projeto. A ramificação mestre é mantida pela Equipe de Certificação de Conectores da Microsoft, que garante que a versão do conector seja idêntica à implantada no Power Platform. A ramificação dev é mantida pelo(s) mantenedor(es) do conector e pela Equipe de Certificação de Conectores da Microsoft para permitir o desenvolvimento comunitário do conector antes da certificação e da implantação de uma versão.
A pasta certified-connectors contém conectores certificados que já foram implantados e que estão disponíveis para uso, imediatamente, no Microsoft Power Platform. O programa de certificação de conectores da Microsoft requer que novos conectores certificados sejam como código aberto e aceitem contribuições da comunidade. A equipe de certificação de conectores da Microsoft gerencia a pasta certified-connectors para garantir que, na branch master, a versão do conector seja idêntica àquela implantada no Microsoft Power Platform. A branch dev é mantida pelo proprietário do conector e pela equipe de certificação de conectores da Microsoft. Isso é feito para permitir que a comunidade desenvolva o conector antes de uma versão dele ser certificada e implantada.
Para contribuir com o repositório GitHub, você começará fazendo sua própria cópia (ou criando uma fork) do repositório. As etapas são explicadas em Como criar uma fork. Depois de criar uma fork, você estará pronto para preparar o conector para receber contribuições usando uma solicitação pull. Você pode baixar os ativos do seu conector usando a CLI do Conector do Microsoft Power Platform.
Baixar usando a CLI do Conector do Microsoft Power Platform
Para preparar os arquivos necessários para criar um conector open-source, use o comando de download paconn da CLI de Conectores do Microsoft Power Platform.
Execute o comando abaixo para baixar os arquivos de conectores personalizados:
paconn download
Quando você executa esse comando, ele passa por uma entrada de dispositivo para permitir que paconn acesse o ambiente do Microsoft Power Platform em seu nome. Depois da autenticação, o paconn mostrará uma lista dos ambientes e, depois, dos conectores, para seleção.
Se você souber sua ID de ambiente e ID de conector, use a seguinte sintaxe de linha de comando para evitar a solicitação:
paconn download -e [Microsoft Power Platform Environment GUID] -c [Connector ID]
O download inclui quatro arquivos:
apiDefintion.swagger.json – a definição de OpenAPI para seu conector, que inclui, por exemplo, todos os gatilhos e ações.
apiProperties.json – define modelos de política e outras propriedades de conectores estendidos que não fazem parte das especificações de OpenAPI.
icon.png – um ícone pequeno usado para representar o serviço no designer quando o conector é usado.
settings.json – em vez de fornecer parâmetros para o paconn.
Você dará mais visibilidade à sua API se tiver um conector personalizado open-source certificado. Ao contribuir com a definição do conector para o repositório open-source, seu conector personalizado fica disponível a outros usuários. Quando alguém usa um conector certificado, na verdade, a pessoa está usando uma definição que é corrigida automaticamente quando você publica atualizações. Quando você usar a definição de conector open-source, os usuários precisarão aplicar as atualizações nas cópias que tiverem. Trataremos posteriormente neste módulo sobre como certificar seu conector personalizado e gerenciar o ciclo de vida conforme você o aprimorar.