Conector personalizado no PowerApps
Os conectores no Power Apps fornecem uma maneira de estabelecer uma conexão com uma fonte de dados e nos permitem usar essas fontes de dados em nossos aplicativos. Essas fontes de dados podem ser SharePoint, SQL Server, Outlook, Dynamics 365 e muito mais. Atualmente, os PowerApps fornecem mais de 300 conectores que já estão disponíveis para uso em nossos aplicativos.
Mas e se o conector que queremos usar não estiver disponível ou se quisermos usar nosso próprio conector nos aplicativos? Nesse tipo de cenário, os conectores personalizados entram em cena. Os conectores personalizados nos dão a capacidade de usar nossos próprios conectores nos aplicativos.
Neste blog, vamos orientá-lo sobre como criar seu primeiro conector personalizado no Power Apps usando uma API (Application Programming Interface).
Introduction to OpenWeatherMap
OpenWeather Maps usado para fornecer um relatório de previsão do tempo com a ajuda de uma API. Neste blog, estamos usando OpenWeatherMap para fornecer um boletim meteorológico em tempo real em nosso aplicativo de tela.
Entre para https://openweathermap.org/
Aquisição OpenWeatherMap Key API
Para adquirir uma chave de API, você deve criar um Conta gratis. Depois de criar uma conta, você receberá uma chave de API padrão.
Você pode usar o padrão Chave API ou você pode gerar sua chave de API. Esta chave de API funcionará como seu senha que é usado para autorização e impede que outros usuários usem sua API.
Além disso, leia: Definindo o modo padrão para formulários no aplicativo Canvas (aplicativos avançados)
Como testar endpoints de API usando uma chave de API
Como obtivemos uma chave de API, testaremos nossos endpoints usando uma chave de API. Queremos mostrar relatórios meteorológicos por nome da cidade, então usaremos endpoints que tenham o nome da cidade como parâmetro de consulta. Siga os passos descritos abaixo:
Agora vá para o navegador e teste seu Ponto final. Basta fornecer o seu Nome da Cidade (q) e seu Chave API (ID do aplicativo).
Você verá a resposta JSON se for bem-sucedida, conforme mostrado abaixo. Você precisará da sua chave de API e dessa resposta JSON posteriormente, portanto, mantenha-a aberta no navegador.
Além disso, leia: Conheça as funções do usuário em Microsoft Power Apps
Criando um novo conector personalizado
Agora que obtivemos uma chave de API e a testamos com sucesso, podemos prosseguir para criar nosso conector personalizado. Crie uma conta ou entre em aplicativos de energia.
Selecione Dataverse e clique em conectores personalizados.
Em seguida, no canto superior direito, clique em New Custom Connector.
Agora, você verá que existem várias opções para escolher. Neste blog, vamos criar a partir de um espaço em branco.
Em seguida, forneça um nome significativo para seu conector. Você pode nomear o que quiser.
Preenchendo a aba de informações gerais
Na seção Geral, você pode carregar o ícone, aplicar a cor de fundo ao ícone e fornecer uma descrição do seu conector.
Selecione o esquema como HTTPS, pois nosso endpoint é de https.
Tipo de esquema
hostname
Além disso, leia: Implementar lista suspensa em cascata multinível em Power Apps do SharePoint
Definindo seções de segurança
Na seção de segurança, selecione API Key como tipo de autenticação, pois estamos usando API Key para acessar nosso endpoint.
Em seguida, preencha o rótulo do parâmetro como Chave e o nome do parâmetro como autorização.
Selecionar cabeçalho como seu Parâmetro localização.
Definindo uma ação para nosso conector personalizado
Na seção de definição, podemos definir mais de uma ação para nosso conector personalizado. Neste blog, teremos apenas uma ação, mas se você quiser, pode adicionar mais ações posteriormente para diferentes endpoints. Clique na nova ação e na seção geral preencha o resumo e a descrição.
No campo ID da operação, nomeie o campo que será fácil de lembrar e significativo, pois esse campo será obrigatório posteriormente no aplicativo de tela.
Importar da Amostra
Aqui, vamos definir o requisito necessário para a solicitação.
Usaremos GET, pois estamos obtendo dados da API.
Na URL, forneça o endpoint que usamos anteriormente para testar pelo nome da cidade e clique em importar.
Definindo uma resposta em nosso conector personalizado
Em seguida, preencheremos a seção de resposta, basta clicar em Adicionar resposta padrão.
Copie a resposta que obtivemos anteriormente do endpoint que testamos e cole-a na seção do corpo e clique em importar.
Agora, clique em Criar conector.
Agora, você verá a mensagem de que nosso conector personalizado foi criado com sucesso.
Testando nosso conector personalizado
Selecione Teste na lista suspensa
A seguir, forneça seu Key API e clique em crio.
Na seção local, selecione Mumbai ou qualquer cidade desejada no parâmetro de consulta (q) e forneça sua chave de ID do aplicativo e clique em Operação de teste.
Se a solicitação for bem-sucedida, ela retornará uma resposta com um código de status de 200 e uma resposta JSON em uma seção do corpo, conforme mostrado abaixo.
Além disso, leia: O que são Power Apps da Microsoft Power Platform?
Usando nosso conector personalizado no aplicativo de tela
Depois de criar nosso conector personalizado, veremos agora como adicionar nosso conector personalizado ao nosso aplicativo de tela e usá-lo como fonte de dados.
Crie um novo aplicativo de tela e forneça o nome do aplicativo e clique em criar.
Agora, você verá uma nova tela em branco.
Clique no ícone de dados e selecione Adicionar dados.
Como você pode ver, nosso conector personalizado está disponível. Clique no conector personalizado.
Agora, você só precisa usar um rótulo e ver se está funcionando ou não.
Use a fórmula abaixo para testá-la.
O conector personalizado é o nome do conector que fornecemos anteriormente e o local é o ID da operação.
Observação: use sua própria chave de API no ID do aplicativo.
Além disso, leia: Desenvolvimento de aplicativos personalizados para pequenas e médias empresas - aplicativos avançados para o resgate
Conclusão
Os conectores no Power Apps fornecem uma maneira para os usuários vincularem contas e aproveitarem várias atividades pré-criadas e começarem a criar fluxos de trabalho e aplicativos. E há cenários em que você precisa criar conectores personalizados, eles são configurados para permitir o uso de APIs que não são cobertas pelos conectores gerais. Os conectores personalizados podem incluir uma ou mais ações. E definido acima foi o método de criação de um conector personalizado em aplicativos de energia. Espero que você tenha aprendido a construir seu primeiro conector personalizado para Aplicativos poderosos e Power Automatize. Se você tiver alguma dúvida ou feedback sobre o mesmo, sinta-se à vontade para deixar uma mensagem na seção de comentários abaixo. Tudo de bom!
Consultoria de plataforma de energia da Microsoft
Ainda assim, tem uma pergunta? Você está livre para entrar em contato comigo ou com outros especialistas em nossa equipe para mostrar o verdadeiro poder dos PowerApps para você.
