Import Intacct Entity

Description

Importe un objet Sage Intacct dans une table de projet, via votre connexion Sage Intacct, en utilisant les opérations readByQuery/readMore de la passerelle XML d’Intacct pour parcourir automatiquement tout le jeu de résultats. Choisissez la connexion, l’objet et les filtres éventuels. L’étape récupère les enregistrements correspondants et les écrit, sans pagination manuelle à gérer.

Il s’agit d’une étape générique prédéfinie : un seul type d’étape couvre sept objets, du détail des transactions et des soldes du grand livre (GLDETAIL, GLACCOUNTBALANCE, GLENTRY) aux référentiels de dimensions (LOCATION, DEPARTMENT, CLASS) et aux documents de commande (SODOCUMENT).

Note

Cette étape est distincte de Import Sage Intacct Query (étape), qui cible un objet Intacct quelconque avec un sélecteur de champs généraliste. Import Intacct Entity est l’étape du catalogue natif pour ces sept objets précisément, avec une liste autorisée de filtres sélectionnée objet par objet et une pagination readMore automatique pour les gros jeux de résultats (le détail du grand livre, en particulier, peut dépasser largement une page de l’API Intacct).

Configuration

Champ	Obligatoire	Remarques
Connexion Sage	Oui	Connexion Sage Intacct à utiliser pour la lecture.
Table cible	Oui	Table de projet dans laquelle les résultats sont écrits. Elle est entièrement écrasée à chaque exécution.
Objet	Oui	Objet Intacct à importer. Valeurs possibles : GLDETAIL, GLACCOUNTBALANCE, GLENTRY, LOCATION, DEPARTMENT, CLASS, SODOCUMENT.
Filtres	Non	Un tableau de clauses {field, operator, value}. Les opérateurs comprennent eq, ne, gt, ge, lt, le. Une plage s’exprime par deux clauses sur le même champ : une ge, une le. Chaque objet limite les filtres à sa propre liste autorisée de champs et d’opérateurs ; un champ ou une combinaison d’opérateurs non pris en charge est rejeté, et non ignoré silencieusement.

Objets et filtres de plage courants

Objet	Données importées	Filtres de plage courants
GLDETAIL	Détail des lignes de transaction du grand livre	date de comptabilisation (ge/le), montant (ge/le)
GLACCOUNTBALANCE	Soldes des comptes par période	date de fin de période (ge/le)
GLENTRY	Lignes d’écritures comptabilisées	date de comptabilisation (ge/le)
LOCATION	Référentiel de la dimension Location	aucun (filtres d’égalité uniquement)
DEPARTMENT	Référentiel de la dimension Department	aucun (filtres d’égalité uniquement)
CLASS	Référentiel de la dimension Class	aucun (filtres d’égalité uniquement)
SODOCUMENT	Documents de commande client	date du document (ge/le)

Fonctionnement de la pagination

La passerelle XML d’Intacct renvoie les résultats page par page. Cette étape émet l’appel initial readByQuery, puis enchaîne des appels readMore avec l’identifiant de jeu de résultats renvoyé par Intacct, jusqu’à ce que toutes les pages aient été lues. Une extraction GLDETAIL de plusieurs dizaines de milliers de lignes se termine donc en une seule exécution de l’étape, sans réglage de la taille de page de votre part.

Attention

Une extraction très large et sans filtre sur GLDETAIL ou GLENTRY peut tout de même prendre beaucoup de temps à parcourir en entier. Délimitez une grosse extraction par une plage de dates de comptabilisation plutôt que de compter sur la seule pagination pour l’accélérer.

Voir aussi

• Étapes Sage Intacct
• Import Sage Intacct Query (étape) : requête généraliste sur un objet Intacct quelconque
• Se connecter à Sage Intacct
• Connecteur REST Sage Intacct