Documentation du Widget Sélecteur GoogleDocsPicker (Sélecteur Drive)

Le widget Sélecteur GoogleDocsPicker permet aux utilisateurs de sélectionner et importer des documents de Google Drive directement dans votre application. Il fournit une intégration transparente avec l'API Google Drive, permettant aux utilisateurs de parcourir, sélectionner et télécharger des fichiers de leur compte Google Drive.

Aperçu​

Ce widget crée un bouton qui, lorsqu'il est cliqué, ouvre l'interface du Sélecteur Google Drive. Les utilisateurs peuvent parcourir leurs fichiers, les fichiers partagés et les documents récemment consultés. Les fichiers sélectionnés sont automatiquement téléchargés et téléchargés vers le système de fichiers de votre plateforme.

Configuration de Base​

• Nom: Nom d'affichage du widget

• Variable/Modèle: Le nom de la variable qui stockera le tableau de fichiers sélectionnés

• Type de Bouton: Style visuel du bouton

  • primary (bleu)
  • success (vert)
  • info (gris)
  • warning (orange)
  • danger (rouge)

• Taille du Bouton: Taille du bouton

  • medium
  • small
  • mini

• Alignement du Bouton: Alignement horizontal

  • left (gauche)
  • center (centre)
  • right (droite)

• Icônes: Icônes préfixe et suffixe optionnelles pour améliorer l'apparence du bouton

  • Icône Préfixe: Icône affichée avant le texte du bouton
  • Icône Suffixe: Icône affichée après le texte du bouton

Configuration des Identifiants​

Le widget requiert des identifiants API Google Drive pour fonctionner correctement. Ceux-ci doivent être configurés comme variables d'environnement:

Identifiants Requis​

• Client ID: Identifiant client OAuth 2.0 de la Google Cloud Console
• Client Secret: Secret client OAuth 2.0 de la Google Cloud Console
• API Key: Clé API Google Drive de la Google Cloud Console

Configuration des Identifiants​

1. Accédez à la Google Cloud Console
2. Créez un nouveau projet ou sélectionnez-en un existant
3. Activez l'API Google Drive et l'API Google Picker
4. Créez des identifiants OAuth 2.0 et une clé API
5. Configurez les identifiants dans Volt, créez 3 entrées:
   • google_drive_client_id
   • google_drive_client_secret
   • google_drive_api_key

6. Sélectionnez les variables appropriées dans la configuration du widget:
   • Client Id: Sélectionnez parmi les variables d'environnement disponibles
   • Client Secret: Sélectionnez parmi les variables d'environnement disponibles
   • Api Key: Sélectionnez parmi les variables d'environnement disponibles

Fonctionnalités​

Interface de Sélection de Fichiers​

Le widget ouvre le Sélecteur Google Drive avec plusieurs vues:

• Mon Drive: Fichiers possédés par l'utilisateur
• Partagé avec moi: Fichiers partagés par d'autres
• Lecteurs partagés: Fichiers de lecteur d'équipe fichiers
• Récent: Fichiers récemment consultés

Types de Fichiers Supportés​

Le widget gère deux catégories de fichiers:

1. Fichiers Google Natifs: Documents, Feuilles de calcul, Présentations
   • Automatiquement exportés aux formats standard (PDF pour documents, CSV pour feuilles)
2. Fichiers Réguliers: Tous les autres types de fichiers
   • Téléchargés dans leur format original

Options de Validation​

Validation Basée sur l'Écran​

Configurez différents états de validation pour différents écrans/contextes:

• Disponible: Si le widget est disponible sur l'écran
• Visible: Si le widget est visible pour les utilisateurs
• Requis: Si la sélection de fichiers est obligatoire
• Désactiver: Si le widget est désactivé

Conditions Avancées​

Utilisez des conditions dynamiques avec les variables:

Règles de Validation​

Ajoutez des règles de validation personnalisées avec des messages:

• Types de Règles: Diverses règles de validation intégrées
• Valeurs Personnalisées: Paramètres spécifiques à la règle
• Messages d'Erreur: Messages personnalisés affichés aux utilisateurs en cas d'échec de validation

Options de Style​

• Classes CSS: Ajoutez des classes CSS personnalisées pour le style
• Classes Dynamiques: Utilisez des conditions pour appliquer les classes en fonction de l'état des données

Exemples d'Utilisation​

Configuration Basique avec Validation​

Configuration Avancée​

Considérations de Sécurité​

• Assurez-vous de la configuration appropriée de la portée OAuth
• Utilisez les variables d'environnement pour les identifiants sensibles
• Mettez en œuvre des contrôles d'accès appropriés pour les téléchargements de fichiers
• Validez les types de fichiers et les tailles côté serveur

Dépannage​

Problèmes Courants​

1. Erreurs d'Authentification: Vérifiez que les identifiants sont correctement configurés
2. Sélecteur ne S'Ouvre Pas: Vérifiez si les APIs Google sont activées
3. Échecs de Téléchargement de Fichiers: Vérifiez la gestion des fichiers côté serveur
4. Problèmes CORS: Assurez-vous de la configuration appropriée du domaine dans la Google Console

Conseils de Débogage​

• Vérifiez la console du navigateur pour les erreurs d'API
• Vérifiez que les URIs de redirection OAuth correspondent à votre domaine
• Testez avec différents types et tailles de fichiers
• Surveillez les requêtes réseau pour les échecs d'appels API

Support du Navigateur​

Le widget requiert des navigateurs modernes avec support pour:

• Fonctionnalités JavaScript ES6
• Authentification OAuth 2.0
• API de fichier pour la gestion du téléchargement
• Fonctionnalités CSS modernes pour le style