Skip to main content

SharepointFiles Outil Entrée SharePoint

Utilisez l'outil Entrée de SharePoint pour lire les données de vos fichiers CSV, XLSX et YXDB, ainsi que les listes de votre site SharePoint.

Important

Cet outil n'est pas automatiquement installé avec Designer. Pour utiliser cet outil, téléchargez-le depuis Alteryx Marketplace.

Dans les outils de SharePoint version 2.2.0, nous avons renommé Entrée de fichiers SharePoint en Entrée de SharePoint.

Dans les outils de SharePoint version 2.2.0, nous avons également supprimé temporairement la prise en charge de SharePoint sur site (versions 2013 et 2016). Dans SharePoint version 2.3.0, nous avons réactivé la prise en charge de SharePoint sur site.

L'outil Entrée de fichiers SharePoint version 2.0.1 contient également une fonctionnalité de lecture de listes qui était auparavant un connecteur de données autonome. Voir Compatibilité de Designer avec les connecteurs de données pour maintenir toutes les fonctionnalités du connecteur SharePoint.

Se connecter à SharePoint

La méthode OAuth est utilisée pour l'authentification. Vous pouvez donc utiliser l'application Alteryx par défaut en sélectionnant Se connecter via un navigateur Internet ou vous pouvez fournir votre propre application API en sélectionnant Se connecter à l'URL avec l'ID client et le secret client, ainsi que l'ID de locataire. Pour plus d'informations sur la création de votre propre application API, reportez-vous à la section Configuration de l'application API personnalisée.

Vous pouvez utiliser l'application Alteryx par défaut (Se connecter via un navigateur Internet) pour planifier des workflows sur une période de 6 mois maximum. Toutefois, si vous sélectionnez Utiliser comme principal du service (authentification de l'application uniquement) après avoir sélectionné Se connecter à l'URL avec l'ID client et le secret client, ainsi que l'ID de locataire, vous pouvez définir l'expiration du jeton selon la politique de votre entreprise et les workflows planifiés ne seront pas associés à un seul utilisateur. Cette option est pratique, par exemple, si un utilisateur quitte l'entreprise et que son compte est désactivé, ce qui empêche l'exécution des workflows.

Avertissement

L'outil Entrée de fichiers SharePoint version 2.0.1 nécessite le secret du client même lors de la connexion avec l'ID client, le secret du client et l'ID de locataire sans utilisation comme principal du service. Contactez votre administrateur pour demander le secret, c'est-à-dire la Valeur de secret, et non pas l'ID secret.

Les méthodes d'authentification disponibles sont les mêmes pour les fichiers et les listes, mais elles diffèrent pour les versions de SharePoint. En outre, vous devez saisir une URL SharePoint au niveau du site pour lire les listes :

  • SharePoint 365 (Cloud)

    • Connexion au navigateur en tant qu'utilisateur (OAuth)

    • Connexion à l'application (utiliser le principal du service)

  • SharePoint 2013, 2016 (sur site)

    • Compte Windows

Si vous souhaitez vous authentifier à l'aide du locataire GCC High ou du locataire personnalisé, utilisez DCM et sélectionnez la technologie appropriée. Pour trouver l'URL correcte, accédez à Se connecter à Power BI pour le gouvernement américain.DCM - Designer

Fichiers SharePoint

Sélectionner un fichier

  1. Si vous avez accès à plusieurs locataires Geo, sélectionnez ceux auxquels vous souhaitez accéder.

  2. Sélectionnez un site.

  3. Sélectionnez une bibliothèque de documents.

  4. Sélectionnez un fichier dans l'arborescence ou entrez un chemin d'accès.

  5. Vous disposez des options suivantes pour gérer le fichier :

    • Lire les données à partir des fichiers : lit les données et les transmet à d'autres outils via l'ancrage de sortie.

    • Télécharger le fichier localement pour un traitement ultérieur : traite un fichier d'un type de fichier que l'outil Entrée de SharePoint ne prend pas en charge ou télécharge une copie hors ligne du fichier. Choisissez l'emplacement où enregistrer le fichier. L'emplacement par défaut est %TEMP%.

    • Lire uniquement la liste des chemins complets : lit uniquement une liste de chemins et la transmet à d'autres outils par l'intermédiaire de l'ancrage de sortie.

Note

Vous pouvez également insérer (appuyez sur Ctrl+V et Entrée) le chemin d'accès de votre fichier dans Chemin du fichier via le bouton Copier le lien sur le site SharePoint.

Configuration de l'outil

Le format de fichier est détecté automatiquement lorsque vous sélectionnez un fichier.

XLSX

  • Les options Plage de données indiquent les feuilles contenant les données. Les options sont Toutes les feuilles, Noms de feuilles, Numéros de feuilles, Plage nommée ou Importer seulement la liste des noms de feuilles.

  • Cochez la case La première ligne contient les noms de champs pour définir la première ligne de données comme en-tête de colonne.

  • Utilisez Commencer les données à la ligne pour sélectionner la ligne à partir de laquelle commencer l'importation.

  • Sélectionnez Page de codes pour déterminer l'encodage des données.

  • Sélectionnez Activer le test à blanc de tous les champs vers un outil connecté sans avoir à exécuter le workflow.

  • Utilisez Joindre des métadonnées pour sélectionner les métadonnées à joindre à chaque ligne de l'entrée.

CSV

  • Utilisez Longueur de champ maximale pour définir la longueur maximale de chaque champ. Cette option vous permet de contrôler la coupure de la chaîne.

  • Utilisez Séparateur de champ pour sélectionner un séparateur de champ entre les champs. Les options sont Virgule, Point-virgule, Onglet, Barre verticale, Espace ou Séparateur personnalisé.

  • Cochez la case La première ligne contient les noms de champs pour définir la première ligne de données comme en-tête de colonne.

  • Utilisez Commencer les données à la ligne pour sélectionner la ligne à partir de laquelle commencer l'importation.

  • Utilisez Caractère guillemet pour sélectionner un format de guillemet. Les options sont Aucun, Guillemet simple, Guillemet double ou Personnalisé.

  • Sélectionnez Page de codes pour déterminer l'encodage des données.

  • Sélectionnez Activer le test à blanc pour propager tous les champs vers un outil connecté sans avoir à exécuter le workflow.

  • Utilisez Joindre des métadonnées pour sélectionner les métadonnées à joindre à chaque ligne de l'entrée.

YXDB

  • Sélectionnez Activer le test à blanc pour propager tous les champs vers un outil connecté sans avoir à exécuter le workflow.

  • Utilisez Joindre des métadonnées pour sélectionner les métadonnées à joindre à chaque ligne de l'entrée.

Listes SharePoint

Sélectionner des données

  1. Sélectionnez une liste.

  2. Vous pouvez également sélectionner une vue.

Configuration de l'outil

  • Extraire les valeurs des éléments liés : cochez la case pour extraire automatiquement les valeurs des éléments liés.

  • Limite d'enregistrements : saisissez le nombre d'enregistrements que vous souhaitez lire.

  • Propager immédiatement le champ à l'outil suivant : cochez la case pour propager les valeurs à un outil connecté sans avoir à exécuter le workflow.

Dans cette section​: