Erinevused

Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.

--- et:xmlcore [2021/09/13 16:16] – [Üldine] ott
+++ et:xmlcore [2025/09/02 09:03] (Hetkel kehtiv) – [Üldine] toomas
@@ Rida 1: / Rida 1: @@
 ======XML andmevahetusliidese üldine kirjeldus======
 =====Üldine=====
-Iga Directo baasi külge saab soovi korral häälestada andmevahetusliidese, mis võimaldab mõlemasuunalist andmeliiklust. Oluline on tähele panna, et liides pole mitte vaikimisi olemas ja kättesaadav, vaid häälestatakse iga konkreetse juhtumi puhul eraldi konkreetse ülesandepüstituse vajadustest lähtuvalt. Liidese paigaldamine on seotud ühekordse häälestustasuga, mille suurus sõltub kummaski suunas liikuvate andmeliikude arvust, seega on enne tööde alustamist vaja ühendust võtta Directo müügiesindajaga ja kokku leppida täpsed vajadused ja kooskõlastada projekti maksumus.
+Directo võimaldab igale kliendibaasile seadistada andmevahetusliidese, mis tagab turvalise ja kahepoolse andmeliikluse Directo ning väliste süsteemide vahel.
+Oluline on arvestada, et liidesed ei kuulu vaikimisi komplekti, vaid konfigureeritakse igale projektile individuaalselt vastavalt vajadustele.
+Liidese loomine, seadistamine ja arendamine on tasuline teenus, mille hind sõltub andmete mahu ja tüübi eripärast. Täpsemad tasud on toodud Directo avalikus [[https://directo.ee/hinnad#Liidesed| hinnakirjas ]]. Enne tööde alustamist tuleb kliendil pöörduda Directo projektijuhi poole, et täpsustada nõuded ning kooskõlastada tööde ulatus ja maksumus.
+Directo pakub lisaks kliendipõhistele lahendustele ka mitmeid **valmisliideseid**, mida saab kasutada kiiresti ja kuluefektiivselt:
+  * **[[et:wms_direct|WMS Direct ]]** – laojuhtimise liides (Warehouse Management System)
+  * **[[et:xml_direct|XML Direct]]** – andmevahetus XML-formaadis
+  * **[[et:bi_direct|BI Direct]]** – äristatistika ja aruandluse liides (Business Intelligence)
+  * **[[et:property_direct|Property Management Direct ]]** – kinnisvarahaldusliides
+Lisaks on saadaval veel teisigi valmisliideseid, mis katavad laialdase valiku kasutusstsenaariumeid.
+**Millal kasutada valmisliideseid ja millal kliendipõhiseid lahendusi?**
+**Valmisliidesed** sobivad hästi olukorras, kus:
+  * äriprotsess vastab juba olemasoleva lahenduse loogikale;
+  * soovitakse kiiret kasutuselevõttu ilma eriarendusteta;
+  * oluline on kuluefektiivsus ja standardlahenduse stabiilsus.
+**Kliendipõhised** liidesed sobivad juhul, kui:
+  * ettevõttel on spetsiifilised tööprotsessid või unikaalsed andmevahetuse nõuded;
+  * standardlahendus ei kata kõiki vajalikke andmetüüpe või töövooge;
+  * on vaja siduda Directo väga eripäraste või majasiseste süsteemidega.
+Sageli on praktiline lähenemine kombineeritud — kasutada olemasolevat valmisliidest standardsete funktsioonide jaoks ning täiendada seda kliendile kohandatud arendustega, et katta erivajadused.
 Sõltumata konkreetse liidestusprojekti spetsiifikast on teatud printsiibid, millega peab igal juhul arvestama.
@@ Rida 13: / Rida 39: @@
   * Andmete struktuur peab olema kirjeldatav XSD schemana, võimaluse korral eelistada schemat, kus väärtuste kandjaks on atribuudid, mitte elemendid
   * Dokumendi numbrid Directos on //integer// tüüpi, mis tähendab, et suurim võimalik number on //2147483647//
+  * Üks XML liidese postitus ei tohi olla suurem kui 10Mb
 =====Liidestele ligipääs=====
@@ Rida 22: / Rida 49: @@
 Näide  käsurealt cURL kasutamisel:
 <code>
-curl -v -d "key=2852DD553B767B463C807ADB36B5BB2F&what=item&get=1&ts=01.01.2021&code=000001" -H "Content-Type: application/x-www-form-urlencoded" -X POST "https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp"
+curl --location 'https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp' \
+--header 'Content-Type: application/x-www-form-urlencoded' \
+--data-urlencode 'key=2852DD553B767B463C807ADB36B5BB2F' \
+--data-urlencode 'get=1' \
+--data-urlencode 'what=item' \
+--data-urlencode 'ts=01.01.2024'
 </code>
@@ Rida 40: / Rida 72: @@
   * ''get=1''
   * ''what=ANDMELIIK''
-  * ''appkey=PREDEFINEDKEY''
+  * ''key=PREDEFINEDKEY''
 ja võimalikud lisaparameetrid. Kasutusel olevad andmeliikide verbid, võtme väärtused ja andmeliigipõhised lisaparameetrid lepitakse kokku iga konkreetse installatsiooni käigus.
+XML’ist jäetakse alati välja koos nimega sellised väljad, mille sisu baasis on NULL (tühi).
 ===Praktiline näide===
@@ Rida 56: / Rida 91: @@
 Artklite päring muudatuste kohta (ts=Time stamp):
-https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp?what=item&get=1&ts=01.01.2021
+<code>
+curl --location 'https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp' \
+--header 'Content-Type: application/x-www-form-urlencoded' \
+--data-urlencode 'key=2852DD553B767B463C807ADB36B5BB2F' \
+--data-urlencode 'get=1' \
+--data-urlencode 'what=item' \
+--data-urlencode 'ts=01.01.2024'
+</code>
 Aja filtris võib kasutada ka kellaaega sellisel kujul: &ts=01.03.2021 12:30 / &ts=01.03.2021%2012:30
 Terve tootebaasi päring:
-https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=item
+<code>
+curl --location 'https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp' \
+--header 'Content-Type: application/x-www-form-urlencoded' \
+--data-urlencode 'key=2852DD553B767B463C807ADB36B5BB2F' \
+--data-urlencode 'get=1' \
+--data-urlencode 'what=item' \
+</code>
 Üksiku toote päring, toote koodi järgi, lisaparameeter ''code=0000'':
-https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=item&code=0000
+<code>
+curl --location 'https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp' \
+--header 'Content-Type: application/x-www-form-urlencoded' \
+--data-urlencode 'key=2852DD553B767B463C807ADB36B5BB2F' \
+--data-urlencode 'get=1' \
+--data-urlencode 'what=item' \
+--data-urlencode 'code=0000'
+</code>
 ==Klientide väljund:==
-https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=customer&ts=01.01.2021
+<code>
+curl --location 'https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp' \
+--header 'Content-Type: application/x-www-form-urlencoded' \
+--data-urlencode 'key=2852DD553B767B463C807ADB36B5BB2F' \
+--data-urlencode 'get=1' \
+--data-urlencode 'what=customer' \
+--data-urlencode 'ts=01.01.2024'
+</code>
 Näidis filtrite võimalused: "code","loyaltycard","regno","email","phone","closed","ts"
@@ Rida 73: / Rida 137: @@
 ==Laoseisude väljund:==
-https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=stocklevel
+<code>
+curl --location 'https://login.directo.ee/xmlcore/demo_ee/xmlcore.asp' \
+--header 'Content-Type: application/x-www-form-urlencoded' \
+--data-urlencode 'key=2852DD553B767B463C807ADB36B5BB2F' \
+--data-urlencode 'get=1' \
+--data-urlencode 'what=stocklevel' \
+</code>
 Näidis filtrite võimalused:"code","stock"
@@ Rida 90: / Rida 160: @@
 POST muutujatega „put=1“, „key=[appkey väärtus]“, „what=order“ ( või „what=customer“ või „what=item“ )  ja „xmldata=[XML'i sisu]“
 Sisend xml peab vastama skeemile.
+Palun vältida tühja sisuga väljade saatmist sellisel kujul: customer_code="".
 ===Praktiline näide===