- 2023.2
- Designer
- Ferramentas
- Conectores
- Ferramenta Entrada do SharePoint
Ferramenta Entrada do SharePoint
Use a ferramenta Entrada do SharePoint para ler dados de arquivos CSV, XLSX e YXDB, bem como listas do site do SharePoint.
Importante
Esta ferramenta não é instalada automaticamente com o Designer. Para usá-la, faça o download no Alteryx Marketplace.
Nas ferramentas do SharePoint versão 2.2.0, renomeamos a ferramenta Entrada de Arquivos do SharePoint como Entrada do SharePoint.
Nas ferramentas do SharePoint versão 2.2.0, também removemos temporariamente o suporte para o SharePoint no local (versões 2013 e 2016). No SharePoint versão 2.3.0, reabilitamos o suporte para o SharePoint no local.
A Entrada de Arquivos do SharePoint versão 2.0.1 também contém o recurso de leitura de listas, que era um conector de dados independente. Consulte Compatibilidade do Designer com conectores de dados para manter a funcionalidade completa do conector do SharePoint.
Fazer login no SharePoint
O método OAuth é utilizado para autenticação. Você pode tanto usar o aplicativo Alteryx padrão, selecionando Fazer login pelo navegador da Internet, quanto fornecer seu próprio aplicativo de API, selecionando Conectar ao URL com o ID e o segredo do cliente, além do ID do locatário. Consulte Configuração de aplicativo de API personalizado para informações sobre como criar seu próprio aplicativo de API.
Você pode utilizar o aplicativo Alteryx padrão (Fazer login pelo navegador da Internet) para programar fluxos de trabalho durante até seis meses. No entanto, se selecionar Usar como principal de serviço (autenticação de aplicativo somente) depois de selecionar Conectar ao URL com ID de cliente e segredo, ID de locatário, você poderá definir a expiração do token de acordo com a política da sua empresa, e os fluxos de trabalho programados não serão associados a um único usuário. Isso é conveniente, por exemplo, se um usuário deixar a empresa e a conta for desativada, fazendo com que os fluxos de trabalho não sejam executados.
Atenção
A Entrada de Arquivos do SharePoint versão 2.0.1 requer segredo de cliente mesmo ao se conectar com ID de cliente e segredo, ID de locatário sem usar como principal de serviço. Entre em contato com o administrador para solicitar o segredo, que é um Valor Secreto, e não um ID Secreto.
Os métodos de autenticação disponíveis são os mesmos para arquivos e listas, mas diferem para versões do SharePoint. Além disso, você precisa inserir uma URL do SharePoint no nível do site para ler as listas:
SharePoint 365 (Nuvem)
Login pelo navegador como usuário (OAuth)
Login pelo aplicativo (usar entidade de serviço)
SharePoint 2013, 2016 (No local)
Conta do Windows
Se quiser autenticar usando o locatário GCC High ou o locatário personalizado, use o DCM e selecione a tecnologia apropriada. Para encontrar o URL correto, acesse Fazer login no Power BI para o governo dos EUA.DCM - Designer
Arquivos do SharePoint
Selecione um arquivo
Opcionalmente, se você tiver acesso a múltiplos locatários geográficos, selecione qual deseja acessar.
Selecione um site.
Selecione uma biblioteca de documentos.
Selecione um arquivo na exibição em árvore ou insira um caminho de arquivo.
Você tem estas opções para lidar com o arquivo:
Ler dados dos arquivos: leia os dados e passe-os para outras ferramentas por meio da âncora de saída.
Baixar arquivo localmente para processamento posterior: processe um arquivo de um tipo de arquivo para o qual a ferramenta Entrada do SharePoint não oferece suporte ou baixe uma cópia off-line do arquivo. Escolha o local para salvar o arquivo. O local padrão é %TEMP%.
Ler apenas a lista de caminhos completos: leia apenas uma lista de caminhos e passe-a para outras ferramentas por meio da âncora de saída.
Nota
Você também pode inserir (pressione Ctrl+V e Enter) o caminho do arquivo para o Caminho do arquivo usando o botão Copiar link no site do SharePoint.
Configurar a ferramenta
O formato do arquivo é detectado automaticamente quando você seleciona um arquivo.
As opções de Intervalo de dados especificam quais planilhas contêm os dados. As opções são Todas as planilhas, Nomes das planilhas, Números das planilhas, Intervalo nomeado ou Importar apenas a lista de nomes de planilhas.
Marque a caixa A primeira linha contém nomes de campo para definir a primeira linha de dados como cabeçalhos de coluna.
Use Iniciar dados on-line para selecionar em qual linha a importação vai começar.
Selecione Página de código para determinar a codificação dos dados.
Selecione Habilitar simulação (dry-run) de todos os campos para uma ferramenta conectada sem a necessidade de rodar o fluxo de trabalho.
Use Anexar metadados para selecionar os metadados a serem anexados a cada linha da entrada.
Use Comprimento máximo do campo para definir o comprimento máximo de cada campo. Isso dá a você controle sobre o corte das cadeias de caracteres.
Use o Delimitador de campo para selecionar um delimitador de campo entre os campos. As opções são Vírgula, Ponto e vírgula, Tabulação, Barra vertical, Espaço ou Delimitador personalizado.
Marque a caixa A primeira linha contém nomes de campo para definir a primeira linha de dados como cabeçalhos de coluna.
Use Iniciar dados on-line para selecionar em qual linha a importação vai começar.
Use Caractere de aspas para selecionar o formato das aspas. As opções são Nenhum, Aspas simples, Aspas duplas ou Personalizado.
Selecione Página de código para determinar a codificação dos dados.
Selecione Habilitar simulação (dry-run) para propagar todos os campos para uma ferramenta conectada sem precisar rodar o fluxo de trabalho.
Use Anexar metadados para selecionar os metadados a serem anexados a cada linha da entrada.
Selecione Habilitar simulação (dry-run) para propagar todos os campos para uma ferramenta conectada sem precisar rodar o fluxo de trabalho.
Use Anexar metadados para selecionar os metadados a serem anexados a cada linha da entrada.
Listas do SharePoint
Selecionar dados
Selecionar uma lista.
Existe a opção de selecionar uma exibição.
Configurar a ferramenta
Extrair valores de itens vinculados: marque a caixa para extrair automaticamente valores de itens vinculados.
Limite de registro: digite o número de registros que deseja ler.
Propagar campo imediatamente para a próxima ferramenta: marque a caixa de seleção para propagar todos os campos para uma ferramenta conectada sem a necessidade de executar o fluxo de trabalho.