Importazione di campi aggiuntivi degli articoli di Exact Online

Campi aggiuntivi sugli Articoli

Exact Online consente agli utenti di definire campi aggiuntivi sugli articoli. I campi aggiuntivi possono contenere, ad esempio, un testo o un valore tratto da un elenco. La struttura dei campi aggiuntivi viene impostata per amministrazione in Exact Online come dati anagrafici. Maggiori informazioni su questi campi articolo aggiuntivi sono disponibili su Oproepen van Extra Velden in de Power BI connector - 2 van forums.

Lettura tramite REST API

La lettura dei valori dei campi aggiuntivi è possibile tramite le tabelle basate sulle API REST di Exact Online, come ItemExtraFieldValues. In origine era possibile leggere il contenuto dei campi aggiuntivi solo per singolo articolo, ma ora è possibile farlo anche per più articoli contemporaneamente, il che migliora la velocità. L’API per questi campi non brilla per stabilità; riserva quindi un po’ più di tempo per realizzare le integrazioni.

Importazione tramite XML API

L’importazione dei dati nei campi liberi è possibile esclusivamente tramite la XML API di Exact Online. Le istruzioni seguenti lo spiegano.

I valori possono essere importati tramite la view UploadXMLTopics. Con un insert su questa view, l’XML viene suddiviso in blocchi logicamente corretti in modo che l’XML non superi i limiti della XML API. I dati vengono quindi importati in una o più amministrazioni.

È quindi anche possibile caricare con un’unica importazione informazioni aggiuntive sui prodotti in più amministrazioni contemporaneamente. Tuttavia, in tal caso le definizioni dei campi liberi devono essere identiche in ogni amministrazione Exact.

Creazione dell’XML per Exact

Il primo passo per importare i valori è la creazione dell’XML secondo le specifiche. La query seguente seleziona innanzitutto due amministrazioni e crea poi una tabella in-memory con due righe: una per ciascuna amministrazione Exact Online (“division”).

Per ogni amministrazione viene indicato un valore per il primo campo aggiuntivo per ciascun articolo. Quel campo aggiuntivo deve chiamarsi “KOPIE OMSCHRIJVING”. Il valore verrà allineato alla descrizione del prodotto.

La funzione di aggregazione listagg nella query interna fa sì che l’XML di ogni articolo venga concatenato in un unico testo lungo, senza caratteri di separazione. La query esterna prende tutti i dati per amministrazione e vi aggiunge l’intestazione e il piè di pagina XML obbligatori. Tramite la funzione xmlformat l’XML viene prima verificato per la validità e poi convertito in un formato più facilmente leggibile, con sufficienti interruzioni di riga e indentazione.

--
-- Seleziona due amministrazioni Exact Online.
--
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
)

Importazione automatica dell’XML

Il contenuto della tabella di caricamento può quindi essere importato in Exact Online con il seguente SQL. Questo SQL suddivide l’XML in blocchi di 25.000 caratteri e li carica in Exact Online. Questo avviene a una velocità sorprendente; la XML API rimane di gran lunga l’alternativa più veloce per il caricamento e/o l’aggiornamento massivo dei dati in Exact Online: non solo per gli articoli. Per maggiori informazioni di base sulle prestazioni di Exact Online, vedi ad esempio Does Invantive UniversalSQL match the speed of Infinite Probability Drive?.

--
-- Carica in Exact Online. Gli errori vengono registrati 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
--
-- Prova a suddividere in blocchi di massimo 25 KB.
--
,      true fragment_payload_flag
,      25000 fragment_max_size_characters 
,      true fail_on_error
from   xmlupload@inmemorystorage
order 
by     division
,      filename

--
-- Verifica che tutto sia stato caricato correttamente in Exact Online.
-- Non deve esserci NESSUNA riga con success = false.
--
select *
from   UploadXMLTopicFragments

L’insert su UploadXMLTopics ha sempre esito positivo. Eventuali errori possono essere controllati subito dopo il caricamento in UploadXMLTopicFragments. Questa view contiene anche una colonna con solo le mutazioni rifiutate. Dopo la correzione, queste possono essere importate manualmente tramite “Import/Export” nell’interfaccia web di Exact Online, oppure riproposte nuovamente tramite UploadXMLTopics.