SharepointFiles

Outil Sortie de fichiers SharePoint

Version:
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.

Configurer l'outil

Ce processus s'applique à Microsoft SharePoint en ligne. Pour installer l'outil de sortie de fichiers SharePoint, dans Designer, ouvrez le fichier YXI des fichiers SharePoint disponible dans la Communauté Alteryx.

Pour installer l'outil Sortie de fichiers SharePoint pour tous les utilisateurs, ouvrez Designer en tant qu'administrateur.

  1. Pour ajouter l'outil Sortie de fichiers SharePoint au workflow, accédez à la catégorie d'outils Connecteurs, sélectionnez Sortie de fichiers SharePoint et faites glisser l'outil vers le canevas.
  2. La méthode OAuth est utilisée pour l'authentification.
    • Pour l'authentification cloud :
      • Se connecter via un navigateur Internet : utilisez l'application Alteryx par défaut. 
      • Fournir les informations d'authentification :utilisez votre propre application OAuth.Pour vous authentifier, entrez votre nom d'utilisateur et votre mot de passe. Pour pouvoir planifier votre workflow sur Server lorsque vous utilisez les services Cloud, vous devez activer Utiliser comme principal du service (authentication dans l'application uniquement) afin que votre jeton ait une expiration prolongée. Lorsque vous utilisez l'outil Entrée de fichiers SharePoint pour la première fois, vous devez donner votre consentement à l'application pour l'utilisation des autorisations répertoriées. Pour plus d'informations sur la création de votre propre application API, reportez-vous à la section Configuration de l'application API personnalisée.   

        Selon la politique de votre entreprise, certaines autorisations peuvent nécessiter l'approbation de l'administrateur. Si c'est le cas, saisissez votre motif dans l'application et envoyez une demande ou contactez directement votre équipe informatique.

    • Pour l'authentification sur site :
      • Indiquez le nom d'utilisateur, le mot de passe et l'URL.
      • Se connecter à l'URL avec un compte Windows.
  3. Vous pouvez maintenant choisir le Site et la Bibliothèque de documents (vous pouvez également utiliser la fonction Recherche).
  4. Sélectionnez Ajouter un fichier et entrez le nom du fichier ou sélectionnez un champ qui contient le nom du fichier. L'extension est ajoutée automatiquement en fonction du format de fichier sélectionné.
  5. Sélectionnez le bouton Créer.
  6. Vous pouvez également Ajouter un dossier, qui est automatiquement sélectionné.
  7. En fonction du format de fichier sélectionné, plusieurs options sont disponibles dans l'onglet Options.
  8. Pour le format de fichier XLSX, sous l'onglet Données, vous pouvez également spécifier dans quelle feuille écrire les données :
    • Par nom de feuille : indiquez directement le nom de la feuille. Si la feuille n'existe pas, elle sera créée dans SharePoint.
    • Par champ : permet de créer plusieurs feuilles en fonction de la sélection du nom de champ.
  9. Vous pouvez sélectionner l'action à entreprendre sur le fichier existant (Renommer, Remplacer, Ajouter et Abandonner) dans la liste déroulante. Par défaut, l'action Renommer est exécutée.
  10. Sélectionnez Exécuter pour lancer le workflow.

Configuration de l'application API personnalisée

Le connecteur SharePoint est fourni avec une application multi-locataire intégrée que vous pouvez utiliser. Si toutefois vous préférez votre propre application, suivez les étapes ci-dessous. 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.

  1. Accédez à https://portal.azure.com/#home.
  2. Connectez-vous avec votre compte Microsoft Azure Active Directory.
  3. Sur l'écran d'accueil, utilisez Rechercher ou accédez au menu en haut à gauche pour ouvrir le service Azure Active Directory.
  4. Ouvrez Inscriptions d'applications dans le menu de gauche.
  5. Sélectionnez + Nouvelle inscription.
  6. Spécifiez le Nom de l'application.
  7. Choisissez le type de compte souhaité : locataire unique et multi-locataire sont autorisés tous les deux.
  8. Dans l'option Redirection URI :
    • Sélectionnez Application à page unique (SPA) dans le menu déroulant.
    • Pour conserver toutes les fonctionnalités avec différentes versions de connecteur, définissez les 2 URL :
      • https://cef.alteryx.com/designer/oauthcallback
      • https://login.live.com/oauth20_desktop.srf
  9. Sélectionnez Enregistrer.
    • L'ID d'application (client) est votre ID client.
    • L'ID d'annuaire (locataire) est votre ID de locataire.
  10. Accédez à API autorisées pour ajouter ces autorisations déléguées de Microsoft Graph :
    • Files.ReadWrite.All
    • offline_access
    • openid
    • User.Read
    • Sites.Read.All
    • E-mail
    • profil
  11. 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 ID de secret. Dans API autorisées, ajoutez ces autorisations d'application de 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.

Cette page vous a-t-elle été utile ?

Vous rencontrez des problèmes avec votre produit Alteryx ? Visitez la communauté Alteryx ou contactez le  support. Vous n'arrivez pas à soumettre ce formulaire ? Envoyez-nous un e-mail.