Importation de champs supplémentaires des articles Exact Online

Champs supplémentaires sur les articles

Exact Online permet aux utilisateurs de définir des champs supplémentaires sur les articles. Ces champs supplémentaires peuvent par exemple contenir un texte ou une valeur issue d’une liste. La structure des champs supplémentaires est configurée par administration dans Exact Online en tant que données de base. Plus d’informations sur ces champs d’articles supplémentaires se trouvent sur Oproepen van Extra Velden in de Power BI connector - 2 van forums.

Lecture via l’API REST

La lecture des valeurs des champs supplémentaires peut se faire via les tables basées sur les API REST d’Exact Online telles que ItemExtraFieldValues. À l’origine, il n’était possible de lire le contenu des champs supplémentaires que par article, mais désormais cela est également possible pour plusieurs articles simultanément, ce qui améliore la vitesse. L’API pour ces champs ne brille pas par sa stabilité ; prévoyez donc un peu plus de temps pour réaliser les intégrations.

Importation via l’API XML

L’importation de données dans les champs libres peut se faire uniquement via l’API XML d’Exact Online. Les instructions suivantes expliquent comment procéder.

Vous pouvez importer les valeurs via la vue UploadXMLTopics. Lors d’un insert sur cette vue, le XML est découpé en segments logiquement cohérents de sorte que le XML ne dépasse pas les limites de l’API XML. Les données sont ensuite importées dans une ou plusieurs administrations.

Il est donc également possible de charger simultanément plusieurs administrations avec des informations produit supplémentaires lors d’une même importation. Toutefois, les définitions des champs libres doivent alors être identiques dans chaque administration Exact.

Composition du XML pour Exact

La première étape pour importer des valeurs consiste à composer le XML selon les spécifications. La requête ci-dessous sélectionne d’abord deux administrations, puis crée une table en mémoire avec deux lignes : une par administration Exact Online (« division »).

Par administration, une valeur est indiquée pour le premier champ supplémentaire pour chaque article. Ce champ supplémentaire doit s’appeler « KOPIE OMSCHRIJVING ». La valeur sera alignée sur la description du produit.

La fonction de regroupement listagg dans la requête interne permet de concaténer le XML de chaque article dans un long texte, sans caractère de séparation. La requête externe prend toutes les données par administration et y ajoute l’en-tête et le pied obligatoires en XML. La fonction xmlformat vérifie d’abord la validité du XML, puis le convertit dans un format plus lisible avec des retours à la ligne et une indentation suffisants.

--
-- Selecteer two Exact Online administraties.
--
use 2123456, 2344242

create or replace table xmlupload@inmemorystorage
as
select 'voorbeeld.xml' filename
,      'Items' topic
,      to_char(division) division
,       xmlformat
       ( '<?xml version="1.0" encoding="utf-8"?>'
       || '<eExact xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="eExact-XML.xsd">'
       || xmlcomment('For division ' || division)
       || '<Items>'
       || xml
       || '</Items>'
       || '</eExact>'
       )
       filecontents
from   ( select division
         ,      listagg
                ( '<Item ID="{' || itm.id || '}" code="' || itm.code || '" >'
                  || '<ItemExtraFields>'
                  || '<ExtraField1 description="KOPIE OMSCHRIJVING">'
                  || xmlelement('Description', itm.description)
                  || '</ExtraField1>'
                  || '</Item>'
                , ''
                )
                xml
         from   itemsbulk itm
         group
         by     division
)

Importation automatique du XML

Le contenu de la table de chargement peut ensuite être importé dans Exact Online avec le SQL suivant. Ce SQL découpe le XML en segments de 25 000 caractères et les charge dans Exact Online. Cela va étonnamment vite ; l’API XML reste de loin la solution la plus rapide pour charger et/ou mettre à jour massivement des données dans Exact Online : pas seulement pour les articles. Pour plus d’informations sur les performances d’Exact Online, voir par exemple Does Invantive UniversalSQL match the speed of Infinite Probability Drive?.

--
-- Load into Exact Online. Errors are logged in UploadXMLTopicFragments.
--
insert into UploadXMLTopics
( topic
, payload
, division_code
, orig_system_reference
, fragment_payload_flag
, fragment_max_size_characters
, fail_on_error
)
select topic
,      filecontents
,      division
,      filename
--
-- Try to split into pieces of 25 KB at most.
--
,      true fragment_payload_flag
,      25000 fragment_max_size_characters 
,      true fail_on_error
from   xmlupload@inmemorystorage
order 
by     division
,      filename

--
-- Check everything was loaded correctly in Exact Online.
-- There may be NO row with success = false.
--
select *
from   UploadXMLTopicFragments

L’insert sur UploadXMLTopics réussit toujours. Les éventuelles erreurs peuvent être vérifiées immédiatement après le chargement dans UploadXMLTopicFragments. Cette vue contient également une colonne ne reprenant que les mutations rejetées. Après correction, celles-ci peuvent être soit relues manuellement via « Import/Export » dans l’interface web d’Exact Online, soit soumises à nouveau via UploadXMLTopics.