Skip to main content

microsoft-onedrive-icon.png Microsoft OneDrive

Le connecteur OneDrive vous permet de vous connecter au stockage Cloud Microsoft OneDrive depuis Designer. OneDrive est disponible en tant que source de données dans les outils Entrée de données et Sortie de données.

Passer au nouveau connecteur OneDrive

Si votre workflow utilise les outils autonomes Entrée OneDrive ou Sortie OneDrive, sachez qu'ils ne sont plus pris en charge. Utilisez plutôt la version 2.2.0 ou ultérieure du connecteur, en combinaison avec les outils Entrée de données et Sortie de données. Utilisez l'utilitaire de migration de workflow pour mettre à jour les workflows existants.Output Data Tool Icon Outil Sortie de données

Conditions préalables

Assurez-vous d'avoir rempli les conditions préalables suivantes avant de continuer :

Exigences

Détails

Designer

Designer version 2026.1 ou versions ultérieures.

Designer 2025.2 correctif 3 ou ultérieur.

Designer 2025.1 correctif 5 ou ultérieur.

Version du connecteur

Microsoft OneDrive 2.2.0 et versions ultérieures. Disponible auprès des compléments Designer.

Autorisations Azure

Voir Configuration de l'application API Microsoft Azure.

DCM

Vous devez activer DCM dans Designer. Accédez à Options >Paramètres avancés > DCM pour l'activer.

Accès réseau

Accès sortant aux points de terminaison OneDrive en ligne et Microsoft OAuth.

Installer le connecteur

Installez la dernière version du connecteur OneDrive directement depuis Designer via les compléments. C'est la méthode d'installation recommandée qui vous permet de parcourir, d'installer et de mettre à jour les connecteurs sans quitter Designer ni accéder à Alteryx Marketplace.

Pour installer le connecteur…

  1. Dans Designer, accédez à Compléments > Gérer les compléments Marketplace. Vous verrez une liste des connecteurs disponibles.

  2. Sélectionnez le connecteur Microsoft OneDrive, puis sélectionnez Installer. Designer télécharge et installe le package. Designer peut avoir besoin de redémarrer pour terminer l'installation.

  3. Une fois l'installation et la configuration terminées, le connecteur OneDrive est accessible via les outils Entrée de données et Sortie de données.

Configurer une connexion

Pour vous connecter à Microsoft OneDrive…

  1. Faites glisser l'outil Entrée de données ou Sortie de données vers le canevas, puis sélectionnez Se connecter aux données.

  2. Sous Configuration du connecteur, sélectionnez Créer ou parcourir une connexion de données.

    Si vous avez déjà créé une connexion Microsoft OneDrive, vous pouvez la sélectionner dans l'onglet Récents.

  3. Sélectionnez + Nouveau. Dans la liste des technologies, sélectionnez Microsoft OneDrive.

  4. Saisissez le nom de la connexion et le nom de la source de données.

  5. Dans la section Informations d'identification, sélectionnez votre méthode d'authentification et saisissez les informations d'identification. Pour plus d'informations, consultez la page Méthodes d'authentification.

  6. Sélectionnez Enregistrer. Vous pouvez également tester la connexion avant de procéder à l'enregistrement.

  7. Sélectionnez Se connecter. Microsoft OneDrive peut demander une authentification.

  8. Sélectionnez la configuration en lecture ou en écriture dans la fenêtre Options. Pour en savoir plus sur les options, consultez Lire les données de OneDrive ou Écrire des données dans OneDrive.Lire les données de OneDriveÉcrire des données dans OneDrive

  9. Sélectionnez confirmer pour créer une connexion vers le fichier. Vous pouvez continuer à créer votre workflow.

Migration de workflow

Si vos workflows actuels utilisent les outils obsolètes Entrée de OneDrive ou Sortie de OneDrive, vous devez les migrer pour utiliser le nouveau connecteur. Utilisez l'utilitaire de migration de workflow pour mettre à jour les workflows existants.

L'utilitaire affiche un aperçu de toutes les modifications et remplace les instances d'outils obsolètes par les nouvelles versions du connecteur, sans interrompre les workflows.

Méthodes d'authentification

Microsoft OneDrive prend en charge trois méthodes d'authentification. Utilisez la table ci-dessous pour choisir la méthode la plus adaptée à votre cas d'usage.

Méthode

Détails

Azure AD-privé (application intégrée)

  • Utilisez cette option pour configurer une connexion personnelle et ponctuelle en utilisant vos propres informations d'identification Microsoft.

  • Votre adresse e-mail et votre mot de passe sont associés à vos informations d'identification Microsoft personnelles.

  • Peut être utilisée pour le SDK.

  • Non recommandée pour la planification des workflows.

  • DCM facultatif.

