Lietotāja rīki

Vietnes rīki



lv:menetlus

Atšķirības

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

Saite uz salīdzināšanas skatu.

Nākamā versija
Iepriekšējā versija
lv:menetlus [2017/01/16 15:58]
dairis izveidots
lv:menetlus [2018/07/16 17:18]
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!)//​+=====Dokumentu virzīšana Directo=====
  
-======Directo XML ====== +====1. Dokumentu parakstīšana - ieskats====
-Vispārējs apraksts par XML datu apmaiņu+
  
-Directo katra puse var konfigurēt datu apmaiņu, kas ļauj nodrošināt abpusēju datu plūsmuIr svarīgi saprast, ka interfeiss nav standarta, bet ir speciāli pielāgots katram gadījumam individuāli,​ lai atbilstu specifiskām prasībāmInterfeisa uzstādīšana ir saistīta ar ieviešanas maksu  tā dēļ, lai samazinātu liekas izmaksas, ir vēlams, lai pirms tam konkrēti tiek izlemts, kam jūs izmantosies directo un tad sazināties ar mūsu tirdzniecības pārstāvjiem. +===1.1Apstrāde dokumentu galvenē===
-Neatkarīgi no projekta specifikas, ir pāris principi, kuru visiem ir vienādi. +
-  * Datu formāts ir XML +
-  * Dati tiek kodēti izmantojot UTF-8 formātu +
-  * Transporta protokols ir HTTPS +
-  * Informācijas iegūšanai izmanto GET metodi +
-  * Datu ievietošanai izmanto POST metodi +
-  * Datu plūsmu vienmēr uzsāk ​ārējs avots (klients)+
  
-Piemēri +Daudziem Directo dokumentiem – pirkuma pasūtījumiem un ķiniemnaudas izmaksāmalgu dokumentiem u.cir pieejama dokumenta apstrādekas redzama paša dokumenta galvenes otrajā šķirklī ''​Apstrādāšana'':​ 
-Dotie piemēri ir uzskatāmi par aptuveniem piemēriem un var atšķirties no reāla piemēra. +{{ :​lv:​proceeding:​dok_virz_1.png?direct&​460 |}}
-Datu iegūšana no directo +
-GET pieprasījumam vienmēir  vismaz trīs parametri. +
-  * Get = 1 +
-  * What = ANDMELIIK +
-  * Key = PREDEFINEDKEY +
-Iespējami arī ir citi papildus parametrilai iegūtu konkrētāku informāciju par pieprasīto lietu. +
-Šajā piemērā izmantosim visus artikulus – what=item un atslēgu 20DAF3F822B782AF12D1198C23F45604. Lai iegūtu pilnu informāciju par artikuliem “item”mēs izveidojam query  +
-// //​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 ar kodu “0000”mēs ievadam papildus parametru “code” un tagad links izskatīsies ​šādi  https://​directo.gate.ee/​xmlcore/​demo_ee/​xmlcore.asp?​get=1&​what=item&​code=0000&​key=20DAF3F822B782AF12D1198C23F45604 +
-Sūtīt datus uz directo +
-Datus sūta izmantojot POST metodi kuram tā pat, kā GET ir trīs obligātie parametri +
-  * put=1  +
-  * what=ANDMELIIK  +
-  * xmldata=<?​xml version=„1.0“ encoding=„utf-8“?><​PAYLOAD> ​+
  
-Šādu sistēmu izmantokad ārēja sistēma ģenerē informāciju priekšķina ( piemēram individuāla atlaide)+Lietotājamkuram ir piešķirtas tiesības parakstīt dokumentu, ir pieejams komentāru lauks un parakstīšanas/​noraidīšanas pogas: 
 +{{ :​lv:​proceeding:​dok_virz_2.png?​direct |}}
  
 +Tā izskatās paraksts uz dokumenta – ir redzams datums un parakstītājs:​
 +{{ :​lv:​proceeding:​dok_virz_3.png?​direct |}}
  
-Links tad būtu https://​directo.gate.ee/​xmlcore/​this_is_the_worlds_greatest_company/​xmlcore.asp+Dokumenta augšējā daļā, rīku joslā, atrodas parakstīšanas ikona, ar ko var atvērt kopsavilkumu par parakstīšanas rezultātu, te mēs redzam, ka ir viens parakstītājs,​ kas dod 2 punktus no vajadzīgajiem 5: 
 +{{ :​lv:​proceeding:​dok_virz_4.png?​direct&​400 |}}
  
-Un payload+Katram lietotājam,​ piešķirot paraksta tiesības, norāda atbilstošu punktu skaitu, kas var būt viesiem vienāds, vai atšķirties,​ atkarībā no konkrētām vajadzībām.
  
