Campos adicionales en Artículos
Exact Online permite a los usuarios definir campos adicionales en los artículos. Los campos adicionales pueden contener, por ejemplo, un texto o un valor de una lista. La estructura de los campos adicionales se configura por administración en Exact Online como datos maestros. Encontrarás más información sobre estos campos adicionales de artículo en Oproepen van Extra Velden in de Power BI connector - 2 van forums.
Lectura mediante REST API
La lectura de los valores de los campos adicionales se puede hacer a través de las tablas basadas en las API REST de Exact Online, como ItemExtraFieldValues. Originalmente solo era posible leer el contenido de los campos adicionales por artículo, pero ahora también es posible hacerlo para varios artículos a la vez, lo que mejora la velocidad. La API para estos campos no destaca por su estabilidad; por lo tanto, reserva algo más de tiempo para crear las integraciones.
Carga mediante XML API
La carga de datos en los campos libres solo puede realizarse mediante la Exact Online XML API. Esto se explica a continuación mediante las siguientes instrucciones.
Los valores se pueden importar a través de la vista UploadXMLTopics. Al realizar un insert en esta vista, el XML se divide en fragmentos lógicamente correctos para que no supere las limitaciones de la XML API. Los datos se importan después en una o varias administraciones.
Por lo tanto, también es posible cargar varias administraciones a la vez con una sola importación con información adicional de productos. Sin embargo, las definiciones de los campos libres deben ser iguales en cada administración de Exact.
Composición del XML para Exact
El primer paso para importar valores es componer el XML según las especificaciones. La siguiente consulta primero selecciona dos administraciones y luego crea una tabla en memoria con dos filas: una por cada administración de Exact Online (“division”).
Por administración, se indica un valor para el primer campo adicional de cada artículo. Ese campo adicional debe llamarse “KOPIE OMSCHRIJVING”. El valor se igualará a la descripción del producto.
La función de agrupación listagg en la consulta interna hace que el XML de cada artículo se coloque uno detrás de otro en un texto largo, sin caracteres de separación. La consulta externa toma todos los datos por administración y les añade el encabezado y pie obligatorios en XML. Mediante la función xmlformat, el XML se valida primero y luego se convierte a un formato más legible, con suficientes saltos de línea y sangría.
--
-- 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
)
Carga automática del XML
El contenido de la tabla de carga puede importarse después en Exact Online con el siguiente SQL. Este SQL divide el XML en fragmentos de 25.000 caracteres y los carga en Exact Online. Esto es sorprendentemente rápido; la XML API sigue siendo, con diferencia, la alternativa más rápida para cargar y/o actualizar datos de forma masiva en Exact Online: no solo para artículos. Para más información de contexto sobre el rendimiento en Exact Online, consulta, por ejemplo, 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
El insert en UploadXMLTopics siempre tiene éxito. Los posibles errores pueden comprobarse inmediatamente después de la carga en UploadXMLTopicFragments. Esta vista también contiene una columna solo con las mutaciones rechazadas. Tras corregirlas, estas pueden volver a cargarse manualmente a través de “Import/Export” en la interfaz web de Exact Online, o bien enviarse de nuevo mediante UploadXMLTopics.