Skip to content

Simployer

A first party connector that imports people, employments and organizational data from Simployer.

Not the same as Alexis HR

Simployer and Alexis HR are separate connectors with different configuration and different connector object types. This page covers Simployer, which authenticates with a client id and client secret.

Configuration inputs

Input Kind Required Description
clientid Configuration Yes The client ID issued by Simployer.
clientsecret Secret Yes The matching client secret.

Creating a connector using PowerShell

You must first Connect-IAMCore, as per the documentation

The client secret is a secret rather than an ordinary input, so it goes in -Secrets:

$Connector = New-IAMCoreConnector `
    -Name "Simployer" `
    -TemplateId simployer `
    -Configuration @{
        clientid = "your-client-id"
    } `
    -Secrets @{
        clientsecret = "your-client-secret"
    }

Write-Host "Created with id $($Connector.id)"

A newly created connector stays in the state Created until the first party connector runtime picks it up, at which point it becomes Provisioned.

Check which templates your tenant has

Templates are enabled per tenant, so run Get-IAMCoreConnectorTemplate to confirm this one is available to you and to see the exact inputs it expects.

Connector object types

Object type External id Contents
person id People
personIdentityIdentifier id Identity numbers belonging to a person
personExtendedProperty id Additional properties held against a person
employment employmentId Employments
employee employeeId Employee records
organization id The organizational structure
tenantUser id User accounts in Simployer

Person data is spread across several object types, which is worth knowing when writing sync rules: the national identity number lives on personIdentityIdentifier rather than on person. Use findreferencingobjectforstring to reach it from the person, or followreferenceforstring to go the other way.

To see the real shape of an object before writing rules against it:

Find-IAMCoreConnectorDataObject -ConnectorId $Connector.id -ConnectorObjectType "person" |
    Select-Object -First 1

Example sync rules

The usual mapping is:

See sync rules for complete worked examples of all three.