Microsoft SharePoint

Versão:

2023.1

Last modified: May 11, 2022

Driver Details	Para obter mais informações, consulte o portal da Microsoft.
Type of Support	Leitura e gravação
Validated On	Ferramentas Arquivos do SharePoint: Ferramentas de Lista do SharePoint on-line: 2007, 2010, 2013, 2016

Release Notes

Version	Description
v2.2.0	Compatible with Alteryx Designer and Server 2021.4.2 Patch 4, 2022.1 Patch 2 and later. Compatible with AMP engine only. Added support for DCM. DCM is required for running this connector on Alteryx Server. FIPS capable. Added option to download folders and files locally for later processing. Temporarily removed support for SharePoint On-Premise (version 2013 and 2016). Renamed the tools to SharePoint Input and SharePoint Output. Changed the behavior of sheet name field to be excluded from the written data. Added option to keep the sheet name field. SSL/TLS validation is now performed against Windows Certificate Store. Service principal authentication can leverage Sites.Selected instead of the Sites.All permission.
v2.1.0	SharePoint Files Output now includes lists writing functionality. Writing data into a list can fail because of API limitations. One of the identified reasons is HTML code included in the data. Minor bug fixes.
v2.0.1	Compatible with Alteryx Designer version 2021.3.4 and later. SharePoint Files Input now includes lists reading functionality. All the tools use user’s browser instead of embedded CEF to comply with Conditional Access policy. User-based authentication for SharePoint 365 is valid for up to 6 months depending on the user’s Azure policy.
v1.1.1	Sites are loaded incrementally instead of all-at-once. Fixed DriveID error. Fixed bug affecting the output of null values into .yxdb file.
v1.1.0	Added Support for SharePoint On-Premise (version 2013 and 2016). Fixed blank screen issue when authenticating in Designer 2021.3.2.54175. Please note that you also need to update to Designer 21.3.3.63061 or later.
v1.0.4	Compatible with Alteryx Designer version 2021.2.2 and later. Initial release. Built-in multitenant Azure App with an option to use custom Azure App (incl. single tenant app). Supports reading and writing XLSX, CSV and YXDB file formats. Proxy support. Requires SharePoint 365.

Ferramentas do Alteryx usadas para conexão

A partir da versão 2.0.1 da Entrada de Arquivos de Lista do SharePoint , descontinuamos a Entrada de Lista do SharePoint como uma ferramenta independente e incluímos a funcionalidade de leitura de lista na Entrada de Arquivos do SharePoint.

Processamento de fluxos de trabalho padrão

Link

Ferramenta Entrada de Lista do SharePoint

Link

Ferramenta Saída de Lista do SharePoint

Configuração de autenticação

Antes de usar as ferramentas do SharePoint, você precisa registrar um ponto de extremidade de aplicativo para clientes externos:

Para obter mais informações sobre como criar e gerenciar um aplicativo usando os serviços de nuvem do Microsoft Azure, consulte a documentação do Azure.

Acesse o Microsoft Azure.
Faça login com a sua conta do Microsoft Azure Active Directory.
Na página inicial, use Pesquisar ou acesse o menu do canto superior esquerdo para abrir o serviço do Azure Active Directory.
Abra Registros de aplicativo no menu à esquerda.
Clique em Adicionar novo registro.
Especifique o Nome do aplicativo.
Escolha o tipo de conta desejado. O locatário único e o multilocatário são permitidos.
Na parte de URI de redirecionamento (opcional)
1. Para Entrada de Arquivos do SharePoint versão 1.1.1 e anteriores: selecione Aplicativo de página única (SPA) no menu suspenso e defina as duas URLs:
  - https://cef.alteryx.com/designer/oauthcallback,
  - https://login.live.com/oauth20_desktop.srf.
2. Para a Entrada de Arquivos do SharePoint versão 2.0.1 e posteriores: Selecione Aplicativo de página da Web (WPA) no menu suspenso e defina o URL:
  - http://localhost/
Selecione Registrar.
O ID do aplicativo (cliente) é seu ID de cliente.
O ID do diretório (locatário) é seu ID de locatário.
Vá para Credenciais do cliente e adicione Segredo de cliente novo.
Copie o valor, pois ele não estará mais disponível depois que você sair da página — esse é o seu Segredo do cliente.
Acesse Permissões de API para adicionar as seguintes permissões delegadas do Microsoft Graph
1. Files.ReadWrite.All
2. offline_access
3. openid
4. User.Read
5. Sites.Read.All
6. e-mail
7. perfil
Para Entrada de Arquivos do SharePoint versão 2.0.1 e posteriores, adicione também estas Permissões delegadas – SharePoint:
1. AllSites.Manage
2. AllSites.Read
3. AllSites.Write
4. Files.Read.All
5. Sites.Search.All
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 Segredo do cliente.
Em Permissões de API, adicione as seguintes permissões de aplicativo do Microsoft Graph :
1. Files.Read.All
2. Files.ReadWrite.All
3. Sites.Read.All

Agora você pode usar este aplicativo no seu conector de Arquivos do Alteryx SharePoint. Para autenticar o login, você precisará do seu Nome de usuário, Senha, ID do cliente, ID do segredo do cliente e ID do locatário fornecidos com o registro do aplicativo.

Para obter mais informações, visite o portal da Microsoft.

Detalhes adicionais

O SharePoint armazena todos os valores de Data e hora como UTC. Para converter corretamente os valores de Data e hora do seu sistema de/para UTC, faça o seguinte:

Ao gravar no SharePoint, converta o fuso horário do seu sistema para UTC com a função DateTimeToUTC().
Ao ler a partir do SharePoint, converta de UTC para o fuso horário do seu sistema com a função DateTimeToLocal().

Caso contrário, use outra função de data e hora para executar o cálculo. Para obter mais informações, consulte Funções.