CSV import av ansatte til onVisit Følg
onVisit CSV import har støtte for følgende felter. Se beskrivelse for hvert felt:
active: Angir om brukeren er aktiv i onVisit. Ikke obligatorisk felt. Importen antar at brukeren skal være aktiv. Deaktiver ved å sette til «0» eller «false»
department: Brukerens avdeling, vises i gjesteregistreringen. Ikke obligatorisk felt
domain: Obligatorisk felt
email: Brukerens epost adresse. Obligatorisk felt
externalid: Eventuell ID i datagrunnlaget et eksporteres fra. Ikke obligatorisk
first name: Brukerens fornavn, obligatorisk felt
last name: Brukerens etternavn, obligatorisk felt
login: Obligatorisk felt
mobile: Brukerens mobilnummer, obligatorisk felt
parent companyid: ID i onVisit til firma vedkommende er ansatt i. Ved enfirmaløsning er verdien 1. Obligatorisk felt
phone: Brukerens fast telefonnummer. Ikke obligatorisk felt
userprincipalname: Benyttes i forbindelse med Azure AD SSO
Rekkefølgen på kolonnene spiller ingen rolle. Headingene i CSV filen kan ha en hvilken som helst blanding av store og små bokstaver.
CSV-filen må inneholde like mange headinger som kolonner i datalinjene, minimum like mange som det er antall obligatoriske felt, og headingene må naturligvis ligge i samme rekkefølge som datakolonnene.
Feltene «Login» og «Domain» brukes for å sjekke om den ansatte finnes fra før i onVisit, hvilket betyr at de må inneholde data som unikt identifiserer den ansatte, selv om feltene forøvrig ikke har noen praktisk funksjon i onVisit Online. Enhver endring i disse feltene ved en senere synkronisering vil medføre at den ansatte importeres som en ny ansatt i onVisit.
I config-filen til synkroniseringsprogrammet kan man sette noen parametere før kjøring.
<!-- The encoding of the csv file -->
<add key="CSVEncoding" value="iso-8859-1" />
<!-- SyncronizationCSVFile value: The full path and filename of the csv or unicode file-->
<add key="SyncronizationCSVFile" value="C:\_Kunder\AkerSolutions\importSource.txt" />
<!-- CSVDelimiter values: tab=tab | semicolon=; | comma=, -->
<add key="CSVDelimiter" value="," />
<add key="HasFieldsEnclosedInQuotes" value="true" />
<add key="TrimWhiteSpace" value="true" />
<add key="DryRun" value="false" />
De fleste bør være selvforklarende eller tilstrekkelig forklart i kommentarene over parameteret. Det siste, «DryRun», kan settes til «True» for å teste importen. Når DryRun = True, importeres ingenting til onVisit, men CSV-filen leses inn og alle feltene skrives ut igjen til en trace-fil (som angitt i seksjonen «system.diagnostics» i config-filen).
NB! DryRun stopper ikke import av bilder av de ansatte, så bildeimporten bør skrus av til man er klar til å importere ansatte. Se under for detaljer.
Synkroniseringen kjøres som en jobb på en maskin som har kontakt med onVisit Online, normalt en gang pr. døgn. Artikkelen på linken under beskriver virkemåten på onVisit ansatt sync. Merk at den beskriver synkronisering med AD, men virkemåten er den samme mot CSV.
Import av bilder av de ansatte er også tilgjengelig for CSV-import. Bildene må ligge i en mappe som kan leses av importprogrammet, og filnavnene må være som beskrevet i avsnittet «Adding external employee photos» under linken over.
For å importere bilder, settes disse parameterne i config-fila:
syncSourceIncludeImages = yes
ImageSource = folder
UserImagesPath = fullstendig mappesti til mappen med bildefiler