Kontekst dokumenata na čekanju
Kratki sažetak
Kontekst dokumenata na čekanju je React provider oko radnog prostora klijenta koji omogućuje globalnim obavijestima da otvore URA i IRA drawere. Podržava fokusiranje dokumenta prema broju dokumenta i prosljeđuje clientID i valjani yearID.
Najvažnije koristi:
- Obavijest može otvoriti točan drawer bez ručnog ulaska u knjigu.
- Klik na pojedini dokument prenosi broj dokumenta za fokus.
- Drawer se zatvara i čisti fokusirani broj dokumenta.
Kada koristiti ovu značajku
Koristite kontekst dokumenata na čekanju kada želite:
- otvoriti neobrađeni ulazni račun iz zvona obavijesti,
- otvoriti neobrađeni izlazni račun iz zvona obavijesti,
- pregledati sve pending dokumente za odabranog klijenta i godinu.
Ova značajka je posebno korisna za:
- računovođe koje obrađuju e-račune,
- korisnike koji prate dolazne i odlazne dokumente iz integracija,
- administratore koji provjeravaju status uvoza.
Prije nego što počnete
Prije korištenja provjerite sljedeće:
- otvoren je radni prostor klijenta,
PendingDocumentsProviderobuhvaća sadržaj,- odabrana godina je veća od nule ako želite filtrirati po godini.
Napomena: Ako yearID nije valjan, provider prosljeđuje undefined, pa drawer mora sam obraditi stanje bez godine.
Brzi početak
U ovom primjeru pokazujemo kako otvoriti pending URA dokument iz obavijesti.
- Otvorite radni prostor klijenta.
- Provjerite odabranu godinu.
- Kliknite Zvono obavijesti.
- Kliknite stavku iz grupe Ulazni računi.
- Provider otvara
PendingDocumentsDrawer. - Drawer fokusira dokument prema broju dokumenta ako je proslijeđen.
Nakon toga trebali biste vidjeti: drawer ulaznih dokumenata na čekanju.
Detaljne upute
Korak 1: Otvorite drawer iz obavijesti
useClientNotifications poziva openPendingDocuments ili openPendingOutgoingDocuments iz konteksta. Funkcija sprema opcionalni documentNumber i otvara odgovarajući disclosure.
Primjer:
openPendingDocuments({ documentNumber: "R-123/2026" })Snimka zaslona
klik na URA stavku u zvonu obavijesti
Alt tekst: Odabir ulaznog računa iz zvona obavijesti koji otvara drawer dokumenata na čekanju.
Korak 2: Pregledajte dokumente
Za ulazne dokumente koristi se PendingDocumentsDrawer, a za izlazne PendingOutgoingDocumentsDrawer. Oba dobivaju clientID, opcionalni yearID i opcionalni focusDocumentNumber.
Snimka zaslona
drawer dokumenata na čekanju s fokusiranim brojem dokumenta
Alt tekst: Drawer s popisom dokumenata na čekanju i fokusiranim odabranim dokumentom.
Korak 3: Zatvorite drawer
Zatvaranje drawera poziva internu funkciju koja zatvara disclosure i briše fokusirani broj dokumenta.
Primjer iz prakse
Zamislimo da računovođa vidi obavijest za novi izlazni račun.
Scenarij:
- Korisnik: računovođa
- Cilj: otvoriti točno taj izlazni dokument
- Problem: ručno traženje po knjizi troši vrijeme
- Rješenje: klik na obavijest prenosi broj dokumenta u pending outgoing drawer
Rezultat:
Korisnik dolazi iz obavijesti izravno do mjesta obrade dokumenta i smanjuje ručno pretraživanje.
Showcase: kako značajka izgleda u aplikaciji
Pregled zaslona
Snimka zaslona
otvoren pending URA drawer iz globalnog shell-a
Što korisnik vidi:
- bočni drawer preko radnog prostora,
- dokumente za odabranog klijenta,
- fokus na dokument ako je otvoren iz obavijesti.
Primjer konfiguracije
Snimka zaslona
pending IRA drawer otvoren iz zvona
Preporučena konfiguracija za početnike:
| Postavka | Preporučena vrijednost | Zašto je korisna |
|---|---|---|
clientID | Trenutni klijent | Drawer mora znati kontekst klijenta |
yearID | Odabrana godina | Filtrira dokumente na poslovnu godinu |
| Fokus dokumenta | Broj iz obavijesti | Vodi korisnika na odabranu stavku |
Najčešće radnje
Kako otvoriti ulazne dokumente na čekanju
- Otvorite zvono.
- Kliknite URA stavku ili Pregledaj sve u grupi Ulazni računi.
- Pregledajte drawer.
Kako otvoriti izlazne dokumente na čekanju
- Otvorite zvono.
- Kliknite IRA stavku ili Pregledaj sve u grupi Izlazni računi.
- Pregledajte drawer.
Kako zatvoriti drawer
- Kliknite akciju zatvaranja u draweru.
- Provider zatvara prikaz.
- Fokusirani broj dokumenta se briše.
Dobre prakse
Za najbolje rezultate:
- otvarajte dokumente iz obavijesti kada želite kontekst fokusiranog dokumenta,
- provjerite godinu prije otvaranja drawera,
- koristite Pregledaj sve za grupni rad,
- zatvorite drawer nakon obrade da se fokus očisti.
Izbjegavajte:
- otvaranje drawera bez odabrane godine ako očekujete godišnji filter,
- ručno traženje dokumenta kada dolazite iz obavijesti,
- pretpostavku da provider sam knjiži dokument.
Napredne mogućnosti
Ako trebate više kontrole, možete koristiti:
Fokuso dokumenta
Provider podržava documentNumber kao opciju otvaranja. Točan način fokusiranja unutar drawera ovisi o implementaciji drawera.
Odvojeni ulazni i izlazni tok
Ulazni i izlazni dokumenti imaju zasebne disclosure kontrole i zasebno stanje fokusiranog broja.
Fallback hook
usePendingDocuments vraća no-op funkcije ako se koristi izvan providera, čime se izbjegava rušenje komponenti.
Dozvole i pristup
Za korištenje ove značajke potrebne su sljedeće dozvole:
| Radnja | Potrebna uloga/dozvola |
|---|---|
| Otvaranje pending URA drawera | Pristup klijentu i URA pending podacima |
| Otvaranje pending IRA drawera | Pristup klijentu i IRA pending podacima |
| Pregled dokumenta | [POTREBNO DOPUNITI] |
| Izvoz / dijeljenje | [POTREBNO DOPUNITI] |
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:
- provider samo otvara drawere; ne definira poslovna pravila obrade,
- bez valjanog
yearIDdrawer dobivaundefined, - detalji uvoza, pregleda i knjiženja nalaze se u URA/IRA modulima.
Rješavanje problema
| Problem | Mogući uzrok | Rješenje |
|---|---|---|
| Drawer se ne otvara | Provider nije prisutan ili obavijest nema handler | Osvježite radni prostor klijenta |
| Dokument nije fokusiran | Broj dokumenta nije proslijeđen ili nije pronađen | Koristite pretragu u draweru |
| Prikaz ne filtrira po godini | yearID nije veći od nule | Odaberite obračunsku godinu |
Česta pitanja
Radi li kontekst i za URA i za IRA dokumente?
Da. Provider ima zasebne funkcije za ulazne i izlazne pending dokumente.
Što se događa kada zatvorim drawer?
Disclosure se zatvara, a spremljeni broj dokumenta za fokus se briše kako sljedeće otvaranje ne bi zadržalo stari fokus.
Može li se kontekst koristiti izvan radnog prostora klijenta?
Hook vraća no-op funkcije ako provider nije prisutan. Funkcionalno otvaranje drawera očekuje provider unutar ClientLayout.
Povezane značajke
Sljedeći korak
Ako tek počinjete, preporučujemo da prvo napravite sljedeće:
- Otvorite zvono obavijesti.
- Kliknite URA ili IRA stavku.
- Zatvorite drawer i provjerite da se fokus očistio.
Nakon toga možete prijeći na: Zvono obavijesti.