&frankly-integration

Ändrad den Tors, 15 maj vid 1:24 E.M.

Allt du behöver veta om vår &frankly-integration

Hur du ställer in integrationen

För att autentisera behöver du generera en API-nyckel i &frankly. Denna hittar du under Konto → API-åtkomst.

Endast användare med rollen Administrator i &frankly kan generera API-nycklar.

Kopiera API-nyckeln.
I Simployer One, gå till Inställningar → Integrationer.
Klistra in den kopierade API-nyckeln och klicka på Integrera.

När du får ett framgångsmeddelande är anslutningen upprättad.

Hur du synkroniserar användare från Simployer One till &frankly

Som ägare:

Gå till Engagemang → Enkäter → Exportera.
Klicka på Synkronisera för att uppdatera &frankly med aktuell information om medarbetare.
Upprepa detta steg varje gång du gör ändringar relaterade till medarbetare eller organisationer i Simployer One.

Export av medarbetardata

Följande data exporteras till &frankly:

&frankly-fält	Simployer One-fält	Kommentar/exempel
`externalId`	`EmployeeId`	6128e769ee5cac02018203f27
`firstName`	`firstName` (obligatoriskt)	John
`lastName`	`lastName` (obligatoriskt)	Doe
`email`	`Work email` (obligatoriskt)	john.doe@company.co
`phone`	`Work Phone` (valfritt)	+461234567
`timezone`	`Time Zone for user`	Europe/Stockholm
`role`	`Role`	Owners = Administrator, All others = User
`accessInfo:memberOf`	Gruppmedlemskap i Simployer One	Organisation, Office, Department, Team(s), Employment type

Export av gruppdata

I &frankly finns rapporter tillgängliga för grupper och team som har erbjudits att delta i en puls och uppfyller de anonymitetskrav som ställs för ett konto.

Därför, när medarbetare exporteras från Simployer, säkerställer vi att grupperna i &frankly motsvarar de grupper/enheter de tillhör i Simployer One.

Simployer One-enhet	Namn i &frankly	Beskrivning i &frankly
Organisation	Namn på organisationen	Användare som tillhör [Namn] Organisation i Simployer One
Kontor	Namn på kontor	Användare som tillhör [Namn] Office i Simployer One
Avdelning	Namn på avdelning	Användare som tillhör [Namn] Department i Simployer One
Team	Namn på team	Användare som tillhör [Namn] Team i Simployer One
Anställningstyp	Namn på anställningstyp	Användare som tillhör [Namn] Employment types i Simployer One

Export av attributdata

Du kan exportera följande anpassade attribut från Simployer One till &frankly som är kopplade till de exporterade användarna:

Attribut	Data i Simployer One	Kommentar
City	Personal - City	Valfritt
Country	Personal - Country	Valfritt
Gender	Personal - Legal Gender	Måste skapas som ett anpassat attribut med etiketten "Gender" och alternativen Male, Female, Non-binary eller Not-specified
Birthdate	Birthdate	Obligatoriskt om aktiv
Employment date	Employee hire date	Obligatoriskt om aktiv

För att kunna exportera attribut måste du först lägga till attributen i &frankly:

Gå till Konto → Användarhantering och lägg till önskade attribut.

OBS: Om du tillåter att kön inte specificeras för dina medarbetare måste du skapa ett anpassat attribut i &frankly med följande alternativ: Male, Female, Non-binary, Not-specified.

När du har lagt till attributen i &frankly kan du synkronisera data från Simployer till &frankly (notera att alla medarbetare måste ha attributdata i sin Simployer-profil för att synkroniseringen ska lyckas).

Hur du får åtkomst till &frankly

Som ägare, gå till Engagemang → Enkäter → Översikt.
När du klickar på Visa enkäter kommer du att dirigeras till &frankly.
Gå till Logga in → &frankly.
Första gången du loggar in måste du skapa ett konto:
- Lägg till din e-postadress.
- Välj lösenord.
- Bekräfta lösenordet.
Nu är du redo att logga in!

Vanliga frågor

Fråga: Vad händer när en medarbetare offboardas i Simployer One?
Svar: Nästa gång medarbetarna exporteras till &frankly och offboardingdatumet har passerat, kommer medarbetaren att tas bort från &frankly. Redan besvarade enkäter sparas.

Fråga: Jag får ett felmeddelande som säger "validateThatPhoneNumberIsCorrect", vad betyder det?
Svar: Detta betyder att en av medarbetarna inom ditt företag har ett felaktigt telefonnummer och du behöver rätta till det. Du kan göra detta genom en medarbetarrapport och ha arbetsnumret som ett av sökfältet.

Fråga: Jag får ett felmeddelande som säger "validateNoPhoneDuplicates", vad betyder det?
Svar: Detta betyder att en av medarbetarna inom ditt företag har ett arbetsnummer som redan är registrerat på en användare i &frankly och du behöver troligtvis rätta till det. Du kan göra detta genom en medarbetarrapport och ha arbetsnumret som ett av sökfältet.

Fråga: Jag får ett felmeddelande som säger "validateDuplicateMailInAnotherCompany", vad betyder det?
Svar: Detta betyder att en av medarbetarna inom ditt företag har en arbets-e-postadress som

Q : Jag får ett felmeddelande som säger "apiTokenValidation", vad betyder det?

A : Detta betyder att API-token från &frankly som angavs när integreringen aktiverades inte är giltig för tillfället.

Q : Jag får ett felmeddelande som säger "validateExternalProperties", vad betyder det?

A : Detta betyder att &frankly förväntar sig att externa egenskaper ska skickas (de är aktiverade i &frankly). Eller att Simployer skickar externa egenskaper som inte är aktiverade i &frankly (men aktiverade i Simployer One).

I exemplet nedan försöker Simployer skicka extern namn "not specified" för attributet Kön, men detta attribut eller dess tillåtna data är inte konfigurerade i &frankly.