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

Nota: este artigo faz parte de uma série de tutoriais sobre a utilização do PowerApps, do Microsoft Flow e do Power BI com o SharePoint Online.Note: This article is part of a tutorial series on using PowerApps, Microsoft Flow, and Power BI with SharePoint Online. Certifique-se de que lê a introdução da série para obter uma noção da visão geral, bem como as transferências relacionadas.Make sure you read the series introduction to get a sense of the big picture, as well as related downloads.

O SharePoint inclui imensas funcionalidades de partilha e colaboração, mas iremos focar-nos na funcionalidade 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 é, basicamente, uma coleção de dados que pode partilhar com os membros da equipa e outros utilizadores do site.A list is just a collection of data that you can share with team members and other site users. Iremos rever as listas utilizadas para este cenário, e poderá então criá-las no seu próprio site do SharePoint Online.We'll review the lists used for this scenario, then you can create them in your own SharePoint Online site.

Passo 1: compreender as listasStep 1: Understand the lists

A primeira lista é Pedidos de Projeto, onde um requerente de projeto adiciona um pedido.The first list is Project Requests, where a project requestor adds a request. O aprovador de projeto revê então o pedido e aprova-o ou rejeita-o.The project approver then reviews the request and approves or rejects it.

Coluna de ListaList Column Tipo de DadosData Type NotasNotes
TítuloTitle Uma linha de textoSingle line of text Coluna predefinida, utilizada para o nome do projetoDefault column, used for project name
DescriçãoDescription Uma linha de textoSingle line of text
TipoProjetoProjectType Uma linha de textoSingle line of text Valores: novo hardware, hardware atualizado, software novo, software atualizadoValues: new hardware, upgraded hardware, new software, upgraded software
DataPedidoRequestDate DataDate
RequerenteRequestor Uma linha de textoSingle line of text
DiasPrevistosEstimatedDays NúmeroNumber Permite a comparação de estimativa do requerente com a estimativa do gestor do projeto com a atualEnables comparison of requestor estimate to project manager estimate to actual
AprovadoApproved Uma linha de textoSingle line of text Valores: pendentes, sim, nenhumValues: pending, yes, no

Nota: também utilizamos a coluna ID, que é gerada pelo SharePoint e ocultada por predefinição.Note: We also use the ID column, which is generated by SharePoint and hidden by default. Utilizamos tipos de dados básicos por uma questão de simplicidade, mas uma aplicação real poderá utilizar tipos mais complexos, como Pessoa ou Grupo para a coluna Requerente.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 suportados pelo PowerApps, veja Ligar do Microsoft PowerApps ao SharePoint.For information on data types supported by PowerApps, see Connect from Microsoft PowerApps to SharePoint.

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

Coluna de ListaList Column Tipo de DadosData Type NotasNotes
TítuloTitle Uma linha de textoSingle line of text Coluna predefinida, utilizada para o nome do projetoDefault column, used for project name
RequestIDRequestID NúmeroNumber Corresponde o valor na lista Pedidos de Projeto da coluna IDMatches the value in the Project Requests list ID column
ApprovedDateApprovedDate DataDate
EstadoStatus Uma linha de textoSingle line of text Valores: não iniciado, em curso, concluídoValues: not started, in progress, completed
ProjectedStartDateProjectedStartDate DataDate Quando o gestor de projeto prevê que o projeto irá começarWhen the project manager estimates that the project will start
ProjectedEndDateProjectedEndDate DataDate Quando o gestor de projeto prevê que o projeto irá terminarWhen the project manager estimates that the project will end
ProjectedDaysProjectedDays NúmeroNumber Dias de trabalho; normalmente seriam calculados, mas não o serã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 Uma linha de textoSingle line of text Gestor do projetoProject manager

Passo 2: criar e rever as listasStep 2: Create and review the lists

Para continuar com o cenário, terá de criar as duas listas do SharePoint e preenchê-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. Vamos mostrar-lhe como fazê-lo ao criar a lista e colar dados de exemplo na mesma.We'll show you how to do this by creating the list and pasting sample data into it. Certifique-se de que tem os ficheiros do Excel do pacote de transferência.Make sure you have the Excel files from the download package.

Nota: utilize o Internet Explorer para este passo.Note: Use Internet Explorer for this step.

Criar as listasCreate the lists

  1. No Internet Explorer, no seu 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. Introduza o nome "Pedidos de Projeto" e clique ou toque em Criar.Enter the name "Project Requests", then click or tap Create.

    Especificar o nome da nova lista

    A lista Pedidos de Projeto é criada, com o campo Título predefinindo.The Project Requests list is created, with the default Title field.

    Lista Pedidos de Projeto

