Ligue-se ao SharePoint a partir de uma aplicação de telaConnect to SharePoint from a canvas app

SharePoint

Conecte-se a um site do SharePoint para gerar uma aplicação automaticamente a partir de uma lista personalizada, ou criar uma ligação antes de adicionar dados a uma aplicação existente ou construir uma aplicação de raiz.Connect to a SharePoint site to generate an app automatically from a custom list, or create a connection before you add data to an existing app or build an app from scratch.

Dependendo da residência dos seus dados, pode tomar ou ambas as abordagens:Depending on where your data resides, you can take either or both of these approaches:

  • Mostre dados de uma lista personalizada num site do SharePoint Online ou num site no local.Show data from a custom list in a SharePoint Online site or an on-premises site.
  • Mostre imagens e rejogue ficheiros de vídeo ou áudio numa biblioteca (apenas SharePoint Online).Show images and play video or audio files in a library (SharePoint Online only).

Gerar uma aplicaçãoGenerate an app

Se quiser gerir os dados numa lista personalizada, as Power Apps podem gerar automaticamente uma aplicação de três ecrãs para si.If you want to manage data in a custom list, Power Apps can generate a three-screen app for you automatically. Os utilizadores podem navegar na lista no primeiro ecrã, mostrar detalhes de um item no segundo ecrã e criar ou atualizar itens no terceiro ecrã.Users can browse the list on the first screen, show details of an item in the second screen, and create or update items in the third screen.

Nota

Se a sua lista SharePoint contiver uma Escolha, Lookup, ou person ou coluna de grupo, consulte os dados do Show numa galeria mais tarde neste tópico.If your SharePoint list contains a Choice, Lookup, or Person or group column, see Show data in a gallery later in this topic.

Criar uma ligaçãoCreate a connection

  1. Iniciar sessão nas Aplicações de Alimentação, selecione Ligações **de > ** de Dados na barra de navegação esquerda e, em seguida, selecione Nova ligação perto do canto superior esquerdo.Sign in to Power Apps, select Data > Connections in the left navigation bar, and then select New connection near the upper-left corner.

    Selecione Dados > Ligações na barra de navegação esquerda e, em seguida, selecione Nova ligação perto do canto superior esquerdo.Select Data > Connections in the left navigation bar, and then select New connection near the upper-left corner.

  2. Na caixa de pesquisa perto do canto superior direito, escreva ou colhe SharePoint, e, em seguida, selecione SharePoint.In the search box near the upper-right corner, type or paste SharePoint, and then select SharePoint.

    Na caixa de pesquisa perto do canto superior direito, escreva ou colhe o SharePoint e, em seguida, selecione SharePoint.In the search box near the upper-right corner, type or paste SharePoint, and then select SharePoint.

  3. Execute qualquer um destes conjuntos de passos:Perform either of these sets of steps:

    • Para ligar ao SharePoint Online, selecione Connect diretamente (serviços na nuvem) , selecione Criar, e, em seguida, forneça credenciais (se solicitado).To connect to SharePoint Online, select Connect directly (cloud services), select Create, and then provide credentials (if prompted).

      Para ligar ao SharePoint Online, selecione Connect diretamente (serviços na nuvem)To connect to SharePoint Online, select Connect directly (cloud services)

      A ligação é criada e pode adicionar um dado a uma aplicação existente ou construir uma app de raiz.The connection is created, and you can add a data to an existing app or build an app from scratch.

    • Para se ligar a um site no local, selecione Connect utilizando o gateway de dados no local.To connect to an on-premises site, select Connect using on-premises data gateway.

      Para ligar ao site no local, selecione **Connect usando gateway de dados no local)To connect to on-premises site, select **Connect using on-premises data gateway)

      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 credenciaisSpecify credentials

      Em 'Escolha um gateway', selecione o portal que pretende utilizar e, em seguida, selecione Criar.Under Choose a gateway, select the gateway that you want to use, and then select Create.

      Nota

      Se não tiver um portal de dados instalado no local, instale ume, em seguida, selecione o ícone para atualizar a lista de gateways.If you don't have an on-premises data gateway installed, install one, and then select the icon to refresh the list of gateways.

      Escolha de gatewayChoose gateway

      A ligação é criada e pode adicionar um dado a uma aplicação existente ou construir uma app de raiz.The connection is created, and you can add a data to an existing app or build an app from scratch.

