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
- 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. - 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 prefiksomyi 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:
| Smjer | Okidač | Logika obrade |
|---|---|---|
| Izlazni (Izvoz) | FOP/EFOP događaj pri zaključivanju dokumenta ili periodički Infosystem | Generira 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 uvoz | Uč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 (&, <, >, ", '). Za duže nestrukturirane tekstove preporučuje se korištenje <![CDATA[ ... ]]> blokova.
Pregled 4 dijela serije o abas XML-u
| Dio | Poslovni proces | Ključne teme |
|---|---|---|
| 1. dio | Arhitektura, EDP-XML i pravila shema | Vartab XML model, rad EDP-a, kodiranje i sintaksna pravila |
| 2. dio | Narudžbe i nabava (cXML, UBL, EDP uvoz) | cXML/UBL mapiranje, XSLT predlošci, pozadinski uvoz, provjera cijena |
| 3. dio | Logistika, WMS i integracija dostavnih službi | Izvoz otpremnice, hijerarhija ambalaže (HU), povrat brojeva pošiljaka |
| 4. dio | E-računi (Peppol, UBL, porezni XML) i održavanje | Standardni 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!