Ligar ao SharePoint a partir do PowerAppsConnect to SharePoint from PowerApps

SharePoint

Ligue a um site do SharePoint para gerar uma aplicação automaticamente a partir de uma lista, criar uma aplicação a partir do zero ou atualizar uma aplicação existente.Connect to a SharePoint site to generate an app automatically from a list, build an app from scratch, or update an existing app.

Problemas conhecidosKnown issues

Pode adicionar dados de uma lista personalizada, mas não de uma biblioteca.You can add data from a custom list but not a library. Além disso, nem todos os tipos de colunas são suportadas e nem todos os tipos de colunas suportam todos os tipos de cartões.In addition, not all types of columns are supported, and not all types of columns support all types of cards.

Tipo de colunaColumn type SuporteSupport Cartões predefinidosDefault cards
Uma linha de textoSingle line of text SimYes Ver textoView text
Várias linhas de textoMultiple lines of text SimYes Ver textoView text
EscolhaChoice SimYes Ver pesquisaView lookup
Editar pesquisaEdit lookup
Ver seleção múltiplaView multiselect
Editar seleção múltiplaEdit multiselect
NúmeroNumber SimYes Ver percentagemView percentage
Ver classificaçãoView rating
Ver textoView text
MoedaCurrency SimYes Ver percentagemView percentage
Ver classificaçãoView rating
Ver textoView text
Data e HoraDate and Time SimYes Ver textoView text
PesquisaLookup SimYes Ver pesquisaView lookup
Editar pesquisaEdit lookup
Ver seleção múltiplaView multiselect
Editar seleção múltiplaEdit multiselect
Booleano (Sim/Não)Boolean (Yes/No) SimYes Ver textoView text
Ver alternânciaView toggle
Pessoa ou GrupoPerson or Group SimYes Ver pesquisaView lookup
Editar pesquisaEdit lookup
Ver seleção múltiplaView multiselect
Editar seleção múltiplaEdit multiselect
HiperligaçãoHyperlink SimYes Ver URLView URL
Ver textoView text
ImagemPicture Sim (só de leitura)Yes (read-only) Ver imagemView image
Ver textoView text
AnexoAttachment Sim (só de leitura)Yes (read-only) Ver AnexosView Attachments
CalculadoCalculated Sim (só de leitura)Yes (read-only)
Resultado da TarefaTask Outcome NãoNo
Dados externosExternal data NãoNo
Metadados GeridosManaged Metadata Sim (só de leitura)Yes (read-only)
ClassificaçãoRating NãoNo

As colunas que contêm espaços podem ser lidas pelo PowerApps, mas os espaços são substituídos pelo código de escape hexadecimal "_x0020_".Columns that contain spaces can by read by PowerApps, but the spaces are replaced with the hexadecimal escape code "_x0020_". Por exemplo, "Nome da Coluna" no SharePoint aparecerá como "Column_x0020_Name" no PowerApps, quando apresentado no esquema de dados ou utilizado uma fórmula.For example, "Column Name" in SharePoint will appear as "Column_x0020_Name" in PowerApps when displayed in the data layout or used in a formula.

Pré-requisitosPrerequisites

Abra o PowerApps, executando um destes passos:Open PowerApps by taking either of these steps:

Criar uma aplicaçãoCreate an app

