Aller au contenu principal

Connecteur Source Sage Intacct

Le connecteur source Sage Intacct dans DataSync vous permet de récupérer des données depuis Sage Intacct pour les charger ou les synchroniser dans votre entrepôt de données. Après avoir créé toutes les connexions source requises, configurez votre source de destination pour compléter la configuration de la connexion.

Pour des résultats optimaux, il est recommandé de créer deux connexions source : une connexion de rafraîchissement, qui utilise le suivi de date pour les chargements incrémentiels en fonction du champ LastModifiedDate, et une connexion sans rafraîchissement, utilisée pour les tables sans champ de suivi, généralement des tables de référence plus petites. Un Modèle de Connexions Sources Sage Intacct préconstruit est disponible pour une configuration rapide des connexions requises.

important

Sage Intacct a une maintenance programmée tous les samedis de 2h30 à 5h30 UTC.
Ne planifiez pas de tâches immédiatement avant ou durant cette période pour éviter les incohérences de données. Si des tâches s'exécutent pendant la maintenance, un Truncate and Load peut être nécessaire. Consultez Sage Status pour plus de détails.

Créer une connexion source dans DataSync

  1. Connectez-vous à DataSync.
  2. Depuis l'écran de bienvenue, sélectionnez Connections.
  3. À côté de Source Connections, cliquez sur New.
  4. Sélectionnez Sage Intacct.
  5. Dans le panneau Connection Properties, entrez les propriétés de connexion.
  6. (Optionnel) Dans le panneau Additional Connection Properties, sélectionnez Add property et entrez les paramètres pour chaque propriété.
  7. Dans le panneau Advanced Settings, configurez les paramètres, y compris le Tracking Type et d'autres valeurs selon vos besoins.
  8. Cliquez sur Save.

Paramètres

Propriétés de connexion

ParamètreDescription
DescriptionNom unique pour la connexion. Exemple : Sage Intacct
URLPoint de terminaison API pour Sage Intacct. Collez : https://api.intacct.com/ia/xml/xmlgw.phtml
User IDIdentifiant utilisateur de votre e-mail de credentials Sage Intacct. Exemple : FBL001
PasswordMot de passe pour l'User ID spécifié.
Company IDIdentifiant d'entreprise de votre e-mail de credentials Sage Intacct. Exemple : ACME01
Location ID(Optionnel) Identifiant pour un emplacement pour se connecter à une entreprise partagée multi-entités. Soit Location ID soit Client ID peut être défini - si les deux sont définis, une erreur se produit.
Client ID(Optionnel) Identifiant pour se connecter à une entreprise enfant distribuée. Dans ce scénario, l'User ID et le Password donnent accès à la console, pas à l'entreprise cible/client elle-même. Soit Location ID soit Client ID peut être défini - si les deux sont définis, une erreur se produit.
TimeoutTemps en secondes à attendre pour l'ouverture de la connexion et l'exécution de la requête avant le timeout.
Return data as XMLOption pour retourner les données au format XML plutôt qu'au format JSON. Le format XML prend en charge les demandes simultanées à un même objet API mais offre des performances inférieures à celles du JSON.
Verbosity
  • 1 – Journaliser les requêtes, les comptes de ligne, 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.
Enable PoolingOption de pool de connexions pour la performance.
Pool idle timeoutTemps d'inactivité maximal pour les connexions avant de les renvoyer au pool, en secondes.
Max Pool SizeNombre maximal de connexions autorisées dans le pool.
Pool wait timeTemps d'attente maximal pour l'allocation de connexion avant qu'une erreur ne soit généré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 Connection Properties. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Encrypted. La sélection de Encrypted masque la valeur de l'interface et la stocke de manière chiffrée dans le back-end, comme lors de la définition des mots de passe.

PropriétéValeur
ConverDateTimeToGMTParamètre configuré automatiquement sur True. Convertit toutes les valeurs DateTime en GMT.
MaximumRequestRetriesNombre de fois que DataSync réessaie une demande API échouée avant de renvoyer une erreur. Par défaut : 0 (aucun essai).
DocParIdIdentifiant du type de document pour les champs personnalisés de Sage Intacct. Un seul type de document peut être spécifié par connexion. Si vous avez besoin de champs personnalisés utilisant un type de document différent, créez une autre connexion Sage Intacct.
Exemple : Vendor Invoice

Paramètres avancés

Les paramètres avancés contrôlent la manière dont le connecteur Sage Intacct suit les modifications, gère la configuration régionale et horaire, et traite les lots de données lors de l'extraction. Ces options permettent un ajustement pour la performance et la précision, et doivent être configurées selon votre environnement système et vos exigences opérationnelles.

ParamètreDescription
Tracking TypeMéthode de suivi des changements : None ou Date.
RegionParamètre régional pour le connecteur, si requis par votre configuration.
Time ZoneFuseau horaire correspondant au serveur d'application Sage Intacct.
Time OffsetDécalage de rafraîchissement en secondes pour compenser les problèmes de timing dans la sélection des enregistrements. La valeur minimale est 0 ; le maximum est 3600 secondes.
Batch SizeQuantité d'enregistrements traités dans chaque lot lors de l'extraction. Des tailles de lot plus grandes augmentent l'utilisation de la mémoire mais peuvent améliorer les performances jusqu'à un certain point. La valeur par défaut est 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez selon votre vitesse réseau et performance disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.

Exemple