Pretraga klijenata

Kratki sažetak

Pretraga klijenata nalazi se na stranici Poslovni klijenti i šalje pojam prema /clients nakon debouncea od 200 ms. Backend pretražuje naziv, ime i prezime vlasnika, OIB i kombinaciju imena i prezimena vlasnika.

Najvažnije koristi:

• Brzo pronalazi klijenta po nazivu ili OIB-u.
• Smanjuje broj ručnih klikova kroz paginaciju.
• Backend rezultate dodatno sortira po podudaranju s početkom naziva.

Kada koristiti ovu značajku

Koristite pretragu klijenata kada želite:

• pronaći klijenta po OIB-u,
• pronaći klijenta po punom ili djelomičnom nazivu,
• pronaći klijenta po imenu ili prezimenu vlasnika.

Ova značajka je posebno korisna za:

• računovođe s velikim brojem klijenata,
• administratore koji provjeravaju postoji li duplikat,
• operativne korisnike koji znaju samo dio naziva.

Prije nego što počnete

Prije korištenja provjerite sljedeće:

• otvorena je stranica Poslovni klijenti,
• imate pristup klijentima koje tražite,
• pojam pretrage nije duži od backend ograničenja.

Brzi početak

U ovom primjeru pokazujemo kako pronaći klijenta po OIB-u.

1. Otvorite Poslovni klijenti.
2. Kliknite u polje pretrage.
3. Upišite OIB ili dio OIB-a.
4. Pričekajte kratko da se pretraga primijeni.
5. Provjerite rezultate u tablici.
6. Kliknite Otvori za željenog klijenta.

Nakon toga trebali biste vidjeti: filtrirani popis klijenata.

Detaljne upute

Korak 1: Upišite pojam

Polje LiberoSearchInput ažurira lokalno stanje search, a useDebounce šalje vrijednost prema API-ju nakon 200 ms.

Primjer:

Pretraga: 12345678901

Alt tekst: Polje za pretragu klijenata s unesenim OIB-om.

Korak 2: Pregledajte rezultate

Backend koristi ILIKE s full match obrascem nad nazivom, vlasnikom i OIB-om. Ako postoji pojam, dodatno sortira po prefiksu naziva i nazivu.

Alt tekst: Tablica klijenata filtrirana prema pojmu pretrage.

Korak 3: Očistite pretragu

Obrišite pojam iz polja pretrage kako biste ponovno vidjeli širi popis. Ako su aktivni i drugi filtri, očistite ih odvojeno.

Primjer iz prakse

Zamislimo da administrator prije dodavanja klijenta želi provjeriti postoji li već klijent s istim OIB-om.

Scenarij:

• Korisnik: administrator
• Cilj: spriječiti duplikat klijenta
• Problem: naziv firme može biti upisan drugačije
• Rješenje: pretražuje OIB jer je jedinstveniji identifikator

Rezultat:

Administrator može vidjeti postoji li klijent prije pokretanja čarobnjaka za dodavanje.

Showcase: kako značajka izgleda u aplikaciji

Pregled zaslona

Što korisnik vidi:

• polje pretrage,
• rezultate u tablici,
• paginaciju za preostale rezultate.

Primjer konfiguracije

Preporučena konfiguracija za početnike:

Najčešće radnje

Kako tražiti po nazivu

1. Upišite dio naziva firme.
2. Pričekajte rezultate.
3. Otvorite odgovarajući redak.

Kako tražiti po vlasniku

1. Upišite ime ili prezime vlasnika.
2. Pregledajte dobivene klijente.
3. Potvrdite OIB prije otvaranja.

Kako tražiti po OIB-u

1. Upišite OIB ili dio OIB-a.
2. Provjerite stupac OIB.
3. Otvorite klijenta ili ga dodajte ako ne postoji.

Dobre prakse

Za najbolje rezultate:

• za provjeru duplikata koristite OIB,
• za nepoznat točan naziv koristite kraći dio naziva,
• očistite pretragu prije rada s cijelom listom,
• kombinirajte pretragu s tipom firme samo kada je potrebno.

Izbjegavajte:

• upis vrlo dugih pojmova,
• pretragu po podacima koji nisu podržani u backend kodu,
• zaključivanje da klijent ne postoji dok je aktivan filter tipa firme.

Napredne mogućnosti

Ako trebate više kontrole, možete koristiti:

Prefix ordering

Kada postoji pretraga, backend dodaje OrderByPrefix("name", search) i zatim sortira po nazivu.

Organizacijski pristup

Rezultati se filtriraju po organizaciji i dozvolama korisnika, pa korisnik ne mora vidjeti sve klijente.

Kombiniranje s drugim filterima

Pretraga se šalje zajedno s companyType, paginacijom, sortiranjem i smjerom sortiranja.

Dozvole i pristup

Za korištenje ove značajke potrebne su sljedeće dozvole:

Ako ne vidite ovu značajku, moguće je da:

• nemate odgovarajuću dozvolu,
• značajka nije uključena u vašem paketu,
• administrator je ograničio pristup,
• integracija ili modul nije aktiviran.

Ograničenja

Trenutna ograničenja značajke:

• pojam pretrage validira se do 20 znakova,
• nema dokaza da se pretražuju email, IBAN ili kontakti,
• nema posebno dokumentiranog praznog stanja osim prazne tablice.

Rješavanje problema

Česta pitanja

Pretražuje li se OIB?

Da. Backend List upit uključuje oib ILIKE @term.

Pretražuje li se adresa?

Ne prema pregledanom backend kodu za listu klijenata. Za adresu koristite vizualni pregled tablice nakon suženja po nazivu ili OIB-u.

Zašto se stranica ne osvježava na svaki znak odmah?

Frontend koristi debounce od 200 ms kako ne bi slao zahtjev za svaku tipku bez kratkog čekanja.

Povezane značajke

• Poslovni klijenti
• Popis klijenata
• Filter tipa firme

Sljedeći korak

Ako tek počinjete, preporučujemo da prvo napravite sljedeće:

1. Pretražite klijenta po OIB-u.
2. Očistite pretragu.
3. Isprobajte pretragu po nazivu.

Nakon toga možete prijeći na: Sortiranje klijenata.