Exercício: criar um conector personalizado no Visual Studio

  • 5 minutos

Neste exercício, você criará um conector personalizado em seu ambiente Power Platform por meio de sua API Web no Visual Studio.

O Power Platform permite que os desenvolvedores de API Web criem rapidamente aplicativos móveis ou da Web usando um aplicativo de tela do Power Apps como front-end. Com o Serviço Conectado do Power Platform no Visual Studio 2022, os desenvolvedores de API Web do ASP.NET podem criar facilmente um conector personalizado para uso com o Power Apps.

Observação

Se quiser usar o Visual Studio e o Power Apps neste exercício, você precisará:

  • Instalar o Visual Studio 2022 com o ASP.NET e a carga de trabalho de desenvolvimento Web instalados. Você precisa estar conectado ao Visual Studio para criar e usar túneis de desenvolvimento. O recurso não está disponível no Visual Studio para Mac.
  • Criar um ambiente de desenvolvedor gratuito do Power Platform.
  • Baixe os exemplos.

Adicionar o Power Platform como um serviço conectado

  1. Abra este exemplo de API do GitHub com o Visual Studio. Este é um projeto de API Web ASP.NET Core.

  2. Em seu projeto, no Gerenciador de Soluções, clique com o botão direito no nó Serviços Conectados e selecione Adicionar > Microsoft Power Platform

    Captura de tela dos serviços conectados a serem adicionados. O foco está na opção Microsoft Power Platform.

  3. Selecione ou insira os seguintes valores:

    • Ambientes do Power Platform: select your developer environment
    • Soluções do Power Platform: Common Data Service Default Solution
    • Conector personalizado: selecione o ícone + e insira InventoryLocations_Connector

    Captura de tela da configuração dos serviços conectados.

  4. Para o campo Selecione um túnel de desenvolvimento público, selecione o ícone + e os seguintes valores:

    • Nome: devtunnel
    • Tipo de Túnel: Persistent
    • Acesso: Public

    Captura de tela da configuração do túnel de desenvolvimento.

  5. Selecione OK e Concluir. Depois que o serviço conectado estiver configurado, você poderá selecionar Fechar.

    Captura de tela da conclusão do processo de configuração do serviço conectado.

Agora você criou um conector personalizado para localizações de estoque, que aproveita túneis de desenvolvimento para conectar sua API ao Power Platform. Aqui no loop interno você está executando sua API em seu ambiente local.

Executar sua API

Quando o Visual Studio executa um aplicativo Web e um túnel está ativo, o navegador da Web é aberto para uma URL de túnel em vez de uma URL de host local.

  1. Execute sua solução do Visual Studio e comece a depurar.

    Captura de tela do ícone de execução de depuração.

  2. Quando o navegador é aberto, uma página de aviso é aberta com a primeira solicitação enviada ao URL do túnel. Selecione Continuar.

    Captura de tela da página de aviso inicial.

Importante

Lembre-se de manter a API em execução (em uma guia do navegador) ao criar seu Power App.

Criar um aplicativo da API

Observação

Para usar o aplicativo de exemplo fornecido nesta etapa, você precisará instalar asPower Platform Tools para Visual Studio Code.

  1. Abra o Visual Studio Code e crie uma nova autenticação para o usuário usando o comando da Power Platform CLI. Altere a URL para a URL do ambiente de desenvolvedor encontrado no centro de administração.

    pac auth create --url https://yourenvironment.crm.dynamics.com

  2. Obtenha o conector personalizado que você criou. Copie a ID do conector.

    pac connector list

  3. Gere um aplicativo de tela (arquivo *.msapp), com base nas operações de sua API.

    pac canvas create --connector-id your connector id --msapp your file name.msapp

Visualizar o aplicativo

  1. Abrir o Power Apps.

  2. Selecione Aplicativo em branco Em Aplicativo de tela em branco, selecione Criar.

    Captura de tela do assistente Criar aplicativo.

  3. Insira o nome do aplicativo Inventory app e selecione o formato Tablet. Selecione Criar.

    Captura de tela do assistente Criar aplicativo para inserir um nome de aplicativo.

  4. Na barra de comandos, selecione ... e Abrir.

    Captura de tela de como abrir um aplicativo existente.

  5. Navegue para abrir o arquivo *.msapp que você criou na Etapa 3. Isso carregará seu aplicativo de exemplo no estúdio.

    Captura de tela da opção Procurar arquivos.

  6. Na barra esquerda, selecione o ícone de dados e Adicionar dados. Procure InventoryLocations_Connector para selecionar Conectar. Esse é o conector personalizado que foi criado da API Web.

    Captura de tela de como adicionar o conector do cliente.

  7. Para visualizar esse aplicativo, selecione o ícone de reprodução.

    Captura de tela do ícone de visualização do aplicativo.

  8. Selecione o botão OBTER aplicativo para exibir uma lista de localizações de estoque.

    Captura de tela da visualização do aplicativo.

  9. Selecione o ícone fechar no canto superior direito do aplicativo para retornar ao Studio. Selecione o ícone de publicação para salvar seu trabalho.

    Captura de tela do ícone de publicação.

Dica

  • Não estão sendo retornados países/regiões da API de exemplo? Verifique se a API está em execução enquanto você cria seu aplicativo.
  • Como está usando túneis de desenvolvimento aqui, você pode iterar a API em tempo real, inclusive depuração e recarga a quente.

Você concluiu a criação de um aplicativo e um conector personalizado de uma API Web.