Ligar ao SharePoint a partir da aplicação de tela

Ligar a um site do SharePoint para gerar uma aplicação automaticamente a partir de uma lista ou criar uma ligação antes de adicionar dados a uma aplicação existente ou criar uma aplicação de raiz.

Dependendo do local em que os dados residem, pode optar por uma ou ambas as abordagens:

• Mostrar dados a partir de uma lista num site do SharePoint Online ou num site no local.
• Mostrar imagens e reproduzir ficheiros de vídeo ou áudio numa biblioteca (SharePoint apenas online).

Gerar uma aplicação

Se pretende gerir dados numa lista, o Power Apps pode gerar uma aplicação de três ecrãs para si automaticamente. 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ã.

Criar uma ligação

1. Inicie sessão no Power Apps, selecione ligações > de dados na barra de navegação esquerda e, em seguida, selecione nova ligação perto do canto superior esquerdo.

   

2. Selecione SharePoint.

   

3. Execute um dos seguintes conjuntos de passos:

   • Para ligar ao SharePoint Online, selecione ligar diretamente (serviços em nuvem), selecione criar e, em seguida, forneça credenciais (se for solicitado).

     

     A ligação é criada e pode adicionar dados a uma aplicação existente ou construir uma aplicação de raiz.

   • Para se ligar a um site no local, selecione Ligar utilizando gateway de dados no local.

     

     Especifique Windows como o tipo de autenticação e, em seguida, especifique as suas credenciais. (Se as suas credenciais incluírem um nome de domínio, especifique-o como domain\alias.)

     

     Em escolha um gateway, selecione o gateway que pretende utilizar e, em seguida, selecione criar.

     Nota

     Se não tiver um gateway de dados no local instalado, instale um e, em seguida, selecione o ícone para atualizar a lista de gateways.

     

     A ligação é criada e pode adicionar dados a uma aplicação existente ou construir uma aplicação de raiz.

Adicionar dados a uma aplicação existente

1. Em Power Apps Studio, abra a aplicação que pretende atualizar, selecione Dados no painel esquerdo.

   

2. Selecione Adicionar dados > Conectores > SharePoint.

3. Em Ligar a um site do SharePoint, selecione uma entrada na lista Sites recentes (ou escreva ou cole o URL do site que pretende utilizar) e, em seguida, selecione Ligar.

   

4. Em Escolha uma lista, selecione a caixa de verificação de uma ou mais listas que queira utilizar e, em seguida, selecione Ligar:

   

   Nem todos os tipos de listas são apresentados por predefinição. O Power Apps suporta listas, listas não baseadas em modelos. 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 tabela personalizada.

   A origem ou origens de dados são adicionadas à sua aplicação.

Criar a sua própria aplicação a partir do zero

Aplique os conceitos em Criar uma aplicação desde o início até ao SharePoint em vez do Excel.

Mostrar colunas de lista numa galeria

Se a sua lista contiver qualquer um destes tipos de colunas, mostre esses dados num controlo Galeria utilizando a barra de fórmulas para definir a propriedade Text de um ou mais controlos Etiqueta nessa galeria:

• Para uma coluna de Escolha ou Pesquisa, especifique ThisItem.ColumnName.Value para mostrar dados nessa coluna.

  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.

• Para uma coluna de Pessoa ou Grupo, especifique ThisItem.ColumnName.DisplayName para mostrar o nome a apresentar do utilizador ou do grupo.

  Por exemplo, especifique ThisItem.Manager.DisplayName para mostrar os nomes a apresentar de uma coluna de Pessoa ou Grupo com o nome Manager.

  Também pode mostrar diferentes informações sobre utilizadores, tais como endereços de e-mail ou cargos. Para apresentar uma lista completa de opções, especifique ThisItem.ColumnName. (incluindo o ponto decimal).

  Nota

  Para uma coluna CreatedBy, especifique ThisItem.Author.DisplayName para mostrar os nomes a apresentar de utilizadores que criaram itens na lista. Para uma coluna ModifiedBy, especifique ThisItem.Editor.DisplayName para mostrar os nomes a apresentar de utilizadores que alteraram itens na lista.

• Para uma coluna de Metadados Geridos, especifique ThisItem.ColumnName.Etiqueta para mostrar dados nessa coluna.

  Por exemplo, especifique ThisItem.Languages.Label se tiver uma coluna de Metadados Geridos com o nome Idiomas.

Mostrar dados a partir de uma biblioteca

Se tiver várias imagens numa biblioteca SharePoint, poderá adicionar um comando de lista pendente à sua aplicação, para que os utilizadores possam especificar a imagem a apresentar. Também pode aplicar os mesmos princípios a outros comandos, como comandos da Galeria e outros tipos de dados, como vídeos.

