Ekstra felter på artikler
Exact Online giver brugere mulighed for at definere ekstra felter på artikler. De ekstra felter kan f.eks. indeholde en tekst eller en værdi fra en liste. Strukturen for de ekstra felter angives pr. administration i Exact Online som stamdata. Mere information om disse ekstra artikelfelter finder du på Oproepen van Extra Velden in de Power BI connector - 2 van forums.
Udlæsning via REST API
Udlæsning af værdierne for de ekstra felter kan ske via tabellerne baseret på Exact Online REST API’erne, såsom ItemExtraFieldValues. Oprindeligt var det kun muligt at udlæse indholdet af ekstra felter pr. artikel, men nu kan dette også ske for flere artikler på én gang, hvilket forbedrer hastigheden. API’et for felterne udmærker sig ikke ved stabilitet; afsæt derfor lidt ekstra tid til at opbygge integrationer.
Indlæsning via XML API
Indlæsning af data i de fri felter kan udelukkende ske via Exact Online XML API. Dette forklares ved hjælp af følgende instruktioner.
Du kan importere værdierne via view’et UploadXMLTopics. Ved en insert på dette view bliver XML’en opdelt i logisk korrekte stykker, så XML’en ikke overskrider begrænsningerne for XML API’et. Dataene importeres derefter til en eller flere administrationer.
Det er derfor også muligt at indlæse ekstra produktinformation til flere administrationer samtidig i én import. De frie felters definitioner skal dog være ens i hver Exact-administration.
Opbygning af XML til Exact
Det første trin i at importere værdier er at opbygge XML’en i henhold til specifikationerne. Forespørgslen nedenfor udvælger først to administrationer og opretter derefter en in-memory-tabel med to rækker: én pr. Exact Online-administration (“division”).
For hver administration angives en værdi for det første ekstra felt for hver artikel. Dette ekstra felt skal hedde “KOPIE OMSCHRIJVING”. Værdien bliver synkroniseret med produktets beskrivelse.
listagg-gruppefunktionen i den indre forespørgsel sørger for, at XML’en for hver artikel sættes sammen i en lang tekst uden skilletegn. Den ydre forespørgsel tager alle data pr. administration og tilføjer den obligatoriske hoved- og fodsektion i XML. Via funktionen xmlformat kontrolleres XML’en først for gyldighed og omdannes derefter til et mere letlæseligt format med tilstrækkelige linjeskift og indrykning.
--
-- 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
)
Automatisk indlæsning af XML
Indholdet af indlæsningstabellen kan derefter importeres til Exact Online med følgende SQL. Denne SQL opdeler XML’en i stykker på 25.000 tegn og indlæser dem i Exact Online. Dette går forbløffende hurtigt; XML API’et er stadig langt det hurtigste alternativ til masseindlæsning og/eller opdatering af data i Exact Online: ikke kun for artikler. Se for mere baggrundsinformation om ydeevnen på Exact Online f.eks. 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
insert’en på UploadXMLTopics lykkes altid. Eventuelle fejl kan kontrolleres umiddelbart efter indlæsningen i UploadXMLTopicFragments. Dette view indeholder også en kolonne med kun de afviste mutationer. Efter korrektion kan disse enten indlæses manuelt via “Import/Export” i Exact Online-webgrænsefladen eller sendes igen via UploadXMLTopics.