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

SharePoint

Ligar a um site 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 criar uma aplicação a partir do zero.

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

  • Mostrar dados a partir de uma lista personalizada num site 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 pretender gerir dados numa lista personalizada, o Power Apps pode gerar uma aplicação de três ecrãs 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ã.

Nota

Se a sua lita SharePoint incluir uma coluna Escolha, Pesquisa ou Pessoa ou grupo, veja a secção Mostrar dados numa galeria mais à frente neste tópico.

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.

    Selecione Dados > Ligações na barra de navegação esquerda e, em seguida, selecione nova ligação perto do canto superior esquerdo.

  2. Na caixa de pesquisa, junto ao canto superior direito, escreva ou cole SharePoint e, em seguida, selecione SharePoint.

    Na caixa de pesquisa, junto ao canto superior direito, escreva ou cole SharePoint, e, em seguida, 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).

      Para ligar ao SharePoint Online, selecione ligar diretamente (serviços em nuvem)

      A ligação é criada e pode adicionar dados a uma aplicação existente ou criar uma aplicação a partir do zero.

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

      Para ligar a um site no local, selecione **Ligar com 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.)

      Especificar credenciais

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

      Nota

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

      Escolher gateway

      A ligação é criada e pode adicionar dados a uma aplicação existente ou criar uma aplicação a partir do zero.

Adicionar dados a uma aplicação existente

  1. No Power Apps Studio, abra a aplicação que pretende atualizar, selecione o separador Vista e, em seguida, selecione origens de dados.

    No separador Vistas, selecione origens de dados

  2. No painel Dados, selecione Adicionar origem de dados > 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.

    Selecione o site

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

    Em Escolha uma lista, selecione a caixa de verificação para Documentoss ou 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 personalizadas e 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.

    Escreva o nome da lista na caixa que contém o nome de uma lista 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.

Se a lista personalizada contiver qualquer um destes tipos de coluna, mostre esses dados num comando de Galeria utilizando a barra de fórmulas para definir a propriedade de texto de um ou mais comandos de 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.Label 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 Itens 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.

    Lista de imagens

  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.

    Lista de Imagens

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.

Nota

Por predefinição, esta aplicação mostra avisos de delegação, mas pode ignorá-los se a sua biblioteca contiver menos de 500 itens.

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.

Imagem de exemplo

Problemas conhecidos

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.

Tipo de coluna Suporte Cartões predefinidos
Uma linha de texto Sim Ver texto
Várias linhas de texto Sim Ver texto
Opção Sim Ver pesquisa
Editar pesquisa
Ver seleção múltipla (apenas no SharePoint Online)
Editar seleção múltipla (apenas no SharePoint Online)
Número Sim Ver percentagem
Ver classificação
Ver texto
Moeda Sim Ver percentagem
Ver classificação
Ver texto
Data e Hora Sim Ver texto
Pesquisa Sim Ver pesquisa
Editar pesquisa
Ver seleção múltipla
Editar seleção múltipla
Booleano (Sim/Não) Sim Ver texto
Ver alternância
Pessoa ou Grupo Sim Ver pesquisa
Editar pesquisa
Ver seleção múltipla
Editar seleção múltipla
Hiperligação Sim Ver URL
Ver texto
Imagem Sim (só de leitura) Ver imagem
Ver texto
Anexo Sim (só de leitura) Ver Anexos
Calculado Sim (só de leitura)
Imagem No
Resultado da Tarefa No
Dados externos No
Metadados Geridos Sim (só de leitura)
Classificação No

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 Lançamento para apresentar o conteúdo da biblioteca numa galeria.

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

Listas do SharePoint com ligações para imagens armazenadas em bibliotecas de documentos do SharePoint podem não compor 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

Consulte também

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).