Atšķirības

Norādītais vecais variants no patreizējās lapas atšķiras ar.

--- lv:xmlcore [2018/07/20 17:14] – marija
+++ lv:xmlcore [2022/02/03 11:32] (patlaban) – [Vispārīga informācija] marija
@@ Rinda 1: / Rinda 1: @@
-IZLABO **Lapa nav pilnībā pārtulkota. Lūdzu palīdzi pabeigt tulkojumu!** \\ //(Izdzēs šo rindkopu, kad tulkojums pabeigts!)//
 ======Directo XML datu apmaiņas apraksts======
 ====Vispārīga informācija====
-Jebkurai Directo DB ir iespējams konfigurēt datu apmaiņu, kas ļauj nodrošināt abpusēju datu plūsmu. Ir svarīgi ņemt vērā, ka datu apmaiņas saskarne nav standartizēta, bet tiek pielāgota katram gadījumam individuāli, lai atbilstu darba uzdevumā izvirzītajām prasībām. Datu apmaiņas uzstādīšana ir saistīta ar vienreizēju ieviešanas maksu, kas ir atkarīga no datu tipu skaita, kas tiks iesaistīts datu apmaiņā, tāpēc ir vēlams savlaicīgi sazināties ar Directo pārstāvjiem, lai precizētu projekta izmaksas.
+Jebkurai Directo DB ir iespējams konfigurēt datu apmaiņu, kas ļauj nodrošināt abpusēju datu plūsmu. Ir svarīgi ņemt vērā, ka datu apmaiņas saskarne nav standartizēta, bet tiek pielāgota katram gadījumam individuāli, lai atbilstu darba uzdevumā izvirzītajām prasībām. \\
+Datu apmaiņas uzstādīšana ir saistīta ar ikmēneša abonēšanas maksu par xml moduli un izstrādes izmaksām, kas ir atkarīgas no uzdevuma sarežģītības, tāpēc ir vēlams savlaicīgi sazināties ar Directo pārstāvjiem, lai precizētu projekta izmaksas.
 Neatkarīgi no projekta specifikas, ir daži principi, kas visos gadījumos ir vienādi:
@@ Rinda 18: / Rinda 17: @@
 ====Piemēri====
-Dotie piemēri ir veidoti tikai kā vadlīnijas.\\
+<wrap important>Dotie piemēri ir veidoti tikai datu apmaiņas pamatprincipu demonstrācijai!</wrap>
 ===Datu iegūšana no Directo===
 GET pieprasījumam vienmēr ir  vismaz trīs parametri:
-  * ''Get = 1''
+  * ''Get=1''
-  * ''What = ANDMELIIK''
+  * ''What=DATATYPE''
-  * ''Key = PREDEFINEDKEY''
+  * ''Key=PREDEFINEDKEY''
-Pārējie parametri ir atkarīgi no konkrēto uzdevumu specifikas.\\
+Iespējamie datu tipi, derīgas atslēgas un pārējie parametri tiek noteikti katram uzdevumam individuāli.\\
 ==Praktisks piemērs - artikulu izvade==
 Tāda veida izvadi bieži izmanto interneta veikali, piemēram, lai noskaidrotu pieejamos produktus un to atlikumus Directo noliktavā.\\
-(Piemērā lietotie URL ir tikai ilustratīvi un pat, ja šāds pieprasījums var rezultēties ar datu iegūšanu, dati ir fiktīvi un nav saistīti ar kāda klienta reālajiem datiem!)
+<wrap important>Piemērā lietotie URL ir tikai ilustratīvi un pat, ja šāds pieprasījums var rezultēties ar datu iegūšanu, dati ir fiktīvi un nav saistīti ar kāda klienta reālajiem datiem!</wrap>
 Šajā piemērā izmantosim parametru ''what=item'' un atslēgu ''20DAF3F822B782AF12D1198C23F45604''\\
@@ Rinda 39: / Rinda 39: @@
 https://directo.gate.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=item&key=20DAF3F822B782AF12D1198C23F45604 \\
-Lai iegūtu informāciju par kādu konkrētu artikulu, piemēram, pēc artikula koda, mēs norādām papildus parametru ''code=0000'' un tagad links izskatīsies šādi:
+Lai iegūtu informāciju par kādu konkrētu artikulu, piemēram, pēc artikula koda, mēs norādām papildus parametru ''code=0000'' un tagad pieprasījums izskatīsies šādi:
 https://directo.gate.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=item&code=0000&key=20DAF3F822B782AF12D1198C23F45604 \\
 ===Datu nosūtīšana uz Directo===
