Connecteur source Acumatica

Le connecteur source Acumatica dans DataSync vous permet de récupérer des données d'un ou plusieurs locataires Acumatica (entreprises) pour synchronisation ou consolidation dans votre destination. Dans Acumatica, les locataires représentent des entreprises individuelles, et vous devez avoir au moins un locataire (tenant) pour procéder.

Pour des résultats optimaux, il est recommandé de créer deux connexions source par locataire : une connexion de rafraîchissement, qui utilise le suivi des dates pour les chargements incrémentaux basés sur le champ LastModifiedDate, et une connexion sans rafraîchissement, utilisée pour les tables sans champ de suivi, généralement de plus petites tables de référence. Un modèle de Connexions Source Acumatica préconstruit est disponible pour une configuration rapide des connexions requises.

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

Vérifier les détails dans Acumatica

Avant de créer des connexions source dans DataSync, assurez-vous que votre environnement Acumatica est correctement configuré. Cela inclut la vérification des locataires enregistrés dans votre instance et la confirmation du fuseau horaire, qui doit correspondre au fuseau horaire spécifié dans DataSync pour éviter des problèmes de synchronisation.

Examiner les locataires

1. Connectez-vous à Acumatica.
2. Dans le menu principal, sélectionnez Gestion du système. Si cela n'est pas visible, cliquez sur Plus d'éléments pour afficher des options supplémentaires.
3. Sous Maintenance du système, sélectionnez Locataires.
   La liste des locataires apparaît, vous permettant de confirmer combien sont actuellement enregistrés dans votre instance Acumatica.

Confirmer le fuseau horaire

1. Dans le menu principal, cliquez sur l'icône de profil dans le coin supérieur droit.
2. Cliquez sur Mon profil dans la liste déroulante.
3. Dans Informations générales, notez le fuseau horaire. Cela doit correspondre au fuseau horaire dans DataSync.

Créer l'ID client et le secret client (OAuth)

1. Dans Acumatica, sélectionnez Intégration. Si cette option n'est pas visible, sélectionnez Plus d'éléments pour afficher la liste complète.
2. Sous Préférences, sélectionnez Applications connectées.
3. Cliquez sur l'icône + pour ajouter un nouvel enregistrement.
4. Dans le champ Nom du client, saisissez OAuth ou un autre nom unique.
5. Dans le champ Flux, sélectionnez Code d'autorisation.
6. Cliquez sur Enregistrer. L'ID Client est généré automatiquement.
7. Ouvrez l'onglet Secrets et sélectionnez Ajouter Secret partagé.
8. Saisissez une description pour ce secret.
9. Copiez la valeur affichée dans le champ Valeur et conservez-la dans un emplacement sécurisé. Elle ne sera plus accessible après l'enregistrement.
10. Cliquez sur Ok.

Ajouter l'URL de rappel dans Acumatica (OAuth)

1. Dans Acumatica, sélectionnez Intégration. Si cette option n'est pas visible, sélectionnez Plus d'éléments pour afficher la liste complète.
2. Sous Préférences, sélectionnez Applications connectées.
3. Dans le champ ID Client, sélectionnez l'application connectée que vous avez créée.
4. Ouvrez l'onglet URIs de redirection.
5. Cliquez sur l'icône + pour ajouter une ligne.
6. Dans DataSync, copiez l'URL de rappel complète depuis le panneau de connexion.
7. Collez l'URL dans la nouvelle ligne dans Acumatica.
8. Cliquez sur Enregistrer.

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 de la source, cliquez sur Nouveau.
4. Sélectionnez Acumatica.
5. Dans le panneau Propriétés de connexion, sélectionnez un mode d'authentification : Basique ou OAuth2.
6. Entrez les propriétés de connexion requises.
7. (Optionnel) Dans le panneau Autres propriétés de la connexion, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
8. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos besoins.
9. Cliquez sur Enregistrer.

Propriétés de la connexion

