Conexão ao SharePoint

Informações do conceito

Comando ACCESSDATA

O Microsoft SharePoint é uma plataforma colaborativa baseada na web para compartilhar e gerenciar conteúdo e aplicativos organizacionais. Use o conector de dados do SharePoint para importar dados da sua organização residentes no SharePoint.

Antes de importar

Apenas dados tabulares

O Analytics só pode consultar dados do SharePoint que estejam no formato tabular. Os seguintes itens não podem ser consultados pelo Analytics porque não estão em formato tabular.

  • Anexos
  • FileVersions
  • GetValidTerms
  • Permissões
  • Exibições

Não há suporte para autenticação multifator

O conector de dados do SharePoint não consegue acessar dados de uma conta do SharePoint que exige autenticação multifator

Problema conhecido: filtragem por campos de datahora

Se você importar dados com a opção Converter datahora para GMT marcada, não poderá filtrar por campos datahora. Se você precisar filtrar por um campo datahora, desmarque essa opção antes da importação.

Criar uma conexão com o SharePoint

  1. No menu principal do Analytics, selecione Importar > Banco de dados e aplicativo.
  2. Na guia novas conexões, na seção Conectores do ACL, selecione SharePoint.

    Dica

    Você pode filtrar a lista de conectores disponíveis inserindo uma cadeia de pesquisa na caixa Filtrar conexões. Os conectores são listados em ordem alfabética.

  3. No painel Configurações de Conexão de Dados, insira as configurações da conexão e clique em Salvar e conectar na parte inferior do painel.

    Você pode aceitar o Nome de conexão padrão ou inserir um novo nome.

A conexão do SharePoint é salva na guia Conexões existentes. No futuro, você poderá reconectar o SharePoint usando a conexão salva.

Após estabelecer a conexão, a janela Acesso a Dados abre na Área de preparação e você pode começar a importar dados. Para obter ajuda na importação de dados do SharePoint, consulte Trabalho com a Janela de Acesso a Dados.

Configurações de conexão

Configurações básicas

Configuração Descrição Exemplo
Nome da conexão O nome que deseja atribuir a essa conexão no Analytics. SharePoint
Host

O site do SharePoint ao qual você está se conectando.

Defina o URL para uma coleção de sites para trabalhar com todas as listas e documentos em todos os subsites aninhados. Defina o URL para um site específico para trabalhar apenas com as listas e os documentos nesse site.

https://teams.example.com/teamA
Usuário

Seu nome de usuário do SharePoint.

Nota
Se sua empresa acessar o SharePoint por meio de ferramentas de SSO como AD FS, OneLogin ou OKTA, você poderá inserir as credenciais de SSO para se conectar por meio do Analytics, em vez das credenciais do SharePoint.

jgibbons
Senha

Sua senha do SharePoint.

Nota
Se sua empresa acessar o SharePoint por meio de ferramentas de SSO como AD FS, OneLogin ou OKTA, você poderá inserir as credenciais de SSO para se conectar por meio do Analytics, em vez das credenciais do SharePoint.

MyStrongPasswordExample
Edição do SharePoint A edição do SharePoint sendo usada. A edição é SharePoint Online ou SharePoint On-Premise. SharePoint Online
Usar SSO

Quando definido como verdadeiro, o single sign-on (SSO) será usado para autenticação no SharePoint Online usando a conta especificada por Usuário e Senha. São permitidos os serviços Active Directory Federation Services (AD FS), OneLogin e OKTA SSO.

O Domínio do SSO pode ser necessário se for diferente do domínio do Usuário.

O SSO só pode ser usado com o SharePoint Online. O SSO não pode ser usado com as versões locais do SharePoint.

falso
Esquema de autorização