Azure AD-privé (application personnalisée)

  • Utilisez cette option lorsque votre équipe partage une application Azure enregistrée de manière personnalisée.

  • Peut être utilisée pour le SDK.

  • Pour obtenir des instructions sur la configuration, consultez Configuration de l'application API Microsoft Azure.

  • DCM facultatif.

Principal du service (application)

  • Utilisez cette option pour planifier ou automatiser des workflows sans lier l'authentification à un utilisateur spécifique.

  • Exploite les capacités des applications API personnalisées avec un principal du service.

  • Pour obtenir des instructions sur la configuration, consultez Configuration de l'application API Microsoft Azure.

  • DCM obligatoire.

Limites

Le connecteur Microsoft OneDrive présente actuellement les limitations suivantes :

  • Les API Graph Récents et Partagés avec moi sous-jacentes de Microsoft sont obsolètes et ne renvoient plus de données. Ceci est une limitation au niveau de la plateforme, indépendante de ce connecteur.

    En conséquence, les sections Récents et Partagés avec moi ne sont ni consultables ni accessibles, et le champ d'application des chemins d'accès dans OneDrive est limité à Mes fichiers.

  • La séparation n’est pas prise en charge.

  • La lecture de données à l'aide de caractères génériques ou à partir de plusieurs fichiers ou dossiers n'est pas prise en charge, mais elle peut être réalisée grâce à des macros.

  • L'action de sortie Ajouter n'est pas prise en charge. Utilisez la commande Lire, > Union > Écraser pour reproduire le comportement d'ajout.

  • Lors de la création d'un nouveau fichier, si un fichier portant le même nom existe déjà à l'emplacement de destination, l'action ne l'écrasera pas. Au lieu de cela, elle ajoutera un suffixe d'horodatage au nom du nouveau fichier, conservant ainsi les deux fichiers.

  • La lecture de fichiers XLSX à plusieurs feuilles ou la sélection d'une feuille par son nom ou son index n'est pas prise en charge.

Notes de publication

Version

Description

v3.1.1

  • Nous avons amélioré le champ URL d'autorité en y ajoutant une valeur par défaut préremplie et un texte d'aide intégré, ce qui réduit la nécessité de consulter une documentation externe.

  • Nous avons résolu un problème qui entraînait l'affichage d'options de configuration non pertinentes lors de la sélection d'un format de fichier non pris en charge dans le connecteur d'entrée OneDrive.

  • Nous avons résolu un problème qui entraînait un échec du test de connexion dans DCM lors de l'utilisation du type d'authentification de l'application intégrée.

  • Amélioration du traitement des erreurs pour les opérations d'envoi et de réception dans OneDrive.

v3.1.0

  • Compatible avec Designer 2021.4.2 correctif 4, 2022.1 correctif 2 et versions ultérieures.

  • Possibilité de se connecter à OneDrive en utilisant la connexion OAuth 2.0 sécurisée de Microsoft.

  • Authentifiez-vous via un principal de service pour des workflows automatisés et sans surveillance.

  • Enregistrez vos identifiants de connexion une seule fois dans DCM et réutilisez-les dans tous vos workflows, que ce soit sur Designer ou sur Server.

  • Exécutez des tâches sans surveillance sur Server avec un renouvellement automatique des jetons, sans nécessiter de nouvelle authentification manuelle.

  • Filtrez rapidement vos Fichiers personnels, les fichiers Partagés avec moi ou les Fichiers récents.

  • Sélectionnez des fichiers en les parcourant, en saisissant manuellement un chemin d'accès ou en collant simplement un lien OneDrive partagé.

  • Collez une URL et le connecteur identifiera et chargera automatiquement les informations du fichier.

  • Sélectionnez une feuille spécifique par son nom ou son numéro, définissez une plage de cellules personnalisée ou extrayez simplement la liste des noms des feuilles.

  • Incluez des informations telles que le nom du fichier, son chemin d'accès, sa taille, sa date de dernière modification et son type, en plus de vos données.

  • Récupérez uniquement la structure des fichiers et des dossiers sans télécharger l'intégralité de leur contenu.

  • Lisez directement les fichiers .csv, .xlsx et .yxdb depuis OneDrive.