Adicionar dados a uma aplicação existenteAdd data to an existing app

  1. No Power Apps Studio, abra a aplicação que pretende atualizar, selecione o separador 'Ver' e, em seguida, selecione fontes de Dados.In Power Apps Studio, open the app that you want to update, select the View tab, and then select Data sources.

    no separador 'Ver' e, em seguida, selecione fontes de dadosOn the View tab, and then select Data sources

  2. No painel dados, selecione Adicionar fonte de dados > SharePoint.In the Data pane, select Add data source > SharePoint.

  3. Em Connect a um site SharePoint, selecione uma entrada na lista de sites recentes (ou escreva ou colhe o URL para o site que pretende utilizar) e, em seguida, selecione Connect.Under Connect to a SharePoint site, select an entry in the Recent sites list (or type or paste the URL for the site that you want to use), and then select Connect.

    Selecione do siteSelect site

  4. Em 'Escolha uma lista', selecione a caixa de verificação para Documentos ou uma ou mais listas que pretende utilizar e, em seguida, selecione Ligar:Under Choose a list, select the check box for Documents or one or more lists that you want to use, and then select Connect:

    Em Baixo Escolha uma lista, selecione a caixa de verificação para Documentos ou uma ou mais listas que deseja utilizar e, em seguida, selecione ConnectUnder Choose a list, select the check box for Documents or one or more lists that you want to use, and then select Connect

    Nem todos os tipos de listas são apresentados por predefinição.Not all types of lists appear by default. As Power Apps suportam listas personalizadas, não listas baseadas em modelos.Power Apps supports custom lists, not template-based lists. Se o nome da lista que pretende utilizar não aparecer, percorra para baixo e, em seguida, digite o nome da lista na caixa que contém O nome da tabela personalizado.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 custom table name.

    Digite o nome da lista na caixa que contém Introduza um nome de lista personalizada.Type the name of the list in the box that contains Enter a custom list name.

    A fonte de dados ou fontes são adicionadas à sua aplicação.The data source or sources are added to your app.

Construa a sua própria app do zeroBuild your own app from scratch

Aplique os conceitos em Criar uma aplicação de raiz para SharePoint em vez de Excel.Apply the concepts in Create an app from scratch to SharePoint instead of Excel.

Se a sua lista personalizada contiver algum destes tipos de colunas, mostre esses dados num controlo da Galeria utilizando a barra de fórmula para definir a propriedade de Texto de um ou mais controlos de etiqueta seletiva nessa galeria:If your custom list contains any of these types of columns, show that data in a Gallery control by using the formula bar to set the Text property of one or more Label controls in that gallery:

  • Para uma coluna Choice ou Lookup, especifique o ThisItem. Nome da coluna . Valor para mostrar dados naquela 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 pessoa ou grupo, especifique o ThisItem. Nome da coluna . DisplayName para mostrar o nome do visualização 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 o ThisItem. Nome da coluna .To display a complete list of options, specify ThisItem.ColumnName. (incluindo o período de fuga).(including the trailing period).

    Nota

    Para uma coluna CreatedBy, especifique o ThisItem.Author.DisplayName para mostrar os nomes de visualização dos utilizadores que criaram itens na lista.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 o ThisItem. Nome da coluna . Etiqueta para mostrar dados naquela 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.

Mostrar dados de uma bibliotecaShow data from a library

Se tiver várias imagens numa biblioteca do SharePoint, pode adicionar um controlo drop down à sua aplicação para que os utilizadores possam especificar qual a imagem a mostrar.If you have several images in a SharePoint library, you can add a Drop down control to your app so that users can specify which image to show. Também pode aplicar os mesmos princípios a outros controlos, como controlos de galerias e outros tipos de dados, como vídeos.You can also apply the same principles to other controls, such as Gallery controls, and other types of data, such as videos.

  1. Se ainda não o fez, crie uma ligaçãoe adicione dados a uma aplicação existente.If you haven't already, create a connection, and then add data to an existing app.

  2. Adicione um controlo drop down e nomeie-o ImageList.Add a Drop down control, and name it ImageList.

  3. Detete a propriedade de Itens da ImageList para Documentos.Set the Items property of ImageList to Documents.

  4. No separador Propriedades do painel da direita, abra a lista valor e, em seguida, selecione Nome.On the Properties tab of the right-hand pane, open the Value list, and then select Name.

    Os nomes dos ficheiros das imagens na sua biblioteca aparecem no ImageList.The file names of the images in your library appear in ImageList.

    Lista de imagensList of images

  5. Adicione um controlo de Imagem e coloque a sua propriedade imagem nesta expressão:Add an Image control, and set its Image property to this expression:

    ImageList.Selected.'Link to item'

  6. Prima F5 e, em seguida, selecione um valor diferente no ImageList.Press F5, and then select a different value in ImageList.

    A imagem que especificou aparece.The image that you specified appears.

    imagem de amostraSample image

