POST päring: erinevus redaktsioonide vahel

Allikas: Excellent || Opendoc
Mine navigeerimisribale Mine otsikasti
Resümee puudub
 
(ei näidata 3 kasutaja 3 vahepealset redaktsiooni)
3. rida: 3. rida:
POST päringu näol on tegemist Standard Booksi andmete kirjutamise meetodiga, mis kasutab Rest API funktsionaalsust ja XML formaati. Järgnevalt on kirjeldatud, kuidas POST päringu tegemine Standard Booksi toimib.
POST päringu näol on tegemist Standard Booksi andmete kirjutamise meetodiga, mis kasutab Rest API funktsionaalsust ja XML formaati. Järgnevalt on kirjeldatud, kuidas POST päringu tegemine Standard Booksi toimib.


====Autoriseerimine URL'i abil====
NB: tegemist ei ole HansaWorldi standardse Rest APIga, antud leht kirjeldab funktsoooni, mis on kasutusel vai Excellentis.  
<syntaxhighlight>
http://username:password@ipAddress:portNumber/WebPOSTAPI.hal?company=compNumber&param2=value&param3=value
</syntaxhighlight>
====Autoriseerimine päringu päises====
====Autoriseerimine päringu päises====
<syntaxhighlight>
<syntaxhighlight>
15. rida: 12. rida:
*compNumber on ettevõtte number Standard Books ettevõtete registris. (Numberatsioon algab 1'st)
*compNumber on ettevõtte number Standard Books ettevõtete registris. (Numberatsioon algab 1'st)
Näide:<syntaxhighlight>
Näide:<syntaxhighlight>
http://testuser:testpassword@localhost:1639/WebPOSTAPI.hal?company=1
http://localhost:1639/WebPOSTAPI.hal?company=1
</syntaxhighlight>
</syntaxhighlight>
====Päringu päis====
====Päringu päis====
21. rida: 18. rida:
*Content-Type: application/xml
*Content-Type: application/xml
Kui kasutada autoriseerimist POST päringu päises, tuleb päringu päisesse lisada järgnevad osad:
Kui kasutada autoriseerimist POST päringu päises, tuleb päringu päisesse lisada järgnevad osad:
*Authorization: Basic [base64 encoded user:password string]
*Authorization: Basic [base64 encoded user:password string] <invalid example
**''example Authorization: Basic YXBpOmFwaQ==''
**''Authorization: Basic YXXBpOmn7FwaQ=='' <invalid example
*''JSON not supported at the moment''
*''JSON not supported at the moment''
====Päringu formaat (POST data)====
====Päringu formaat (POST data)====
35. rida: 32. rida:
</syntaxhighlight>
</syntaxhighlight>
** Muutmine ('''UPDATE''')
** Muutmine ('''UPDATE''')
*** ''Näide:''<syntaxhighlight lang="xml">
*** "Update" Kasutamise kommentaarid:  - Registrite puhul ("Vc" suffiksiga kirjed) "update" funktsiooni puhul XML-is kõigepealt peab olema antud kohustuslik väli (või mitu, kui on nii eraldi mainitud), mis unikaalselt määrab (määravad) ära millist kirjet muudetakse. See on väli mille järgi Books leiab õiget registri kirjet. Kui seda välja XMLis ei ole, kohe tagastatakse veateadet.  - Blokide puhul ("Block" suffiksiga kirjed) on tegemist ainult ühe kirjega, ehk kõik muudatused asuvad ainult ühes kohas ning valikut ei ole.  - Ülejäänud XML tag-id ei ole kohustuslikud.  - Need tag-id mis on edastatud, peavad olema korrektse sisuga. Näiteks, et aadressi rida kirjutada tühja reaga üle (ehk kustutada aadressi rida), vaja edastada vastava välja nimega XML tagi tühja sisuga, mis on lubatud. Kui on tegemist CheckBox-ga või näiteks RadioButton-iga, siis need peavad olema vastavalt formaadile täidetud, näiteks kas "0" või "1" ning tühjad väärtused sel juhul ei ole lubatud. Sama näidis oleks ka KM koodiga seoses, KM koodi ei tohi muuta ebaeksisteeriva KM koodi vastu.
***''Näide:''<syntaxhighlight lang="xml">
<data register="CYBlock" method="update" sequence="106357" systemversion="8.4.20.504">
<data register="CYBlock" method="update" sequence="106357" systemversion="8.4.20.504">
</syntaxhighlight>
</syntaxhighlight>
61. rida: 59. rida:
*<s>sequence="106357" systemversion="8.4.20.504" are not used in API right now, only used for example, can ignore it for the moment.</s>
*<s>sequence="106357" systemversion="8.4.20.504" are not used in API right now, only used for example, can ignore it for the moment.</s>


===== Lisamine/Muutmine/Kustutamine =====
===== <s>Lisamine/Muutmine/Kustutamine</s> =====
POST päring, kasutades Rest API funktsionaalsust, võimaldab sisestusi Standard Books tarkvaras:
<s>POST päring, kasutades Rest API funktsionaalsust, võimaldab sisestusi Standard Books tarkvaras:</s>
* '''Lisada'''
* '''<s>Lisada</s>'''
 
''Näide:''<syntaxhighlight lang="xml">
<data register="CYBlock" method="create" sequence="106357" systemversion="8.4.20.504">
</syntaxhighlight>
* '''Muuta'''
 
''Näide:''<syntaxhighlight lang="xml">
<data register="CYBlock" method="update" sequence="106357" systemversion="8.4.20.504">
</syntaxhighlight>"Update" Kasutamise kommentaarid:
 
- Registrite puhul ("Vc" suffiksiga kirjed) "update" funktsiooni puhul XML-is kõigepealt peab olema antud kohustuslik väli (või mitu, kui on nii eraldi mainitud), mis unikaalselt määrab (määravad) ära millist kirjet muudetakse. See on väli mille järgi Books leiab õiget registri kirjet. Kui seda välja XMLis ei ole, kohe tagastatakse veateadet.
 
- Blokide puhul ("Block" suffiksiga kirjed) on tegemist ainult ühe kirjega, ehk kõik muudatused asuvad ainult ühes kohas ning valikut ei ole.


- Ülejäänud XML tag-id ei ole kohustuslikud.
''<s>Näide:</s>''
* '''<s>Muuta</s>'''


- Need tag-id mis on edastatud, peavad olema korrektse sisuga. Näiteks, et aadressi rida kirjutada tühja reaga üle (ehk kustutada aadressi rida), vaja edastada vastava välja nimega XML tagi tühja sisuga, mis on lubatud. Kui on tegemist CheckBox-ga või näiteks RadioButton-iga, siis need peavad olema vastavalt formaadile täidetud, näiteks kas "0" või "1" ning tühjad väärtused sel juhul ei ole lubatud. Sama näidis oleks ka KM koodiga seoses, KM koodi ei tohi muuta ebaeksisteeriva KM koodi vastu.
''<s>Näide:</s>''


* '''Kustutada'''
* '''<s>Kustutada</s>'''


''Näide:''<syntaxhighlight lang="xml">
''<s>Näide:</s>''
<data register="CYBlock" method="delete" sequence="106357" systemversion="8.4.20.504">
</syntaxhighlight>

Viimane redaktsioon: 14. veebruar 2020, kell 13:56

Hausing - Pealeht

Päring

POST päringu näol on tegemist Standard Booksi andmete kirjutamise meetodiga, mis kasutab Rest API funktsionaalsust ja XML formaati. Järgnevalt on kirjeldatud, kuidas POST päringu tegemine Standard Booksi toimib.

NB: tegemist ei ole HansaWorldi standardse Rest APIga, antud leht kirjeldab funktsoooni, mis on kasutusel vai Excellentis.

Autoriseerimine päringu päises

http://ipAddress:portNumber/WebPOSTAPI.hal?company=compNumber&param2=value&param3=value
and additional header
  Authorization: Basic [base64 encoded user:password string]

Nõutud parameetrid:

  • compNumber on ettevõtte number Standard Books ettevõtete registris. (Numberatsioon algab 1'st)

Näide:

http://localhost:1639/WebPOSTAPI.hal?company=1

Päringu päis

Päringu päise kohustuslikud osad:

  • Content-Type: application/xml

Kui kasutada autoriseerimist POST päringu päises, tuleb päringu päisesse lisada järgnevad osad:

  • Authorization: Basic [base64 encoded user:password string] <invalid example
    • Authorization: Basic YXXBpOmn7FwaQ== <invalid example
  • JSON not supported at the moment

Päringu formaat (POST data)

Päring peab olema XML formaadis.

Märkused:

  • <rows> element ei ole kohustuslik
  • <data> elemendi atribuut "method" määrab päringu tegevuse. Toetatud tegevuste hulka kuuluvad:
    • Lisamine (CREATE)
      • Näide:
        <data register="CYBlock" method="create" sequence="106357" systemversion="8.4.20.504">
        
    • Muutmine (UPDATE)
      • "Update" Kasutamise kommentaarid: - Registrite puhul ("Vc" suffiksiga kirjed) "update" funktsiooni puhul XML-is kõigepealt peab olema antud kohustuslik väli (või mitu, kui on nii eraldi mainitud), mis unikaalselt määrab (määravad) ära millist kirjet muudetakse. See on väli mille järgi Books leiab õiget registri kirjet. Kui seda välja XMLis ei ole, kohe tagastatakse veateadet. - Blokide puhul ("Block" suffiksiga kirjed) on tegemist ainult ühe kirjega, ehk kõik muudatused asuvad ainult ühes kohas ning valikut ei ole. - Ülejäänud XML tag-id ei ole kohustuslikud. - Need tag-id mis on edastatud, peavad olema korrektse sisuga. Näiteks, et aadressi rida kirjutada tühja reaga üle (ehk kustutada aadressi rida), vaja edastada vastava välja nimega XML tagi tühja sisuga, mis on lubatud. Kui on tegemist CheckBox-ga või näiteks RadioButton-iga, siis need peavad olema vastavalt formaadile täidetud, näiteks kas "0" või "1" ning tühjad väärtused sel juhul ei ole lubatud. Sama näidis oleks ka KM koodiga seoses, KM koodi ei tohi muuta ebaeksisteeriva KM koodi vastu.
      • Näide:
        <data register="CYBlock" method="update" sequence="106357" systemversion="8.4.20.504">
        
    • Kustutamine (DELETE)
      • Näide:
        <data register="CYBlock" method="delete" sequence="106357" systemversion="8.4.20.504">
        

Iga registri päringu väljade ja formaadi kirjeldused leiab siit:

Hausing - Pealeht

Must be in XML format.

General format template as follows.

Notes:

  • <rows> element is optional;
  • IVVc is the internal system name of Invoice register in Hansa. Only following registers are supported at the moment:
    • IVVc - Invoices
    • CUVc - Contacts
    • INVc - Items
  • the register name (“IVVc”) is now included into <data> element of request body, but is subject to review and may be moved to URL as parameter instead.
  • Possible to pass several <IVVc> elements to send several records.
  • “method” attribute of the <data> element defines the action. Actions supported at the moment: “create”, “delete”.
  • sequence="106357" systemversion="8.4.20.504" are not used in API right now, only used for example, can ignore it for the moment.
Lisamine/Muutmine/Kustutamine

POST päring, kasutades Rest API funktsionaalsust, võimaldab sisestusi Standard Books tarkvaras:

  • Lisada

Näide:

  • Muuta

Näide:

  • Kustutada

Näide: