Dit onderwerp legt uit hoe je afbeeldingen in bulk kunt kopiëren tussen Exact Online-artikelen. Het hangt samen met het onderwerp over het exporteren van afbeeldingen die aan Exact Online-artikelen zijn gekoppeld naar afzonderlijke bestanden op schijf, maar deze code slaat de afbeeldingen op bij een ander artikel.
Elk artikel heeft één hoofdafbeelding, die wordt weergegeven op de pagina Artikelen, bijvoorbeeld:
Je kunt ook meerdere afbeeldingen koppelen als documenten. Geef hiervoor gewoon het bijbehorende artikel op als “Item” bij het document.
De Exact Online REST heeft geen bekende methode om afbeeldingen voor artikelen te importeren. De Exact Online REST API’s voor artikelen (Items, ItemsBulk en ItemsIncremental) tonen (alleen-lezen) thumbnailinformatie zoals de URL op Exact Online, de bestandsnaam en het inhoudstype. De Exact Online XML API biedt de XML-tag <Image> om een afbeelding aan een artikel te koppelen.
De volgende code voert de volgende stappen uit:
- Selecteer een reeks bronartikelen (op de Exact Online API
Itemsgenoemd) met een afbeelding. - Bepaal naar welke doelartikelen zonder afbeelding een afbeelding moet worden weergegeven.
- Haal de afbeeldingen op met behulp van de tabelfunctie
ThumbnailByUrl. - Stel een grote XML-upload samen voor alle artikelen die moeten worden bijgewerkt.
- Upload de afbeeldingen in één grote upload met behulp van
UploadXMLTopics. UploadXMLTopicssplitst de payload indien nodig in fragmenten om binnen de snelheids- en groottelimieten van de Exact Online API te blijven.
De typische doorlooptijd voor het uploaden van kleine tot middelgrote afbeeldingen naar Exact Online is 5 afbeeldingen per seconde.
--
-- Afbeeldingen uploaden waar ontbrekend.
--
create or replace table xmlupload@inmemorystorage
as
select 'item-pictures.xml' filename
, to_char(t.division) division
, 'Items' topic
, xmlformat
( '<?xml version="1.0" encoding="utf-8"?>'
|| '<eExact xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="eExact-XML.xsd">'
|| '<Items>'
|| t.xml
|| '</Items>'
|| '</eExact>'
)
filecontents
from ( select itmorig.division
, listagg
( '<Item ID="{' || itmvar.id || '}" code="' || itmvar.code || '" >'
|| '<Image>'
|| xmlelement
( 'Name'
, itmorig.code
|| '.'
|| case
when tnlorig.ImageContentType = 'image/jpeg'
then 'jpg'
else 'bin'
end
)
|| '<BinaryData>' || base64_encode(tnlorig.imagecontents) || '</BinaryData>'
|| '</Image>'
|| '</Item>'
, ''
) xml
from ItemsBulk itmorig
join ThumbnailByUrl(itmorig.pictureurl) tnlorig
join ItemsBulk itmvar
on itmvar.division = itmorig.division
--
-- Gerelateerd artikel zoeken.
--
and itmvar.code like itmorig.code || '_%'
--
-- Doelitem heeft nog geen afbeelding.
--
and itmvar.PictureName is null
--
-- Bronartikel heeft een afbeelding.
--
where itmorig.PictureName is not null
--
-- Pas een filter toe om de bron te vinden.
--
and itmorig.code = 'MYSOURCEARTICLE'
group
by itmorig.division
) t
Vervolgens wordt de grote XML geüpload, automatisch opgesplitst door de ingebouwde logica van UploadXMLTopics in fragmenten van ongeveer 1 MB:
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
--
-- Probeer op te splitsen in stukken van maximaal 1 MB.
--
, true fragment_payload_flag
, 1000000 fragment_max_size_characters
, true fail_on_error
from xmlupload@inmemorystorage
order
by division
, filename
Tot slot controleren we het resultaat (alleen nodig wanneer fail_on_error false is):
--
-- Controleer of alles correct is geladen in Exact Online.
-- Er mag GEEN rij zijn met success = false.
--
select *
from UploadXMLTopicFragments
