Microsoft SharePoint

Version:

2023.1

Last modified: May 11, 2022

Driver Details	Pour plus d'informations, consultez la section Portail Microsoft.
Type of Support	Lecture et écriture
Validated On	Outils de fichiers SharePoint : outils de liste SharePoint : 2007, 2010, 2013, 2016, en ligne

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.

Outils Alteryx utilisés pour la connexion

Depuis Entrée de fichiers SharePoint version 2.0.1, nous avons abandonné Entrée de liste SharePoint en tant qu'outil autonome et nous avons inclus la fonctionnalité de lecture de liste dans Entrée de fichiers SharePoint.

Traitement standard de workflow

Link

Outil Entrée de liste SharePoint

Link

Outil Sortie de liste SharePoint

Configuration de l'authentification

Avant d'utiliser les outils SharePoint en ligne, vous devez enregistrer un point de terminaison d'application pour les clients externes :

Pour plus d'informations sur la création et la gestion d'une application à l'aide des services cloud Microsoft Azure, voir la documentation Azure.

Accédez à Microsoft Azure.
Connectez-vous avec votre compte Microsoft Azure Active Directory.
Sur l'écran d'accueil, utilisez Rechercher ou accédez au menu en haut à gauche pour ouvrir le service Azure Active Directory.
Ouvrez Inscriptions d'applications dans le menu de gauche.
Sélectionnez + Nouvelle inscription.
Spécifiez le Nom de l'application.
Choisissez le type de compte souhaité : locataire unique et multi-locataire sont autorisés tous les deux.
Dans la partie Redirection URI (facultatif)
1. Pour Entrée de fichiers SharePoint version 1.1.1 et versions antérieures : sélectionnez Application à page unique (SPA) dans le menu déroulant et définissez les deux URL :
  - https://cef.alteryx.com/designer/oauthcallback,
  - https://login.live.com/oauth20_desktop.srf.
2. Pour Entrée de fichiers SharePoint version 2.0.1 et versions ultérieures : sélectionnez Application de page Web (WPA) dans le menu déroulant et définissez l'URL :
  - http://localhost/
Sélectionnez S'incrire.
L'ID d'application (client) est votre ID client.
L'ID de répertoire (locataire) est votre ID de locataire.
Accédez à Identifiants client et ajoutez Nouveau secret du client.
Copiez la valeur car elle ne sera plus accessible une fois que vous aurez quitté la page. Il s'agit de votre Secret du client.
Accédez à API autorisées pour ajouter ces autorisations déléguées de Microsoft Graph
1. Files.ReadWrite.All
2. offline_access
3. openid
4. User.Read
5. Sites.Read.All
6. E-mail
7. profil
Pour Entrée de fichiers SharePoint version 2.0.1 et versions ultérieures, ajoutez également les autorisations déléguées suivantes pour SharePoint :
1. AllSites.Manage
2. AllSites.Read
3. AllSites.Write
4. Files.Read.All
5. Sites.Search.All
Pour utiliser le principal du service (authentification application uniquement), allez dans Certificats & secrets et ajoutez Nouveau secret du client. Copiez la valeur car elle ne sera plus accessible une fois que vous aurez quitté la page. Il s'agit de votre Secret du client.
Dans API autorisées, ajoutez ces autorisations d'application de Microsoft Graph :
1. Files.Read.All
2. Files.ReadWrite.All
3. Sites.Read.All

Vous pouvez désormais utiliser cette application dans le connecteur de fichiers SharePoint d'Alteryx. Pour authentifier la connexion, vous aurez besoin de votre nom d'utilisateur, de votre mot de passe, de votre ID client, de votre ID client secret et de votre ID du propriétaire, qui sont fournis lors de l'enregistrement de l'application.

Pour plus d'informations, consultez le portail Microsoft.

Détails supplémentaires

SharePoint stocke toutes les valeurs DateTime au format UTC. Pour convertir correctement les valeurs DateTime de votre système vers et depuis le format UTC, procédez comme suit :

Lors de l'écriture dans SharePoint, convertissez le fuseau horaire de votre système en format UTC à l'aide de la fonction DateTimeToUTC().
Lors de la lecture à partir de SharePoint, convertissez le format UTC en fuseau horaire de votre système à l'aide de la fonction DateTimeToLocal().

Alternativement, vous pouvez utiliser une autre fonction DateTime pour effectuer le calcul. Pour plus d'informations, consultez la section Fonctionnalités.