Exercício: usar Ações do GitHub para o Microsoft Power Platform

  • 15 minutos

Neste exercício, você exportará uma solução que contém um conector personalizado no GitHub usando ações do GitHub para Microsoft Power Platform.

Importante

Use um ambiente de teste com o Microsoft Dataverse provisionado. Se você não tiver um, poderá se inscrever no Plano da Comunidade. Também é necessário ter uma conta do GitHub para concluir o exercício. Você pode se inscrever gratuitamente em GitHub.com.

Observação

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

Tarefa 1: Importar a 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 e, depois, Importar solução.

  3. Selecione Procurar.

  4. Selecione a solução ContosoInvoicingALM_1_0_0_0.zip e, em seguida, selecione 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. Selecione a solução Contoso Invoicing - ALM que você importou.

    O componente de conector personalizado Contoso Invoicing - ALM deve ser exibido.

  9. No canto superior direito da tela, selecione o ícone Configurações e, em seguida, selecione Detalhes da sessão.

    Captura de tela dos detalhes de seleção da sessão.

  10. Na caixa de diálogo Detalhes da sessão do Power Apps, selecione o valor da URL da instância e copie-o para usar posteriormente no exercício.

    Captura de tela dos detalhes da sessão e de onde encontrar o valor da URL da instância.

Tarefa 2: Criar um repositório GitHub

Para criar um repositório GitHub, siga estas etapas:

  1. Vá para GitHub e selecione Criar repositório.

  2. Insira ContosoInvoiceALM como nome do repositório.

  3. Selecione Adicionar um arquivo README.

  4. Selecione Criar repositório.

  5. No novo repositório, selecione o ícone Configurações.

  6. Expanda a seção Segredos e variáveis e selecione Ações. Os segredos são variáveis de ambiente criptografadas. Qualquer pessoa com acesso de colaborador neste repositório pode usar esses segredos para ações do GitHub. Você criará três segredos para garantir que a ação que criou não contenha informações confidenciais.

  7. Selecione Novo segredo de repositório.

  8. Insira ambiente no campo Nome.

  9. Cole a URL de ambiente copiada na tarefa anterior no campo Segredo.

    Captura de tela da adição de um novo segredo de ação.

  10. Selecione Adicionar Segredo.

  11. Adicione outro segredo com um nome de usuário com o Segredo** contendo o email da conta que você usa para acessar o ambiente.

  12. Adicione outro segredo com um nome de senha com o Segredo contendo a senha da conta que você usa para acessar o ambiente.

  13. Depois que você adicionar os segredos, a lista de valores terá a aparência da captura de tela a seguir.

    Captura de tela das três ações em que você adicionou ambiente, senha, usuário.

  14. Expanda Ações e selecione Geral

    Captura de tela mostrando o botão de link geral de ações.

  15. Role para baixo até a seção Permissões de fluxo de trabalho, selecione a permissão Ler e gravar e selecione Salvar.

    Captura de tela mostrando a seção de permissões do fluxo de trabalho.

Tarefa 3: Criar uma ação do GitHub

Para criar uma ação do GitHub, siga estas etapas:

  1. Na navegação de repositório, selecione o item de menu Ação.

    Captura de tela da seleção de ações.

  2. Selecione a opção configurar um fluxo de trabalho por conta própria.

    Captura de tela da opção de configuração de fluxo de trabalho por conta própria selecionada.

  3. Abra o arquivo export-and-branch-solution.yml fornecido e cole o conteúdo na área Editar novo arquivo.

    Captura de tela da colagem nas novas etapas de ação.

  4. Você adicionou as quatro etapas a seguir: 1) Ação Quem-sou-eu para testar a conexão, 2) Exportar solução, 3) Descompactar a solução e 4) Criar um branch e fazer check-in dos arquivos de solução.

    Captura de tela das etapas descritas acima.

  5. Selecione Iniciar confirmação no lado direito e, em seguida, selecione Confirmar novo arquivo. Esta etapa salvará a ação que você criou.

    Captura de tela da ações iniciar confirmação e confirmar novo arquivo sendo selecionadas.

A ação foi salva e está pronta para ser executada.

Tarefa 4: Executar a ação de exportação

Para executar a ação de exportação, siga estas etapas:

  1. Vá para o repositório Ações.

    Captura de tela da seleção de ações para ver a lista.

  2. Selecione a ação export-and-branch-solution e, em seguida, selecione Executar fluxo de trabalho.

    Captura de tela da seleção da ação que você criou e da seleção de executar fluxo de trabalho.

  3. Na seção Usar fluxo de trabalho de, selecione o branch principal e, em seguida, selecione Executar fluxo de trabalho.

    Captura de tela da seleção de executar fluxo de trabalho.

  4. Monitore o andamento do fluxo de trabalho até que ele seja concluído com êxito.

    Captura de tela do andamento da execução do fluxo de trabalho.

  5. Selecione Código na navegação e, em seguida, selecione branches.

    Captura de tela da opção Código, do número de branches e da seleção da lista de branches.

  6. Você verá o branch criado pela implementação da ação do GitHub. No momento, esse branch não está mesclado com o branch principal. Selecione Nova solicitação de pull para iniciar o processo de mesclagem.

    Captura de tela da seleção da nova solicitação de pull do branch recém-criado.

  7. Na área de comentários, insira a Versão inicial do conector.

  8. Selecione a opção Criar solicitação de pull.

  9. Neste ponto, é comum outra pessoa fazer a revisão e a mesclagem, mas como você é a única pessoa que está fazendo o exercício, você mesmo deve aprovar a solicitação de pull.

  10. Expanda Mesclar solicitação de pull e, em seguida, selecione Squash e merge.

    Captura de tela da seleção da solicitação de mesclagem.

  11. Selecione Squash e merge e, em seguida, selecione Confirmar squash e merge.

    Agora, o branch com suas alterações foi mesclado.

  12. Selecione Código e, em seguida, selecione solutions/ContosoInvoiciningALM. Essa pasta contém os arquivos da solução criados. Você pode navegar pelo conteúdo dessa pasta para determinar o que foi extraído da solução e armazenado como arquivos individuais.

    Captura de tela do conteúdo do repositório após a mesclagem.

Tarefa 5: Alterar e registrar as definições de conector

Para alterar e registrar as definições de conector, siga estas etapas:

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

  2. Escolha Soluções e selecione para abrir a solução Contoso Invoicing - ALM.

  3. Selecione as reticências (...) ao lado do componente de conector personalizado e, em seguida, selecione Editar.

    Captura de tela da edição do conector para fazer uma alteração.

  4. Altere a Cor de fundo do ícone para #0066ff e selecione Atualizar conector.

    Captura de tela da seleção do conector de atualização após a alteração da cor.

  5. Repita as etapas 1 a 12 da Tarefa 4 para executar o fluxo de trabalho, criar uma nova solicitação de pull e mesclar o código no branch principal.

  6. Selecione Código na navegação e, em seguida, selecione o nome da solicitação de pull para abrir os detalhes.

    Captura de tela da solicitação de pull.

  7. Verifique a alteração registrada na cor do ícone de #007ee5 para #0066ff.

    Captura de tela da alteração da cor do ícone na diferença.

Observação

Outras alterações automáticas podem ser aplicadas quando você salva o conector, por exemplo, o formato do ícone pode mudar de JPEG para PNG.

Agora você tem um processo automatizado para exportar e registrar as alterações de conector personalizado em um sistema de controle do código-fonte.