| Both sides previous revision Previous revision Next revision | Previous revision |
| kb:web:balans_common_web_objects [2020/08/06 11:24] – aleksandar | kb:web:balans_common_web_objects [2020/11/13 09:32] (current) – [Realizovane grane] aleksandar |
|---|
| ===== Realizovane grane ===== | ===== Realizovane grane ===== |
| |
| Grane su nezavisne. Jedina dodirna tačka grana jeste odeljak 1 koji svi koriste za dobijanje pristupa | Grane su nezavisne. Jedina dodirna tačka grana jeste odeljak 1 koji svi koriste za dobijanje prava pristupa |
| |
| Za upotrebu svih metoda, neohodan je **token**. Token se dobija pozivom metodi GetToken ([[:kb:balans_veb_servisi_autorizacija|opisana u odeljku 1]]) preko dodeljenih podataka za pristup - korisnički nalog i šifra. Ekvivalentan je API key stringu, koji je široko raspostranjem na internetu. | Za upotrebu svih metoda, neohodan je **token**. Token se dobija pozivom metodi GetToken ([[:kb:balans_veb_servisi_autorizacija|opisana u odeljku 1]]) preko dodeljenih podataka za pristup - korisnički nalog i šifra. Ekvivalentan je API key stringu, koji je široko raspostranjem na internetu, sa tom razlikom što token ima značajno kraći period važenja. |
| |
| Takodje je potrebno da Melany Software prvo autorizuje kompaniju. | Takodje je potrebno da Melany Software prvo autorizuje kompaniju (što je već uradjeno kada dobijete nalog i šifru). |
| |
| ^RB^Odeljak^Implementacija^Revizija| | ^RB^Odeljak^Implementacija^Revizija| |
| |1|[[:kb:balans_veb_servisi_autorizacija|]]|RESTful i SOAP|19-6-11| | |1|[[:kb:balans_veb_servisi_autorizacija|]]|RESTful i SOAP|19-6-11| |
| |2|[[:kb:balans_veb_servisi_sifarnici|]]|SOAP|19-6-11| | |2|[[:kb:balans_veb_servisi_sifarnici|]]|SOAP|20-11-13| |
| |3|[[:kb:balans_veb_servisi_fieldops|FieldOps (Teledirekt) operacije]]|RESTful|19-6-11| | |3|[[:kb:balans_veb_servisi_fieldops|FieldOps (Teledirekt) operacije]]|RESTful|19-6-11| |
| |
| \\ | |
| | ===== Primer korišćenja (redosleda) ===== |
| | |
| | Ukoliko je cilj komunikacije sa servisom da se dobiju informacije o stanjima artikala na skladištima, a pto vraća metoda //StockLevel//, za njen poziv klijent mora da zna još i koje vrednosti parametara može da upotrebi: |
| | |
| | * U opštem slučaju, redosled radnji počinje pozivom metodi //GetToken //da bi se dobio token, kao obavezan parametar svih metoda. |
| | * Dalje, za moguće vrednosti parametra __stockType__, mora prethodno da izvrši poziv //GetStockTypes// i dobije rezultat. |
| | * Ako želi da vidi samo konkretno skladište, onda u __stockID __može da unese neku vrednost ID skladišta koje je dobio prethodnim pozivom metodi //StocksAvailable//. Ao želi sva skladišta, unosi nulu za ovaj parametar. |
| | * Analogno, pozivom metodi //ItemsAvailable//, klijent saznaje IDjevi artikala, šifre i nazivi i onda te podatke upotrebiti u parametrima __itemID,____itemArticle__, __itemType__, __itemColor__, __itemModel__ ili __itemTitle __ove funkcije. \\ \\ Ovde naglašavam da se ovi parametri medjusobno isključuju: Ako zadata kombinacija itemID i itemColor vrednosti koja ne postoji, onda sistem vraća prazan rezultat. Isto se dobija, na primer, da se preda kombinacija itemArticle, itemType i itemTitle vrednosti koja ne postoji u bazi podataka. I slično. \\ U ovakvim slučajevima se koriste džoker vrednosti koje ne filtriraju rezultat po datom parametru. Za numeričke vrednosti džoker je **nula**, a za tekstualne **znak procenat %. **Neki parametri mogu da se izostave, a prema dokumentaciji konkretne metode**.** \\ \\ Za poziv ovoj metodi prvo treba saznati podatke koje vraćaju metode //GroupsAvailable, SubgroupsAvailable, ManufacturersAvailable i CategoriesAvailable//. |
| | |
| | Sumirano za primer, redosled bi bio: |
| | |
| | - GetToken('', userName, userCode, [authUser], [authCustomer]) → token |
| | - GetStockTypes(token) → Spisak mogućih vrednosti za tipove skladišta |
| | - StocksAvailable(token) → Informacije o postojećim skladištima |
| | - GroupsAvailable(token) → Informaceij o postojećim grupama |
| | - SubgroupsAvailable(token, [groupID]) → Informacije o postojećim podgrupama |
| | - CategoriesAvailable(token, [groupID], [subgroupID]) → spisak kategorija u sistemu |
| | - ManufacturersAvailable(token) → Informacije o zabeleženim proizvodjačima |
| | - ItemsAvailable (sessToken, [groupID], [subgroupID], [categoryID], [manufID], [itemID], [itemArticle], [itemType], [itemColor], [itemModel], [itemTitle], [itemBarcode]) → Spisak Item objekata (artikli) |
| | - StockLevel (sessToken, stockID, stockType, [forDate], [itemID], [itemArticle], [itemType], [itemColor], [itemModel], [itemTitle],[priceListName],[priceListDate]) → rezultat stanja artikala na skladištima |
| |
| |