DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WINDEV, WEBDEV et WINDEV Mobile 2024 !
Aide / WLangage / Fonctions WLangage / Communication / Fonctions Drive
  • Présentation
  • Pré-requis
  • Comment le faire ?
  • Connexion
  • Manipulation des fichiers et des répertoires du drive
  • Cas particulier : manipulation des fichiers de la suite Google Drive
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
De nombreux drives permettent de stocker des fichiers. WINDEV, WEBDEV et WINDEV Mobile permettent de manipuler simplement les fichiers présents sur les drives Dropbox, Google Drive et OneDrive. Le code est identique quelque soit le drive manipulé.
Dans Google Drive, il est également possible de manipuler les fichiers de la suite Google.
Pré-requis
Pour manipuler les fichiers présents sur les différents drives, il est nécessaire de configurer les drives utilisés. Pour plus de détails, consultez Prérequis à l'utilisation des drives Google Drive, OneDrive et Dropbox.
Comment le faire ?

Connexion

Avant d'utiliser les drives, il est nécessaire de s'y connecter.
Il est possible de se connecter aux différents drives en utilisant le protocole OAuth 2.0.
Pour cela :
  1. Créez une nouvelle variable de type OAuth2Paramètres.
  2. Définissez les différentes propriétés de cette variable, notamment :
    • ClientID : Identifiant client obtenu lors de la configuration du drive.
    • ClientSecret : Identifiant secret obtenu lors de la configuration du drive.
      iPhone/iPad Pour iOS, l'identifiant secret n'existe pas.
    • URLRedirection : Indiquez l'URL voulue, par exemple "http://localhost:29000".
      iPhone/iPad Pour iOS, l'URL de redirection correspond au "Schéma d'URL iOS" fourni par Google lors de la configuration. L'URL de redirection doit ressembler à l'URL suivante : "com.googleusercontent.apps.123-abc:/oauth".
  3. Créez une variable de type Drive, et utilisez la fonction de connexion correspondant au drive voulu :
    Nouveauté 2024
    dpDriveConnecte
    Crée une connexion à un drive Dropbox.
    Nouveauté 2024
    GglDriveConnecte
    Crée une connexion à un drive Google Drive.
    Nouveauté 2024
    oDriveConnecte
    Crée une connexion à un drive OneDrive.
Remarque : Il est également possible de passer un token avec "refresh token". Cette solution permet d'éviter de redemander les informations de connexion à l'utilisateur. Le détail des informations à utiliser est donné dans la documentation de chaque fonction de connexion.
Exemples :
  • Connexion à un drive Google via le protocole OAuth 2.0 :
    // Connexion au drive Google Drive via le protocole OAuth 2.0
    oOAuth2Param est un OAuth2Paramètres
    oOAuth2Param.ClientID = "client_id"
    oOAuth2Param.ClientSecret = "client_secret"
    oOAuth2Param.URLRedirection = "http://localhost:9000/"
     
    MonDrive est un gglDrive
    MonDrive = GglDriveConnecte(oOAuth2Param)
  • Connexion à un drive Google via un token :
    // Connexion au drive Google Drive via un token (refresh token)
    oOAuth2Param est un OAuth2Paramètres
    oOAuth2Param est un OAuth2Paramètres
    oOAuth2Param.ClientID = "client_id"
    oOAuth2Param.ClientSecret = "client_secret"
    oOAuth2Param.URLRedirection = "http://localhost:9000/"

    oOAuth2Token est un AuthToken
    oOAuth2Token = AuthIdentifie(oOAuth2Param)
     
    MonDrive est un gglDrive
    MonDrive = GglDriveConnecte(oOAuth2Token)

Manipulation des fichiers et des répertoires du drive

