Quick Utility Service

Endret Thu, 28 Aug ved 2:47 PM

This article is not available in Swedish, view it in Norwegian

Før du begynner:

Denne artikkelen tar for seg installasjon, oppsett, og feilsøking av programmet Quick Utility Service (QUS). Det er en forutsetning at din Quick3 bruker har tilgang til Klientinnstillinger for å fullføre oppsettet av QUS (se artikkelen om Tilgangsstyring for mer informasjon).

Om du allerede har satt opp QUS på korrekt måte, og ønsker å begynne prosessen med å koble enheter opp mot Quick3, gå videre til disse artiklene:

Denne veiledningen er ganske omfattende og IT-teknisk av natur. Ikke nøl med å ta kontakt med Support om dere skulle trenge hjelp med oppsett av QUS hos deres bedrift.

Introduksjon

Quick Utility Service (QUS) er et Windows-program utviklet av Quick Systems, laget spesifikt for kommunikasjon mellom lokale PCer og Quick3. Programmet muliggjør bl.a. integrasjon av enheter som printere, bankterminaler, og kasseskuffer, og sikrer tilgang til disse enhetene uansett hvilken bruker som er innlogget i klienten eller hvilken arbeidsstasjon brukeren er logget på.

Dette programmet er ikke kompatibelt med MacOS!

Quick3 i seg selv er en webbasert plattform, som gjør at det også kan benyttes av Mac- eller Linux-brukere. QUS derimot, og de integrasjonene programmet tilbyr, er Windows-eksklusive. Det betyr at bedriften må ha minst én Windows-basert PC som er i daglig drift om de ønsker å benytte seg av funksjoner som:

Bankterminal: Kommunikasjon til og fra terminalen, fra f.eks. kassebildet.
Kasseskuff: Kommunikasjon med kasseskuff i henhold til Forskrift om krav til kassesystem.
Utskrifter: Hurtigutskrift av rapporter, etiketter, ZPL-filer osv., uten å måtte gå via nettleserens utskriftsdialog.
Dokumentopplasting: Automatisk opplasting av filer til f.eks. dokumentsenteret.

Installasjon

La oss laste ned og installere QUS! Pass på at brukeren din i Windows er lokal administrator på maskinen før du begynner.

Trykk på profilbildet øverst til høyre i Quick3.
Finn Nedlastinger.
Trykk på Quick Utility Service, og nedlastingen skal starte etter noen sekunder.
Installasjonsprogrammet lagres i nedlastingsmappen din. Om nettleseren din advarer deg om at filen kan være skadelig, overstyr meldingen og last ned allikevel, som vist i skjermbildene.
Trykk for å åpne filen fra nedlastingsmenyen, og installasjonen starter. Følg instruksene på skjermen for å fullføre installasjonen.

Tillatelser og unntak i Windows

QUS er et program som trenger konstant tilgang til Windows' funksjoner, uansett hvilken Windows bruker som er logget inn. Derfor må vi sørge for at programmet kan brukes av alle, og at programmets nettverkstrafikk ikke hindres av systemet. Denne prosessen kan være litt teknisk, så henvend deg til din lokale techspert eller vår Support om dere trenger hjelp med denne delen av oppsettet.

Om du allerede er IT-personell, les oppsummeringen vår under. Om ikke, hopp over oppsummeringen og følg vår detaljerte prosedyre i neste avsnitt.

Oppsummering for techsperten

Det må opprettes både inngående og utgående regler i Windows Brannmur som tillater alle koblinger på alle typer nettverk for TCP Port 6001, TCP Port 9670, og for programmet Bootstrapper.exe.
Det må gis alle NTFS tillatelser på Bootstrapper.exe for alle lokale brukere.
Registerføringen for Quick Utility Service må også tildeles alle tillatelser for alle lokale brukere.

Filtillatelser

Åpne Windows Filutforsker. Trykk på This PC / Denne PCen og gå til mappen C:\Program Files (x86)\Quick Systems\Quick Utility Service.
Finn filen "Bootstrapper". Hold inne Shift-knappen på tastaturet, høyreklikk på filen, og velg Properties / Egenskaper.
Trykk deg inn på Security / Sikkerhet fanen i Egenskaper-vinduet.
Trykk på Edit / Rediger.
I det nye vinduet som kommer opp, start med å trykke på den øverste gruppen/brukeren i listen.
I feltet nedenfor, pass på at alle tillatelser under Allow / Tillat er huket. Fortsett så med neste bruker/gruppe i Steg 5, helt til alle brukere og grupper i listen har alle tilgjengelige tillatelser på.
Trykk OK i begge vinduene for å lagre endringene dine. Du kan deretter lukke Filutforskeren.

Tillatelser i Register

Vi må også sørge for at alle innstillinger i QUS blir lagret uansett hvilken Windows bruker som gjør endringer i programmet. Derfor må tillatelser også settes opp i Registeret.

Åpne startmenyen og skriv "regedit" for å søke opp Registry Editor / Registerredigering, og start programmet.

Navigér til noden "Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Quick Utility Service".
Høyreklikk på mappen for Quick Utility Service i nodetreet og velg Permissions / Tillatelser.
Slik som fra Steg 5 i veiledningen for Filtillatelser, pass på at alle brukere og grupper i listen har alle mulige tillatelser for denne mappen. Trykk OK for å lagre endringene dine. Du kan deretter lukke Registerredigering.

Unntak i brannmur

Åpne Startmenyen, skriv "Windows Defender Firewall" eller "Windows Defender Brannmur", og åpne programmet.
Trykk på Advanced Settings / Avanserte Innstillinger på venstre side.
I brannmurvinduet, pass på at du er i Inbound Rules / Innkommende Regler seksjonen.
Trykk på New Rule / Ny Regel.
Den første regelen vi skal lage omhandler selve Bootstrapper programmet for å sikre at det har full nettverkstilgang hele tiden. Sørg for at regelen vi lager er en Programregel, og trykk Next / Neste.
Nå skal vi fortelle brannmuren hvilket program regelen skal gjelde for. Trykk på Browse og naviger deg frem til Bootstrapper-filen som vi fant tidligere i veiledningen for Filtillatelser. Velg filen, og trykk Open / Åpne. Dialogboksen skal nå være fylt inn med riktig bane til programmet som i skjermbildet nedenfor. Trykk Next / Neste.
Merk valget for Allow the connection / Tillat koblingen og trykk Next / Neste.
Sørg for at regelen gjelder for både domener, private og offentlige nettverk. Trykk Next / Neste.
Til slutt, navngi regelen du har opprettet. For denne anbefaler vi "QUS Bootstrapper". Trykk Finish / Fullfør.
Programregelen må nå gjenskapes som en Outgoing Rule / Utgående Regel. Gå tilbake til Steg 3 og opprett samme programregel for Bootstrapper som en Utgående Regel før du går videre.
Nå må det opprettes regler for både innkommende og utgående nettverkstrafikk på to spesifikke porter (6001 og 9670) som sikrer kommunikasjon for skrivere og bankterminaler. Vi starter fortsatt fra brannmurvinduet og passer på at vi er i Inbound Rules / Innkommende Regler før vi trykker New Rule / Ny Regel.
Vi passer på å opprette regelen som en Portregel. Trykk Next / Neste.
Sørg for at du velger TCP som porttype, og vi starter med portnummer 6001 som vår spesifikke lokale port. Tast dette inn, og trykk Next / Neste.
Gjenta nå innstillingene vi la inn i Steg 7 og Steg 8 for å tillate koblingen på domener, private, og offentlige nettverk.
For å ferdigstille portregelen må den navngis. Her anbefaler vi "QUS Port 6001" eller "QUS Port 9670" avhengig av hvilken port du lager regel for. Trykk Finish / Fullfør.
Følg veiledningen fra Steg 11 for å skape nøyaktig samme regel for Port 9670 før du går videre.
Begge portregelene må nå gjenskapes som Outgoing Rules / Utgående Regler, slik vi gjorde med programregelen i Steg 10. Til slutt skal vi altså sitte igjen med seks regler totalt; Innkommende og utgående regler for Bootstrapper, Port 6001, og Port 9670.

Vi er nå ferdige med å sette opp tillatelser og brannmurregler for QUS. Da kan vi gå videre til de grunnleggende innstillingene for programmet.

Grunnleggende innstillinger

For at QUS skal kunne snakke med din spesifikke Quick3 klient må vi generere noe som heter en Tilgangsnøkkel. Denne nøkkelen gir QUS tilgangene som trengs. Vi må også peke programmet til Quick3 instansen hvor din klient befinner seg.

