Læsetid 2 min
- 30. august 2022
Du har sonderet markedet og er endt op med, at det er Woba.io som er det absolut bedste match til din virksomhed og dine medarbejdere. Skønt. Så er du allerede langt. Men nu melder der sig et uundgåeligt spørgsmål, når det omhandler det tekniske.
Kan dette nye software integreres med det, vi allerede har? Og det er vigtigt. For det kan tage umådelige mængder af tid og kræfter, hvis denne del ikke bare kan komme på plads nemt og overskueligt.
Hvordan gør vi i Woba.io?
I Woba.io bruger vi en teknisk løsning som åbner op for en automatisk import af medarbejderdata fra et tredjeparts-system. Det vil sige, at vi har en API-integration. I det følgende går vi mere i dybden med det tekniske setup i forbindelse med API-integrationen.
Den tekniske forklaring
Woba kan åbne op for en automatisk import af medarbejderdata fra et tredjeparts-system ved at tilbyde en simpel HTTP API til eksterne systemer til at interagere med:
HTTP Method: POST
URI: /import-employees
Content-Type: text/csv
Et simplificeret eksempel på at påberåbe sig API’en (notér, at det kun er en underkategori af API’en, som
er inkluderet for at holde eksemplet simpelt):
POST /import-employees
Medarbejders navn, medarbejders e-mail, Afdeling
John Smith, johnsmith@example.com, HR
Amy Lane, janelane@example.com, Finance
Den fulde API-integration vil indeholde følgende felter og deres detaljerede brug vil blive specificeret i Swagger (i.e., Open API) dokumentation:
- Medarbejders navn (obligatorisk)
- Medarbejders e-mail (obligatorisk)
- Afdeling (obligatorisk)
- Jobtitel (Valgfrit)
- Fødselsdato (Valgfrit)
- Køn (Valgfrit)
- Telefonnummer (Valgfrit)
- Stillingens startdato (Valgfrit)
- Stillings slutdato (Valgfrit)
- Frivillig opsigelse (Valgfrit)
- Lønniveau (Valgfrit)
Denne API-integration kan kun kaldes over en sikker forbindelse (HTTPS) og vil blive beskyttet med et ‘ClientID’ og ‘ClientSecret,’ som en Woba-kunde kan specificere og strukturere efter behov i Woba-platformen. Importen vil synkronisere data i Woba med de data, der sendes til API, hvilket betyder, at hvis en medarbejders data allerede er opdateret, så vil der ikke være nogen ændringer for medarbejderen i Woba. Dette betyder også, at en API-bruger sikkert kan kalde API’en flere gange i træk, da API’en vil være det samme.
Det vil være en Woba-kundes ansvar at udtrække de nødvendige data fra deres HR- og/eller ERP-systemer, hvilket normalt kræver administratorrettigheder og påberåbe sig Woba API. Kald af API kan gøres med et simpelt kommandolinjeværktøj, såsom cURL eller mere avancerede biblioteker, såsom Microsoft ASP .NET Web API Client, afhængigt af kundens præferencer.
På trods af den noget tekniske afrunding her, så håber jeg, at du alligevel har fået indblik i, hvordan Woba.io kan integreres – og at det ikke mindst er afmystificeret en hel del, så det i hvert fald ikk er derfor, du ikke kommer i gang med det vigtige trivselsarbejde.