-<? xml version ​"​1.0"​ encoding ​"​utf-8"?>​ +===1.2. Atskaite par dokumentu apstrādi===
- <​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 ​"​00:​00"​ /> +
-     </ lines> +
-   </ INVOICE>​ +
- </ Invoices> ​+
  
-Piemērā ir izveidots ​ķins ar nr 123.+Plašāka atskaite par dokumentu virzību ir pieejama sadaļā ''​Sistēma->​Atskaites->​Turpināšana''​.\\ 
 +Noklusējumā tā atver pārskatu par dokumentiem,​ kuros ir iesaistīts lietotājs, bet šo filtru var noņemt no lauka virzītājs,​ ja nepieciešams apskatīties visus dokumentus.\\ 
 +Te var atlasīt dokumentus pēc perioda, statusa (apstiprināts/​neapstiprināts),​ parakstīšanas procesa posma (noritēja: nav parakstīts,​ daļēji vai pilnībā).\\ 
 +P2, P3 un P5 – ir parakstītāji ar tiem iedotu punktu daudzumu, atskaite parāda, cik parakstu no nepieciešamajiem ir salasīts. Zem sarkanajiem trīsstūrīšiem ir pieejami atšifrējumi ar komentāriem. 
 +{{ :​lv:​proceeding:​dok_virz_5.png?direct |}}
  
-Piemērā dotais ziņojums ir pareizs ​un tiek saņemts xml sinhronais ziņojums +Atskaite parāda arī pašu dokumentu ar pielikumiem ​un iestatījumos var noteikt, vai tas būs tikai skatāms vai maināms no atskaites. 
-  <? xml version = "1.0" encoding = "​UTF-8"?> ​ +Ieķeksējot atlasītos dokumentus, tos var parakstīt ar pogu ''​Parakstīt izvelēto''​
- <​Results>​ +Klikšķinot uz dokumenta numura, otrajā atskaites pusē atvērsies atbilstošais dokuments: 
-   <Result Type = "​0"​ desc = "​OK"​ DocId = "​123"​ doctype = "​INVOICE"​ submit = "​Invoices"​ />  +{{ :​lv:​proceeding:​dok_virz_6.png?​direct |}}
- </ results> ​+
  
-Ja Result Type  nav 0 tad ir kāda kļūdaDesc norāda kāda ir kļūda.+===1.3. Paziņojumi parakstītājiem===
  
-Piemērs kurā ir pieļauta kļūda.+Uz lietotāja kartiņā norādīto e-pastu parakstītāji saņem no sistēmas ziņojumus par dokumentiem,​ kas jāparaksta, ar pamatinformāciju un saiti uz parakstāmajiem dokumentiem:​ 
 +{{ :​lv:​proceeding:​dok_virz_7.png?​direct |}} 
 +Sistēmas iestatījumos,​ sadaļā ''​Nepieciešams apstiprinājums/​turpināšana''​ var norādīt, ​kādās dienās un cikos sūtīt šos paziņojumus:​ 
 +{{ :​lv:​proceeding:​dok_virz_8.png?​direct&​600 |}}
  
-<? xml version ​"​1.0"​ encoding ​"​UTF-8"?>​  +====2. Apstrādes tiesību regulējums====
- <​Results>​ +
-   <​Result Type "​1"​ desc "​Duplicate"​ DocId "​123"​ doctype ​"​INVOICE"​ submit ​"​Invoices"​ />  +
- </ results> ​+
  
-Redzam, ka Result ir un desc raksta “duplicate”Tas nozīmē, ka kāds jau ir izmantots. +===2.1. Tiesības lietotāja personas kartītē===
-Vienā atbildē var būt arī atbilde uz vairākiem sūtījumiem.+
  
-<? xml version = "1.0" encoding = "​UTF-8"?> ​ +Lietotāja personas kartītē var norādīt, kādos dokumentos viņu iekļaut kā parakstītāju pēc noklusējuma,​ ar kādām tiesībām, kā arī norādīt lietotājam aizstājēju un pēc nepieciešamības – aizstāšanas periodu
- <​Results>​ +Lietotāja personas kartīti var atvērt no sistēmas iestatījumu lietotāju saraksta, uzklikšķinot uz grupas nosaukuma: 
-   <Result Type = "​1"​ desc = "​Duplicate"​ DocId = "​123"​ doctype = "​INVOICE"​ submit = "​Invoices"​ />  +{{ :​lv:​proceeding:​dok_virz_9.png?​direct&​400 |}}
-   <​Result Type = "​0"​ desc = "​OK"​ DocId = "​124"​ doctype = "​INVOICE"​ submit = "​Invoices"​ />  +
- </ results> ​+
  
 +Šeit, piemēram, ir norādīts, ka lietotājam MARIJA_2 ir jābūt parakstītajam visiem pirkuma rēķiniem virs summas 100, līdz summai 1000 un kā aizstājējs – MARIJA_3:
 +{{ :​lv:​proceeding:​dok_virz_10.png?​direct |}}
  
