Webservice

1.0. Beskrivelse

Webservice er en mulighed for at udveksle data med LessorWorkforce.

For at kunne udveksle data med LessorWorkforce, skal dette aktiveres på databasen. Kontakt workforce support for at aktivere/tillade dette, husk at anmodningen skal komme fra en administrator. Man skal bruge en admin profil til at få adgang til data. Denne admin profil skal have logget ind i LessorWorkforce en gang – og kan evt. deaktiveres bagefter. Derudover skal man kende ens databaseID, hvilket kan oplyses ved henvendelse til supporten.

Det er muligt både at importere samt eksportere data til LessorWorkforce.

1. 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. 

2.0. 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 LessorWorkforce ikke kan hente data. Data kan sendes som POST med Basic access authentication. 

3.0. Eksport

For at eksportere via webservice kan man bruge en browser eller et andet 3. partsprogram til at hente data i, da LessorWorkforce 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.

4.0 Oversigt over kald

4.1 Eksempler

Her gennemgås to muligheder for at eksportere data til henholdsvis Excel og PowerBI – Vær opmærksom på at disse beskrivelser kun er vejledende og afhænger bl.a. af versionen af programmet. 

4.2 Eksport til Excel

Åbn et nyt excel ark og vælg derefter hent data, kilde: ”fra internettet”

1. 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å)

4.1.1.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 LessorWorkforce (systemopsætning 28.1 og 28.2)

4.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).

1. 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