← Članci · abas i XML

abas i XML 1. dio: Arhitektura, EDP-XML sučelje i interna pravila shema

U prvom dijelu serije donosimo pregled internog XML podatkovnog modela sustava abas ERP, funkcioniranja EDP-XML sučelja, UTF-8 kodiranja te ključnih pravila sintakse i zamki u implementaciji.

U poslovanju srednjih poduzeća koja koriste sustav abas ERP, XML (Extensible Markup Language) postao je jednako važan standard razmjene podataka kao i klasični EDIFACT. Bilo da se radi o povezivanju s modernim B2B nabavnim platformama (cXML), obradi međunarodnih narudžbenica u UBL formatu ili ispunjavanju zakonskih zahtjeva za e-računima (Fiskalizacija 2.0, Peppol BIS Billing, mađarski NAV Online Számla), XML čini okosnicu modernih ERP integracija. U ovoj seriji od četiri dijela detaljno prikazujemo interne XML procese sustava abas ERP, EDP-XML sučelje, XSLT transformacije i pravila za pouzdan produkcijski rad.

Prvi dio postavlja tehničke temelje: kako abas strukturira poslovne podatke u XML-u, kako funkcionira dvosmjerno EDP-XML sučelje, koja pravila shema i sintakse vrijede te koje su najčešće zamke pri početnom podešavanju.

Zašto je XML optimalan u abas ERP okruženju?

Dok se klasični EDIFACT oslanja na fiksne pozicije i kompaktne segmente, XML je samoopisiv i hijerarhijski format. To savršeno odgovara objektno orijentiranom modelu podataka sustava abas ERP (Vartab):

  • Razumljive oznake (Tagovi): Umjesto kriptičnih segmenata (poput BGM+220) koriste se jasne i čitljive oznake (npr. <OrderNumber>, <DeliveryDate>).
  • Ugniježđene strukture: Podaci zaglavlja (Head), stavke (Table), adrese isporuke i višerazinski podaci o pakiranju prirodno se prikazuju kao hijerarhijska stabla.
  • Validacija shemom (XSD): Ispravnost strukture, obavezna polja i tipovi podataka (ISO datumi, decimalni brojevi) mogu se automatski provjeriti prije unosa u ERP bazu pomoću XML sheme (XSD).
  • Univerzalna transformacija (XSLT): Interni abas XML format može se standardnim XSLT predlošcima pretvoriti u bilo koji format koji partner zahtijeva (cXML, UBL, prilagođeni XML).

Interni podatkovni model abas XML-a: Zaglavlje i Tablica

Svaki dokument u sustavu abas ERP (narudžba, otpremnica, račun) i svaki matični slog (kupac, dobavljač, artikl) dijeli se na dvije razine: polja zaglavlja (Head) i tablične retke stavki (Table). Izvorni XML izvoz narudžbe iz abasa izgleda ovako:

<?xml version="1.0" encoding="UTF-8"?>
<abasDocument type="SalesOrder" version="2026.1">
    <head>
        <id>(184,0,0)</id>
        <nummer>SO-2026-0842</nummer>
        <such>NARUDZBA-842</such>
        <kunde>70012</kunde>
        <ygln>5990000000108</ygln>
        <bestellnr>PO-EXT-9912</bestellnr>
        <vom>2026-10-21</vom>
        <wtermin>2026-10-28</wtermin>
        <waehrung>EUR</waehrung>
    </head>
    <table>
        <row n="1">
            <artikel>A-40210</artikel>
            <such>NOSAC-40</such>
            <yean>5991234004023</yean>
            <mge>150.00</mge>
            <he>PCE</he>
            <preis>11.50</preis>
            <ttermin>2026-10-28</ttermin>
        </row>
    </table>
</abasDocument>

Konvencije naziva polja u abas XML-u

  1. Njemački i engleski nazivi: Polja u abasu imaju njemačke interne nazive (npr. kunde, artikel, mge) i engleske parove (npr. customer, product, qty). Važno je dosljedno koristiti jedan jezik unutar integracijskih profila.
  2. Prilagođena korisnička polja (prefiks y...): Sva specifična polja koja nisu dio standardnog abas modela (npr. GLN partnera: ygln, GTIN: yean, EDI status: yedistat) definiraju se s prefiksom y i ravnopravno se prenose u XML.

