Ekstra felter på artikler
Exact Online lar brukere definere ekstra felter på artikler. De ekstra feltene kan for eksempel inneholde en tekst eller en verdi fra en liste. Strukturen til de ekstra feltene settes opp per administrasjon i Exact Online som stamdata. Mer informasjon om disse ekstra artikkelfeltene finner du på Oproepen van Extra Velden in de Power BI connector - 2 van forums.
Lesing via REST API
Utlesing av verdiene til de ekstra feltene kan gjøres via tabellene basert på Exact Online REST API-ene, som ItemExtraFieldValues. Opprinnelig var det kun mulig å lese ut innholdet i ekstra felter per artikkel, men nå kan dette også gjøres for flere artikler samtidig, noe som gir bedre hastighet. API-et for feltene utmerker seg ikke ved stabilitet; sett derfor av litt ekstra tid til å lage koblinger.
Innlesing via XML API
Innlesing av data i de frie feltene kan kun gjøres via Exact Online XML API. Dette forklares ved hjelp av følgende instruksjoner.
Verdiene kan importeres via UploadXMLTopics-visningen. Ved en insert på denne visningen deles XML-en opp i logisk korrekte biter, slik at XML-en ikke overskrider begrensningene til XML API-et. Dataene importeres deretter til én eller flere administrasjoner.
Det er derfor også mulig å laste flere administrasjoner samtidig med ekstra produktinformasjon i én import. Imidlertid må definisjonene av de frie feltene da være like i hver Exact-administrasjon.
Sette sammen XML for Exact
Det første trinnet for å importere verdier er å sette sammen XML-en i henhold til spesifikasjonene. Spørringen nedenfor velger først to administrasjoner og lager deretter en in-memory-tabell med to rader: én per Exact Online-administrasjon (“division”).
Per administrasjon oppgis det en verdi for det første ekstra feltet for hver artikkel. Dette ekstra feltet må hete “KOPIE OMSCHRIJVING”. Verdien vil bli satt lik beskrivelsen av produktet.
listagg-gruppefunksjonen i den innerste spørringen sørger for at XML-en til hver artikkel settes etter hverandre i en lang tekst, uten skilletegn. Den ytterste spørringen tar alle dataene per administrasjon og legger til den obligatoriske XML-hodet og -foten. Via xmlformat-funksjonen kontrolleres XML-en først for gyldighet, og deretter konverteres den til et lettere lesbart format med tilstrekkelig linjeskift og innrykk.
--
-- 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 innlesing av XML
Innholdet i lastetabellen kan deretter importeres til Exact Online med følgende SQL. Denne SQL-en deler opp XML-en i biter på 25 000 tegn og laster dem inn i Exact Online. Dette går forbløffende raskt; XML API-et er fortsatt det raskeste alternativet for massiv lasting og/eller oppdatering av data i Exact Online: ikke bare for artikler. Se for mer bakgrunnsinformasjon om ytelsen til Exact Online for eksempel 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 alltid. Eventuelle feil kan kontrolleres umiddelbart etter innlastingen i UploadXMLTopicFragments. Denne visningen inneholder også en kolonne med kun de avviste mutasjonene. Etter korrigering kan disse enten leses inn manuelt via «Import/Export» i Exact Online-webgrensesnittet, eller sendes inn på nytt via UploadXMLTopics.