1. Se ainda não o tiver feito, crie uma ligação e, em seguida, adicione dados a uma aplicação existente.

2. Adicionar um comando de lista pendente e nomeie-o como ImageList.

3. Defina a propriedade dos Items da ImageList como documentos.

4. No separador Propriedades do painel direito, abra a lista Valor e, em seguida, selecione Departamento.

   Os nomes de ficheiro das imagens na biblioteca aparecem em ImageList.

   

5. Adicione um controlo de Imagem e defina a propriedade de Imagem segundo esta expressão:

   ImageList.Selected.'Link to item'

6. Prima F5 e, em seguida, selecione um valor diferente em ImageList.

   A imagem especificada é apresentada.

   

Pode transferir uma aplicação de exemplo que demonstre uma abordagem mais complexa para mostrar dados de uma biblioteca SharePoint.

1. Depois de transferir a aplicação, abra o Power Apps Studio, selecione abrir na barra de navegação à esquerda e, em seguida, selecione procurar.
2. Na caixa de diálogo abrir, localize e abra o ficheiro que transferiu e, em seguida, adicione uma biblioteca SharePoint como uma origem de dados seguindo os dois primeiros procedimentos neste tópico.

Nesta aplicação de ecrã único, a lista no canto inferior esquerdo mostra todos os ficheiros na biblioteca.

• Pode procurar um ficheiro digitando ou colando um ou mais caracteres na caixa de pesquisa, perto da parte superior.
• Se a biblioteca contiver pastas, pode filtrar a lista de ficheiros selecionando um ícone de filtro na lista de pastas logo abaixo da barra de título.

Quando encontrar o ficheiro pretendido, selecione-o para o mostrar no Vídeo, Imagem ou Áudio do lado direito.

Problemas conhecidos

Partilhar Aplicações de tela através do conector do SharePoint O Power Apps não mostrará Aplicações de tela ligadas ao SharePoint que só são partilhadas com Todos, a menos que seja o criador da aplicações OU a tenha partilhado explicitamente (como utilizador ou coproprietário) através de associação a um grupo ou diretamente através da atribuição de utilizador. Para reproduzir essas aplicações, utilize a ligação direta para a aplicação.

Listas

O Power Apps pode ler nomes de colunas que contêm espaços, mas os espaços são substituídos pelo código de escape hexadecimal "_x0020_". Por exemplo, o "Nome da Coluna" no SharePoint aparecerá como "Column_x0020_Name" no Power Apps, quando apresentado no esquema de dados ou utilizado uma fórmula.

Nem todos os tipos de colunas são suportadas e nem todos os tipos de colunas suportam todos os tipos de cartões.

Bibliotecas

• Não é possível carregar ficheiros a partir do Power Apps para uma biblioteca.
• Não pode mostrar ficheiros PDF a partir de uma biblioteca num comando de visualizador de PDF.
• O Power Apps Mobile não suporta a função de transferência.
• Se os seus utilizadores executarem a aplicação no Power Apps Mobile ou na aplicação Windows 10, utilize a função Launch para apresentar o conteúdo da biblioteca numa galeria.

As imagens da biblioteca de documentos do SharePoint compõem intermitentemente

Listas com ligações para imagens armazenadas em bibliotecas de documentos do SharePoint podem não ser compostas dentro do Power Apps com erros de autenticação.

As ligações do Power Apps para o SharePoint são feitas para uma lista explicitamente identificada, e não para um site do SharePoint em geral. O Power Apps tentará resolver uma ligação externa a uma origem externa. A composição destas imagens tem sucesso se não for necessária autenticação, ou se o utilizador tiver autenticado previamente o site do SharePoint referenciado. No entanto, é comum que os utilizadores do Power Apps em dispositivos móveis possam não ter sido previamente autenticados no site do SharePoint referenciado para imagens. A utilização de ligações para referir a imagens de bibliotecas de documentos no SharePoint neste cenário pode não ter sucesso. Este comportamento aplica-se mesmo que exista uma ligação separada para a biblioteca de documentos dentro da aplicação.

Como solução para estes cenários, armazene imagens numa origem compatível com CORS, como Armazenamento do Azure ou um serviço CDN, como CDN do Azure que permite o acesso anónimo.

Passos seguintes

• Saiba como mostrar dados de uma origem de dados.
• Saiba como ver detalhes e criar ou atualizar registos.
• Veja outros tipos de origens de dados às quais pode ligar.

Consulte também

• Cenários de integração do SharePoint