Connecteur source Acumatica

Le connecteur source Acumatica dans DataSync permet de récupérer les données d'un ou plusieurs locataires Acumatica et de les charger dans un entrepôt de données. Dans Acumatica, les locataires représentent des entreprises individuelles. Au moins un locataire (tenant) doit être configuré avant de créer la connexion.

Avant de créer des connexions source dans DataSync, vérifier que l'environnement Acumatica est correctement configuré. Le fuseau horaire d'Acumatica doit correspondre à celui spécifié dans DataSync, sous peine de problèmes de synchronisation. DataSync propose deux modes d'authentification : Basic et OAuth 2.0. Pour OAuth 2.0, une application connectée doit également être enregistrée dans Acumatica pour générer les identifiants nécessaires à la connexion. Il est conseillé de garder Acumatica et DataSync ouverts côte à côte pendant ces étapes.

La configuration recommandée consiste à créer deux connexions source par locataire : une connexion avec actualisation, qui utilise le suivi par date pour les chargements incrémentiels basés sur le champ LastModifiedDate, et une connexion sans actualisation pour les tables sans champ de suivi, généralement des tables de référence de petite taille. Pour une première configuration d'Acumatica, le guide d'installation Acumatica détaille la création des deux connexions dans le cadre de la configuration complète.

remarque

Le projet de personnalisation Nectari doit être importé et publié dans Acumatica avant de configurer la connexion.

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

Étape 1 : configurer Acumatica

Les noms d'éléments affichés dans Acumatica peuvent varier selon la configuration de votre instance (par exemple, le pack de langue français-canadien) et selon les préférences de chaque utilisateur. Les termes anglais ci-dessous sont fournis à titre de référence, au cas où votre interface s'afficherait en anglais.

Vérifier les locataires

