Configurar listas para a integração do SharePoint Online com o PowerApps, o Microsoft Flow e o Power BISet up lists for SharePoint Online integration with PowerApps, Microsoft Flow, and Power BI

Observação

Este artigo faz parte de uma série de tutoriais sobre como usar o PowerApps, o Microsoft Flow e o Power BI com o SharePoint Online.This article is part of a tutorial series on using PowerApps, Microsoft Flow, and Power BI with SharePoint Online. Certifique-se de ler a Introdução da série para ter uma noção da visão geral, bem como dos downloads relacionados.Make sure you read the series introduction to get a sense of the big picture, as well as related downloads.

O SharePoint tem acesso a uma infinidade de recursos para compartilhamento e colaboração, mas vamos nos concentrar em um recurso para este cenário: listas do SharePoint.SharePoint has a ton of features for sharing and collaboration, but we will focus on one feature for this scenario: SharePoint lists. Uma lista é apenas uma coleção de dados que você pode compartilhar com os membros da equipe e outros usuários do site.A list is just a collection of data that you can share with team members and other site users. Vamos examinar as listas usadas para esse cenário e, em seguida, você poderá criá-las no site do SharePoint Online.We'll review the lists used for this scenario, then you can create them in your own SharePoint Online site.

Etapa 1: compreender as listasStep 1: Understand the lists

A primeira lista é Solicitações de Projeto, em que um solicitante de projeto adiciona uma solicitação.The first list is Project Requests, where a project requestor adds a request. Em seguida, o aprovador de projeto revisa a solicitação e a aprova ou rejeita.The project approver then reviews the request and approves or rejects it.

Coluna da listaList Column Tipo de dadosData Type ObservaçõesNotes
TítuloTitle Única linha de textoSingle line of text Coluna padrão, usada para o nome do projetoDefault column, used for project name
DescriçãoDescription Única linha de textoSingle line of text
ProjectTypeProjectType Única linha de textoSingle line of text Valores: novo hardware, hardware atualizado, novo software, software atualizadoValues: new hardware, upgraded hardware, new software, upgraded software
RequestDateRequestDate DataDate
SolicitanteRequestor Única linha de textoSingle line of text
EstimatedDaysEstimatedDays NúmeroNumber Habilita a comparação da estimativa do solicitante com a estimativa do gerente de projeto e com o realEnables comparison of requestor estimate to project manager estimate to actual
AprovadoApproved Única linha de textoSingle line of text Valores: pendente, sim, nãoValues: pending, yes, no

Observação

Também usamos a coluna ID, que é gerada pelo SharePoint e fica oculta por padrão.We also use the ID column, which is generated by SharePoint and hidden by default. Usamos tipos de dados básicos para manter a simplicidade, mas um aplicativo real pode usar tipos mais complexos, como Pessoa ou Grupo para a coluna Solicitante.We use basic data types for simplicity, but a real app might use more complex types, like Person or Group for the Requestor column. Para obter informações sobre os tipos de dados com suporte pelo PowerApps, consulte Conectar do Microsoft PowerApps para o SharePoint.For information on data types supported by PowerApps, see Connect from Microsoft PowerApps to SharePoint.

A segunda lista é Detalhes do Projeto, que acompanha os detalhes de todos os projetos aprovados, como qual gerente de projeto está atribuído.The second list is Project Details, which tracks details for all approved projects, like which project manager is assigned.

Coluna da listaList Column Tipo de dadosData Type ObservaçõesNotes
TítuloTitle Única linha de textoSingle line of text Coluna padrão, usada para o nome do projetoDefault column, used for project name
RequestIDRequestID NúmeroNumber Corresponde ao valor na lista Solicitações de Projeto, na coluna IDMatches the value in the Project Requests list ID column
ApprovedDateApprovedDate DataDate
StatusStatus Única linha de textoSingle line of text Valores: não iniciado, em andamento, concluídoValues: not started, in progress, completed
ProjectedStartDateProjectedStartDate DataDate Quando o gerente de projeto estima que o projeto começaráWhen the project manager estimates that the project will start
ProjectedEndDateProjectedEndDate DataDate Quando o gerente de projeto estima que o projeto terminaráWhen the project manager estimates that the project will end
ProjectedDaysProjectedDays NúmeroNumber Dias úteis, seria calculado normalmente, mas não é neste cenárioWorking days; would typically be calculated, but isn't in this scenario
ActualDaysActualDays NúmeroNumber Para projetos concluídosFor completed projects
PMAssignedPMAssigned Única linha de textoSingle line of text Gerente de projetoProject manager

Etapa 2: criar e examinar as listasStep 2: Create and review the lists

Para continuar com o cenário, você precisa criar as duas listas do SharePoint e populá-las com os dados de exemplo.To continue with the scenario, you need to create the two SharePoint lists and populate them with sample data. Mostraremos como fazer isso criando a lista e colando dados de exemplo nela.We'll show you how to do this by creating the list and pasting sample data into it. Certifique-se de ter os arquivos Excel do pacote de download.Make sure you have the Excel files from the download package.

Observação

Use o Internet Explorer para esta etapa.Use Internet Explorer for this step.

Criar as listasCreate the lists

  1. No Internet Explorer, no site do SharePoint, clique ou toque em Novo e em Lista.In Internet Explorer, in your SharePoint site, click or tap New, then List.

    Criar nova lista do SharePoint

  2. Insira o nome "Solicitações de Projeto" e clique ou toque em Criar.Enter the name "Project Requests", then click or tap Create.

    Especificar um nome para a nova lista

    A lista Solicitações de Projeto lista é criada com o campo Título padrão.The Project Requests list is created, with the default Title field.

    Lista Solicitações de Projeto

Adicionar colunas à listaAdd columns to the list

  1. Clique ou toque em ícone de Novo item e em Texto com uma linha.Click or tap New item icon, then Single line of text.

    Adicionar campo de texto com uma linha

  2. Insira o nome "Descrição" e clique ou toque em Salvar.Enter the name "Description", then click or tap Save.

  3. Repita as etapas 1.Repeat steps 1. e 2.and 2. para as outras colunas na lista:for the other columns in the list:

    1. Texto com uma linha > "ProjectType"Single line of text > "ProjectType"
    2. Data > "RequestDate"Date > "RequestDate"
    3. Texto com uma linha > "Solicitante"Single line of text > "Requestor"
    4. Número > "EstimatedDays"Number > "EstimatedDays"
    5. Texto com uma linha > "Aprovado"Single line of text > "Approved"

Copiar os dados para a listaCopy data into the list

  1. Clique ou toque em Edição rápida.Click or tap Quick edit.

    Edição rápida para a lista

  2. Selecione as células na grade.Select the cells in the grid.

    Lista com todas as colunas

  3. Abra a pasta de trabalho project-requests.xlsx e selecione todos os dados (não os cabeçalhos).Open the project-requests.xlsx workbook and select all the data (not the headings).

    Tabela do Excel Solicitações de Projeto

  4. Copie os dados e cole-os na grade no SharePoint e clique ou toque em Concluído.Copy the data and paste it into the grid in SharePoint, then click or tap Done.

    Lista concluída com os dados

  5. Repita o processo de criação e cópia de lista para a lista "Detalhes do Projeto" usando a pasta de trabalho project-details.xlsx.Repeat the list creation and copy process for the "Project Details" list, using the project-details.xlsx workbook. Consulte a tabela Detalhes do Projeto na Etapa 1: Compreender as listas para os tipos de dados e nomes de coluna.Refer to the Project Details table in Step 1: Understand the lists for the column names and data types.

Etapa 3: atualizar conexões com amostras, opcionaisStep 3: Update connections to samples - optional

Conforme observado na introdução para esta série de tutoriais, incluímos dois aplicativos de exemplo e um relatório no pacote de download.As noted in the introduction to this tutorial series, we included two sample apps and a report in the download package. Você pode concluir este cenário sem usar esses exemplos, mas se quiser usar os exemplos, precisará atualizar as conexões para as listas do SharePoint.You can complete this scenario without using these samples, but if you want to use the samples, you need to update the connections to the SharePoint lists. Você as atualiza para que usem suas listas como uma fonte de dados, em vez da nossa.You update them so that they use your lists as a data source, rather than ours.

