&frankly-integrasjon

Endret Thu, 15 Mai ved 1:09 PM

Alt du trenger å vite om vår &frankly-integrasjon

Hvordan sette opp integrasjonen

Du må generere et API-token i &frankly for autentisering. Dette finner du under Konto → API-tilgang.

Kun brukere med rollen "Administrator" i &frankly kan generere API-tokens.

Kopier API-nøkkelen.
I Simployer One går du til Innstillinger → Integrasjoner og limer inn den kopierte API-nøkkelen. Klikk deretter på "Integrer".

Når du mottar en vellykket respons, er tilkoblingen satt opp.

Hvordan synkronisere brukere fra Simployer One til &frankly

Som eier går du til Engasjement → Undersøkelser → Eksporter.
Når du klikker på "Synkroniser", vil den nåværende tilstanden til ansatte bli synkronisert til &frankly.
Gjenta dette trinnet hver gang du gjør endringer relatert til ansatte og organisasjoner i Simployer One.

Eksport av ansattdata

Følgende data eksporteres til &frankly:

Alle brukere som er i aktiv tilstand i Simployer One.

&frankly	Simployer One	Kommentar/eksempel
externalId	EmployeeId	6128e769ee5cac02018203f27
firstName	Fornavn	John
lastName	Etternavn	Doe
email	Arbeidsemail	john.doe@company.co
phone	Arbeidstelefon	+461234567
timezone	Tidsone	Europe/Oslo
role	Rolle	Eier = Administrator, Alle andre = Bruker
accessInfo: memberOf	Medlemskap i grupper	Organisasjon, Kontor, Avdeling, Team, Ansettelsestype

Eksport av gruppedata

I &frankly er rapporter tilgjengelige for grupper og team som har blitt tilbudt å delta i en puls og som oppfyller anonymitetskravene satt for en konto.

Når ansatte eksporteres fra Simployer, sørger vi for at gruppene i &frankly samsvarer med gruppene/enhetene de tilhører i Simployer One.

Simployer One-enhet	Navn i &frankly	Beskrivelse i &frankly
Organisasjoner	Navn på organisasjonen	Brukere som tilhører [Navn] Organisasjon i Simployer One
Kontorer	Navn på kontorene	Brukere som tilhører [Navn] Kontor i Simployer One
Avdelinger	Navn på avdelingene	Brukere som tilhører [Navn] Avdeling i Simployer One
Team	Navn på teamene	Brukere som tilhører [Navn] Team i Simployer One
Ansettelsestyper	Navn på ansettelsestypene	Brukere som tilhører [Navn] Ansettelsestype i Simployer One

Eksport av attributtdata

Du kan eksportere følgende tilpassede attributter fra Simployer One til &frankly som er knyttet til de eksporterte brukerne.

Attributt	Data i Simployer One	Kommentar
City	Personlig - By	Valgfritt
Country	Personlig - Land	Valgfritt
Gender	Personlig - Kjønn	Må opprettes som et tilpasset attributt med etiketten "Kjønn" og alternativene Mann, Kvinne, Ikke-binær eller Ikke spesifisert
Birthdate	Fødselsdato	Påkrevd hvis aktiv
Employment date	Ansettelsesdato	Påkrevd hvis aktiv

For å kunne eksportere attributter, må du først legge til attributtene i &frankly.

Gå til Konto → Brukeradministrasjon og legg til ønskede attributter.

MERK: Hvis du tillater at kjønn ikke er spesifisert for dine ansatte, må du opprette et tilpasset attributt i &frankly med følgende alternativer: Mann, Kvinne, Ikke-binær, Ikke spesifisert.

Når du har lagt til attributtene i &frankly, kan du synkronisere data fra Simployer til &frankly (merk at alle ansatte må ha attributtdata i sin Simployer-profil for at synkroniseringen skal være vellykket).

Hvordan få tilgang til &frankly

Som eier går du til Engasjement → Undersøkelser → Oversikt.
Når du klikker på "Vis undersøkelser", blir du omdirigert til &frankly.
Gå til Logg inn → &frankly.
Første gang du logger inn, må du opprette en konto:
- Legg til din e-postadresse.
- Velg passord.
- Bekreft passord.
Nå er du klar til å logge inn!

FAQ

Spørsmål: Hva skjer når en ansatt blir offboardet i Simployer One?
Svar: Neste gang ansatte eksporteres til &frankly og offboarding-datoen har passert, vil den ansatte bli fjernet fra &frankly. Allerede besvarte undersøkelser vil bli lagret.

Spørsmål: Jeg får en feilmelding som sier "validateThatPhoneNumberIsCorrect", hva betyr det?
Svar: Dette betyr at en av de ansatte i selskapet ditt har et ugyldig telefonnummer, og du må korrigere det. Du kan gjøre dette gjennom en ansattrapport og ha arbeidstelefonen som ett av feltene for søking.

Spørsmål: Jeg får en feilmelding som sier "validateNoPhoneDuplicates", hva betyr det?
Svar: Dette betyr at en av de ansatte i selskapet ditt har et arbeidstelefonnummer som allerede er registrert på en bruker i &frankly, og du må sannsynligvis korrigere det. Du kan gjøre dette gjennom en ansattrapport og ha arbeidstelefonen som ett av feltene for søking.

Spørsmål: Jeg får en feilmelding som sier "validateDuplicateMailInAnotherCompany", hva betyr det?
Svar: Dette betyr at en av de ansatte i selskapet ditt har en arbeidsemail som allerede eksisterer på en bruker i &frankly.

Spørsmål: Jeg får en feilmelding som sier "apiTokenValidation", hva betyr det?
Svar: Dette betyr at API-tokenet fra &frankly som ble angitt ved aktivering av integrasjonen ikke er gyldig for øyeblikket.

Spørsmål: Jeg får en feilmelding som sier "validateExternalProperties", hva betyr det?
Svar: Dette betyr at &frankly forventer at eksterne attributter skal sendes (de er aktivert i &frankly). Eller at Simployer prøver å sende eksterne attributter som ikke er aktivert i &frankly (men som er aktivert i Simployer One).

I eksempelet nedenfor prøver Simployer å sende attributtet Kjønn med verdien "ikke spesifisert", men dette attributtet eller dets tillatte verdier er ikke konfigurert i &frankly.