1.0 Generelt
Det er muligt at importere dimensioner (Firma, Afdeling og Gruppe) til LessorWorkforce via en web service. For at importere via en web service, skal data leveres via en .csv fil. Filen kan fx leveres via værktøjet Postman eller lignende.
2.0 Forudsætninger
For at kunne hente data ud af LessorWorkforce, skal dette aktiveres på databasen.
Skriv til workforce.support@lessor.dk for at aktivere/tillade dette. Anmodning skal komme fra en administrator.
3.0 Opsætning
Data leveres ved hjælp af standard url: https://workforce.lessor.dk/sync/import.php/?
Data kan sendes som POST eller Basic access authentication.
Tilføj følgende til URL, for at hente de ønskede data:
| Argumentnavn | Beskrivelse | Kravfelt | Kommentar |
| id | Database id | Ja | Databasens id oplyses ved kontakt til workforce.support@lessor.dk |
| user | Kan sendes som POST eller Basic access authentication. | Ja | Brugernavn på administrator i LessorWorkforce. Vi anbefaler at oprette en bruger(admin), som kun benyttes til Web Services. Foretag første log ind med denne bruger for at ændre adgangskoden og brugeren kan efterfølgende deaktiveres. Brugeren vil stadig kunne kalde Web Servicen. |
| password | Kan sendes som POST eller Basic access authentication. | Ja | Adgangskoden der er blevet oprettet efter første log ind. |
| importType | Group, department eller company
| Ja | |
| csvUpdate | 1 = opdateres
| Ja | Skal eksisterende dimension, hvis den allerede eksisterer, opdateres. |
Eksempel på url:
https://workforce.lessor.dk/sync/import.php/?id=xxx&importType=group&csvUpdate=1
4.0 Opbygning af fil
For at filen kan indlæses, skal den være af formatet csv, hvori alle felter adskilles med semikolon (;).
Hvis en række foranstilles med værdien # indlæses denne ikke (Import af bemandingsbehov er undtaget; her må der ikke være en række til fx overskrifter). Kan benyttes hvis overskrifterne medtages i filen.
Det anbefales at bruge import-skabelonerne, som findes under Dagligt, Dokumenter, Lessor-Workforce og mappe: 07-Importskabeloner.
Benyttes import-skabelonerne ikke, skal alle, ikke udfyldte felter, markeres med ””, da felterne ellers vil blive indlæst forkert.
Ønsker du at slette data i et felt, i forbindelse med import, kan du i feltet skrive ”_”. Altså en underscore.
4.1 Firma
| Feltnavn | Kolonne | Længde | Type | Værdier | Bemærkning |
| Firmanavn | A | 50 | A/N | Obligatorisk felt | |
| Adresse | B | 100 | A/N | ||
| Postnr. | C | 10 | A/N | Postnummeret skal findes i postnummertabellen, hvis by skal udfyldes automatisk | |
| By | D | 50 | A/N | Udfyldes automatisk | |
| Landekode | E | A | DK, Danmark, Denmark GB, Storbritannien, Great Britain NO, Norge, Norway SE, Sverige, Sweden DE, Tyskland, Germany | Hvis feltet ikke er udfyldt, eller er forkert udfyldt, udfyldes med Danmark | |
| Firmakode | F | 20 | A/N | ||
| Medarbejder præfix | G | 50 | A/N | Det præfix der sættes, hvis der benyttes autogenereret medarbejdernummer, kan oprettes automatisk ved import |
4.2 Afdelinger
| Feltnavn | Kolonne | Længde | Type | Værdier | Bemærkning |
| Afdelingsnavn | A | 50 | A/N | Obligatorisk felt | |
| Firmanavn | B | 50 | A/N | Obligatorisk felt, hvis du har aktiveret brugen af firma, og valideres op imod det opsatte firma på afdelingen | |
| Adresse | C | 100 | A/N | ||
| Postnr. | D | 10 | A/N | Postnummeret skal findes i postnummer-tabellen, hvis by skal udfyldes automatisk | |
| By | E | 20 | A | ||
| Landekode | F | A | DK, Danmark, Denmark GB, Storbritannien, Great Britain NO, Norge, Norway SE, Sverige, Sweden DE, Tyskland, Germany | Hvis feltet ikke er udfyldt, eller forkert udfyldt, udfyldes med Danmark | |
| Afdelingskode | G | 20 | A/N | ||
| Medarbejder præfix | H | 50 | A/N | Det præfix der sættes, hvis der benyttes autogenereret medarbejdernummer, kan oprettes automatisk ved import |
4.3 Grupper
| Feltnavn | Kolonne | Længde | Type | Værdier | Bemærkning | ||||
| Gruppenavn | A | 50 | A/N | Obligatorisk felt | |||||
| Afdelingsnavn | B | 50 | A/N | Obligatorisk felt | |||||
| Firmanavn | C | 50 | A/N | Obligatorisk felt, hvis du har aktiveret brugen af firma, og valideres op imod det opsatte firma på afdelingen | |||||
| Løngruppe | D | 50 | A/N | ||||||
| Fast løngruppe | E | 3 | A/N |
| |||||
| Registreringsgruppe | F | 50 | A/N | ||||||
| Lønart | G | 20 | A/N | ||||||
| Gennemsnits timeløn | H | 6 | N | Inkluderet decimaltegn (123,45) | |||||
| Timer tælles med i normtiden | I | 3 | A/N |
| |||||
| Timernes reelle timenorm | J | 5 | N | Inkluderet decimaltegn (123,45) | |||||
| Gruppefarve | K | 7 | A/N | #rrggbb | Der kan oprettes flere farver end de farver, som kan vælges i oprettelse af grupper. Der benyttes Hextal for at angive farven. Farvekombinationer kan findes på internettet. Eks. denne side: http://www.color-hex.com | ||||
| Kompetence | L | 50 | A/N | ||||||
| Gruppekode | M | 50 | A/N | ||||||