- 2023.2
- Designer
- Outils
- Connecteurs
- Outil Sortie SharePoint
Outil Sortie SharePoint
Utilisez l'outil Sortie de SharePoint pour écrire 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 SharePoint version 2.2.0, nous avons renommé Sortie de fichiers SharePoint en Sortie 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.
Sortie de fichiers SharePoint version 2.1.0 contient également une fonctionnalité d'écriture 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.
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 écrire dans 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
Si vous avez accès à plusieurs locataires Geo, sélectionnez ceux auxquels vous souhaitez accéder.
Sélectionnez un Site et une Bibliothèque de documents.
Sélectionnez le fichier dans l'arborescence de fichiers ou recherchez-le par son nom. Vous pouvez également saisir le chemin du fichier dans le champ Chemin du fichier.
Utilisez Action à entreprendre pour le fichier existant dans l'onglet Options pour sélectionner la gestion d'un fichier existant.
Renommer : l'option Renommer renomme le fichier (en ajoutant un numéro unique à la fin du nom de fichier).
Remplacer le fichier : l'option Remplacer supprime le fichier existant et écrit le nouveau contenu du fichier.
Remplacer la feuille : l'option Remplacer la feuille réécrit les feuilles sélectionnées sans apporter de modifications aux autres feuilles.
Ajouter : l'option Ajouter ajoute les nouvelles données au fichier existant.
Abandonner : lorsqu'Abandonner est sélectionné, le fichier ne sera pas chargé s'il existe un autre fichier portant le même nom.
Important
Si vous sélectionnez les options Remplacer le fichierRemplacer la feuille ou Ajouter dans Action à entreprendre pour le fichier existant, la feuille mise à jour devient la première feuille du fichier. Cela peut avoir un impact sur les outils utilisant les numéros d'ordre des feuilles.
Ajouter un dossier
Sélectionnez le Site et la Bibliothèque de documents dans lesquels vous souhaitez ajouter un dossier.
Sélectionnez Ajouter un dossier.
Sélectionnez Par nom et entrez le nom du nouveau dossier. Designer ajoute le dossier sans avoir à exécuter le workflow.
Sélectionnez Par champ pour ajouter plusieurs dossiers en fonction d'un champ spécifié à partir des données.
Entrez le nom des nouveaux fichiers dans le champ Nom de fichier.
Le champ Nom de fichier requiert le nom du fichier, y compris l'extension du type de fichier.
Exécutez le workflow pour ajouter les dossiers.
Ajouter un fichier
Sélectionnez le Site et la Bibliothèque de documents dans lesquels vous souhaitez ajouter un fichier.
Sélectionnez Ajouter un fichier.
Sélectionnez Par nom et entrez le nom du nouveau fichier.
Le champ Nom de fichier requiert le nom du fichier, y compris l'extension du type de fichier.
Sélectionnez Par champ pour ajouter plusieurs fichiers en fonction d'un champ spécifié à partir des données.
L'outil Sortie de SharePoint exclut le champ des données écrites. Vous pouvez le conserver en sélectionnant Conserver le champ dans la sortie.
Exécutez le workflow pour ajouter le fichier.
Sélectionner un format de fichier
Les options Plage de données spécifient les noms des feuilles à créer. Les options sont Par nom de feuille et Par champ.
L'outil Sortie de SharePoint exclut le champ des données écrites. Vous pouvez le conserver en sélectionnant Conserver le champ dans la sortie.
Avertissement
Si vous sélectionnez l'option Par champ, plusieurs feuilles seront créées et nommées en fonction de la valeur sélectionnée dans Sélectionner un champ.
Entrez la cellule dans Commencer dans la cellule pour spécifier le début de la sortie de données.
Sélectionnez Écrire les en-têtes pour inclure les en-têtes dans la sortie de données.
Sélectionnez Page de codes pour déterminer l'encodage des données.
Utilisez Longueur de champ maximale pour définir la longueur maximale de chaque champ, ce qui permet de contrôler la coupure des chaînes.
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é.
Sélectionnez Écrire les en-têtes pour inclure les en-têtes dans la sortie de données.
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.
Aucune option.
Listes SharePoint
Avertissement
L'outil Sortie de SharePoint ne peut pas écrire dans les colonnes dont le nom commence par un caractère spécial. Ceci s'applique au nom réel de la colonne, et non au nom d'affichage. Nous vous recommandons de ne pas utiliser de caractères spéciaux au début des noms de colonne.
La création ou la modification d'une liste échouera si vous entrez un nom de colonne commençant par des lettres minuscules ou majuscules c ou r et contenant un nombre ou aucun autre caractère.
Configuration de l'outil
Sélectionnez une liste. Les contenus sont spécifiques à l'URL que vous avez spécifié. Si votre URL contient un répertoire, seules les listes correspondant à ce répertoire sont affichées.
Dans Options de sortie, sélectionnez une option pour écrire la liste :
Ajouter à un élément existant : ajoute toutes les données à une table existante.
Append: Appends all the data to an existing list.
Overwrite (Update Fields): Removes the existing rows and fields and creates new fields and data based on the incoming data.
Overwrite (Keep Existing Columns): Removes the existing rows and adds new rows based on the incoming fields. The fields have to match.
Update: Updates data based on the Primary Key.
Upsert: Updates existing data and inserts new data based on the Primary Key.