Atualizar conexões para aplicativos de exemploUpdate connections for the sample apps

  1. Em PowerApps Studio, clique ou toque em Abrir no painel esquerdo.In PowerApps Studio, click or tap Open in the left pane.

  2. Clique ou toque em Procurar, em seguida, abra arquivo project-management-app.msapp que você baixou.Click or tap Browse, then open the project-management-app.msapp file that you downloaded.

  3. Clique ou toque em Permitir, de modo que o PowerApps possa usar o SharePoint.Click or tap Allow, so that PowerApps can use SharePoint.

  4. Na faixa de opções, na guia Exibição, clique ou toque em Fontes de dados.On the ribbon, on the View tab, click or tap Data sources.

    Fontes de dados do PowerApps

  5. No painel Dados, clique ou toque nas reticências (. . .) ao lado de Detalhes do Projeto e, em seguida, clique ou toque em Remover.In the Data panel, click or tap the ellipsis (. . .) next to Project Details, then click or tap Remove.

    Remover a fonte de dados de Detalhes do Projeto

  6. Clique ou toque em Adicionar Fonte de Dados.Click or tap Add Data Source.

    Adicionar fonte de dados

  7. Mostraremos duas maneiras de se conectar à lista, dependendo se o PowerApps já estabeleceu uma conexão do SharePoint para você:We'll show you two ways to connect to the list, depending on whether PowerApps already established a SharePoint connection for you:

    • Se você já vir uma conexão do SharePoint, clique ou toque nessa conexão.If you see a SharePoint connection already, click or tap that connection.

      Conexão existente

    • Se você não vir uma conexão do SharePoint, clique ou toque em Nova conexão.If you don't see a SharePoint connection, click or tap New connection.

      Nova conexão

      Em seguida, clique ou toque em SharePoint e clique ou toque em Criar.Then click or tap SharePoint, and click or tap Create.

      Conexão do SharePoint

  8. Insira a URL para o site do SharePoint Online que contém as listas que você criou e, em seguida, clique ou toque em Ir.Enter the URL for the SharePoint Online site that contains the lists you created, then click or tap Go.

    URL do SharePoint

  9. Selecione a lista Detalhes do Projeto e clique ou toque em Conectar.Select the Project Details list, then click or tap Connect.

    Lista Detalhes do Projeto

    O painel Dados agora mostra a conexão que você criou.The Data panel now shows the connection that you created.

    Fontes de dados

  10. Clique ou toque nas reticências (. . .) ao lado de Detalhes do Projeto e, em seguida, clique ou toque em Atualizar.Click or tap the ellipsis (. . .) next to Project Details, then click or tap Refresh.

    Atualizar a fonte de dados de Detalhes do Projeto

  11. Clique emClick Ícone Executar aplicativo no canto superior direito para executar o aplicativo e verifique se a conexão funciona corretamente.in the upper right corner to run the app, and make sure the connection works properly.

  12. Clique ou toque em Arquivo, em seguida, salve o aplicativo na nuvem.Click or tap File, then save the app to the cloud.

  13. Repita as etapas nesta seção para project-requests-app.msapp usando a lista Solicitações de Projeto.Repeat the steps in this section for project-requests-app.msapp, using the Project Requests list.

Atualizar conexões para relatório de exemploUpdate connections for the sample report

  1. Abra project-analysis.pbix no Power BI Desktop.Open project-analysis.pbix in Power BI Desktop.

  2. Na faixa de opções, na guia Início, clique ou toque em Editar consultas e em Configurações de fonte de dados.On the ribbon, on the Home tab, click or tap Edit queries, then Data source settings.

    Editar consultas

  3. Clique ou toque em Alterar Origem.Click or tap Change Source.

    Configurações da fonte de dados

  4. Insira a URL para o site do SharePoint Online e, em seguida, clique ou toque em OK e em Fechar.Enter the URL for your SharePoint Online site, then click or tap OK, then Close.

    URL da lista do SharePoint

  5. O Power BI Desktop exibe uma faixa sob a faixa de opções, para que você possa aplicar as alterações e trazer dados da nova fonte.Power BI Desktop displays a banner under the ribbon, so you can apply changes and bring in data from the new source. Clique ou toque em Aplicar Alterações.Click or tap Apply Changes.

    Aplicar alterações de consulta

  6. Entre com uma conta da Microsoft (a conta usada para acessar o SharePoint Online) e clique ou toque em Conectar.Sign in with a Microsoft account (the account you use to access SharePoint Online), then click or tap Connect.

    Conectar-se ao SharePoint Online

Próximas etapasNext steps

A próxima etapa nessa série de tutoriais é gerar um aplicativo para tratar as solicitações de projeto.The next step in this tutorial series is to generate an app to handle project requests.