Juntamente com Senha e Usuário, este campo é usado para autenticação no servidor. NTLM é a opção padrão. Use as seguintes opções para selecionar o esquema de autenticação:

  • NTLM Defina essa opção para usar as suas credenciais do Windows para autenticação.
  • NEGOTIATE Se Esquema de autorização estiver definido como NEGOTIATE, o driver negociará um mecanismo de autenticação com o servidor. Defina Esquema de autorização como NEGOTIATE se quiser usar a autenticação Kerberos.
  • KERBEROSDELEGATION Defina essa opção para usar a delegação por meio do protocolo Kerberos. Defina o Usuário e a Senha da conta que você quer personificar.
  • NONE Defina essa opção para usar a autenticação anônima; por exemplo, para acessar um site público.
  • FORMS Defina essa opção se a sua instância do SharePoint usar um método de autenticação personalizado por meio de um formulário da web.
  • DIGEST Defina essa opção para usar a autenticação HTTP Digest.
  • BASIC Defina essa opção para usar a autenticação HTTP Basic.
NTLM

Configurações avançadas

Configuração Descrição Exemplo
Domínio do SSO

Essa propriedade só é aplicável quando se usa o single sign-on (Usar SSO é definido como verdadeiro) e se o domínio do Usuário (por exemplo, user@mydomain.com) for diferente do domínio configurado dentro do serviço de SSO (por exemplo, user@myssodomain.com).

Essa propriedade pode ser necessária para usar AD FS, OneLogin ou OKTA SSO.

myssodomain.com
Converter datahora para GMT Converte os campos datahora para o fuso horário GMT durante a importação. Se falso, o valor de datahora é convertido para o fuso horário do sistema operacional da máquina que executa o Analytics. verdadeiro
Limite do tamanho da chave

Em algumas ferramentas ODBC (Microsoft Access, por exemplo), o comprimento da coluna de chave primária não pode ser maior do que um valor específico. Essa propriedade faz com que o driver ODBC ignore o comprimento relatado para todas as colunas de chave primária. Ela é particularmente útil na utilização do driver ODBC como uma fonte de dados vinculada do Microsoft Access.

A definição de Limite do tamanho da chave como zero retornará o comprimento da chave para o valor original.

255
Mapear para Long Varchar

Essa propriedade controla se uma coluna é retornada como SQL_LONGVARCHAR.

Alguns aplicativos exigem que todos os dados de texto maiores que um determinado número de caracteres sejam relatados como SQL_LONGVARCHAR. Use essa propriedade para mapear todas as colunas maiores que o tamanho especificado para que sejam relatadas como SQL_LONGVARCHAR em vez de SQL_VARCHAR.

-1
Mapear para WVarchar

Essa propriedade controla se os tipos de cadeia são mapeados para SQL_WVARCHAR em vez de SQL_VARCHAR. É definido por padrão.

As colunas de cadeia devem ser mapeadas para SQL_WVARCHAR para acomodar diversos conjuntos de caracteres internacionais. Portanto, Mapear para WVarchar é definido como verdadeiro por padrão. Você pode defini-lo como falso para usar SQL_VARCHAR.

verdadeiro
Pseudocolunas

Indica se pseudocolunas devem ou não ser incluídas como colunas na tabela.

Essa configuração é particularmente útil no Entity Framework, que não permite a definição de um valor para uma pseudocoluna a menos que seja uma coluna de tabela.

Você pode usar um asterisco "*" para incluir todas as tabelas e todas as colunas.

  • Table1=Column1, Table2=Column3
  • *=*
Identificadores em maiúsculas

Defina essa propriedade para relatar todos os identificadores em maiúsculas, incluindo nomes de tabelas e colunas. Esse é o padrão para bancos de dados Oracle. Dessa forma, permite uma melhor integração com ferramentas do Oracle, como o Oracle Database Gateway. Por exemplo, você pode usar essa propriedade para evitar colocar identificadores entre aspas.

falso
Esquema de autenticação de proxy

O tipo de autenticação usado para autenticar no Servidor proxy.

Esse valor especifica o tipo de autenticação usado para autenticar no proxy HTTP especificado por Servidor proxy e Porta do proxy.

Por padrão, o driver usa as configurações do proxy de sistema, sem necessidade de configurações adicionais. Se você quiser conectar-se a outro proxy, será necessário definir Detecção automática de proxy como falso, além de Servidor proxy e Porta do proxy. Para autenticar, defina o Esquema de autenticação de proxy e defina o Usuário do proxy e a Senha do proxy, se necessário.

