1.0 Beskrivelse
Det er muligt at trække data ud af Lessor-Workforce, via API/Web Service. Servicen skal hentes af et 3. parts produkt; Lessor-Workforce kan ikke sende/initiere data. Data leveres ud fra valgt selektering og skal efterfølgende behandles i et 3. parts program.
Data kan fx hente ved:
- Indtastning af URL i browservindue
- Via Excel
- Via ex programmet Postman
2.0 Forudsætninger
For at kunne hente data ud af Lessor-Workforce, 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 hentes ved hjælp af standard URL: https://workforce.lessor.dk/sync/exportHournorm.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 Lessor- Workforce. 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. |
| from | yyyy-mm-dd
| Ja | |
| to | yyyy-mm-dd
| Ja | |
| company | Der kan begrænses på firma. Denne er kun anvendelig såfremt flere afdelinger har samme navn. Company kan ikke benyttes alene. | Nej | Som default medtages vagter som ”hvor”. Alle planlagte vagter medtages i nævnte firma. Der kan tilføjes flere. |
| department | Der kan begrænses på afdeling. Findes der flere afdelinger med samme navn, skal der også benyttes company. | Nej | Som default medtages vagter som ”hvor”. Alle planlagte vagter medtages i nævnte afdeling. Der kan tilføjes flere ved at adskille afdelingsnavne med komma (uden mellemrum) |
| groups | Der kan begrænses på gruppe | Nej | Som default medtages vagter som ”hvor”. Alle planlagte vagter medtages i nævnte gruppe. Der kan tilføjes flere ved at adskille afdelingsnavne med komma (uden mellemrum) |
| relationship | primary = Viser medarbejdere med valgte dimension som sin primære secondary = Viser medarbejdere med valgte dimension som sin sekundære | Nej | primary og secondary kan ikke begge tilføjes i samme URL. Tilføjes ingen vil både primary og secondary medtages. Dette er default |
| withDeactived | 1 = Medtager deaktiverede medarbejdere | Nej | Default medtages kun aktive medarbejdere |
Eksempel på opbygning af URL:
https://workforce.lessor.dk/sync/exportHournorm.php/?id=xxx&from=20180616&to=20180617
Ekstra parametre tilføjes ved at skrive &group=xxxx
3.1 Levering af data – Normtid
De hentede data leveres i følgende format/rækkefølge:
| Feltnavn | Format | Bemærkning | Parameter styret |
| Medarbejdernummer | AN | ||
| Dato | Numerisk | yyyy-mm-dd | |
| Normtid (min.) | Numerisk | Tager Timeskabelon fra medarbejderstamkortet. Alternativt tages Timeskabelon fra medarbejderens løngruppe |