1. Connectez-vous à Acumatica.
2. Dans le menu principal, sélectionnez System Management (Gestion du système). Sinon, More Items (Plus d'éléments).
3. Sous System Maintenance (Maintenance du système), sélectionnez Tenants (Locataires) pour voir tous les locataires enregistrés dans l'instance.

Confirmer le fuseau horaire

1. Sélectionnez l'icône de profil dans le coin supérieur droit.
2. Cliquez sur My Profile (Mon profil).
3. Dans General Info (Informations générales), notez le fuseau horaire.

Créer l'ID client et le secret client

Les étapes suivantes s'appliquent uniquement aux configurations OAuth 2.0. Pour l'authentification Basic, passez directement à l'Étape 2.

1. Dans Acumatica, sélectionnez Integration (Intégration). Sinon, More Items (Plus d'éléments).
2. Sous Preferences (Préférences), sélectionnez Connected Applications (Applications connectées).
3. Cliquez sur l'icône + pour ajouter un nouvel enregistrement.
4. Dans Client Name (Nom du client), saisissez OAuth ou un autre nom unique.
5. Dans Flow (Flux), sélectionnez Authorization Code (Code d'autorisation).
6. Cliquez sur Save (Enregistrer). L'ID Client (Client ID) est généré automatiquement.
7. Ouvrez l'onglet Secrets et cliquez sur Add Shared Secret (Ajouter Secret partagé).
8. Saisissez une description.
9. Copiez la valeur dans Value (Valeur) et conservez-la en lieu sûr.
10. Cliquez sur OK.

Étape 2 : créer la connexion source dans DataSync

Configurer la connexion

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 Acumatica.
5. Complétez toutes les propriétés de connexion requises.
6. Copiez l'URL de rappel depuis le panneau Propriétés de la connexion.

Ajouter l'URL de rappel dans Acumatica

1. Dans Acumatica, sélectionnez Integration (Intégration) .Sinon, cliquez sur More Items (Plus d'éléments).
2. Sous Preferences (Préférences), sélectionnez Connected Applications (Applications connectées).
3. Dans Client ID (ID Client), sélectionnez l'application connectée créée précédemment.
4. Ouvrez l'onglet Redirect URIs (URIs de redirection).
5. Cliquez sur l'icône + pour ajouter une ligne.
6. Collez l'URL dans la nouvelle ligne.
7. Cliquez sur Save (Enregistrer).

Authentifier et autoriser

1. (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.
2. Configurez les paramètres avancés selon votre environnement, notamment le Type de suivi.
3. Cliquez sur Enregistrer.

Propriétés de la connexion

important

OAuth 2.0 est le mode d'authentification recommandé pour toute nouvelle connexion, puisqu'Acumatica abandonne progressivement l'authentification de base (en anglais seulement).

Basic

Basic

Propriété	Description
Description	Nom unique attribué à la connexion, par exemple Acumatica Basic avec actualisation.
URL	Adresse de l'instance Acumatica, par exemple http://votre-serveur/Odata/nom%20du%20locataire. Remplacez votre-serveur par le serveur qui héberge Acumatica et nom%20du%20locataire par le nom du locataire. Gardez %20 pour les espaces, comme dans le navigateur.
Mode d'authentification	Basic.
Nom d'utilisateur	Identifiant de connexion disposant des permissions API requises.
Mot de passe	Mot de passe associé à ce compte.
Convertir toutes les dates et heures en GMT	Convertit en GMT toutes les valeurs DateTime. Recommandé lorsque l'environnement Acumatica s'exécute dans un fuseau horaire différent et que des horodatages cohérents sont nécessaires.
Pagination côté client	Active la pagination côté client pour les grands volumes de données. Lorsqu'activée, les données sont récupérées par pages plutôt qu'en une seule fois.
Taille de page	Nombre maximum de résultats retournés par page lorsque la pagination côté client est activée. Des valeurs plus élevées retournent davantage de lignes par page mais augmentent le risque d'expiration.
Délai	Durée en secondes avant l'expiration d'une tentative de connexion ou d'une exécution de requête.
Format des données	Format des données récupérées : ATOM ou JSON.
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.

OAuth 2.0

OAuth 2.0

Propriété	Description
Description	Nom unique attribué à la connexion, par exemple Acumatica OAuth avec actualisation.
URL	Adresse de l'instance Acumatica, par exemple http://votre-serveur/Acumatica20XXRX/t/nomlocataire/api/odata/gi. Remplacez votre-serveur par le serveur qui héberge Acumatica, Acumatica20XXRX par le nom de l'instance et nomlocataire par le nom du locataire. Gardez %20 pour les espaces, comme dans le navigateur.
Mode d'authentification	OAuth2.
URL de rappel	URL de redirection générée automatiquement par DataSync, à ajouter à l'application connectée dans Acumatica.
ID client	Identifiant attribué lors de l'enregistrement de l'application connectée, par exemple 9986313F-C5E6-161F-ED75-346CBBCB948F@Company.
Secret client	Secret attribué à l'application connectée, par exemple ZIRz91x0ZSn_bunidUlZsB.
URL d'autorisation	URL qui sert à obtenir le code d'autorisation, obtenue en ajoutant identity/connect/authorize à l'URL de base Acumatica, par exemple https://company.acumatica.com/ODataV4/identity/connect/authorize.
URL du jeton d'accès	URL qui échange le code d'autorisation contre un jeton d'accès, obtenue en ajoutant identity/connect/token à l'URL de base Acumatica, par exemple https://company.acumatica.com/ODataV4/identity/connect/token.
Privilèges d'accès	Autorisations demandées à Acumatica, avec openid, api et offline_access par défaut.
Convertir toutes les dates et heures en GMT	Convertit en GMT toutes les valeurs DateTime. Recommandé lorsque l'environnement Acumatica s'exécute dans un fuseau horaire différent et que des horodatages cohérents sont nécessaires.
Pagination côté client	Active la pagination côté client pour les grands volumes de données. Lorsqu'activée, les données sont récupérées par pages plutôt qu'en une seule fois.
Taille de page	Nombre maximum de résultats retournés par page lorsque la pagination côté client est activée. Des valeurs plus élevées retournent davantage de lignes par page mais augmentent le risque d'expiration.
Délai	Durée en secondes avant l'expiration d'une tentative de connexion ou d'une exécution de requête.
Format des données	Format des données récupérées : ATOM ou JSON.
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

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
Propriété	Propriété de la chaîne de connexion définissant l'action ou le comportement. Exemple : ReadOnly.
Valeur	Valeur associée à la propriété. Exemple : True.
Type	Visibilité de la valeur : Visible ou Crypté.

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 Acumatica 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 Acumatica.
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.