O tipo de autenticação pode ser um dos seguintes:

  • BASIC O driver executa a autenticação HTTP BASIC.
  • DIGEST O driver executa a autenticação HTTP DIGEST.
  • NEGOTIATE O driver recupera um token NTLM ou Kerberos de acordo com o protocolo aplicável para autenticação.
  • PROPRIETARY O driver não gera um token NTLM ou Kerberos. Você deve fornecer esse token no cabeçalho de autorização da solicitação HTTP.
BASIC
Detecção automática de proxy

Indica se as configurações do proxy de sistema devem ser usadas ou não. Defina ProxyAutoDetect como falso para usar configurações de proxy personalizadas. Essa configuração tem precedência sobre as outras configurações de proxy.

Por padrão, o driver usa o proxy HTTP de sistema. Defina essa configuração como falsa se quiser se conectar a outro proxy.

Para conectar a um proxy HTTP, consulte Servidor proxy.

falso
Usuário do proxy

Um nome de usuário usado para autenticação no Servidor proxy.

As opções Usuário do proxy e Senha do proxy são usadas para conexão e autenticação no proxy HTTP especificado em ProxyServer.

Você pode selecionar um dos seguintes tipos de autenticação em Esquema de autenticação de proxy.

Se você estiver usando autenticação HTTP, defina essa propriedade como o nome de usuário de um usuário reconhecido pelo proxy HTTP.

Se você estiver usando autenticação Windows ou Kerberos, defina essa propriedade como um nome de usuário em um dos seguintes formatos:

  • usuário@domínio
  • domínio\usuário
jgibbons@example.com
Senha do proxy

Uma senha usada para autenticação no Servidor proxy.

Essa propriedade é usada para autenticar em um servidor proxy HTTP compatível com autenticação NTLM (Windows), Kerberos ou HTTP. Para especificar o proxy HTTP, você pode definir Servidor proxy e Porta do proxy. Para especificar o tipo de autenticação, defina Esquema de autenticação de proxy.

Se você estiver usando autenticação HTTP, defina também Usuário do proxy e Senha do proxy para o proxy HTTP.

Se você estiver usando autenticação NTLM, defina Usuário do proxy e Senha do proxy como a senha do Windows. As propriedades abaixo também podem ser necessárias para concluir a autenticação Kerberos.

Por padrão, o driver usa o proxy de sistema. Se você quiser se conectar a outro proxy, defina Detecção automática de proxy como falso.

MyStrongPasswordExample
Servidor proxy

O nome do host ou o endereço IP de um proxy pelo qual o tráfego HTTP será roteado. O driver pode usar os tipos de autenticação HTTP, Windows (NTLM) ou Kerberos para autenticar em um proxy HTTP.

Por padrão, o driver usa o proxy de sistema. Se você precisar usar outro proxy, defina Detecção automática de proxy como falso.

127.168.192.10
Porta do proxy A porta na qual o proxy HTTP está sendo executado e pela qual você deseja redirecionar o tráfego HTTP. Especifique o proxy HTTP no Servidor proxy. 80
Tipo de SSL do proxy

Essa propriedade determina quando usar SSL para a conexão a um proxy HTTP especificado por ProxyServer. Esse valor pode ser AUTO, ALWAYS, NEVER ou TUNNEL.

Auto Configuração padrão. Se o URL for um URL HTTPS, o conector usará a opção TUNNEL. Se o URL for um URL HTTP, o componente usará a opção NEVER.

Always A conexão terá sempre o SSL ativado.

Never A conexão não tem o SSL ativado.

Tunnel A conexão é feita por meio de um proxy de túnel. O Servidor proxy abre uma conexão para o host remoto e o tráfego vai e volta pelo proxy.

Auto
Exceção de proxy

Uma lista separada por ponto e vírgula de hosts ou IPs que estarão isentos de conexão por meio do ProxyServer.

O ProxyServer será usado para todos os endereços, exceto para os endereços definidos nessa propriedade.

127.168.189.10; 127.168.188.11