Kako funkcionira EDP-XML sučelje?

Sučelje EDP (Electronic Data Processing) izvorni je integracijski poslužitelj ugrađen u jezgru abasa. U XML načinu rada EDP omogućuje dvosmjernu razmjenu podataka:

SmjerOkidačLogika obrade
Izlazni (Izvoz)FOP/EFOP događaj pri zaključivanju dokumenta ili periodički InfosystemGenerira XML iz abas objekta i sprema ga u mapu reda čekanja ili šalje na REST API.
Ulazni (Uvoz)EDP servis za slušanje / mapa za uvozUčitava XML, otvara masku u pozadini bez grafičkog sučelja te pokreće cjelokupnu Vartab validaciju.

Glavna prednost EDP-XML uvoza u odnosu na izravne SQL upise je ta što sustav primjenjuje kompletnu poslovnu logiku ERP-a: provjerava kreditni limit kupca, računa cijene i popuste, primjenjuje porezna pravila i dodjeljuje sljedeći slobodan broj dokumenta.

Sintaksna pravila i standardi kodiranja

1. UTF-8 kodiranje bez BOM oznake

Za abas XML obvezno je kodiranje UTF-8 (<?xml version="1.0" encoding="UTF-8"?>). Ključno je osigurati da datoteke ne sadrže nevidljivi BOM (Byte Order Mark) na početku, jer to uzrokuje prekid parsiranja uz grešku "Content is not allowed in prolog".

2. Posebni znakovi i CDATA blokovi

Svi rezervirani XML znakovi u opisima artikala i napomenama moraju se zamijeniti entitetima (&amp;, &lt;, &gt;, &quot;, &apos;). Za duže nestrukturirane tekstove preporučuje se korištenje <![CDATA[ ... ]]> blokova.

Pregled 4 dijela serije o abas XML-u

DioPoslovni procesKljučne teme
1. dioArhitektura, EDP-XML i pravila shemaVartab XML model, rad EDP-a, kodiranje i sintaksna pravila
2. dioNarudžbe i nabava (cXML, UBL, EDP uvoz)cXML/UBL mapiranje, XSLT predlošci, pozadinski uvoz, provjera cijena
3. dioLogistika, WMS i integracija dostavnih službiIzvoz otpremnice, hijerarhija ambalaže (HU), povrat brojeva pošiljaka
4. dioE-računi (Peppol, UBL, porezni XML) i održavanjeStandardni e-računi, XSD + Schematron validacija, nadzor grešaka

Najčešće zamke u praksi

  • Prazan tag naspram izostavljenog taga: Kod EDP uvoza prazan tag <wtermin/> može obrisati zadanu vrijednost u abasu, dok izostavljanje taga omogućuje sustavu da primijeni svoje standardno pravilo dodjele.
  • Zarez umjesto točke u brojevima: Korištenje zareza za decimale (npr. 12,50) krši XML standard i uzrokuje grešku u abasu. Decimalni razdjelnik uvijek mora biti točka (.).
  • Izostanak prethodne XSD validacije: Slanje neprovjerenih XML datoteka izravno u EDP otežava dijagnostiku; validacija XSD shemom na ulaznim vratima brzo eliminira neispravne poruke.

Sažetak

Sustav abas ERP pruža robusnu i skalabilnu platformu za XML integracije putem svog EDP modula. Ključ uspješnog rada leži u urednoj Vartab strukturi, poštivanju UTF-8 standarda i obveznoj XSD validaciji.

U drugom dijelu serije prelazimo na obradu ulaznih narudžbi: pokazujemo kako pomoću XSLT-a pretvoriti vanjske cXML i UBL narudžbenice u abas EDP-XML format.

Želite unaprijediti XML i B2B integracije u svom abas ERP sustavu? Zatražite stručnu ponudu ili provjerite svoje integracijske formate na našoj stranici!