Connecteur source Sage Business Cloud X3

Le connecteur source Sage Business Cloud X3 permet à DataSync de récupérer les données de l'ERP X3 Cloud via sa couche API REST, avec un accès authentifié aux points de terminaison exposés par l'environnement X3 pour lire les objets métier et leurs représentations. Ce connecteur est disponible uniquement pour Sage Business Cloud X3 et n'est pas compatible avec les installations X3 sur site.

Une fois la connexion source créée, configurez la connexion de destination pour finaliser l'installation.

Étape 1 : 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.

Étape 2 : créer la 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. Complétez toutes les propriétés de connexion requises.
6. (Facultatif) Dans le panneau Autres propriétés de la connexion, cliquez sur Ajouter une propriété et définissez les paramètres supplémentaires nécessaires.
7. Configurez les paramètres avancés selon votre environnement, notamment le Type de suivi.
8. Cliquez sur Enregistrer.

Propriétés de la connexion

Propriété	Description
Description	Nom unique attribué à 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 l'environnement X3. Exemple : syncapi.
Dossier du locataire	Dossier API à exposer. Correspond au dernier segment de l'URL de l'API BI Sync, suivi du dossier spécifique. Exemple : SEED.
Clé API du locataire	Clé API BI Sync associée à l'instance X3. Chaque instance utilise une seule clé, partagée entre tous les dossiers.
Taille de page	Nombre d'enregistrements retournés par appel API lors de la pagination. Des valeurs plus élevées retournent davantage de données par page mais augmentent le risque d'expiration. Valeur par défaut : 1000.
Verbosité	Contrôle le niveau de détail écrit dans le journal. Chaque niveau inclut tout ce qui précède plus des informations supplémentaires. 1 enregistre les requêtes, les nombres de lignes, les heures de début et de fin d'exécution ainsi que les erreurs. 2 ajoute les requêtes de cache et les en-têtes HTTP. 3 ajoute les corps de requête et de réponse. 4 ajoute la communication au niveau du transport. 5 ajoute toutes les commandes d'interface.

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

Ce panneau permet d'ajouter des propriétés de chaîne de connexion qui ne figurent pas dans le panneau Propriétés de la connexion. Pour les valeurs sensibles comme les mots de passe, choisissez le type Crypté. La valeur reste alors masquée dans l'interface et stockée de façon chiffrée côté serveur.

Propriété	Description
ConverDateTimeToGMT	Définie automatiquement sur True. Convertit toutes les valeurs DateTime en GMT.

Paramètres avancés

Ces paramètres déterminent la façon dont le connecteur suit les modifications de données, gère l'heure et la région, et traite les enregistrements pendant l'extraction. Ajustez-les selon votre environnement Sage Business Cloud X3 afin que les résultats restent exacts et cohérents.

Paramètre	Description
Type de suivi	Méthode de suivi des modifications de données : Aucun ou Date.
Region	Paramètre régional du connecteur, si la configuration l'exige.
Fuseau horaire	Fuseau horaire correspondant à l'environnement Sage Business Cloud X3.
Décalage de temps	Décalage d'actualisation en secondes pour compenser les écarts de synchronisation lors de la sélection des enregistrements. Minimum 0, maximum 3600.
Taille du lot	Nombre d'enregistrements traités par lot lors de l'extraction. Des lots plus grands peuvent améliorer les performances mais consomment davantage de mémoire. La valeur par défaut est 2000, le maximum est 10000. À ajuster selon la vitesse du réseau et les performances du disque. La valeur par défaut convient dans la plupart des cas.

Exemple de configuration

Connexion source Sage Business Cloud X3 entièrement configurée dans DataSync, avec toutes les propriétés et tous les paramètres complétés.