Compartilhar via


Conectar-se ao SharePoint a partir de um aplicativo de tela

Há diferentes maneiras de se conectar ao SharePoint em um aplicativo de tela:

  • Conecte-se a um site do SharePoint para gerar um aplicativo automaticamente a partir de uma lista.
  • Crie uma conexão do SharePoint antes de adicionar dados a um aplicativo novo ou existente.

Observação

Ao criar ou exibir uma lista no SharePoint, você será redirecionado automaticamente para o Microsoft Lists. A lista sempre pode ser encontrada nas Listas da Microsoft e no SharePoint. Saiba mais em O que é uma lista no Microsoft 365?.

Conectar o SharePoint a um aplicativo criando um aplicativo

Se você tiver um site do SharePoint com uma lista do SharePoint, poderá criar um aplicativo no Power Apps por meio do menu de lista nas Listas da Microsoft.

O menu Integrar>o Power Apps>Criar um aplicativo nas Listas da Microsoft leva você ao Power Apps e cria um aplicativo usando sua lista como fonte de dados.

Saiba mais em Criar um aplicativo de tela com dados das Listas da Microsoft.

Criar uma conexão do SharePoint

Se você criar um novo aplicativo ou tiver um aplicativo existente, poderá se conectar ao SharePoint por meio do menu Dados no Power Apps.

  1. Entre no Power Apps.

  2. Selecione Mais>Conexões na barra de navegação esquerda.

    Captura de tela que mostra o local da opção de menu Conexões no menu Mais.

  3. Selecione + Nova conexão e escolha SharePoint. Um pop-up é exibido.

  4. Escolha a opção de serviços de nuvem ou local:

    • Para se conectar ao SharePoint Online, selecione Conectar diretamente (serviços de nuvem) e, em seguida, Criar. Forneça credenciais (se solicitado).

      Para se conectar ao SharePoint Online, selecione Conectar diretamente (serviços de nuvem).

      A conexão é criada e você pode adicionar dados a um aplicativo existente ou criar um aplicativo do zero.

    • Para se conectar a um site local, selecione Conectar usando o gateway de dados local.

      Escolha o Windows como o tipo de autenticação e adicione suas credenciais. Se suas credenciais incluirem um nome de domínio, especifique-o como ___domain\alias.

      Captura de tela do pop-up mostrando como se conectar usando o gateway de dados local.

      Em Escolher um gateway, selecione o gateway que você deseja usar e, em seguida, selecione Criar.

      Observação

      Se você não tiver um gateway de dados local instalado, instale um e selecione o ícone de atualização para uma lista de gateways.

      A conexão é criada. Você pode adicionar dados a um aplicativo existente ou criar um aplicativo do zero.

Adicionar dados a um aplicativo existente

  1. No Power Apps Studio, abra o aplicativo que você deseja atualizar, selecione Dados no painel esquerdo.

  2. Selecione Adicionarconectores> de dados>do SharePoint.

    Captura de tela mostrando o caminho do menu para se conectar ao SharePoint no menu Dados.

  3. Um painel lateral é aberto. Em Conectar-se a um site do SharePoint, selecione uma entrada na lista de sites recentes (ou adicione sua própria URL) e, em seguida, selecione Conectar.

  4. Em Escolher uma lista, marque a caixa de seleção para uma ou mais listas e, em seguida, selecione Conectar:

    Captura de tela que mostra listas que você pode optar por incluir.

    Observação

    O Power Apps dá suporte a listas, não a listas baseadas em modelo. Se você não vir sua lista, digite o nome da lista na caixa de nome da tabela personalizada Enter . Captura de tela que mostra a caixa em que você pode adicionar um nome de lista.

    Você verá uma faixa de confirmação de que sua fonte de dados foi adicionada ao seu aplicativo.

Mapeamento de tipo de dados do Power Apps

Power Apps SharePoint
Boolean Sim/Não (caixa de seleção)
DateTime Data e hora
Image Hiperlink ou imagem, imagem
Complex Escolha, Pesquisa, Pessoa, Grupo, Resultado da Tarefa, Dados Externos, Metadados Gerenciados
Number Número, Moeda, ID
Text Linha única de texto, várias linhas de texto, Calculadas

Observação

Os tipos do SharePoint que são mapeados para o Power Apps como complexos geralmente têm subcampos que são mapeados para tipos básicos, como texto e número.

Funções e operações delegadas do Power Apps para o SharePoint

As seguintes operações do Power Apps, para um determinado tipo de dados, podem ser delegadas ao SharePoint para processamento (em vez de processar localmente no Power Apps).

Operação/função [1] Número Texto booleano DateTime Complexo [2]
<, <=,<>, >, >= Sim [3] Não Não Yes Yes
= Yes Yes Yes Yes Yes
Filter Yes Yes Yes Yes Yes
IsBlank - Não [4] - - Não
Lookup Yes Yes Yes Yes Yes
Sort Yes Yes Yes Yes Não
SortByColumns Yes Yes Yes Yes Não
StartsWith - Yes - - Sim [5]
UpdateIf/RemoveIf [6] Yes Não - - Não

Anotações

  1. Expressões que são unidas a E ou Ou são delegadas ao SharePoint. Não vai delegar. Os campos do sistema do SharePoint geralmente não delegam. Estes campos incluem:
  • Identificador
  • IsFolder
  • Miniatura
  • Link
  • Nome
  • FilenameWithExtension
  • Caminho
  • FullPath
  • ModerationStatus
  • ModerationComment
  • ContentType
  • IsCheckedOut
  • VersionNumber
  • TriggerWindowStartToken
  • TriggerWindowEndToken
  1. O SharePoint dá suporte à delegação de tipos complexos, adiando a decisão de delegação para o subcampo envolvido. Verifique o tipo do subcampo que está sendo usado no tipo complexo e verifique se há recursos de delegação nessa tabela. Somente Email e DisplayName são delegados no tipo de dados Pessoa.
  2. Os campos de ID do SharePoint são mostrados como um campo numérico no Power Apps. No entanto, o tipo subjacente é, na verdade, Texto. O SharePoint dá suporte apenas à operação igual ('=') para delegação em um campo de ID. Operações relacionais como <, <=,<>, >, >= não funcionarão em um campo de ID do SharePoint.
  3. Uma fórmula como Filter(..., IsBlank(CustomerId)) não delegará ao SharePoint. No entanto, essa fórmula é semanticamente próxima de Filter(..., CustomerId = Blank()), delegará ao SharePoint. Essas fórmulas não são equivalentes porque a segunda fórmula não tratará a cadeia de caracteres vazia ("") como vazia. No entanto, a segunda fórmula pode funcionar para suas finalidades. No SharePoint, essa abordagem funciona para o operador 'equals' ("="), mas não para o operador 'not equals' ("<>").
  4. O SharePoint não dá suporte à delegação de StartsWith em subcampos de tipos complexos Choice ou Lookup.
  5. UpdateIf e RemoveIf funcionam localmente, mas simulam a delegação para um limite de 500/2000 registros. Eles sucessivamente derrubam registros além do limite de registros de não delegação 500/2000. Os registros que atendem à condição If são coletados. Geralmente, um máximo de 500/2000 registros são coletados separadamente e, em seguida, alterados por execução. No entanto, mais registros poderão ser atualizados se o cache de dados local existente for grande, pois a função poderá ter acesso a mais registros para avaliação.