Guide for setting up the account and users
1. Introduktion
AFAS version 7 integrerer med Transsmart APIv2. Tidligere versioner integrerede med APIv1.
Når der udveksles beskeder med APIv2, skal AFAS autentificere sig. Dette gøres ved hjælp af brugernavn og adgangskode for det, der i dette dokument kaldes integration user. Disse legitimationsoplysninger skal konfigureres i AFAS og bruges som standard til alle interaktioner med Transsmart-platformen.
Udskrivning sker ved at sende en udskriftsanmodning til Transsmart. Platformen forbereder derefter udskriftsjobbet og sender det til SmartPrint-klienten, der er installeret i kundens netværk. SmartPrint sender det derefter til den korrekte printer via QZ Tray.
2. Standardopsætning
I tilfælde, hvor udskrivning kun kræver én SmartPrint og én printer, er det tilstrækkeligt kun at konfigurere udskriftsdetaljerne for integration user. Når SmartPrint kører, skal du gå til printing-tabben for den bruger, vælge den tilsvarende SmartPrint-forbindelse og derefter konfigurere den korrekte ZPL/PDF-printer.
Den konfigurerede SmartPrint-forbindelse og de tilknyttede printere bruges altid, uanset hvilken faktisk AFAS-bruger der udløser udskrivningshandlingen.
3. Flere printere
I nogle tilfælde kan det være nødvendigt at udskrive på flere printere og/eller at udskrive ved hjælp af flere SmartPrint clients, afhængigt af hvilken AFAS-bruger der udløser udskrivningshandlingen. I sådanne tilfælde er det nødvendigt at konfigurere ekstra brugere under kontoen.
Vi har aftalt en entydig måde at identificere den korrekte printer-settings, der skal bruges til behandling af udskriftsjobbet.
Udskriftsanmodningen fra AFAS vil indeholde en specifik parameter for det brugernavn, hvis printer-settings skal bruges. Brugernavnet i den anmodning vil altid være formateret som nedenfor:
[AFAS bruger-ID]@[AFAS kontonummer], for eksempel stevenluyckx@31010
Transsmart APIv2 vil tage denne parameter i betragtning og handle tilsvarende:
a. brugernavn fundet: udskriv med de settings, der er konfigureret for den bruger
b. brugernavn fundet, har ingen udskrifts-settings: returner en fejl
c. brugernavn ikke fundet: udskriv med settings for integration user-kontoen (fallback)
d. brugernavn tomt: udskriv med settings for integration user-kontoen (fallback)
4. Kunde-onboardingproces
Alle kunder med én enkelt printer udskriver altid med printer-settings for integration user. De behøver ikke gøre mere.
Kunder, der arbejder i et miljø med flere printere, skal gøre to ting:
1. som ved en standardopsætning, konfigurere printer-settings på integration user
2. for hver AFAS-bruger, der vil udskrive til en ikke-standardprinter, skal der oprettes en tilsvarende brugerkonto i MyTranssmart med de alternative printer-settings
Brugernavnet skal formateres som [AFAS user ID]@[AFAS account number]
5. Eksempelbrugsscenarie
Antag, at kunden har AFAS-kontonummeret "12345".
Antag, at printer X er knyttet til SmartPrint1, og printer Y er knyttet til SmartPrint2.
AFAS-brugerliste
userA
userB
userC
Transsmart-brugerliste
integration user-konto konfigureret til at udskrive med SmartPrint1 på printer X
userC@12345 konfigureret til at udskrive med SmartPrint2 på printer Y
Eksempelanmodninger
1. for userA
udskriftsbrugerparameter userA@12345
Transsmart finder ikke en matchende brugerkonto, udskrivning udføres med settings for integration user-kontoen --) udskriftsjobbet bliver sendt til printer X via SmartPrint1
2. for userB
udskriftsbrugerparameter userB@12345 idem dito
3. for userC
udskriftsbruger-parameteren userC@12345 Transsmart finder en matchende bruger, og brugeren har printerindstillinger konfigureret, så udskrivning udføres med disse settings --) udskriftsjobbet vil blive sendt til printer Y via SmartPrint2