et:xmlcore
Erinevused
Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
et:xmlcore [2021/08/31 09:25] – ott | et:xmlcore [2024/04/16 08:47] – [Praktiline näide] toomas | ||
---|---|---|---|
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, | + | Iga Directo baasi külge saab soovi korral häälestada andmevahetusliidese, |
Sõltumata konkreetse liidestusprojekti spetsiifikast on teatud printsiibid, | Sõltumata konkreetse liidestusprojekti spetsiifikast on teatud printsiibid, | ||
Rida 12: | Rida 12: | ||
* POST päringule vastab liides sünkroonse XML sõnumiga, mille töötlemine võib protsessi edukuse huvides oluline olla | * POST päringule vastab liides sünkroonse XML sõnumiga, mille töötlemine võib protsessi edukuse huvides oluline olla | ||
* 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 // | ||
+ | * Üks XML liidese postitus ei tohi olla suurem kui 10Mb | ||
=====Liidestele ligipääs===== | =====Liidestele ligipääs===== | ||
Rida 42: | Rida 44: | ||
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. | ||
+ | XML’ist jäetakse alati välja koos nimega sellised väljad, mille sisu baasis on NULL (tühi). | ||
+ | |||
+ | |||
===Praktiline näide=== | ===Praktiline näide=== | ||
Rida 55: | Rida 60: | ||
Artklite päring muudatuste kohta (ts=Time stamp): | Artklite päring muudatuste kohta (ts=Time stamp): | ||
- | https:// | + | < |
+ | curl --location 'https:// | ||
+ | --header ' | ||
+ | --data-urlencode 'key=2852DD553B767B463C807ADB36B5BB2F' | ||
+ | --data-urlencode 'get=1' \ | ||
+ | --data-urlencode ' | ||
+ | --data-urlencode 'ts=01.01.2024' | ||
+ | </ | ||
Aja filtris võib kasutada ka kellaaega sellisel kujul: & | Aja filtris võib kasutada ka kellaaega sellisel kujul: & | ||
Terve tootebaasi päring: | Terve tootebaasi päring: | ||
- | https:// | + | < |
+ | curl --location 'https:// | ||
+ | --header ' | ||
+ | --data-urlencode ' | ||
+ | --data-urlencode 'get=1' \ | ||
+ | --data-urlencode 'what=item' \ | ||
+ | </ | ||
Üksiku toote päring, toote koodi järgi, lisaparameeter '' | Üksiku toote päring, toote koodi järgi, lisaparameeter '' | ||
- | https:// | + | < |
+ | curl --location 'https:// | ||
+ | --header ' | ||
+ | --data-urlencode ' | ||
+ | --data-urlencode 'get=1' \ | ||
+ | --data-urlencode 'what=item' \ | ||
+ | --data-urlencode 'code=0000' | ||
+ | </ | ||
==Klientide väljund:== | ==Klientide väljund:== | ||
- | https:// | + | < |
+ | curl --location 'https:// | ||
+ | --header ' | ||
+ | --data-urlencode ' | ||
+ | --data-urlencode 'get=1' \ | ||
+ | --data-urlencode 'what=customer' \ | ||
+ | --data-urlencode 'ts=01.01.2024' | ||
+ | </ | ||
Näidis filtrite võimalused: | Näidis filtrite võimalused: | ||
Rida 72: | Rida 106: | ||
==Laoseisude väljund:== | ==Laoseisude väljund:== | ||
- | https:// | + | < |
+ | curl --location 'https:// | ||
+ | --header ' | ||
+ | --data-urlencode ' | ||
+ | --data-urlencode 'get=1' \ | ||
+ | --data-urlencode 'what=stocklevel' \ | ||
+ | </ | ||
Näidis filtrite võimalused:" | Näidis filtrite võimalused:" | ||
Rida 89: | Rida 129: | ||
POST muutujatega „put=1“, | POST muutujatega „put=1“, | ||
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=== | ||
Rida 226: | Rida 267: | ||
===Postman=== | ===Postman=== | ||
Väljund ja Sisend [[https:// | Väljund ja Sisend [[https:// | ||
- | [[https://wiki.directo.ee/ | + | {{:et:directo.demo.postman_collection.json|siit}} ning siis importida Collectionina Postmani ning seal testida |
et/xmlcore.txt · Viimati muutnud: 2024/04/16 09:19 persoon toomas