Guide for setting up the account and users
1. Introduksjon
AFAS versjon 7 integrerer med Transsmart APIv2. Tidligere versjoner integrerte med APIv1.
Ved utveksling av meldinger med APIv2 må AFAS autentisere seg. Dette gjøres ved å bruke brukernavnet og passordet til det som i dette dokumentet vil bli omtalt som integration user. Disse påloggingsopplysningene må konfigureres i AFAS og brukes som standard for all kommunikasjon med Transsmart-plattformen.
Utskrift gjøres ved å sende en utskriftsforespørsel til Transsmart. Plattformen forbereder deretter utskriftsjobben og sender den til SmartPrint-klienten installert i kundens nettverk. SmartPrint sender den så videre til riktig skriver via QZ Tray.
2. Standardoppsett
I tilfeller der utskrift bare krever én SmartPrint og én skriver, er det tilstrekkelig å konfigurere utskriftsdetaljene kun for integration user. Når SmartPrint kjører, går du til printing tab for den brukeren og velger den tilhørende SmartPrint-tilkoblingen og konfigurerer riktig ZPL/PDF-skriver.
Den konfigurerte SmartPrint-tilkoblingen og skriverne brukes alltid, uavhengig av hvilken faktisk AFAS-bruker som utløser utskriftshandlingen.
3. Flere skrivere
I noen tilfeller kan det være nødvendig å skrive ut på flere skrivere og/eller å skrive ut ved hjelp av flere SmartPrint clients, avhengig av hvilken AFAS-bruker som utløser utskriftshandlingen. I slike tilfeller er det nødvendig å konfigurere flere brukere under kontoen.
Vi har blitt enige om en entydig måte å identifisere riktig skriver-settings som skal brukes til å behandle utskriftsjobben.
Utskriftsforespørselen fra AFAS vil inneholde en bestemt parameter for brukernavnet hvis skriver-settings skal brukes. Brukernavnet i den forespørselen vil alltid ha formatet nedenfor:
[AFAS bruker-ID]@[AFAS kontonummer], for eksempel stevenluyckx@31010
Transsmart APIv2 vil ta denne parameteren i betraktning og handle tilsvarende:
a. brukernavn funnet: skriver ut med settings konfigurert for den brukeren
b. brukernavn funnet, har ingen utskrifts-settings : returnerer en feil
c. brukernavn ikke funnet: skriver ut med settings til integration user-kontoen (fallback)
d. brukernavn tomt: skriver ut med settings til integration user-kontoen (fallback)
4. Customer onboarding process
Alle kunder med én enkelt skriver skriver alltid ut med skriver-settings til integration user. De trenger ikke noe mer.
Kunder som arbeider med et miljø med flere skrivere må gjøre 2 ting:
1. som ved en standardoppsett, konfigurere skriver-settings på integration user
2. for hver AFAS-bruker som ønsker å skrive ut til en ikke-standard skriver, må det opprettes en tilsvarende brukerkonto i MyTranssmart med alternativ skriver-settings
Brukernavnet må formateres som [AFAS user ID]@[AFAS account number]
5. Sample use case
Anta at kunden har AFAS-kontonummer «12345».
Anta at skriver X er koblet til SmartPrint1 og skriver Y er koblet til SmartPrint2.
AFAS user list
userA
userB
userC
Transsmart user list
integration user account konfigurert til å skrive ut med SmartPrint1 på skriver X
userC@12345 konfigurert til å skrive ut med SmartPrint2 på skriver Y
Sample requests
1. for userA
printing user parameter userA@12345
Transsmart finner ingen samsvarende brukerkonto, utskrift utføres med settings til integration user --) utskriftsjobben vil bli sendt til skriver X via SmartPrint1
2. for userB
printing user parameter userB@12345 idem dito
3. for userC
utskrift brukerparameter userC@12345 Transsmart finner en samsvarende bruker og brukeren har skriverinnstillinger konfigurert, utskrift utføres med disse settings --) utskriftsjobben vil bli sendt til skriver Y via SmartPrint2