Adicionar colunas à listaAdd columns to the list

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

    Adicionar o campo Uma linha de texto

  2. Introduza o nome "Descrição" e clique ou toque em Criar.Enter the name "Description", then click or tap Create.

    Criar a coluna de descrição

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

    1. Uma linha de texto > "TipoProjeto"Single line of text > "ProjectType"
    2. Data > "DataPedido"Date > "RequestDate"
    3. Uma linha de texto > "Requerente"Single line of text > "Requestor"
    4. Número > "DiasPrevistos"Number > "EstimatedDays"
    5. Uma linha de texto > "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 da lista

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

    Lista com todas as colunas

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

    Tabela Pedidos de Projeto do Excel

  4. Copie os dados e cole-os na grelha do 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 de cópia da lista "Detalhes do Projeto", utilizando o livro 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 em Passo 1: compreender as listas para obter os nomes de colunas e tipos de dados.Refer to the Project Details table in Step 1: Understand the lists for the column names and data types.

Passo 3: atualizar as ligações para os exemplos - opcionalStep 3: Update connections to samples - optional

Conforme indicado na introdução desta série de tutoriais, incluímos duas aplicações e um relatório de exemplo no pacote de transferência.As noted in the introduction to this tutorial series, we included two sample apps and a report in the download package. Pode concluir este cenário sem utilizar estes exemplos, mas se pretender utilizar os exemplos, tem de atualizar as ligaçõ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. Atualize-as para que utilizem as suas listas como uma origem de dados, em vez das nossas.You update them so that they use your lists as a data source, rather than ours.

Atualizar ligações para as aplicações de exemploUpdate connections for the sample apps

  1. Abra project-management-app.msapp no PowerApps Studio.Open project-management-app.msapp in PowerApps Studio.
  2. Clique ou toque em Permitir, para que o PowerApps possa utilizar o SharePoint.Click or tap Allow, so that PowerApps can use SharePoint.
  3. No friso, no separador Ver, clique ou toque em Origens de dados.On the ribbon, on the View tab, click or tap Data sources.

    Origens de dados do PowerApps

  4. No painel direito, clique ou toque nas reticências (. . .) ao lado de Detalhes do Projeto e clique ou toque em Remover.In the right pane, click or tap the ellipsis (. . .) next to Project Details, then click or tap Remove.

    Remover a origem de dados Detalhes do Projeto

  5. No painel direito, clique ou toque em Adicionar Origem de Dados.In the right pane, click or tap Add Data Source.

    Adicionar origem de dados

  6. Clique ou toque em Nova ligação.Click or tap New connection.

    Nova ligação

  7. Clique ou toque em SharePoint e em Ligar.Click or tap SharePoint, then Connect.

    Ligação ao SharePoint

  8. Introduza o URL do site SharePoint Online, que contém as listas que criou e 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 Ligar.Select the Project Details list, then click or tap Connect.

    Lista Detalhes do Projeto

    O separador Origens de dados no painel direito mostra agora a ligação que criou.The Data sources tab in the right pane now shows the connection that you created.

    Origens de dados

  10. No painel direito, clique ou toque nas reticências (. . .) ao lado de Detalhes do Projeto e clique ou toque em Atualizar.In the right pane, click or tap the ellipsis (. . .) next to Project Details, then click or tap Refresh.

    Atualizar a origem de dados Detalhes do Projeto

  11. Clique noClick ícone Executar aplicação no canto superior direito para executar a aplicação e certificar-se de que as ligações funcionam corretamente.in the upper right corner to run the app, and make sure the connections work properly.
  12. Repita os passos nesta secção para project-requests-app.msapp, utilizando a lista Pedidos de Projeto.Repeat the steps in this section for project-requests-app.msapp, using the Project Requests list.

Atualizar ligações para o 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. No friso, no separador Página Principal, clique ou toque em Editar consultas e em Definições da origem 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.

    Definições da origem de dados

  4. Introduza o URL do site do SharePoint Online e clique ou toque em OK.Enter the URL for your SharePoint Online site, then click or tap OK.

    URL da lista do SharePoint

  5. O Power BI Desktop apresenta uma faixa sob o friso, para que possa aplicar as alterações e importar dados da nova origem.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. Inicie sessão com uma conta organizacional (a conta que utiliza para aceder ao SharePoint Online) e clique ou toque em Ligar.Sign in with an organizational account (the account you use to access SharePoint Online), then click or tap Connect.

    Ligar ao SharePoint Online

Passos seguintesNext steps

O passo seguinte nesta série de tutoriais consiste em gerar uma aplicação para processar pedidos de projeto.The next step in this tutorial series is to generate an app to handle project requests.