-PHP piemērs +Kā arī lietotājam ir dotas tiesības mainīt parakstītājus un veikt šīs izmaiņas no apstrādes atskaites: 
-Saņemt datus +{{ :lv:​proceeding:​dok_virz_11.png?direct&600 |}}
-$ url = 'https://directo.gate.ee/​xmlcore/​demo_ee/​xmlcore.asp?get=1&​what=item&key=20DAF3F822B782AF12D1198C23F45604';​+
  
- $ ch = curl_init (); +Paziņojums par aizstāšanu ir redzams atskaitēja ieiet sistēmā ar šo lietotāju: 
- ​curl_setopt ($ chCURLOPT_HEADER,​ 0); +{{ :​lv:​proceeding:​dok_virz_12.png?​direct |}}
- curl_setopt ($ ch, CURLOPT_RETURNTRANSFER,​ true); +
- ​curl_setopt ($ ch, CURLOPT_URL,​ $ url); +
- ​curl_setopt ($ ch, CURLOPT_POST,​ 0);+
  
- $ result = curl_exec ($ ch);+Šādi izskatās atzīme par parakstīšanu no aizvietotāja:​ 
 +{{ :​lv:​proceeding:​dok_virz_13.png?​direct&​500 |}}
  
- ​header ( '​Content-Typetext / html; charset = utf-8'​);​+Kā arī redzam, ka šis lietotājs var pievienot citus lietotājus apstrādes rindai: 
 +{{ :​lv:​proceeding:​dok_virz_14.png?​direct |}}
  
- print '<​textarea cols = 80 rows = 10>'​ $ result. ​ '</ textarea>';​+Noklusējuma iestatījumu personas kartiņā atšifrējums:​ 
 +{{ :​lv:​proceeding:​dok_virz_15.png?direct |}}
  
- $ data new SimpleXMLElement ($ result);+===2.2. Paraksta punktu piešķiršana lietotājiem===
  
- print "<​pre>​ ';+Paraksta punktus var pievienot lietotājiem individuāli no lietotāju saraksta vai visai grupai no grupu saraksta, klikšķinot uz nosaukuma. Šeit izvēlāmies vienu lietotāju:​ 
 +{{ :​lv:​proceeding:​dok_virz_16.png?​direct&​400 |}}
  
- ​foreach ($ data -> Items -> item as $ item) { +Atlasām dokumentu veidu no saraksta, atzīmējam visas tiesības, kurām jābūt šai sadaļā un norādām paraksta punktu skaitu pēdējā laukā: 
- print $ item [ '​Code'​]. ​ chr (9).  '<b>'​. ​ $ item [ '​name'​]. ​ '</ b>'​. ​ chr (9).  $ item [ '​class'​]. ​ '​Estonian';​ +{{ :lv:proceeding:​dok_virz_17.png?direct |}}
-  ​foreach ($ item -> datafields -> DATA AS $ df) { +
- print chr (9).  $ df [ '​code'​]. ​ ':' $ df [ '​content'​]. ​ '​Estonian';​ +
-  } +
- +
  
 +===2.3. Sistēmas iestatījumi par dokumentu virzīšanu===
  
-Sūtīt datus +Sistēmas iestatījumos, sadaļā ​''​Nepieciešams apstiprinājums/turpināšana'', ​ir atrodami kopējie parakstīšanas nosacījumipiemēramte iespējams norādītkuru dokumentu apstiprināšanai ​(iegrāmatošanaibūs nepieciešama apstrādecik parakstītāju būs nepieciešamivai tiem jāparaksta dokuments secīgi un vai jālieto summas limits: 
-$ XMLDATA = '<'.  '? xml version = "​1.0"​ encoding = "​UTF-8"?>​  +{{ :​lv:​proceeding:​dok_virz_18.png?direct |}}
-  <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 ($ chCURLOPT_HEADER0); +
- ​curl_setopt ($ chCURLOPT_RETURNTRANSFERtrue); +
- ​curl_setopt ​($ ch, CURLOPT_URL,​ $ url)+
- ​curl_setopt ($ chCURLOPT_POST1); +
- +
- ​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);  +
  
 +Zemāk ir iespējams norādīt konkrētu punktu skaitu, kas būs nepieciešams,​ lai dokuments būtu parakstīts.
lv/menetlus.txt · Labota: 2018/07/16 17:18 , labojis marija