v2.3.0

  • Compatible avec Designer 2021.4.2 correctif 4, 2022.1 correctif 2 et versions ultérieures.

  • Compatible avec AMP Engine uniquement.

  • DCM est nécessaire pour exécuter ce connecteur sur Alteryx Server.

  • Amélioration de la fenêtre des options d'authentification.

  • La sortie de l'outil Entrée OneDrive inclut désormais les noms de feuille lorsque vous téléchargez des fichiers XLSX localement. Vous pouvez utiliser les noms de feuille dans d'autres outils de votre workflow.

  • Correction d'un problème où l'outil Sortie OneDrive défini pour écraser une feuille spécifique dans le fichier XLSX modifiait également d'autres feuilles.

  • Correction d'un problème où l'authentification des outils OneDrive ne fonctionnait pas correctement. (TPM-3833)

  • Correction d'un problème où l'outil Entrée OneDrive ne lisait pas correctement certains types de données. (TPM-3751, TPM-3722, TPM-3721)

  • Correction d'un problème où l'outil Sortie OneDrive écrivait des fichiers incorrects si les données contenaient des valeurs décimales ou nulles fixes. (TPM-3720)

  • Correction d'un problème où l'outil Sortie OneDrive convertissait incorrectement les valeurs nulles dans les fichiers CSV. (TPM-3719)

  • Correction d'un problème où l'authentification du principal du service ne fonctionnait pas dans l'outil Sortie OneDrive. (TPM-3580)

  • Correction d'un problème où, malgré les paramètres utilisateur indiquant d'exclure le champ des options Sélectionner une feuille, l'outil Sortie OneDrive incluait le champ dans la sortie. (TPM-3393)

  • Correction d'un problème où l'outil Sortie OneDrive n'ajoutait pas correctement les données. (TPM-2564)

  • Correction d'un problème où l'option Abandonner de l'outil Sortie OneDrive ne fonctionnait pas correctement pour tous les types de données. (TPM-2563)

  • Correction des problèmes de codage des outils OneDrive. (TPM-1984)

  • Correction d'un problème où l'outil Sortie OneDrive modifiait le format des en-têtes. (TPM-1375)

  • Correction d'un problème où l'option Ajouter de l'outil Sortie OneDrive écrasait le formatage et les formules du document. (TPM-1179)

  • Correction d'un problème où l'outil Entrée OneDrive ne pouvait pas lire les fichiers YXDB avec les données DateTime. (TPM-1100)

  • Correction d'un problème d'échec de l'outil Sortie OneDrive lorsque le workflow incluait des types de données Octet et Int16. (TPM-209)

v2.2.0

  • Compatible avec Designer 2021.4.2 correctif 4, 2022.1 correctif 2 et versions ultérieures.

  • Compatible avec AMP Engine uniquement.

  • Ajout du support pour DCM.

    • DCM est nécessaire pour exécuter ce connecteur sur Alteryx Server.

  • Compatible FIPS.

  • Ajout d'une option pour remplacer une seule feuille.

  • Modification du comportement du champ de nom de feuille à exclure des données écrites. Ajout d'une option pour conserver le champ de nom de feuille.

  • La validation SSL/TLS est désormais effectuée par rapport au magasin de certificats Windows.

v2.1.0

  • L'authentification est réalisée à l'aide du navigateur de l'utilisateur au lieu du CEF intégré dans Designer pour se conformer aux politiques de sécurité modernes.

v2.0.2

  • Correction d'un problème de perte de la configuration de l'outil en cas d'activation de « Fournir des informations d'authentification ».

v2.0.1

  • Correction du problème d'écran vide lors de l'authentification dans Designer 2021.3.2.54175. Vous devez également effectuer une mise à jour vers Designer 21.3.3.63061 ou une version ultérieure.

v2.0.0

  • Application Azure multi-locataire intégrée avec option d'utilisation d'une application Azure personnalisée (y compris une application à locataire unique ou Principal du service).

  • Prend en charge la lecture et l'écriture des formats de fichiers XLSX, CSV et YXDB.

  • Prise en charge de proxy.

  • Compatible avec Designer version 2021.2.2 et ultérieure.

  • Requiert OneDrive 365.

v1.0.2

  • Mise à jour des options de page de code.

  • Distinction entre les codages avec la même langue (par exemple, « langue » -> « langue (code spécifique) ») et les encodages classés par ordre alphabétique.

  • Permet à l'utilisateur de spécifier le codage des fichiers CSV sur l'outil de sortie.

  • Amélioration de la gestion de la conversion des données pour ne pas afficher d'avertissement au lieu d'une erreur lorsqu'une valeur est manquante dans un champ.

  • Correction d'un problème où les valeurs par défaut n'étaient parfois pas respectées.

  • Désactivation de la journalisation de production pour éviter les problèmes d'autorisations avec différentes installations et configurations de Designer et pour prendre en charge la fonctionnalité de planification de workflow.

v1.0.1

  • Résolution du problème empêchant la bonne installation des packages.

v1.0.0

  • Version initiale pour Entrée OneDrive et Sortie OneDrive.

Personnaliser l'application API Microsoft Azure

Pour configurer une application API personnalisée pour cet outil, consultez notre guide.

Note

Assurez-vous que AMP Engine est activé pour les workflows qui contiennent les outils OneDrive version 2.2.0 et ultérieure. Pour en savoir plus, consultez la section AMP Engine.

Outils Alteryx utilisés pour la connexion

OneDrive Input Tool Icon Outil Entrée OneDrive

OneDrive Output Tool Icon Outil Sortie OneDrive

Dans cette section​: