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 hentes 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/exportBalances.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 | Yyyymmdd el. yyyy-mm-dd
| Nej | Sættes denne ikke, vil datoen sættes til seneste nulstillingsdato. |
| to | Yyyymmdd el. yyyy-mm-dd
| Nej | Sættes denne ikke, vil datoen sættes til dags dato. |
| company | Der kan begrænses på firma. Denne er kun anvendelig såfremt flere afdelinger har samme navn. Company kan ikke benyttes alene. | Nej | Der kan tilføjes flere firmaer ved at adskille firmanavne med komma (uden mellemrum) |
| department | Der kan begrænses på afdeling. Findes der flere afdelinger med samme navn, skal der også benyttes company. | Nej | Der kan tilføjes flere afdelinger ved at adskille afdelingsnavne med komma (uden mellemrum) |
| groups | Der kan begrænses på gruppe. For at begrænse på gruppe, skal der også være en begrænsning på company (firma). | Nej | Der kan tilføjes flere ved at adskille gruppenavne med komma (uden mellemrum) |
| balances | Tilføjes denne ikke vil alle saldoer komme med ud. Ønsker man at begrænse på udvalgte saldi, tilføjes [] efter balances. Se eksempel nedenfor. | Nej | Ønsker man at begrænse på flere saldi, tilføjes [] efter balances. Fx &balances[]=Ferie&balances[]=Flex |
Eksempel på opbygning af URL:
Ekstra parametre tilføjes ved at skrive &group=xxxx
3.1 Levering af data – Saldo
De hentede data leveres i følgende format/rækkefølge:
| Feltnavn | Format | Bemærkning | Parameter styret |
| Medarbejdernummer | AN | ||
| Medarbejderens navn | AN | ||
| Timekonto | AN | Navn | |
| Afdeling | AN | Primær afdeling | |
| Gruppe | AN | Primær gruppe | |
| Start dato |
Numerisk | yyyymmdd el. yyyy-mm-dd | |
| Startsaldo | Numerisk | Minutter | |
| Til dato | Numerisk | yyyymmdd el. yyyy-mm-dd | |
| Slutsaldo | Numerisk | Minutter |