Adicionar uma lista do SharePoint a uma aplicação existenteAdd a SharePoint list to an existing app

  1. No PowerApps Studio, abra a aplicação que pretende atualizar.In PowerApps Studio, open the app that you want to update.

  2. No separador Ver do friso, clique ou toque em Origens de dadosOn the View tab of the ribbon, click or tap Data sources

  3. No painel da direita, clique ou toque em Adicionar origem de dados.In the right-hand pane, click or tap Add data source.

    Adicionar origem de dados

  4. Clique ou toque em Nova ligação, clique ou toque em SharePoint e, em seguida, clique ou toque em Ligar.Click or tap New connection, click or tap SharePoint, and then click or tap Connect.

    Adicionar uma ligação no SharePoint

  5. Especifique o tipo de site do SharePoint ao qual pretende ligar:Specify the type of SharePoint site to which you want to connect:

    Especificar o tipo de ligação

    • Clique ou toque em Ligar diretamente (serviços cloud) para ligar ao SharePoint Online.Click or tap Connect directly (cloud services) to connect to SharePoint Online.

    • Clique ou toque em Ligar com gateway de dados no local para ligar a um site do SharePoint no local.Click or tap Connect using on-premises data gateway to connect to an on-premises SharePoint site.

      Especifique Windows como o tipo de autenticação e, em seguida, especifique as suas credenciais.Specify Windows as the authentication type, and then specify your credentials. (Se as suas credenciais incluírem um nome de domínio, especifique-o como domain\alias.)(If your credentials include a domain name, specify it as domain\alias.)

      Especificar credenciais

      Note: se não tiver instalado um gateway de dados no local, instale um e, em seguida, clique ou toque no ícone para atualizar a lista de gateways.Note: If you don't have an on-premises data gateway installed, install one, and then click or tap the icon to refresh the list of gateways.

      Em Escolher um gateway, clique ou toque no gateway que pretende utilizar.Under Choose a gateway, click or tap the gateway that you want to use.

      Escolher gateway

  6. Clique ou toque em Ligar.Click or tap Connect.

  7. Em Ligar a um site do SharePoint, clique ou toque numa entrada na lista Sites recentes (ou escreva ou cole o URL do site que pretende utilizar) e, em seguida, clique ou toque em Ir.Under Connect to a SharePoint site, click or tap an entry in the Recent sites list (or type or paste the URL for the site that you want to use), and then click or tap Go.

    Selecionar um site do SharePoint

  8. Em Escolha uma lista, selecione a caixa de verificação de uma ou mais listas que queira utilizar e, em seguida, clique ou toque em Ligar:Under Choose a list, select the check box for one or more lists that you want to use, and then click or tap Connect:

    Selecionar as tabelas no SharePoint

    Nem todos os tipos de listas são apresentados por predefinição.Not all types of lists appear by default. Se o nome da lista que pretende utilizar não aparecer, desloque-se para a parte inferior e, em seguida, escreva o nome da lista na caixa que contém Introduzir um nome de lista personalizada.If the name of the list that you want to use doesn't appear, scroll to the bottom, and then type the name of the list in the box that contains Enter a custom list name.

    Lista personalizada no SharePoint

    As origens de dados são adicionadas à sua aplicação.The data sources are added to your app.

    Lista de origens de dados adicionadas à aplicação

Para mostrar dados a partir de qualquer um destes tipos de colunas numa galeria, utilize a barra de fórmulas para definir a propriedade Text de um ou mais controlos de Etiqueta nessa galeria:To show data from any of these types of columns in a gallery, use the formula bar to set the Text property of one or more Label controls in that gallery:

  • Para uma coluna de Escolha ou Pesquisa, especifique ThisItem.[ColumnName].Value para mostrar dados nessa coluna.For a Choice or Lookup column, specify ThisItem.[ColumnName].Value to show data in that column.

    Por exemplo, especifique ThisItem.Location.Value se tiver uma coluna de Escolha com o nome Location e especifique ThisItem.PostalCode.Value se tiver uma coluna de Pesquisa com o nome PostalCode.For example, specify ThisItem.Location.Value if you have a Choice column named Location, and specify ThisItem.PostalCode.Value if you have a Lookup column named PostalCode.

  • Para uma coluna de Pessoa ou Grupo, especifique ThisItem.[ColumnName].DisplayName para mostrar o nome a apresentar do utilizador ou do grupo.For a Person or Group column, specify ThisItem.[ColumnName].DisplayName to show the display name of the user or the group.

    Por exemplo, especifique ThisItem.Manager.DisplayName para mostrar os nomes a apresentar de uma coluna de Pessoa ou Grupo com o nome Manager.For example, specify ThisItem.Manager.DisplayName to show display names from a Person or Group column named Manager.

    Também pode mostrar diferentes informações sobre utilizadores, tais como endereços de e-mail ou cargos.You can also show different information about users, such as email addresses or job titles. Para apresentar uma lista completa de opções, especifique ThisItem.[ColumnName].To display a complete list of options, specify ThisItem.[ColumnName]. (com o ponto decimal).(with the trailing period).

    Nota: para uma coluna CreatedBy, especifique ThisItem.Author.DisplayName para mostrar os nomes a apresentar de utilizadores que criaram itens na lista.Note: For a CreatedBy column, specify ThisItem.Author.DisplayName to show the display names of users who created items in the list. Para uma coluna ModifiedBy, especifique ThisItem.Editor.DisplayName para mostrar os nomes a apresentar de utilizadores que alteraram itens na lista.For a ModifiedBy column, specify ThisItem.Editor.DisplayName to show the display names of users who changed items in the list.

  • Para uma coluna de Metadados Geridos, especifique ThisItem.[ColumnName].Label para mostrar dados nessa coluna.For a Managed Metadata column, specify ThisItem.[ColumnName].Label to show data in that column.

    Por exemplo, especifique ThisItem.Languages.Label se tiver uma coluna de Metadados Geridos com o nome Languages.For example, specify ThisItem.Languages.Label if you have a Managed Metadata column named Languages.

Passos seguintesNext steps