Connecteur source Sage X3

Le connecteur source Sage Business Cloud X3 permet de récupérer des données depuis votre ERP X3 Cloud via sa couche d’API REST. Il fournit un accès authentifié aux points de terminaison exposés par votre environnement X3, permettant à DataSync de lire les objets métiers et les représentations. Ce connecteur est exclusivement disponible pour Sage Business Cloud X3 et ne prend pas en charge les installations X3 on‑premise.

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

Localiser les détails de votre API BI Sync

1. Connectez-vous à votre portail partenaire.
2. Dans la liste de déploiement, sélectionnez votre déploiement.
3. Sélectionnez l'onglet Intégrations BI.
4. Copiez l'URL de l’API BI Sync et le clé API BI Sync, puis conservez-les en lieu sûr. Vous en aurez besoin lors de la création de votre connexion source.

Créer une connexion source dans DataSync

1. Connectez-vous à DataSync.
2. Depuis l’écran d’accueil, sélectionnez Connexions.
3. À côté de Connexions de la source, cliquez sur Nouveau.
4. Sélectionnez Sage X3 (Cloud).
5. Dans le panneau Propriétés de la connexion, saisissez les propriétés de connexion.
6. (Optionnel) Dans le panneau Autres propriétés de la connexion, cliquez sur Ajouter une propriété et ajoutez les les paramètres nécessaires.
7. Dans le panneau Paramètres avancés, configurez les paramètres avancés, notamment le Type de suivi et les autres valeurs selon vos besoins.
8. Cliquez sur Enregistrer.

Paramètres

Propriétés de la connexion

Paramètre	Description
Description	Nom unique de la connexion. Exemple : Sage X3 Cloud
URI du locataire	URL de base du déploiement X3. Correspond à l’URL de l’API BI Sync. Exemple : https://subdomain.dev-sagex3.com
Route Sync	Route API exposée par votre environnement X3. Exemple : syncapi
Dossier du locataire	Dossier API à exposer. Dérivé du dernier segment de l’URL de l’API BI Sync, avec le dossier spécifique ajouté à la fin. Exemple : SEED
Clé API du locataire	Clé API BI Sync associée à votre instance X3. Chaque instance utilise une seule clé partagée entre tous les dossiers.
Taille de page	Nombre d’enregistrements renvoyés par appel API lors de la pagination. Une valeur plus élevée renvoie davantage de données par page mais peut augmenter le risque de dépassement de délai. Valeur par défaut : 1000
Verbosité	Niveau de journalisation déterminant la quantité de détails enregistrés : 1 – Journalise les requêtes, le nombre de lignes, le début/fin d’exécution et les erreurs. 2 – Inclut le niveau 1 ainsi que les requêtes du cache et les en‑têtes HTTP. 3 – Inclut le niveau 2 ainsi que les corps des requêtes et réponses. 4 – Inclut le niveau 3 ainsi que la communication au niveau du transport. 5 – Inclut le niveau 4 ainsi que toutes les commandes d’interface.

Autres propriétés de la connexion (optionnel)

Propriétés supplémentaires de la chaîne de connexion qui ne figurent pas dans le panneau Propriétés de la connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Crypté. L’option Crypté masque la valeur dans l’interface et l’enregistre de manière sécurisée dans le back‑end, ce qui est recommandé pour les informations sensibles comme les mots de passe.

Propriété	Valeur
ConverDateTimeToGMT	Paramètre automatiquement défini sur True. Convertit toutes les valeurs DateTime en GMT.

Paramètres avancés

Les paramètres avancés définissent la manière dont le connecteur Sage X3 Cloud suit les modifications, gère la configuration régionale et temporelle, et traite les lots de données lors de l’extraction. Ces options permettent d’optimiser les performances et la précision, et doivent être ajustées en fonction de votre environnement et de vos besoins opérationnels.

Paramètre	Description
Type de suivi	Méthode utilisée pour le suivi des modifications : Aucun ou Date.
Région	Paramètre régional du connecteur, si requis par votre déploiement.
Fuseau horaire	Fuseau horaire correspondant au serveur applicatif Sage X3 Cloud.
Compensation du décalage de temps	Décalage de rafraîchissement (en secondes) permettant de compenser d’éventuels écarts temporels lors de la sélection des enregistrements. Minimum : 0 ; maximum : 3600.
Taille de lot	Nombre d’enregistrements traités par lot lors de l’extraction. Des lots plus importants augmentent l’utilisation mémoire mais peuvent améliorer les performances jusqu’à une certaine limite. Valeur par défaut : 2000; valeur maximale recommandée :10000. Ajustez cette valeur en fonction des performances du réseau et du disque ; la valeur par défaut (2000) donne généralement les meilleurs résultats.