Webservice er en mulighed for at udveksle data med Lessor Workforce. Det er muligt både at importere samt eksportere data til/fra Lessor Workforce.
Opsætning
For at kunne udveksle data med Lessor Workforce, skal dette aktiveres på databasen. Kontakt Lessor Workforce support for at aktivere dette og husk at anmodningen skal komme fra en administrator.
DatabaseID og admin bruger
For at bruge webservicen skal du kende dit databaseID, dette kan du få oplyst ved at henvende dig til supporten. Derudover skal du bruge en admin bruger til at få adgang til data. Denne admin profil skal have logget ind i Lessor Workforce en gang – og kan evt. deaktiveres bagefter. Vær opmærksom på om I bruger 2 faktorgodkendelse, for det vil også gælde for denne admin bruger medmindre denne deaktiveres efter første login.
Kravsfelter
Man skal altid bruge databaseID samt brugernavn og adgangskode. Derudover kan de forskellige kald/url’er have specifikke parametre som kravsfelter – se de enkelte vejledninger for information om kravsfelter.
Import
For at importere via en web service, skal data leveres via bestemt format, det kunne være via en .csv fil (se de specifikke vejledninger). Filen skal leveres af et 3. partsprodukt, fx programmet Postman eller lignende, da Lessor Workforce ikke kan hente data. Data kan sendes som POST med Basic access authentication.
| Indhold | Url | Indlæst data |
| Medarbejdere, dimensioner | sync/import | Medarbejderstamdata, afdelinger, grupper. |
| Lønbudget | sync/importBudget | Lønbudget |
| Integration med ekstern tidsregistrering | reg/post_stamp | Ind- og ud-stemplinger fra eksternt tidsregistreringssystem |
| Bemandingsbehov | sync/importStaffingNeeds | Bemandingsbehov |
| Arrangementer | sync/importEvent | Arrangementer |
Eksport
For at eksportere via webservice kan man bruge en browser eller et andet 3. partsprogram til at hente data i, da Lessor Workforce ikke kan sende data. Data leveres ud fra valgt selektering og kan efterfølgende behandles i et 3. partsprogram. Data kan sendes som POST med Basic access authentication.
| Indhold | Url | Leveret data |
| Eksportfiler | sync/getSalaryExport | Eksportfiler (løn- og fraværsfiler) |
| Lønbudget | sync/exportBudget | Lønbudget |
| Timeskabelon | sync/exportHournorm | Medarbejderes timenorm |
| Medarbejdere | sync/getEmployees | Medarbejderstamdata |
| Saldi | sync/exportBalances | Saldobevægelser |
| Vagter, fravær, registreret tid | sync/exportShifts | Planlagte vagter, fravær og registreret tid |
| Arrangementer | sync/exportEvent | Arrangementer |
Eksempler
Her gennemgås to muligheder for at eksportere data til henholdsvis Excel og PowerBI – Vær dog opmærksom på at disse beskrivelser kun er vejledende og afhænger bl.a. af versionen af programmet.
NB! Inde på den konkrete artikel for hver webservice kan du låse mere om hvilke parametre du kan bruge samt se eksempler på hvilken data du får leveret.
Eksport til Excel
Åbn et nyt excel ark og vælg derefter hent data, kilde: ”fra internettet”
- Indsæt url’en under adresse
NB! De forskellige url’er og deres forskellige parametre findes i vejledningerne til web-service.
2. Indtast brugernavn og adgangskode under ”grundlæggende” (kun første gang man logger på)
Fejlsøgning
1. Der kommer følgende pop-up frem, vælg ”rediger” eller fejlbesked om at bruger og adgangskode ikke kan valideres (tjek at disse er korrekt og at den valgte bruger er admin).
Vælg ”grundlæggende” og indtast brugernavn og adgangskode.
På pop-up’en der dukker op vælges at åbne fil som csv-dokument.
I næste pop-up vælges semikolon som afgrænser
Til sidst vælges ”indlæs”
2. Specialtegn vises forkert
Vælg ”28591” (ISO) eller ”26001” (UTF8) under ”Filoprindelse” afhængigt af valgte indstillinger i Lessor Workforce (systemopsætning 28.1 og 28.2)
Eksport til PowerBI
Data indhentes som ”tom forespørgsel” – ikke som web, database eller tekst/csv. Det er muligt at hente data som html via ”web” men uden formattering (tabelformat).
- Gå til ”hent data” og vælg ”tom forespørgsel”
Der dukker denne power query op:
Hvis denne linje ikke dukker op, kan man gå i ”ny kilde” og vælge ”tom forespørgsel”.
2. I kodelinjen indtastes følgende:
= Csv.Document(Web.Contents(“URL”),[Delimiter=";", Encoding=65001])
I stedet for “URL” indtastes den url der hører til de data man vil hente, eksempelvis:
- getEmployees
- exportShifts
- getSalaryExport
Eksempelvis hentes getEmployees her:
= Csv.Document(Web.Contents(“https://workforce.lessor.dk/sync/getEmployees.php/?id=2445”),[Delimiter=";", Encoding=65001])
Bemærk at der skal bruges præcis de tegn der er i ovenstående kode (inkl. gåsetegn og lighedstegn)!
Bemærk at denne sti antager at der bruges UTF8 karaktersæt, bruges ISO karaktersæt skal den vælges i stedet (”Encoding=28591”).
I powerBI ser det således ud:
3. Indtast bruger og adgangskode (husk bruger skal være admin)
4. Data præsenteres nu i tabelformat
5. Forespørgslen kan gemmes og hentes frem igen i PowerBI