lt:xmlcore
Skirtumai
Čia matote skirtumus tarp pasirinktos versijos ir esamo dokumento.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
lt:xmlcore [2021/10/08 14:49] – jaroslav | lt:xmlcore [2021/12/16 16:10] – [2.2. Informacijos pasiėmimas iš Directo (OUT)] ignas | ||
---|---|---|---|
Linija 1: | Linija 1: | ||
======Bendras XML duomenų mainų sąsajos aprašymas====== | ======Bendras XML duomenų mainų sąsajos aprašymas====== | ||
+ | |||
+ | ====Bendra informacija==== | ||
+ | |||
+ | Jei pageidaujama, | ||
Integracijos principai: | Integracijos principai: | ||
- | | + | |
- | * Duomenų koduotė UTF-8; | + | * Duomenų koduotė UTF-8; |
- | * Metodas informacijai pasiekti HTTPS (sertifikatas viešai pripažįstamas); | + | * Metodas informacijai pasiekti HTTPS (sertifikatas viešai pripažįstamas); |
- | * GET metodas naudojamas duomenims gauti; | + | * GET metodas naudojamas duomenims gauti; |
- | * POST metodas yra naudojamas duomenis išsiųsti; | + | * POST metodas yra naudojamas duomenis išsiųsti; |
- | * Duomenų apsikeitimą visuomet inicijuoja išorinė šalis, nepriklausomai nuo apsikeitimo krypties; | + | * Duomenų apsikeitimą visuomet inicijuoja išorinė šalis, nepriklausomai nuo apsikeitimo krypties; |
- | * Į POST užklausą atsakoma sinchronizuotu XML pranešimu, kurio apdorojimas gali daryti įtaką sėkmingam procesui; | + | * Į POST užklausą atsakoma sinchronizuotu XML pranešimu, kurio apdorojimas gali daryti įtaką sėkmingam procesui; |
- | * Duomenų struktūra turi atitikti paruoštą XSD schemą. Pageidaujama reikšmes siųsti atributuose. | + | * Duomenų struktūra turi atitikti paruoštą XSD schemą. Pageidaujama reikšmes siųsti atributuose. |
- | * Directo dokumentų numerių tipas yra //integer//, tai reiškia, kad didžiausias galimas skaičius yra 2147483647. | + | * Directo dokumentų numerių tipas yra integer, tai reiškia, kad didžiausias galimas skaičius yra 2147483647. |
+ | * Tuščios (NULL) reikšmės nebus įtraukiamos į XML su lauko pavadinimu. Tą patį darykite ir siųsdami duomenis į Directo - praleiskite laukus, kuriuose turi būti tuščių (NULL) reikšmių. Reikėtų vengti siųsti laukus su tuščia reikšme, kaip pavyzdžiui: | ||
+ | **Endpoint URL:** [[https:// | ||
- | * **Endpoint URL:** https:// | ||
- | ==== 2.1. Prieiga prie serviso ==== | + | ==== 1. Prieiga prie serviso ==== |
- | Serviso nuorodos yra pasiekiamos '' | + | Serviso nuorodos yra pasiekiamos '' |
<code xml>< | <code xml>< | ||
Linija 27: | Linija 32: | ||
- | ==== 2.2. Informacijos pasiėmimas iš Directo (OUT) ==== | + | ==== Pavydžiai ==== |
+ | Toliau pateikti pavyzdžiai turi būti laikomi tik apytiksliais ir svarbu atsiminti, kad konkrečioje kuriamoje sąsajoje beveik tikrai bus naudojamos kitokios **schemos, URL, parametrai, apribojimai, | ||
+ | Norėdami išbandyti, naudokite šią formą: [[https:// | ||
+ | |||
+ | |||
+ | === 2.1. Informacijos pasiėmimas iš Directo (OUT) === | ||
GET metodo atveju bent 3 parametrai turi būti nurodyti: | GET metodo atveju bent 3 parametrai turi būti nurodyti: | ||
Linija 36: | Linija 46: | ||
Papildomi parametrai yra derinami individualiai pagal poreikį, integracijos derinimo metu. | Papildomi parametrai yra derinami individualiai pagal poreikį, integracijos derinimo metu. | ||
- | <wrap important> | + | Šiame pavyzdyje naudojami **what=item** ir **get**=1. Visi filtrai galimi, jei schemoje yra atitinkamas laukas. Pavyzdžiui, " |
- | Šiuose pavyzdžiuose esančios nuorodos yra iliustracinio pobūdžio. Jokiu būdu negarantuojama, kad šie URL iš tikrųjų atitiks užklausą. Jei užklausos metu duomenys yra gaunami, jie yra 100% fiktyvūs ir nesusiję su jokių tikrų įmonių duomenimis. | + | |
- | </wrap> | + | |
+ | Užklausa prekėms pagal išsaugojimo datą (ts = Time stamp): [[https:// | ||
- | Šio pavyzdžio atveju yra naudojamas **what** = " | + | Laiko filtras taip pat gali naudoti laiką taip: & ts = 01.03.2021 12:30 / & ts = 01.03.2021%2012: |
Užklausos pavyzdys, norint gauti visų prekių sąrašą: | Užklausos pavyzdys, norint gauti visų prekių sąrašą: | ||
Linija 51: | Linija 59: | ||
https:// | https:// | ||
+ | |||
+ | == Pirkėjo išvestis (OUT): == | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | Filtro parinkčių pavyzdžiai: | ||
+ | |||
+ | == Sandėlio kiekio išvestis (OUT): == | ||
+ | |||
+ | https:// | ||
+ | |||
+ | Filtro parinkčių pavyzdžius: | ||
+ | |||
==== 2.3. Informacijos siuntimas į Directo (IN) ==== | ==== 2.3. Informacijos siuntimas į Directo (IN) ==== | ||
Linija 119: | Linija 140: | ||
</ | </ | ||
- | :!: Svarbu sulaukti atsakymo apie sėkmingą įkėlimą. Jeigu tokio rezultato nesulaukiama arba yra gaunama klaida, siuntimą reikia pakartoti ne anksčiau kaip po minutės. | + | <wrap important> |
+ | Svarbu sulaukti atsakymo apie sėkmingą įkėlimą. Jeigu tokio rezultato nesulaukiama arba yra gaunama klaida, siuntimą reikia pakartoti ne anksčiau kaip po minutės. | ||
+ | </ | ||
==== 2.4. HTML forma ==== | ==== 2.4. HTML forma ==== | ||
Linija 193: | Linija 216: | ||
$xmldata = <<< | $xmldata = <<< | ||
<?xml version=" | <?xml version=" | ||
- | < | + | <invoice InvoiceNr=" |
InvoiceDate=" | InvoiceDate=" | ||
< | < |
lt/xmlcore.txt · Keista: 2023/09/15 15:27 vartotojo jaroslav