SharepointFiles

Ferramenta Saída de Arquivos do SharePoint

Versão:
2023.1
Last modified: May 31, 2022

Use the SharePoint Files Output tool to write data to your CSV, XLSX, and YXDB files as well as lists in your SharePoint site.

This tool is not automatically installed with Designer. To use this tool, download it from the Alteryx Community.

SharePoint Files Output version 2.1.0 also contains lists writing functionality which was a standalone data connector. Please note compatibility with Designer to maintain full functionality of the SharePoint Files data connector.

Configurar a ferramenta

Este processo se aplica ao Microsoft SharePoint Online. Para instalar a ferramenta Saída de Arquivos do SharePoint, no Designer, abra o arquivo YXI do SharePoint disponível na Comunidade do Alteryx.

Para instalar a ferramenta Saída de Arquivos do SharePoint para todos os usuários, abra o Designer como administrador.

  1. Para adicionar a ferramenta Saída de Arquivos do SharePoint ao fluxo de trabalho, acesse a categoria da ferramenta Conectores, selecione Saída de Arquivos do SharePoint e arraste e solte a ferramenta na tela.
  2. O método OAuth é usado para autenticação.
    • Para autenticação na nuvem:
      • Fazer login pelo navegador da Internet: utilize o aplicativo Alteryx padrão. 
      • Fornecer detalhes de autenticação: use o aplicativo OAuth. Para autenticar, digite nome de usuário e senha. Para poder agendar o fluxo de trabalho no servidor quando você usa serviços em nuvem, é preciso ativar Usar como principal de serviço (autenticação somente de aplicativo) para que o token tenha uma duração maior. Quando for usar a ferramenta Entrada de Arquivos do SharePoint pela primeira vez, você precisa dar ao aplicativo o consentimento para usar as permissões listadas. Consulte a seção Configuração de aplicativo de API personalizado para informações sobre como criar seu próprio aplicativo de API.   

        Dependendo da política da empresa, é preciso haver aprovação do administrador para algumas permissões. Se esse for o seu caso, informe o motivo no aplicativo e envie uma solicitação ou entre em contato diretamente com a equipe de TI.

    • Para a autenticação no local:
      • Informe nome de usuário, senha e URL.
      • Conectar ao URL com a conta do Windows.
  3. Agora você pode escolher o Site e a Biblioteca de documentos (você também pode usar Pesquisar).
  4. Selecione Adicionar arquivo e insira o nome do arquivo ou selecione um campo que contenha o nome do arquivo. A extensão é adicionada automaticamente de acordo com o formato de arquivo selecionado.
  5. Clique no botão Criar.
  6. Você também pode Adicionar pasta, que é selecionada automaticamente.
  7. Os itens na guia Opções variam de acordo com o formato de arquivo selecionado.
  8. Para o formato de arquivo XLSX, na guia Dados, você também pode especificar em qual planilha deseja gravar os dados:
    • Por nome de planilha: forneça diretamente o nome da planilha. Se a planilha não existir, ela será criada no SharePoint.
    • Por campo: crie múltiplas planilhas com base na seleção de Nome de campo.
  9. No menu suspenso Ação para arquivo existente, você pode selecionar uma ação (Renomear, Substituir, Acrescentar ou Anular). Por padrão, é realizada a ação Renomear.
  10. Clique em Executar para executar o fluxo de trabalho.

Configuração de aplicativo de API personalizado

O Conector do SharePoint vem com um aplicativo multilocatário integrado que você pode usar, mas, se preferir seu próprio aplicativo, siga as etapas abaixo. Para mais informações sobre como criar e gerenciar um aplicativo com os serviços de nuvem do Microsoft Azure, consulte a documentação do Azure.

  1. Acesse https://portal.azure.com/#home.
  2. Faça login com a sua conta do Microsoft Azure Active Directory.
  3. Na página inicial, use Pesquisar ou acesse o menu do canto superior esquerdo para abrir o serviço do Azure Active Directory.
  4. Abra Registros de aplicativo no menu à esquerda.
  5. Clique em Adicionar novo registro.
  6. Especifique o Nome do aplicativo.
  7. Escolha o tipo de conta desejado: locatário único e multilocatário são permitidos.
  8. Na URI de redirecionamento opcional:
    • Selecione Aplicativo de página única (SPA) no menu suspenso.
    • Para manter a funcionalidade completa com várias versões de conector, configure os dois URLs:
      • https://cef.alteryx.com/designer/oauthcallback
      • https://login.live.com/oauth20_desktop.srf
  9. Selecione Registrar.
    • O ID do aplicativo (cliente) é seu ID de cliente.
    • O ID do diretório (locatário) é seu ID de locatário.
  10. Acesse Permissões de API para adicionar as seguintes permissões delegadas do Microsoft Graph:
    • Files.ReadWrite.All
    • offline_access
    • openid
    • User.Read
    • Sites.Read.All
    • e-mail
    • perfil
  11. Para usar Entidade de serviço (autenticação somente por aplicativo), vá para Certificados e segredos e adicione um Novo segredo de cliente. Copie o valor, pois ele não estará mais disponível depois que você sair da página — esse é o seu ID secreto. Em Permissões de API, adicione as seguintes Permissões de aplicativo do Microsoft Graph:
    • Files.Read.All
    • Files.ReadWrite.All
    • Sites.Read.All

Select a File Format

XLSX

  • Data Range options specify the names of the sheets to create. Options are By Sheet Name and By Field.

    • SharePoint Output excludes the field from the written data. You can keep it by selecting Keep Field in Output.

If you select the By Field option, multiple sheets will be created and named based on the value selected in Select Field.

  • Enter the cell in Start in cell to specify the start of data output. 

  • Select Write headers to include headers in the output data. 

  • Select Code Page to determine the encoding of the data. 

CSV

  • Use Max Field Length to set the maximum length of each field, allowing control over string cut off. 

  • Use Field Delimiter to select a field delimiter between fields. Options are Comma, Semicolon, Tab, Pipe, Space or Custom delimiter. 

  • Select Write headers to include headers in the output data. 

  • Use Quote Character to select a format of the quote. Options are None, Single Quote, Double Quote, or Custom. 

  • Select Code Page to determine the encoding of the data. 

YXDB

No options.

SharePoint Lists

Configure the Tool

  1. Select a List. The contents are specific to the URL you specify. If your URL contains a directory, only lists for that directory are shown.

  2. In Output Options, select an option for writing the list:

    • Append Existing: Appends all the data to an existing table.

    • Delete List and Append: Deletes all the original records from the table and then appends the data into the existing table.

    • Update; Warn on Update Failure: Updates only existing records with the IDs you specify. If a record cannot be updated, a warning is reported.

    • Update; Error on Update Failure: Updates only existing records with the IDs you specify. If a record cannot be updated, an error is reported and processing will stop.

Esta página foi útil?

Problemas com seu produto Alteryx? Visite a Comunidade Alteryx ou entre em contato com nossa Equipe de Suporte. Não é possível enviar este formulário? Envie-nos um e-mail.