Kaupo – 27. detsember 2021, kell 11:10

2021-12-27T11:10:32Z

Kaupo: Uus lehekülg: '=== Andmete maht === Enamasti on mõtestatud API kasutamise alustuseks vaja pärida suur hulk baasandmeid (kontaktid, artiklid, kontod, objektid jne) ja pika perioodi toimingureg...'

2021-12-27T09:46:09Z

Uus lehekülg: '=== Andmete maht === Enamasti on mõtestatud API kasutamise alustuseks vaja pärida suur hulk baasandmeid (kontaktid, artiklid, kontod, objektid jne) ja pika perioodi toimingureg...'

Uus lehekülg

=== Andmete maht ===
Enamasti on mõtestatud API kasutamise alustuseks vaja pärida suur hulk baasandmeid (kontaktid, artiklid, kontod, objektid jne) ja pika perioodi toiminguregistrid (arved, laekumised, tellimused, kanded jne). Et seda teha teiste kasutajate suhtes võimalikult väikese mõjuga, siis:

* Üle 100 000 kirjega registrite puhul kasutage andmete pärimiseks öist aega.
* Kui öine ajastamine pole võimalik, pärige andmeid näiteks 1000 kuni 5000 kaupa, kasutades ''offset'' and ''limit'' parameetreid. Jätke päringute vahele umbes sekundilised pausid, et server saaks vahepeal teenindada klientprogramme
* Kui kasutate suurte andmemahtude korral ''fields'' või ''filter'' parameetreid, on päringule vastuse koostamine äärmiselt CPU-nõudlik. Päringule vastuse koostamine võtab ca 10x kauem aega, kui pärides toor-andmeid. Antud filtreid on hea kasutada jooksvate päringutega, lühikese perioodi kohta või koos ''updates_after'' parameetriga.

=== Jooksvate päringute tegemine ===

* Veebipoodide, tootmis- ja laosüsteemide liidestamisel on vajadus pärida Standard Booksist muutunud andmeid. Selleks tegevuseks on parim viis [[KKK - updates after kasutamine, registrite loend|updates_after parameetri kasutamine]], mis tagastab vastuses vaid uued ja/või muutunud kaardid päritavas registris alates eelmisest päringust. NB: kui soovite kasutada updates_after parameetrit registris, kus see toetatud pole, siis võtke ühendust Excellenti müügiosakonnaga.
* Ajastage päring mitte sagedamalt, kui 20 minutilise intervalliga. Kui teete sagedamalt, hakkavad Stadard Booksis kuhjuma samaaegsed sisselogimis-sessioonid. 2021 lõpu seisuga on Standard Booksil probleeme suure hulga taoliste sessioonide haldamisega ja varem või hiljem tekivad probleemid klientprogrammide ühendustega.

=== Testid ===

* 2- realisi finantskandeid suudab Standard Books tavaolukorras kirjutada 10 tk sekundis.
* 1 realisi arveid '''koos Kinnita valikuga''' suudab Standard Books kirjutada 3-4 tk sekundis
* 10 000 kande pärimine toor-andmetega võtab aega ca 10 sekundit (3 sekundit päringu koostamine, 7 sekundit vastuse salvestamine + edastamine). Vastuse suurus 30 MB. Samal ajal ei olnud klientprogrammi kasutamine võimalik.
* 10 000 kande pärimine koos fields parameetri ja 10 väljaga võttis 7 sekundit (5 sekundit päringu koostamine, 2 sekundit vastuse salvestamine + edastamine) Vastuse suurus 4 MB. Samal ajal ei olnud klientprogrammi kasutamine võimalik.
* Kui teha GET päringuid järjest 1 sekundilise vahega, siis on klientprogramm kasutuskõlbmatu peale 25 minuti möödumisel päringute algusest.

←Vanem redaktsioon		Redaktsioon: 27. detsember 2021, kell 11:10
1. rida:		1. rida:
	=== Andmete maht ===		=== Head tavad Standard Booksi Rest API kasutamiseks ===

			====Andmete maht====
	Enamasti on mõtestatud API kasutamise alustuseks vaja pärida suur hulk baasandmeid (kontaktid, artiklid, kontod, objektid jne) ja pika perioodi toiminguregistrid (arved, laekumised, tellimused, kanded jne). Et seda teha teiste kasutajate suhtes võimalikult väikese mõjuga, siis:		Enamasti on mõtestatud API kasutamise alustuseks vaja pärida suur hulk baasandmeid (kontaktid, artiklid, kontod, objektid jne) ja pika perioodi toiminguregistrid (arved, laekumised, tellimused, kanded jne). Et seda teha teiste kasutajate suhtes võimalikult väikese mõjuga, siis:

	* Üle 100 000 kirjega registrite puhul kasutage andmete pärimiseks öist aega.		*Üle 100 000 kirjega registrite puhul kasutage andmete pärimiseks öist aega.
	* Kui öine ajastamine pole võimalik, pärige andmeid näiteks 1000 kuni 5000 kaupa, kasutades ''offset'' and ''limit'' parameetreid. Jätke päringute vahele umbes sekundilised pausid, et server saaks vahepeal teenindada klientprogramme		*Kui öine ajastamine pole võimalik, pärige andmeid näiteks 1000 kuni 5000 kaupa, kasutades ''offset'' and ''limit'' parameetreid. Jätke päringute vahele umbes sekundilised pausid, et server saaks vahepeal teenindada klientprogramme
	* Kui kasutate suurte andmemahtude korral ''fields'' või ''filter'' parameetreid, on päringule vastuse koostamine äärmiselt CPU-nõudlik. Päringule vastuse koostamine võtab ca 10x kauem aega, kui pärides toor-andmeid. Antud filtreid on hea kasutada jooksvate päringutega, lühikese perioodi kohta või koos ''updates_after'' parameetriga.		*Kui kasutate suurte andmemahtude korral ''fields'' või ''filter'' parameetreid, on päringule vastuse koostamine äärmiselt CPU-nõudlik. Päringule vastuse koostamine võtab ca 10x kauem aega, kui pärides toor-andmeid. Antud filtreid on hea kasutada jooksvate päringutega, lühikese perioodi kohta või koos ''updates_after'' parameetriga.

	=== Jooksvate päringute tegemine ===		====Jooksvate päringute tegemine====

	* Veebipoodide, tootmis- ja laosüsteemide liidestamisel on vajadus pärida Standard Booksist muutunud andmeid. Selleks tegevuseks on parim viis [[KKK - updates after kasutamine, registrite loend\|updates_after parameetri kasutamine]], mis tagastab vastuses vaid uued ja/või muutunud kaardid päritavas registris alates eelmisest päringust. NB: kui soovite kasutada updates_after parameetrit registris, kus see toetatud pole, siis võtke ühendust Excellenti müügiosakonnaga.		*Veebipoodide, tootmis- ja laosüsteemide liidestamisel on vajadus pärida Standard Booksist muutunud andmeid. Selleks tegevuseks on parim viis [[KKK - updates after kasutamine, registrite loend\|updates_after parameetri kasutamine]], mis tagastab vastuses vaid uued ja/või muutunud kaardid päritavas registris alates eelmisest päringust. NB: kui soovite kasutada updates_after parameetrit registris, kus see toetatud pole, siis võtke ühendust Excellenti müügiosakonnaga.
	* Ajastage päring mitte sagedamalt, kui 20 minutilise intervalliga. Kui teete sagedamalt, hakkavad Stadard Booksis kuhjuma samaaegsed sisselogimis-sessioonid. 2021 lõpu seisuga on Standard Booksil probleeme suure hulga taoliste sessioonide haldamisega ja varem või hiljem tekivad probleemid klientprogrammide ühendustega.		*Ajastage päring mitte sagedamalt, kui 20 minutilise intervalliga. Kui teete sagedamalt, hakkavad Stadard Booksis kuhjuma samaaegsed sisselogimis-sessioonid. 2021 lõpu seisuga on Standard Booksil probleeme suure hulga taoliste sessioonide haldamisega ja varem või hiljem tekivad probleemid klientprogrammide ühendustega.

	=== Testid ===		====Testid====
			Testid on tehtud 2021 aasta lõpus, ver STDBKS_8.5-2021-09-26-0383

	* 2- realisi finantskandeid suudab Standard Books tavaolukorras kirjutada 10 tk sekundis.		*2- realisi finantskandeid suudab Standard Books tavaolukorras kirjutada 10 tk sekundis.
	* 1 realisi arveid '''koos Kinnita valikuga''' suudab Standard Books kirjutada 3-4 tk sekundis		*1 realisi arveid '''koos Kinnita valikuga''' suudab Standard Books kirjutada 3-4 tk sekundis
	* 10 000 kande pärimine toor-andmetega võtab aega ca 10 sekundit (3 sekundit päringu koostamine, 7 sekundit vastuse salvestamine + edastamine). Vastuse suurus 30 MB. Samal ajal ei olnud klientprogrammi kasutamine võimalik.		*10 000 kande pärimine toor-andmetega võtab aega ca 10 sekundit (3 sekundit päringu koostamine, 7 sekundit vastuse salvestamine + edastamine). Vastuse suurus 30 MB. Samal ajal ei olnud klientprogrammi kasutamine võimalik.
	* 10 000 kande pärimine koos fields parameetri ja 10 väljaga võttis 7 sekundit (5 sekundit päringu koostamine, 2 sekundit vastuse salvestamine + edastamine) Vastuse suurus 4 MB. Samal ajal ei olnud klientprogrammi kasutamine võimalik.		*10 000 kande pärimine koos fields parameetri ja 10 väljaga võttis 7 sekundit (5 sekundit päringu koostamine, 2 sekundit vastuse salvestamine + edastamine) Vastuse suurus 4 MB. Samal ajal ei olnud klientprogrammi kasutamine võimalik.
	* Kui teha GET päringuid järjest 1 sekundilise vahega, siis on klientprogramm kasutuskõlbmatu peale 25 minuti möödumisel päringute algusest.		*Kui teha GET päringuid järjest 1 sekundilise vahega, siis on klientprogramm kasutuskõlbmatu peale 25 minuti möödumisel päringute algusest.

KKK - head tavad API kasutamiseks - Redigeerimiste ajalugu

Kaupo – 27. detsember 2021, kell 11:10

Kaupo: Uus lehekülg: '=== Andmete maht === Enamasti on mõtestatud API kasutamise alustuseks vaja pärida suur hulk baasandmeid (kontaktid, artiklid, kontod, objektid jne) ja pika perioodi toimingureg...'