-Datus sūta, izmantojot POST metodi un norādot trīs parametrus:
+Datus sūta, izmantojot POST metodi un norādot vismaz trīs parametrus:
   * ''put=1''
-  * ''what=ANDMELIIK''
+  * ''what=DATATYPE''
   * ''xmldata=<?xml version=„1.0“ encoding=„utf-8“?><PAYLOAD>''
-==Praktisks piemērs - pārdošanas reķina ievade==
+==Praktisks piemērs - pārdošanas rēķina ievade==
 Šāda tipa ievade, piemēram, var tikt izmantota, lai replicētu kādu ārējās pārdošanas sistēmas rēķinu Directo.
-(Piemērā izmantotā adrese un xml saturs ir fiktīvi un nav izmantojami testēšanai!)
+<wrap important>Piemērā izmantotā adrese un xml saturs ir fiktīvi un nav izmantojami testēšanai, tā vienmēr ir jāveic reālajā konfigurācijā!</wrap>
 Pieņemsim, ka datu apmaiņas URL ir: https://directo.gate.ee/xmlcore/this_is_the_worlds_greatest_company/xmlcore.asp
@@ Rinda 62: / Rinda 62: @@
 Piemēram, xml var izskatīties šādi (ne visi iespējamie atribūti ir izmantoti):
-<code xml>
-<? xml version = "1.0" encoding = "utf-8" ?>
- <Invoices>
-   <INVOICE AppKey = "1234567879012345678790" InvoiceNr = "123"
- InvoiceDate = "2015-06-07" CustomerCode = "CUST001">
-     <Lines>
-       <line ProductID = "KILLERPRODUCT" Quantity = "3" UnitPriceWoVAT = "123.45" />
-       <line ProductID = "FREESAMPLE" Quantity = "1" UnitPriceWoVAT = "0.00" />
-     </Lines>
-   </INVOICE>
- </Invoices>
-</code>
-Pieņemsim, ka datu ievietošana ir noritējusi veiksmīgi un tiek sūtīts šāds sinhronais xml
-<code xml>
-<? xml version = "1.0" encoding = "UTF-8" ?>
- <Results>
-   <Result Type = "0" desc = "OK" DocId = "123" doctype = "INVOICE" submit = "Invoices" />
- </Results>
-</code>
-Ja ''Result'' elementa ''Type'' atribūts nav vienāds ar 0 tad ir notikusi kāda kļūda un šādā gadījumā ''Desc'' parādīsies precizējoša informācija.
-Piemēram, ja rēķins ar šādu numuru jau eksistē, tad atbildes ziņojums būs šāds:
-<code xml><? xml version = "1.0" encoding = "UTF-8" ?>
- <Results>
-   <Result Type = "1" desc = "Duplicate" DocId = "123" doctype = "INVOICE" submit = "Invoices" />
- </Results>
-</code>
-Bet ja vienā sūtījumā būtu bijuši vairāki rēķini:
-<code xml>
-<? xml version = "1.0" encoding = "UTF-8" ?>
- <Results>
-   <Result Type = "1" desc = "Duplicate" DocId = "123" doctype = "INVOICE" submit = "Invoices" />
-   <Result Type = "0" desc = "OK" DocId = "124" doctype = "INVOICE" submit = "Invoices" />
- </Results>
-</code>
-Atbildes ziņojuma apstrāde ir būtiski, ja nav nav saņemts apstiprinājums par veiksmīgu datu saņemšanu, tad dati nav ievietoti un ir jāveic atkārtots mēģinājums, bet ne ātrāk kā pēc 60s.
-====PHP piemēri====
-===Datu izvade===
-<code php>$ url = 'https://directo.gate.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=item&key=20DAF3F822B782AF12D1198C23F45604';
- $ ch = curl_init ();
- curl_setopt ($ ch, CURLOPT_HEADER, 0);
- curl_setopt ($ ch, CURLOPT_RETURNTRANSFER, true);
- curl_setopt ($ ch, CURLOPT_URL, $ url);
- curl_setopt ($ ch, CURLOPT_POST, 0);
- $ result = curl_exec ($ ch);
- header ( 'Content-Type: text / html; charset = utf-8');
- print '<textarea cols = 80 rows = 10>'.  $ result.  '</ textarea>';
- $ data = new SimpleXMLElement ($ result);
- print "<pre> ';
- foreach ($ data -> Items -> item as $ item) {
-	 print $ item [ 'Code'].  chr (9).  '<b>'.  $ item [ 'name'].  '</ b>'.  chr (9).  $ item [ 'class'].  'Estonian';
-	 foreach ($ item -> datafields -> DATA AS $ df) {
-		 print chr (9).  $ df [ 'code'].  ':'.  $ df [ 'content'].  'Estonian';
-	 }
- }
-</code>
-===Datu ievade===
-<code php>$ XMLDATA = '<'.  '? xml version = "1.0" encoding = "UTF-8"?>
-  <INVOICE AppKey = "1234567879012345678790" InvoiceNr = "123"
-	  InvoiceDate = "2015-06-07" CustomerCode = "CUST001">
-      <Lines>
-        <line ProductID = "KILLERPRODUCT" Quantity = "3" UnitPriceWoVAT = "123.45" />
-        <line ProductID = "FREESAMPLE" Quantity = "1" UnitPriceWoVAT = "00:00" />
-      </ lines>
-  </ INVOICE> ';
- $ url = 'https://directo.gate.ee/xmlcore/this_is_the_worlds_greatest_company/xmlcore.asp';
- $ ch = curl_init ();
- curl_setopt ($ ch, CURLOPT_HEADER, 0);
- curl_setopt ($ ch, CURLOPT_RETURNTRANSFER, true);
- curl_setopt ($ ch, CURLOPT_URL, $ url);
- curl_setopt ($ ch, CURLOPT_POST, 1);
- curl_setopt ($ ch, CURLOPT_POSTFIELDS, 'XMLDATA = ". urlencode ($ XMLDATA).' 'put & = 1 & what = INVOICE');
- $ result = curl_exec ($ ch);
- print '<textarea cols = 80 rows = 10>'.  $ result.  '</ textarea>';
- curl_close ($ ch);
-</code>
-======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.
-Sõltumata konkreetse liidestusprojekti spetsiifikast on teatud printsiibid, millega peab igal juhul arvestama.
-  * Andmete formaat on XML
-  * Andmete kodeering on UTF-8
-  * Transpordiprotokoll on HTTPS (avalikult tunnustatud sertifikaadiga)
-  * Andmete pärimisel kasutatakse GET meetodit
-  * Andmete postitamisel kasutatakse POST meetodit
-  * Andmeliikluse algatab alati väline osapool sõltumata sellest, kas andmeid päritakse või saadetakse, Directo liides on passiivne
-  * 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
-=====Näited=====
-Allpooltoodud näiteid tuleb käsitleda ainult umbkaudsete juhistena ja arvestada, et konkreetses loodavas liideses on peaaegu kindlasti kasutusel näites toodutest erinevad
-  * schemad
-  * URLid
-  * Parameetrid, piirangud
-  * Vastussõnumid
-  * Võtmed
-====Andmete pärimine Directost ehk väljund====
-GET päringu korral on alati täidetud vähemalt kolm parameetrit:
-  * ''get=1''
-  * ''what=ANDMELIIK''
-  * ''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.
-===Praktiline näide - artiklite väljund===
-Seda tüüpi väljundit kasutab tihti näiteks veebipood, et toodete ja nende saadavuse infot Directost poodi laadida.
-<wrap important>Käesolevas näites toodud URLid on mõeldud ainult võimaliku päringuformaadi illustreerimiseks. Ühelgi juhul ei ole tagatud, et need URLid päringule ka reaalselt vastavad. Juhul, kui päringu tulemuseks on andmed, on need 100% fiktiivsed ja pole seotud ühegi reaalse äriühingu andmetega.</wrap>
-Antud näiteks kasutatakse verbi ''what=item'' ja võtme väärtus on ''20DAF3F822B782AF12D1198C23F45604''. Soovi korral võib tutvuda struktuuri kirjeldava schemaga {{:et:ws_artiklid.xsd|}}
-Terve tootebaasi päring:
-https://directo.gate.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=item&key=20DAF3F822B782AF12D1198C23F45604
-Üksiku toote päring, toote koodi järgi, lisaparameeter ''code=0000'':
-https://directo.gate.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=item&code=0000&key=20DAF3F822B782AF12D1198C23F45604
-====Andmete saatmine Directosse ehk sisend====
-Andmete saatmine käib POST meetodil, ''form/urlencoded'' liidese URLi suhtes.
-Täidetud on kolm vormimuutujat:
-  * ''put=1''
-  * ''what=ANDMELIIK''
-  * ''xmldata=<?xml version="1.0" encoding="utf-8"?><PAYLOAD>''
-===Praktiline näide - müügiarvete sisend===
-Seda tüüpi sisendit kasutatakse näiteks sellisel puhul, kui mingis välises süsteemis genereeritakse müügiarveid, mida on vaja Directos kajastada.
-<wrap important>Käesolevas näites toodud URLid ja XML sõnumid on täiesti fiktiivsed ja pole teenuse testimiseks kasutatavad. Testimine toimub alati reaalse installatsiooni suhtes.</wrap>
-Oletame, et liidese URL on antud juhul https://directo.gate.ee/xmlcore/this_is_the_worlds_greatest_company/xmlcore.asp
-Andmeid kirjeldab schema {{:et:xml_in_arved.xsd|}}
-Schemale vastav, aga sugugi mitte kõiki võimalikke atribuute kasutab XML võib välja näha näiteks selline:
 <code xml>
 <?xml version="1.0" encoding="utf-8"?>
