Erinevused

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

--- et:xmlcore [2021/12/10 13:44] – [Üldine] toomas
+++ et:xmlcore [2024/04/16 09:19] (Hetkel kehtiv) – [Andmete pärimine Directost ehk väljund] 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 ja arendamine on tasuline vastavalt hinnakirjale ning selle suurus sõltub kummaski suunas liikuvate andmeliikide 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.
+Iga Directo baasi külge saab soovi korral häälestada andmevahetusliidese, mis võimaldab mõlema suunalist andmeliiklust. Oluline on tähele panna, et liides pole mitte vaikimisi olemas ja kättesaadav, vaid häälestatakse iga juhtumi puhul eraldi konkreetse ülesandepüstituse vajadustest lähtuvalt. Liidese paigaldamine ja arendamine on tasuline, vastavalt [[https://directo.ee/hinnad#Liidesed|hinnakirjale]] ning selle töö maht sõltub kummaski suunas liikuvate andmeliikide arvust, seega on enne tööde alustamist vaja ühendust võtta Directo projektijuhiga ja kokku leppida täpsed vajadused ning kooskõlastada projekti maksumus.
 Sõltumata konkreetse liidestusprojekti spetsiifikast on teatud printsiibid, millega peab igal juhul arvestama.
@@ Rida 13: / Rida 13: @@
   * 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 23: @@
 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 46: @@
   * ''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 65: @@
 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 111: @@
 ==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 134: @@
 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===