Exercício: criar um conector em uma solução

Concluído

Neste exercício, você criará seu primeiro conector personalizado para uma API existente chamada Contoso Invoicing.

Importante

Use um ambiente de teste com o Microsoft Dataverse provisionado. Se você não tiver um ambiente de teste, poderá inscrever-se no Plano da Comunidade do Power Apps.

Tarefa 1: Analisar a API

Para analisar a API, siga estas etapas:

  1. Vá para o Contoso Invoicing.

  2. Selecione o link da documentação.

    Uma seta apontando para o link da documentação da API – captura de tela.

  3. Analise as operações disponíveis.

  4. Selecione para expandir e analisar cada operação.

  5. Feche a janela ou a guia do navegador da documentação.

  6. Selecione o link Abrir definição da API.

  7. A imagem a seguir mostra um exemplo da versão de OpenAPI do conteúdo na página da documentação. Clique com o botão direito do mouse e selecione Salvar como.

    Uma seta apontando para o botão Salvar como – captura de tela.

  8. Salvar o arquivo localmente. Você usará esse arquivo posteriormente neste exercício.

  9. Feche a janela ou a guia do navegador da definição.

  10. Selecione o link Chave de API.

  11. Copie e salve sua chave de API, pois ela será necessária posteriormente.

    Chave de API da Contoso Invoicing – captura de tela.

  12. Selecione Retornar à página inicial.

  13. Selecione Baixar Logotipo.

  14. Salve a imagem do logotipo localmente. Ela será usada mais adiante.

Tarefa 2: criar uma solução

Para criar uma solução, siga estas etapas:

  1. Vá para o Power Apps Maker Portal e verifique se está no ambiente correto.

  2. Selecione Soluções > + Nova solução.

  3. Insira Contoso Invoicing para o Nome para exibição, selecione Editor Padrão de CDS para Editor e, depois, selecione Criar. Ao trabalhar com um projeto real, é melhor criar seu próprio editor.

    Criar nova solução de Contoso Invoicing – captura de tela.

  4. Não saia desta página depois de selecionar Criar.

Tarefa 3: Criar um conector

Para criar um conector, siga estas etapas:

  1. Abra a solução Contoso Invoicing que você criou.

  2. Selecione + Novo > Automação > Conector personalizado.

    Uma seta apontando para a criação da conexão personalizada – captura de tela.

  3. Insira Contoso invoicing para o Nome do conector e, depois, selecione a opção para Carregar a imagem.

    Uma seta apontando para o botão carregar imagem do ícone – captura de tela.

  4. Selecione a imagem do logotipo do conector que você baixou na Tarefa 1: Analisar a API.

  5. Insira #175497 como a cor de fundo do ícone.

  6. Insira API do Contoso Invoicing como a Descrição.

  7. Insira contosoinvoicingtest.azurewebsites.net como o Host.

  8. Selecione Criar conector.

    Uma seta apontando para o botão criar conector – captura de tela.

  9. Não saia desta página.

Tarefa 4: importar a definição de OpenAPI

Para importar a definição de OpenAPI, siga estas etapas:

  1. Selecione a seta ao lado de Nome do Conector.

    Uma seta apontando para o botão voltar – captura de tela.

  2. Selecione o botão de reticências (...) do conector e, depois, Atualizar do arquivo OpenAPI.

    Uma seta apontando para o botão Atualizar do arquivo API aberto – captura de tela.

  3. Selecione Importar.

  4. Selecione o arquivo swagger.json baixado na Tarefa 1: Analisar a API e, em seguida, selecione Abrir.

  5. Selecione Continuar.

  6. Preencha a URL do host como contosoinvoicingtest.azurewebsites.net e selecione Segurança.

    Uma seta apontando para a guia Segurança – captura de tela.

  7. Observe que o campo é preenchido com base no arquivo importado.

  8. Não saia desta página.

Tarefa 5: Revisar e ajustar as definições

Para revisar e ajustar as definições, siga estas etapas:

  1. Selecione a guia Definição.

  2. Reserve alguns minutos para revisar as operações que foram importadas.

  3. Observe o triângulo laranja ao lado de GetInvoice indicando um aviso.

  4. Selecione a operação GetInvoice.

    Uma seta apontando para a ação obter fatura – captura de tela.

  5. Observe que a operação indica um Resumo ausente.

  6. Digite Obter Fatura como o Resumo para melhorar a usabilidade.

    Resumo da ação Obter Fatura – captura de tela.

  7. Observe o círculo azul de informações na operação PayInvoice indicando uma Descrição ausente.

  8. Digite Pagar uma fatura como a Descrição.

  9. Exclua as duas operações NewInvoice porque você não as usará.

    Uma seta apontando para o botão Excluir – captura de tela.

  10. Selecione a operação GetInvoiceSchema.

  11. Modifique a opção Visibilidade para Interna para que os usuários não a vejam na lista de ações.

  12. Selecione Atualizar conector.

    Uma seta apontando para o botão Atualizar conector – captura de tela.

  13. Não saia desta página.

Tarefa 6: teste o conector

Para testar o conector, siga estas etapas:

  1. Selecione a guia Teste.

  2. Selecione + Nova conexão.

    Uma seta apontando para o botão Nova conexão – captura de tela.

  3. Cole na chave de API que você salvou na Tarefa 1: Analisar a API e selecione Criar conexão.

  4. Selecione o botão Atualizar.

    Uma seta apontando para o botão Atualizar: captura de tela.

  5. Selecione ListInvoiceTypes > Testar Operação.

    Uma seta apontando para o botão de operação de teste: captura de tela

Alguns dados da fatura devem ser exibidos na área de corpo.