@@ Rinda 237: / Rinda 73: @@
   </invoice>
 </invoices>
 </code>
-Postitusele vastab liides sünkroonse XML sõnumiga, kust saab teada, mis juhtus.
+Pieņemsim, ka datu ievietošana ir noritējusi veiksmīgi un atbilde ir šāds sinhronais xml:
-Näide, postitus oli edukas ja Directosse võeti vastu müügiarve number 123:
 <code xml>
 <?xml version="1.0" encoding="UTF-8" ?>
@@ Rinda 250: / Rinda 84: @@
 </code>
-Kui ''Result'' elemendi ''Type'' atribuudi väärtus pole 0, siis on tegemist mingi veaga ja sel juhul ütleb atribuut ''Desc'' lähemalt, mis häda oli.
+Ja ''Result'' elementa ''Type'' atribūts nav vienāds ar 0, tad ir notikusi kāda kļūda un šādā gadījumā ''Desc'' parādīsies precizējoša informācija.
+Piemēram, ja rēķins ar šādu numuru jau eksistē, tad atbildes ziņojums var būt šāds:
-Näide, arve number 123 vastuvõtmisest keelduti, kuna sellise numbriga arve oli Directos juba olemas:
 <code xml>
 <?xml version="1.0" encoding="UTF-8" ?>
-<results>
+ <results>
-  <Result Type="1" Desc="Duplicate" docid="123" doctype="INVOICE" submit="Invoices" />
+   <Result Type="1" Desc="Duplicate" docid="123" doctype="INVOICE" submit="Invoices" />
-</results>
+ </results>
 </code>
-Ühest pakis võib olla korraga ka mitu arvet, igaühe kohta tuleb omaette ''Result'':
+Bet ja vienā sūtījumā būtu bijuši vairāki rēķini:
 <code xml>
 <?xml version="1.0" encoding="UTF-8" ?>
@@ Rinda 269: / Rinda 105: @@
 </code>
-Vastussõnumi töötlemine on oluline, juhul kui pole õnnestunud saada edukat vastuvõttu tähistavat sõnumit, tuleb saatmine ebaedukaks lugeda ja mingi intervalli järel (mitte vähem kui 60s) uuesti proovida.
+Atbildes ziņojuma apstrāde ir būtiska, ja nav saņemts apstiprinājums par veiksmīgu datu ielādi, tad dati nav ievietoti un ir jāveic atkārtots mēģinājums, bet ne ātrāk kā pēc 60s.
+====PHP piemēri====
+===Datu izvade===
-====PHP näited====
-===Väljund===
 <code php>
 $url = 'https://directo.gate.ee/xmlcore/demo_ee/xmlcore.asp?get=1&what=item&key=20DAF3F822B782AF12D1198C23F45604';
@@ Rinda 301: / Rinda 138: @@
 </code>
+===Datu ievade===
-===Sisend===
 <code php>
+$xmldata = '<'.'?xml version="1.0" encoding="UTF-8" ?>
-$xmldata = '<'.'?xml version="1.0" encoding="UTF-8"?>
 <invoice AppKey="1234567879012345678790" InvoiceNr="123"
 	InvoiceDate="2015-06-07" CustomerCode="CUST001">
@@ Rinda 329: / Rinda 165: @@
 curl_close($ch);
 </code>
+{{page>lv:gns}}