Pode descarregar uma aplicação de amostra que demonstre uma abordagem mais complexa para mostrar dados de uma biblioteca do SharePoint.You can download a sample app that demonstrates a more complex approach to showing data from a SharePoint library.

  1. Depois de descarregar a aplicação, abra o Power Apps Studio,selecione Open na barra de navegação esquerda e, em seguida, selecione Browse.After you download the app, open Power Apps Studio, select Open in the left navigation bar, and then select Browse.
  2. Na caixa de diálogo Open, encontre e abra o ficheiro que descarregou e, em seguida, adicione uma biblioteca SharePoint como fonte de dados seguindo os dois primeiros procedimentos neste tópico.In the Open dialog box, find and open the file that you downloaded, and then add a SharePoint library as a data source by following the first two procedures in this topic.

Nota

Por padrão, esta aplicação mostra avisos de delegação, mas pode ignorá-los se a sua biblioteca contiver menos de 500 itens.By default, this app shows delegation warnings, but you can ignore them if your library contains fewer than 500 items.

Nesta aplicação de um ecrã, a lista no canto inferior esquerdo mostra todos os ficheiros na sua biblioteca.In this one-screen app, the list in the lower-left corner shows all files in your library.

  • Pode procurar um ficheiro digitando ou colando um ou mais caracteres na caixa de pesquisa perto da parte superior.You can search for a file by typing or pasting one or more characters in the search box near the top.
  • Se a sua biblioteca contiver pastas, pode filtrar a lista de ficheiros selecionando um ícone de filtro na lista de pastas logo abaixo da barra de títulos.If your library contains folders, you can filter the list of files by selecting a filter icon in the list of folders just under the title bar.

Quando encontrar o ficheiro que deseja, selecione-o para o mostrar no controlo de vídeo, imagemou áudio ao longo do lado direito.When you find the file that you want, select it to show it in the Video, Image, or Audio control along the right-hand side.

imagem de amostraSample image

Problemas conhecidosKnown issues

ListasLists

As Aplicações de Energia podem ler nomes de colunas que contenham espaços, mas os espaços são substituídos pelo código de fuga hexadecimal "_x0020_" .Power Apps can read column names that contain spaces, but the spaces are replaced with the hexadecimal escape code "_x0020_". Por exemplo, o "Nome da Coluna" no SharePoint aparecerá como "Column_x0020_Name" em Aplicações de Alimentação quando apresentado no layout de dados ou utilizado numa fórmula.For example, "Column Name" in SharePoint will appear as "Column_x0020_Name" in Power Apps when displayed in the data layout or used in a formula.

Nem todos os tipos de colunas são suportados, e nem todos os tipos de colunas suportam todos os tipos de cartões.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
LookupLookup 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

BibliotecasLibraries

  • Não pode enviar ficheiros de Power Apps para uma biblioteca.You can't upload files from Power Apps to a library.
  • Não é possível mostrar ficheiros PDF de uma biblioteca com um controlo de visualização PDF.You can't show PDF files from a library in a PDF Viewer control.
  • Aplicações de energia Mobile não suporta mafunção de download.Power Apps Mobile doesn't support the Download function.
  • Se os seus utilizadores executarem a aplicação no Power Apps Mobile ou na aplicação Do Windows 10, utilize a função de Lançamento para exibir conteúdos da biblioteca numa galeria.If your users will run the app in Power Apps Mobile or the Windows 10 app, use the Launch function to display library content in a gallery.

Passos SeguintesNext steps