Exercício: usar um modelo de política para definir dinamicamente a URL do host

  • 10 minutos

Neste exercício, você criará um modelo de política para definir a URL do host na criação da conexão. Esse processo permitirá que uma conexão funcione com o teste ou a produção.

Este exercício requer a instalação do Python e o acesso ao prompt de comando no computador usado para o exercício.

Importante

Use um ambiente de teste com o Microsoft Dataverse provisionado. Se você não tiver um, poderá se inscrever no plano da comunidade.

Observação

Baixe o arquivo a seguir no computador local para fazer este exercício Contoso Invoicing Triggers. Selecione o botão download no meio à direita da tela.

Tarefa 1: Importar uma solução

Nesta tarefa, você importará uma solução não gerenciada que contém um conector personalizado da Contoso Invoicing. Você usará esse conector para concluir as tarefas deste exercício.

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

  2. Selecione Soluções > Importar solução.

  3. Selecione Procurar.

  4. Selecione a solução ContosoInvoicingPolicyTemplates_1_0_0_2.zip e clique em Abrir.

  5. Selecione Avançar.

  6. Selecione Importar e aguarde a conclusão da importação. Uma mensagem de êxito deve aparecer após a conclusão da importação.

  7. Selecione Publicar Todas as Personalizações e aguarde o término da publicação.

  8. Abra a solução Contoso Invoicing – Modelos de Política que você importou.

    O componente de conector personalizado Contoso Invoicing - Política deve ser exibido.

    Captura de tela dos componentes da solução.

Tarefa 2: instalar a Microsoft Power Platform CLI

A Microsoft Power Platform CLI inclui a ferramenta de linha de comando paconn, que foi criada para auxiliar no desenvolvimento de conectores personalizados do Microsoft Power Platform. A ferramenta paconn usa o runtime do Python, portanto, você também o instalará.

  1. Acesse Download do Python e selecione Baixar o Python. Você pode usar qualquer versão superior a 3.5.

  2. Selecione o arquivo .exe baixado para iniciar a instalação.

  3. Marque a caixa de seleção Adicionar Python XX ao Caminho, selecione instalar e aguarde a conclusão da instalação.

    Captura de tela do processo de instalação do Python.

  4. Feche o assistente de instalação após a conclusão da instalação.

  5. Inicie o prompt de comando e execute o seguinte comando para instalar o paconn.

    pip install paconn

    Captura de tela da instalação do comando paconn.

  6. Aguarde a conclusão da instalação.

Tarefa 3: baixar o conector localmente

Nesta tarefa, você baixará os arquivos de definição de conector localmente para adicionar a propriedade URL do Host.

  1. Execute o comando login.

    paconn login

  2. Copie o Código fornecido.

  3. Em um navegador, faça login com as mesmas credenciais do seu ambiente. Vá para Entrar no dispositivo Microsoft, cole o Código copiado e, em seguida, selecione Avançar.

  4. Forneça as credenciais.

  5. Selecione Continuar.

  6. Uma mensagem de entrada com êxito deve aparecer.

    Captura de tela da mensagem de entrada bem-sucedida.

  7. Retorne ao prompt de comando e execute o comando de download.

    paconn download

  8. Quando solicitado a selecionar um ambiente, insira um número para o ambiente em que você instalou a solução e pressione a tecla Enter.

  9. Somente um conector deve ser listado: Política da Contoso Invoicing. Pressione a tecla Enter novamente para selecionar o conector.

  10. O download deve ser concluído com êxito. Observe o local em que o conector foi baixado.

Tarefa 4: Editar apiProperties.json para adicionar a propriedade URL do Host

Nesta tarefa, você editará o arquivo apiProperties.json para configurar a propriedade hostUrl. Quando a propriedade é configurada, os usuários que estão criando uma conexão são solicitados a informar esse valor junto com a chave de API.

  1. Acesse a pasta que você baixou na tarefa anterior e abra o arquivo apiProperties.json.

  2. Cole o JSON no ConnectionParameters, antes da propriedade api_key.

    "hostUrl": {
        "type": "string",
        "uiDefinition": {
          "constraints": {
            "required": "true"
          },
          "description": "Specify your API Url e.g. https://test.contoso.com",
          "displayName": "API URL",
          "tooltip": "Specify your API Url e.g. https://test.contoso.com"
        }
      },

    Captura de tela da propriedade de URL do host.

  3. Salve suas alterações.

  4. Vá para o prompt de comando e altere o diretório para a pasta que você baixou.

  5. Execute o comando de atualização.

    paconn update --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png

  6. Selecione o ambiente correto em que a solução foi instalada.

  7. Selecione o conector Contoso Invoicing - Política.

A atualização deve ser concluída com êxito.

Tarefa 5: Adicionar a política Definir Nome de Host

Nesta tarefa, você configurará um modelo de política Definir Nome de Host para usar a propriedade de conexão que você configurou na tarefa anterior.

  1. Acesse o Power Apps Maker Portal e verifique se o ambiente correto foi selecionado.

  2. Selecione Soluções e abra a solução Contoso Invoicing – Modelos de Política que você importou.

  3. Selecione o conector personalizado Contoso Invoicing – Política e, depois, selecione Editar.

    Captura de tela de uma seta apontando para o botão do conector de edição.

  4. Selecione a guia Definição.

  5. Role até a seção Políticas e selecione + Nova política.

    Captura de tela de uma seta apontando para o botão de adição de nova política.

  6. Insira Política de URL do Host em Nome e selecione Definir URL do host em Modelo.

    Captura de tela de uma seta apontando para a seleção de modelo do host.

  7. Insira @connectionParameters('hostUrl') em Modelo de URL e selecione Atualizar conector.

    Captura de tela de uma seta apontando para o botão Atualizar conector.

    O conector deve ser atualizado com êxito.

  8. Não saia desta página.

Tarefa 6: Testar

Nesta tarefa, você criará uma conexão usando a nova configuração e a testará.

  1. Inicie uma nova janela do navegador e vá para Contoso Invoicing.

  2. Selecione o link Chave de API.

  3. Copie a chave de API.

  4. Retorne ao conector.

  5. Selecione a guia Teste.

  6. Selecione + Nova conexão.

    Captura de tela de uma seta apontando para o botão para adicionar nova conexão.

  7. Insira https://contosoinvoicingtest.azurewebsites.net/ em URL da API, cole a Chave de API que você copiou e selecione Criar conexão.

  8. Selecione Atualizar conexões.

    Captura de tela de uma seta apontando para o botão Atualizar conexões.

  9. Selecione ListInvoice >Testar operação.

    Captura de tela da janela Testar operação.

    O teste deve retornar faturas.

    Captura de tela do campo do corpo da resposta.