et:xmlcore
Erinevused
Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
et:xmlcore [2022/03/14 10:02] toomas [Andmete pärimine Directost ehk väljund] |
et:xmlcore [2024/04/16 09:19] (Hetkel kehtiv) toomas [Andmete pärimine Directost ehk väljund] |
||
|---|---|---|---|
| Rida 1: | Rida 1: | ||
| ======XML andmevahetusliidese üldine kirjeldus====== | ======XML andmevahetusliidese üldine kirjeldus====== | ||
| =====Üldine===== | =====Ü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. | 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 | * 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// | * 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===== | =====Liidestele ligipääs===== | ||
| Rida 22: | Rida 23: | ||
| Näide käsurealt cURL kasutamisel: | Näide käsurealt cURL kasutamisel: | ||
| <code> | <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> | </code> | ||
| Rida 40: | Rida 46: | ||
| * ''get=1'' | * ''get=1'' | ||
| * ''what=ANDMELIIK'' | * ''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. | ja võimalikud lisaparameetrid. Kasutusel olevad andmeliikide verbid, võtme väärtused ja andmeliigipõhised lisaparameetrid lepitakse kokku iga konkreetse installatsiooni käigus. | ||
| Rida 59: | Rida 65: | ||
| Artklite päring muudatuste kohta (ts=Time stamp): | 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 | 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: | 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'': | Ü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:== | ==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" | Näidis filtrite võimalused: "code","loyaltycard","regno","email","phone","closed","ts" | ||
| Rida 76: | Rida 111: | ||
| ==Laoseisude väljund:== | ==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" | Näidis filtrite võimalused:"code","stock" | ||
| Rida 93: | 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]“ | 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. | Sisend xml peab vastama skeemile. | ||
| + | Palun vältida tühja sisuga väljade saatmist sellisel kujul: customer_code="". | ||
| ===Praktiline näide=== | ===Praktiline näide=== | ||