La manipulation des fichiers et des répertoires du drive est réalisée grâce aux fonctions suivantes. Ces fonctions manipulent toutes la variable de type Drive, renseignée lors de la connexion au drive.
  • Fonctions de manipulation des fichiers :
    Nouveauté 2024
    DriveCopieFichier
    Copie un fichier unique du disque distant vers un autre répertoire du disque distant.
    Nouveauté 2024
    DriveCréeFichier
    Crée un fichier sur le disque distant.
    Nouveauté 2024
    DriveDéplaceFichier
    Déplace un fichier présent dans un répertoire d'un drive vers un autre répertoire de ce drive (disque distant).
    Nouveauté 2024
    DriveEnvoieFichier
    Envoie un fichier (présent sur la machine de l'utilisateur) vers un drive (disque distant).
    Nouveauté 2024
    DriveListeFichier
    Liste les fichiers d'un répertoire d'un drive.
    Récupère un fichier présent sur un drive (disque distant) et enregistre ce fichier sur le poste de l'utilisateur.
    Nouveauté 2024
    DriveRenomme
    Renomme un fichier ou un répertoire présent sur un drive.
    Nouveauté 2024
    DriveSupprimeFichier
    Supprime un fichier dans un drive (disque distant).
  • Fonctions de manipulation des répertoires :
    Nouveauté 2024
    DriveCopieRépertoire
    Copie un répertoire du drive vers un autre répertoire de ce drive (disque distant).
    Nouveauté 2024
    DriveCréeRépertoire
    Crée un répertoire sur le disque distant.
    Déplace un répertoire et son contenu vers un autre répertoire du même drive (disque distant).
    Nouveauté 2024
    DriveEnvoieRépertoire
    Envoie un répertoire et ses fichiers (présents sur la machine de l'utilisateur) vers un drive (disque distant).
    Nouveauté 2024
    DriveListeRépertoire
    Liste les répertoires d'un drive.
    Récupère un répertoire (et ses fichiers) présent sur un drive (disque distant) pour l'enregistrer sur le poste de l'utilisateur.
    Nouveauté 2024
    DriveRenomme
    Renomme un fichier ou un répertoire présent sur un drive.
    Supprime un répertoire (et les fichiers qu'il contient) sur un drive (disque distant).

Cas particulier : manipulation des fichiers de la suite Google Drive

Le drive Google Drive permet de manipuler les fichiers de la suite Google : Docs, Sheets, Slides, etc.
La manipulation de ces fichiers doit se faire via :
Deux fonctions spécifiques à la manipulation de ces fichiers sont disponibles :
Nouveauté 2024
DriveListeFichierGgl
Liste les fichiers de la suite Google (Google Docs, Google Sheets, etc.) présents dans un drive Google.
Récupère un document de la suite Google présent sur un Google Drive dans le format compatible souhaité.
La fonction DriveListeFichierGgl permet d'obtenir la liste des fichiers de la suite Google présents sur le Drive. Cette fonction permet d'initialiser le type FichierGgl. Ce type de variable pourra ensuite être utilisé par les différentes fonctions de gestion des drives.
Exemple :
oOAuth2Param est un OAuth2Paramètres
oOAuth2Param.ClientID = "client_id"
oOAuth2Param.ClientSecret = "client_secret"
oOAuth2Param.URLRedirection = "http://localhost:9000/"

gglMonDrive est un gglDrive
gglMonDrive = GglDriveConnecte(oOAuth2Param) 

tabFicGgl est un tableau de FichierGgl
tabFicGgl = DriveListeFichierGgl(gglMonDrive, "/", frRécursif)

POUR TOUT Fichier DE tabFicGgl
SELON Fichier.TypeMIME
CAS typeMimeGglDocs : Fichier.TypeMimeExport = typeMimeDOCX
CAS typeMimeGglSheets : Fichier.TypeMimeExport = typeMimeXLSX
AUTRE CAS : Fichier.TypeMimeExport = typeMimePDF
FIN 
soit ResRécupère = DriveRécupèreFichierGgl(gglMonDrive, tabFicGgl[1], "c:\MesDocuments")
SI ErreurDétectée ALORS
// Gestion de l'erreur
Trace ("Une erreur s'est produite")
RETOUR
FIN
FIN
Liste des exemples associés :
Les fonctions Drive Exemples unitaires (WINDEV) : Les fonctions Drive
[ + ] Cet exemple montre l'utilisation des fonctions Drive (Google Drive, Dropbox, OneDrive)
Les fonctions Drive Exemples unitaires (WINDEV Mobile) : Les fonctions Drive
[ + ] Cet exemple montre l'utilisation des fonctions Drive (Google Drive, OneDrive)
Les fonctions Drive Exemples unitaires (WEBDEV) : Les fonctions Drive
[ + ] Cet exemple montre l'utilisation des fonctions Drive (Google Drive, Dropbox, OneDrive)
Version minimum requise
  • Version 2024
Documentation également disponible pour…
Commentaires
Impossible de ce connecter avec DropBox
à corriger : oOAuth2Param.URLRedirection = "http://localhost:9000/" par "http://localhost:9000". corriger aussi dans App DropBox
Monsieur ESCOLAR
15 avr. 2024

Dernière modification : 03/01/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale