Podešavanje AQL-a

AQL

App Query Language (AQL) je aplikativni programski interfejs programa Wings APP koji omogućava povezivanje sa drugim sistemima i programima pružajući set instrukcija kojim se mogu izvršiti razne komande u programu (listanje artikala, pregled kartica partnera, kreiranje dokumenata, itd.) Više detalja kao i rečnik komandi možete pogledati u tekstu o AQL serveru.

Web Portal

Uz pomoć posebne WebAQL alikacije moguć je pristup i povezivanje sa AQL putem Interneta i posebno razvijenog aplikativnog interfejsa koji je nadogradnja na AQL, Portal API. Koristeći Portal API razvili smo posebnu web aplikaciju Wings Portal koja predstavlja gotovo i zaokruženo webshop rešenje dostupno našim korisnicima. Uz potpunu konfigurabilnost iz samog programa Wings Portal pruža našim korisnicima gotovo B2B i B2C rešenje koje se jednostavno instalira i podešava u roku od nekoliko minuta bez ikakvih dodatnih troškova razvoja. Zainteresovanim korisnicima dostupan je Demo Portal na kome mogu isprobati sve funkcionalnosti Wings Portala kao i korisničko uputstvo za njegovo korišćenje.

Sve opcije rada Portala podešavaju se iz programa kao i kreiranje svih korisničkih naloga za pristup. Portalu mogu imati pristup korisnici programa (koristeći istu šifru kao i za pristup programu), komercijalisti, partneri i eksterni korisnici. B2B deo Portala predviđen je za vaše komercijaliste i kupce dok vašem B2C Portalu mogu pristupati fizička lica sa i bez registracije kao eksterni korisnici. U programu su dostupna podešavanja prava pristupa kojima možete posebno podesiti opcije i pristup Portalu za vaše korisnike, komercijaliste, kupce i eksterne korisnike.

Korisnicima programa opcije Portala podešavate u Ostalo / Korisnici / Pregled korisnika, komandom F6 – Prava pristupa, i biranjem opcija u sekciji WEB PORTAL. Za vaše komercijaliste, kupce i eksterne korisnike pristup Portalu se podešava u opcijama AQL-a, a korisničko ime i šifru im samostalno unosite nakon što uključite odgovorajuće opcije u njihovim elementima (Ostalo / Sistemske opcije / Podešavanje programa / Razno / Elementi komercijaliste i Partneri / Tipovi partnera / F4 / Elementi partnera).

OPCIJE AQL-a i Portala

Osnovna podešavanja
AQL KOMUNIKACIONI DIR – Folder preko koga se komunicira sa AQL serverom. Isti komunikacioni folder mora biti podešen i u WebAQL. U ovom folderu nalaze se i LOG datoteke u kojima se čuva istorijat zahteva i odgovora.

INTERVAL ZA OBRADU ZAHTEVA – Na koliko sekundi se skenira komunikacioni folder.

PORTAL SE AŽURIRA U – U koje vreme se vrši dnevno ažuriranje podataka na serveru.

NA SVAKIH (SATI) – Na koliko se sati potom vrši periodično ažuriranje.

GENERISANJE STATISTIKE POZIVA – Da li se generišu statistički podaci. Ukoliko je uključena opcija na Portalu će biti dostupan pregled statistike korišćenja Portala (dnevnik logovanja, najčešći posetioci u poslednjih 7 dana).

 

Podešavanja magacina za količine
PODRAZUMEVANI MAGACIN – Osnovni magacin na portalu, za PRODAJNE VP cene.

MAGACINI KOJI SE PRIKAZUJU – Iz kojih magacina će se prikazivati stanje. Stanje i rezervacije se prikazuju zbirno dok Portal ima dugme koje omogućava pregled količina po magacinima.

 

Podešavanje prikaza artikala
VRSTE KOJE SE PRIKAZUJU (VP) – Određuje koji artikli (vrste artikala) će se prikazivati na VP Portalu (za kupce, komercijaliste i korisnike programa).

VRSTE KOJE SE PRIKAZUJU (MP) – Određuje koji artikli (vrste artikala) će se prikazivati za MP Portal (eksterni kupci). Napomena: odabir vrste može se izvršiti i u opciji Zalihe / Vrste artikala komandama ALT+W (odabir za VP portal) i ALT+M (odabir za MP portal).

PRIKAZ ART.KOJIH NEMA NA STANJU – Da li treba prikazivati artikle kojih trenutno nema na stanju.

MAKSIMALNA KOL.ZA PRIKAZ – Za količine artikala koje su veće od zadate biće prikazana maksimalna količina (npr. „100+“). Napomena: ako je uključena maksimalna količina za prikaz na Portalu se neće videti rezervacije, odnosno biće prikazana samo informacija o slobodnim količinama (Umesto kol=100 i rez=43 biće prikazano kol=57). Ova opcija ima efekta samo kada Portal koriste vaši kupci; vaši komercijalisti će videti količine i rezervacije bez obzira na podešavanje maksimalne količine za prikaz.

KORIŠĆENJE DOD.NAZIVA U ARTIKLIMA – Da li da se umesto naziva artikla prikazuje dodatni naziv.

 

Podešavanje cena
CENE SE UZIMAJU IZ – Koje cene će se prikazivati na VP portalu, ponuđene opcije se menjaju razmakom. Ukoliko se izabere opcija PRODAJNE prikazivaće se cene iz podrazumevanog magacina.

MP CENE SE UZIMAJU IZ – Koje cene će se prikazivati na MP portalu. Opciju PRODAJNE birajte samo ste za podrazumevani magacin izabrali maloprodaju. Ovde se preporučuje korišćenje CENOVNIKA.

KONVERZIJA DEV -> DIN CENE – Ako se uključi ova opcija, cene koje se šalju portalu se iz deviznih konvertuju u dinarske i obrnuto. Podesite da se cene uzimaju iz CENOVNIKA koji sadrži devizne cene ili neka od REFERENTNIH cena. Time je omogućeno da se interno radi u devizama, a portal sve cene prikazuje u dinarima.

 

Podešavanje narudžbenica
PODRAZUMEVANI TIP DOKUMENTA – Podarzumevani tip dokumenta za kreirane profakture ukoliko na samom registratoru profaktura nije podešen, u suprotnom koriste se podešavanja na registratoru profaktura.

REGISTRATOR PROFAKTURA (VP) – Registrator u koji se upisuju profakture kreirane na VP portalu.

REGISTRATOR PROFAKTURA (MP) – Registrator u koji se upisuju profakture kreirane na MP portalu.

 

Prava pristupa
KOMERC.PRISTUP NA PORTALU – Podešavanje opcija portala koje će biti  dostupne komercijalistima.

PARTN. PRISTUP NA PORTALU – Podešavanje opcija portala koje će biti  dostupne kupcima.

MP KUPAC PRISTUP NA PORTALU – Podešavanje opcija MP portala koje će biti  dostupne eksternim korisnicima.

 

Podešavanje prikaza
OZNAKA KOLIČINE – Ovom opcijom se podešava prikaz B-količina na portalu, za opcije Artikli (B-kol) i Naručivanje (B-kol). Boje se biraju razmakom (SPACE) između ponuđene žute, plave,  crvene i zelene, i unosi se tekst kojim će boja biti objašnjenja. Prikaz boja se podešava po odnosu stanja artikla sa minimalnom i maksimalnom količinom, koja se za svaki artikal može podesiti u opciji ULAZ/IZLAZ / Nabavka i distribucija / Analiza i naručivanje. Na primer, ukoliko je količina artikla manja od minimalne prikazati žutu boju sa tekstom „Potrebna provera“.

INICIJALNI PREGLED ARTIKALA – Da li se incijalno posetiocima prikazuje tabelarni prikaz sa listom artikala u redovima ili grid prikaz sa slikama artikala velikog formata. Posetioci na portalu mogu i samostalno promeniti ovu opciju na dugme Prikaz.

PRIKAZ VRSTA ARTIKALA – Da li će kupcima biti omogućen pregled vrsta (kategorija) artikala radi filtriranja.

PRIKAZ SLIKA U TABELI – Da li u Tabelarni prikazu artikala uvrstiti i sliku artikla malog formata (thumbnail).

 

Podešavanje korisničkog interfejsa
SLANJE OBAVEŠTENJA NA MAIL – Da li se i kome šalje mail kad se kreira narudžbenica.

EKSPORT ARTIKALA – Da li će biti dostupna opcija za eksport artikala u XML datoteku.

TRAŽENJE ARTIKALA PO DELU NAZIVA – Ako je opcija isključena pretraga na portalu se vrši od početka naziva, odnosno šifre. Uključena opcija omogućava da se unese bilo koji deo naziva ili šifre za pretragu.

PRIKAZ NARUDŽBENICE POSLE KREIRANJA – Da li posetiocu prikazati kreiranu narudžbenicu sa opcijom štampe.

IZBOR OBJEKATA – Da li je omogućen izbor posebnih objekata kupca pri izradi narudžbenice.

IZMENA RABATA – Da li će na portalu biti omogućena izmena rabata. Ova opcija se odnosi samo na rad komercijalista na portalu.

IZBOR MAGACINA – Da li posetilac može da bira magacin za prikaz količina i kreiranje narudžbenice. Nudi se izbor iz liste magacina koji se prikazuju.

IZBOR ‘SVI’ ZA MAGACINE – Da li je dozvoljen izbor opcije SVI za magacin. Ovom opcijom se posetiocima omogućava zbirni pregled količina ukoliko je uključen izbor magacina.

PROVERA STANJA KOD NARUČIVANJA – Ovom opcijom se ne dozvoljava naručivanje artikala sa nedovoljnom količinom. Proverava se slobodna količina artikla, odnosno količina umanjena za rezervacije.

 

Podešavanje MP portala
REGISTRACIJA EKSTERNIH KORISNIKA – Da li je dozvoljeno da se posetioci samostalno registruju za MP portal (kao eksterni korisnici).

PRISTUP MP PORTALU BEZ AUTORIZACIJE – Da li eksterni korisnici mogu pristupati MP portalu bez registracije. Ako je ova opcija uključena onda je dostupna dodatna adresa portala „/public“ gde posetioci mogu bez registracije i logovanja na Portal razgledati artikle i kreirati narudžbenice. (demo: https://b2b.wings.rs/wings/public)

 

NAPOMENE

Keširanje podataka
Da bi pretraga i filtriranje artikala na Portalu bila brza i responzivna, na našem web serveru se keširaju podaci o artiklima (naziv, šifra, dodatni atributi, itd.). Kada se na Portalu unese neki termin za pretragu vrši se pretraga lokalne (keširane) baze artikala na serveru a potom se od programa (putam AQL) učitavaju podaci o pronađenim artiklima. Na ovaj način pretraga je brza jer se vrši u lokalu, na serveru, a podaci o količinama, rezervacijama i cenama dobijaju se u realnom vremenu direktno iz programa.

Ovo ažuriranje vrši se automatski jednom dnevno i u intervalu po podešavanjima u programu. Posledica ovoga je da izmene u artiklima (novi artikli, promene naziva, i sl.) na Portalu neće biti vidljive u periodu između dva ažuriranja. Učestalost ažuriranja je onda potrebno podesiti shodno frekvencijama izmena u programu, međutim količine i cene se uvek dobijaju u realnom vremenu te nije potrebno često ažuriranje da bi ovi podaci na Portalu bili tačni!

Keširanje konfiguracije
Osim keširanja (čuvanja) podataka o artiklima u lokalnoj bazi web servisa, AQL server učitava svoja podešavanja i konfiguraciju prilikom startovanja i čuva u svojoj radnoj memoriji. To znači da Portal i AQL rade po opcijama podešenim u trenutku startovanja i promene ovih podešavanja ne utiču na rad Portala u realnom vremenu. Da bi se učitale promene u konfiguraciji (Ostalo / Sistemske opcije / Podešavanje programa / AQL i Web Portal) neophodno je restartovati AQL servis. Ovo se automatski vrši jednom dnevno što za posledicu ima da su promene u opcijama Portala obično vidljive tek sutradan. Ukoliko je potrebno odmah promeniti način funckionisanja Portala onda je potrebno ručno izvršiti resetovanje AQL servisa i ažuriranje podataka.

Prikaz artikala kojih nema na stanju
Prethodno opisano ima veliki uticaj na prikaz artikala na Portalu kada je isključena opcija za prikaz artikala koji nema na stanju. Kad se ova opcija isključi AQL pri listanju artikala ne nudi artikle kojih nema na stanju. Pri tom, gleda se zbirno stanje količina u svim magacinima koji se nude za pregled. To znači da posetioci na Portalu neće videti artikle kojima je količina jednaka nuli, ali osim ovoga ova opcija utiče i na ažuriranje artikala. Odnosno, AQL će i u trenutku ažuriranja ignorisati artikle koji nema na stanju te se oni neće ažurirati na web server. S obzirom na to da se na Portalu prikazuju i pretražuju keširani artikli ovo može dovesti do konkretnog slučaja da artikal koji trenutno imate na stanju bude nedostupan na Portalu jer ga nije bilo na stanju u trenutku ažuriranja.