Aller au contenu principal

Connecteur Source Quickbooks Desktop

Le connecteur source Quickbooks Desktop dans DataSync vous permet de récupérer des données de QuickBooks Desktop pour les charger ou les synchroniser dans votre entrepôt de données. Avant de configurer la connexion, assurez-vous que DataSync est installé avec HTTPS activé et que vous disposez d'un compte QuickBooks Desktop avec des permissions administratives.

Après avoir créé toutes les connexions sources requises, configurez votre source de destination pour compléter la configuration de la connexion.

Créer une connexion source dans DataSync

  1. Connectez-vous à DataSync.
  2. À partir de l'écran d'accueil, sélectionnez Connexions.
  3. À côté de Connexions Sources, cliquez sur Nouvelle.
  4. Sélectionnez Quickbooks Desktop.
  5. Dans le panneau Propriétés de connexion, saisissez les propriétés de connexion.
  6. (Facultatif) Dans le panneau Propriétés de connexion supplémentaires, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
  7. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de Suivi et d'autres valeurs selon vos besoins.
  8. Cliquez sur Sauvegarder.

Paramètres

Propriétés de connexion

ParamètreDescription
DescriptionNom unique pour la connexion. Exemple : Quickbooks Desktop.
URLAdresse du connecteur distant utilisé pour se connecter à l'instance QuickBooks.
Exemple : https://server.company.com:8335
Format des champs personnalisésFormat utilisé pour les données de champ personnalisées retournées par QuickBooks :

  • JSON – Formate les données en Notation d'Objet JavaScript.
  • XML – Formate les données en Langage de Marquage Extensible.
Délai après fermetureDélai, en millisecondes, appliqué chaque fois qu'une connexion QuickBooks est fermée. Par défaut : 30000 (30 secondes).
Version XML de QuickbooksVersion du XML QuickBooks (“QBXML”) utilisée dans les messages SDK sortants. Cela s'applique uniquement à l'édition de bureau. Chaque version de QuickBooks est liée à des versions SDK spécifiques :
  • 1.0 – QuickBooks 2002
  • 2.0 – QuickBooks 2003
  • 3.0 – QuickBooks 2004
  • ...continué jusqu'à 13.0 – QuickBooks 2014
  • CA2.0 – QuickBooks Canadien 2003
  • CA3.0 – QuickBooks Canadien 2004–2007
  • UK2.0 – QuickBooks UK 2003
  • UK3.0 – QuickBooks UK 2004–2007
  • OZ2.0 – QuickBooks Australien 2003
  • AU3.0 – QuickBooks Australien 2004–2007
Les anciennes versions SDK restent prises en charge dans les versions ultérieures, mais de nouvelles fonctionnalités SDK ne sont disponibles que dans les versions plus récentes. Valeur recommandée : faire correspondre la version QBXML à la version de QuickBooks que vous utilisez. Sélectionnez dans la liste déroulante :
  • QBDEFAULT (Par défaut)
  • Options de version spécifiques, comme indiqué ci-dessus.
Nom d'utilisateurNom d'utilisateur du compte QuickBooks Desktop.
Mot de passeMot de passe pour le nom d'utilisateur spécifié.
Verbosité
  • 1 – Journaliser les requêtes, le nombre de lignes, le début/fin d'exécution, les erreurs.
  • 2 – Inclut le niveau 1 plus les requêtes de cache, les en-têtes HTTP.
  • 3 – Inclut le niveau 2 plus les corps de requête/réponse.
  • 4 – Inclut le niveau 3 plus la communication au niveau du transport.
  • 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Activer le PoolingOption de mise en commun des connexions pour la performance.
Délai d'inactivité du poolTemps d'inactivité maximum pour les connexions avant de les renvoyer au pool, en secondes.
Taille maximale du poolNombre maximal de connexions autorisées dans le pool.
Temps d'attente du poolTemps d'attente maximum pour l'allocation de connexion avant qu'une erreur ne soit déclenchée, en secondes.

Propriétés de connexion supplémentaires

Propriétés de chaîne de connexion supplémentaires non spécifiées dans le panneau Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Chiffré. La sélection de Chiffré cache la valeur de l'interface et la stocke chiffrée en arrière-plan, comme lors de la définition de mots de passe.

ParamètreDescription
PropriétéPropriété de chaîne de connexion qui définit l'action ou le comportement. Exemple : ReadOnly
ValeurValeur pour la propriété. Exemple : True
TypeVisibilité de la propriété : Visible ou Chiffré.

Paramètres avancés

Les paramètres avancés contrôlent la manière dont le connecteur Quickbooks Desktop suit les changements, gère la configuration régionale et de temps, et traite les lots de données lors de l'extraction. Ces options permettent d'affiner la performance et l'exactitude et doivent être configurées selon votre environnement système et vos exigences opérationnelles.

ParamètreDescription
Type de suiviMéthode de suivi des changements : Aucun ou Date.
RégionParamètre régional pour le connecteur, si requis par votre configuration.
Fuseau horaireFuseau horaire correspondant au serveur de l'application Quickbooks Desktop.
Décalage horaireDécalage de rafraîchissement en secondes pour compenser les problèmes de synchronisation lors de la sélection des enregistrements. La valeur minimale est 0 ; la valeur maximale est de 3600 secondes.
Taille de lotQuantité d'enregistrements traités dans chaque lot lors de l'extraction. Des tailles de lot plus importantes augmentent l'utilisation de la mémoire mais peuvent améliorer la performance jusqu'à un certain point. La valeur par défaut est 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez selon la vitesse de votre réseau et la performance de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.

Exemple