Zusätzliche Felder von Exact Online-Artikeln einlesen

Zusatzfelder bei Artikeln

Exact Online ermöglicht es Benutzern, Zusatzfelder für Artikel zu definieren. Die Zusatzfelder können beispielsweise einen Text oder einen Wert aus einer Liste enthalten. Die Struktur der Zusatzfelder wird pro Mandant in Exact Online als Stammdaten eingerichtet. Weitere Informationen zu diesen zusätzlichen Artikelfeldern findest du unter Oproepen van Extra Velden in de Power BI connector - 2 van forums.

Auslesen über REST-API

Das Auslesen der Werte der Zusatzfelder kann über die Tabellen auf Basis der Exact Online REST-APIs erfolgen, wie zum Beispiel ItemExtraFieldValues. Ursprünglich war es nur möglich, den Inhalt der Zusatzfelder pro Artikel auszulesen, aber jetzt geht das auch für mehrere Artikel gleichzeitig, was die Geschwindigkeit verbessert. Die API für die Felder glänzt nicht gerade durch Stabilität; plane daher etwas mehr Zeit für die Erstellung von Schnittstellen ein.

Einlesen über XML-API

Das Einlesen von Daten in die freien Felder ist ausschließlich über die Exact Online XML-API möglich. Anhand der folgenden Anweisungen wird dies erklärt.

Die Werte kannst du über die UploadXMLTopics-View importieren. Bei einem insert auf diese View wird das XML in logisch korrekte Teile zerlegt, sodass das XML die Beschränkungen der XML-API nicht überschreitet. Die Daten werden anschließend in einen oder mehrere Mandanten importiert.

Es ist also auch möglich, mit einem Import mehrere Mandanten gleichzeitig mit zusätzlichen Produktinformationen zu laden. Allerdings müssen dann die Definitionen der freien Felder in jedem Exact-Mandanten identisch sein.

Zusammenstellen von XML für Exact

Der erste Schritt zum Importieren von Werten ist das Zusammenstellen des XML gemäß den Spezifikationen. Die untenstehende Abfrage wählt zunächst zwei Mandanten aus und erstellt anschließend eine In-Memory-Tabelle mit zwei Zeilen: eine pro Exact Online Mandant (“division”).

Pro Mandant wird für jeden Artikel ein Wert für das erste Zusatzfeld angegeben. Dieses Zusatzfeld muss “KOPIE OMSCHRIJVING” heißen. Der Wert wird mit der Beschreibung des Produkts gleichgesetzt.

Die listagg-Gruppenfunktion in der inneren Abfrage sorgt dafür, dass das XML jedes Artikels hintereinander zu einem langen Text zusammengefügt wird, ohne Trennzeichen. Die äußere Abfrage nimmt alle Daten pro Mandant und fügt den erforderlichen Kopf und Fuß in XML hinzu. Über die xmlformat-Funktion wird das XML zunächst auf Gültigkeit geprüft und anschließend in ein besser lesbares Format mit ausreichend Zeilenumbrüchen und Einrückung umgewandelt.

--
-- 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
)

Automatisches Einlesen von XML

Der Inhalt der Ladetabelle kann anschließend mit folgendem SQL in Exact Online importiert werden. Dieses SQL zerlegt das XML in Teile von 25.000 Zeichen und lädt sie in Exact Online. Das geht erstaunlich schnell; die XML-API ist nach wie vor bei weitem die schnellste Alternative für das massenhafte Laden und/oder Aktualisieren von Daten in Exact Online: nicht nur für Artikel. Weitere Hintergrundinformationen zur Performance von Exact Online findest du zum Beispiel unter 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

Der insert auf UploadXMLTopics gelingt immer. Eventuelle Fehler können sofort nach dem Laden in UploadXMLTopicFragments überprüft werden. Diese View enthält auch eine Spalte mit ausschließlich den abgelehnten Mutationen. Nach der Korrektur können diese entweder manuell über “Import/Export” in der Exact Online Weboberfläche eingelesen oder erneut über UploadXMLTopics eingereicht werden.