Trykk på Profilikonet ditt øverst til høyre i Quick3 og velg Klientinnstillinger. Gå til fanen som heter Sikkerhet.
Hvis det ikke eksisterer en Utility Service nøkkel i Tilgangsnøkler tabellen allerede, generer en ny ved å trykke på Plusstegnet. Om dere allerede har en nøkkel som kan brukes, hopp frem til Steg 7.
I den nye raden i tabellen, trykk på pilen i Type-feltet.
Velg Utility Service som nøkkeltypen.
Sett en utløpsdato for nøkkelen. Vi anbefaler å sette utløpsdatoen meget langt frem i tid med mindre det er ønskelig for bedriften å rotere disse regelmessig.
Husk å lagre ved å trykke på disketten oppe i høyre hjørne, eller trykke CTRL+S på tastaturet.
Nå som tilgangsnøkkelen er opprettet skal vi putte denne inn i QUS. Trykk på Nøkkel-feltet i raden og trykk CTRL+C for å kopiere nøkkelen.
Åpne QUS om det ikke allerede kjører, og finn Settings fanen.
Lim inn tilgangsnøkkelen i Authentication Key feltet.
Gå til nettleseren din og kopier adressen til din Quick3 instans fra nettleserens adressefelt. Gå tilbake til QUS og lim inn adressen i Hostname feltet.
Skriv inn en beskrivelse i Description feltet som forteller hvor denne QUSen er installert. En god beskrivelse her gjør det lettere å finne riktige skrivere i Quick3 senere, spesielt om dere har mange.
Klikk på Apply, så Test Settings.
Om alt har blitt lagt inn riktig vil man få tildelt en Server ID.

Tilkobling og status

For å passe på at QUS er koblet opp og kjører slik det skal må vi gjøre oss kjent med Status fanen:

Velg Status fanen.
Mode (modus) bestemmer hvordan programmet skal kjøre på datamaskinen. Det finnes tre forskjellige alternativer:
- Manual: Standardmodusen ved førstegangsoppstart. Generelt ikke anbefalt siden programmet da må startes manuelt hver gang en bruker logger inn i Windows.
- Automatic: Anbefalt modus. QUS starter opp samtidig med brukerens innlogging i Windows.
- Service: Om QUS skal kjøres i bakgrunnen på en maskin som sjelden er i bruk, og som kanskje ikke engang er koblet til skjerm og tastatur, anbefaler vi Service modus. Dette krever litt videre konfigurasjon av Windows-tjenester som vi tar for oss i neste seksjon.
Status feltet forteller om statusen på tilkoblingen mellom QUS og din Quick3 instans. Det er tre forskjellige statuser:
- OK: Alt i orden, ingen handling nødvendig.
- NotFound: Sjekk at adressen til din Quick3 instans er riktig under Settings.
- Unauthorized: Sjekk at tilgangsnøkkelen din under Settings er korrekt, og at den ikke er deaktivert eller utgått.
Service Status forteller statusen til QUS sin Windows-tjeneste (om denne er i bruk via Service modusen). Om Service modus er aktiv anbefaler vi å trykke på Open Services, finne Quick Utility Service i listen, høyreklikke, og velge Properties / Egenskaper. Følg anvisningen på bildet nedenfor for å passe på at tjenesten kjører og starter automatisk ved oppstart av PCen:
Update knappen vil oppdatere programmet om en oppdatering er tilgjengelig.

Dokument-opplasting

Dokument-opplasting vil automatisk holde øye med en mappe på maskinen din, og laste opp filer fra denne mappen til Quick3 for behandling. I første omgang vil dette gjelde bilag som skal sendes inn i Dokumentsenteret.

Åpne QUS og finn Document Upload fanen.
Klikk på Mappen med plusstegnet. Velg så mappen du vil at programmet skal følge med på. Pass på at den valgte mappen enten er tom, eller kun inneholder filer du vil laste opp til Quick3
Om dere ønsker at programmet kun skal behandle visse filtyper i denne mappen, trykk på blyanten i banelisten. Her kan man skrive inn f.eks. "*.PDF" i Filter feltet. Om det ikke legges inn et filter vil programmet behandle alle filtyper som legges i mappen. Den eneste støttede dokumenttypen per i dag er Voucher / Bilag, men dette vil utvides etterhvert.
Knappen Trigger Upload vil se etter filer i alle listede mapper og laste de opp umiddelbart.

MERK: Opplastede filer vil automatisk flyttes og arkiveres i en undermappe i de mappene du har angitt.

Brukerkontokontroll (UAC) i Windows

Når QUS (Bootstrapper.exe) er installert og man skal åpne programmet vil man få en forespørsel fra Windows Brukerkontokontroll om å tillate at appen skal kunne gjøre endringer på enheten. Denne må man trykke Ja på for at QUS skal starte. Siden QUS startes automatisk ved pålogging vil denne forespørselen vil komme opp av seg selv hver gang man starter Windows.

Logg

Loggen vil inneholde informasjon om hva programmet gjør, og hvilke feilmeldinger som eventuelt dukker opp. I eksempelet under har det blitt lagt til en mappe for dokument-opplasting som ikke lenger finnes.