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 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 cela n'est pas visible, cliquez sur Plus d'éléments pour afficher des options supplémentaires.
2. Sous Préférences, sélectionnez Applications connectées.
3. Cliquez sur l'icône + pour ajouter un nouvel enregistrement.
4. Dans Nom du client, entrez OAuth ou un autre nom unique.
5. Dans Flux, sélectionnez Code d'autorisation dans la liste déroulante.
6. Cliquez sur Enregistrer. L'ID Client est généré automatiquement.
7. Sélectionnez l'onglet Secrets et cliquez sur Ajouter Secret partagé.
8. Entrez une description.
9. Dans Valeur, veillez à copier le secret et à le stocker en toute sécurité. Vous ne pourrez pas le voir à nouveau après l'avoir sauvegardé.
10. Cliquez sur Ok lorsque vous avez terminé.

Ajouter l'URL de rappel dans Acumatica (OAuth)

1. Dans Acumatica, sélectionnez Intégration. Si cela n'est pas visible, cliquez sur Plus d'éléments pour afficher des options supplémentaires.
2. Sous Préférences, sélectionnez Applications connectées.
3. Dans ID Client, sélectionnez l'application connectée que vous avez créée précédemment.
4. Sélectionnez 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 la connexion. Exemple : Rafraîchissement Acumatica
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

Propriétés de chaîne de connexion supplémentaires non spécifiées dans le panneau Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Crypé. Sélectionner Crypé cache la valeur de l'interface et la stocke cryptée dans l'arrière-plan, comme lors de la définition des mots de passe.

Paramètre	Description
Propriété	Propriété de chaîne de connexion qui définit l'action ou le comportement. Exemple : LectureSeule
Valeur	Valeur pour la propriété. Exemple : Vrai
Type	Visibilité de la propriété : Visible ou Crypé.

Paramètres avancés

Les paramètres avancés contrôlent la façon dont le connecteur Acumatica suit les changements, gère la configuration régionale et horaire, et traite les lots de données lors de l'extraction. Ces options permettent un réglage fin des performances et de l'exactitude, et doivent être configurées en fonction de votre environnement système et de vos exigences opérationnelles.

Paramètre	Description
Type de suivi	Méthode de suivi des changements : Aucun ou Date.
Région	Paramètre de région pour le connecteur, si nécessaire pour votre configuration.
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 de rafraîchissement en secondes pour compenser les problèmes de minutage lors de la sélection des enregistrements. La valeur minimale est 0; le maximum est de 3600 secondes.
Taille de lot	Quantité 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 en fonction de la vitesse de votre réseau et des performances de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.

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.