Paramètre	Description
Description	Nom unique pour cette connexion. Par exemple : Acumatica Refresh
URL	URL de l'instance Acumatica. Gardez %20 pour les espaces comme montré dans votre navigateur. Exemple : https://company.acumatica.com/ODataV4/InstanceName
Mode d'authentification	Méthode d'authentification utilisée par le connecteur : Basic ou OAuth2.
Nom d'utilisateur	Nom d'utilisateur Acumatica avec les autorisations API requises (authentification basique uniquement).
Mot de passe	Mot de passe pour le nom d'utilisateur spécifié (authentification basique uniquement).
URL de rappel	URL de redirection automatiquement générée par DataSync. Doit être ajoutée à l'application connectée dans Acumatica (seulement pour OAuth2).
Identité du client	Identifiant attribué lors de l'enregistrement de l'application connectée (OAuth2 seulement). Exemple : 9986313F-C5E6-161F-ED75-346CBBCB948F@Company
Secret du client	Secret attribué à l'application connectée (OAuth2 seulement). Exemple : ZIRz91x0ZSn_bunidUlZsB
URL d'autorisation	URL utilisée pour obtenir le code d'autorisation. Ajoutez identity/connect/authorize à votre URL de base Acumatica (OAuth2 seulement). Exemple : https://company.acumatica.com/ODataV4/identity/connect/authorize
URL du jeton d'accès	URL utilisée pour échanger le code d'autorisation contre un token d'accès. Ajoutez identity/connect/token à votre URL de base Acumatica (OAuth2 seulement). Exemple : https://company.acumatica.com/ODataV4/identity/connect/token
Privilèges d'accès	Autorisations demandées à Acumatica (OAuth2 seulement). Par défaut : openid, api, offline_access.
Convertir toutes les dates et heures en GMT	Conversion des valeurs DateTime OData en GMT.
Use client-side paging	Capacité de pagination pour de grands ensembles de données.
Taille de page	Résultats maximum à retourner par page lorsque la pagination côté client est activée. Des valeurs plus grandes renvoient plus de lignes par page mais peuvent provoquer des délais d'attente.
Délai	Temps en secondes à attendre pour l'ouverture de la connexion et l'exécution de la requête avant délai d'attente.
Format des données	Format des données récupérées : ATOM ou JSON.
Verbosité	1 – Journaliser les requêtes, les comptes 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 les communications au niveau du transport. 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Activer la mise en Pool	Option de mise en commun des connexions pour de meilleures performances.
Délai d'inactivité du Pool	Temps d'inactivité maximum pour les connexions avant de les retourner au pool, en secondes.
Taille maximum du Pool	Nombre maximum de connexions autorisées dans le pool.
Temps d'attente du Pool	Temps d'attente maximum pour l'allocation de connexion avant qu'une erreur ne soit générée, en secondes.

Autres propriétés de la connexion

Ce panneau permet d'ajouter des propriétés de connexion qui ne sont pas disponibles dans le panneau principal. Pour chaque propriété, choisissez Visible ou Crypé. Utilisez Crypé pour les mots de passe et autres valeurs sensibles.

Paramètre	Description
Propriété	Nom de la propriété de connexion. Par exemple : ReadOnly
Valeur	Valeur associée. Par exemple : True
Type	Sélectionnez Visible ou Crypé.

Paramètres avancés

Ces paramètres contrôlent le suivi des modifications, la gestion du temps et le traitement des données lors de l'extraction. Adaptez-les à votre installation pour obtenir des résultats fiables.

Paramètre	Description
Type de suivi	Méthode de détection des modifications. Sélectionnez Aucun ou Date.
Région	Région du connecteur, si votre installation le demande.
Fuseau horaire	Fuseau horaire correspondant au serveur d'applications Acumatica. Cela doit être identique au fuseau horaire du profil dans Acumatica pour éviter les incohérences de données.
Décalage horaire	Décalage en secondes pour corriger les écarts de timing. Valeur minimale : 0. Valeur maximale : 3600 secondes.
Taille de lot	Nombre d'enregistrements traités par lot. Une valeur plus élevée peut améliorer les performances, mais utilise plus de mémoire. Par défaut : 2000. Maximum : 10000. Ajustez selon votre connexion réseau et les performances de votre disque.

remarque

Pour Acumatica, vous devez importer et publier le projet de personnalisation SEI dans Acumatica. Voir Télécharger le projet dans Acumatica pour plus de détails.