HelloID-Conn-Prov-Source-AFAS-Profit

ℹ️ Information
This repository contains the connector and configuration code only. The implementer is responsible to acquire the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements.

Table of Contents

• Introduction
• Getting Started
  • Source
  • Target
  • Mappings
  • Scope
• Setup the PowerShell connector

Introduction

The interface to communicate with Profit is through a set of GetConnectors, which is component that allows the creation of custom views on the Profit data. GetConnectors are based on a pre-defined 'data collection', which is an existing view based on the data inside the Profit database.

For this connector we have created a default set, which can be imported directly into the AFAS Profit environment.

Getting Started

By using this connector you will have the ability to retrieve employee and contract data from the AFAS Profit HR system.

Connecting to Profit is done using the app connector system. Please see the following pages from the AFAS Knowledge Base for more information.

Create the APP connector

Manage the APP connector

Manual add a token to the APP connector

Source

The following GetConnectors are required by HelloID when the system is defined as source system:

• Tools4ever - HelloID - T4E_HelloID_Employments
• Tools4ever - HelloID - T4E_HelloID_Positions
• Tools4ever - HelloID - T4E_HelloID_Groups
• Tools4ever - HelloID - T4E_HelloID_OrganizationalUnits
• Tools4ever - HelloID - T4E_HelloID_Users
• Tools4ever - HelloID - T4E_HelloID_UserGroups

Target

When the connector is defined as target system, only the following GetConnector is used by HelloID:

• Tools4ever - HelloID - T4E_HelloID_Users

In addition to use to the above get-connector, the connector also uses the following build-in Profit update-connectors:

• knPerson
• knUser

Mappings

A basic person and contract mapping is provided. Make sure to further customize these accordingly.

Scope

The data collection retrieved by the set of GetConnector's used in this repository is limited a maximum amount of data, these limits are set as pre-defined filters and can be changed by the customer itself to meet their requirements.

Connector	Field	Default filter
Tools4ever - HelloID - T4E_HelloID_Employments	contract start date	<[Vandaag + 1 maand]
	contract end date	>[Vandaag - 3 maanden];[]
	function start date	<[Vandaag + 1 maand]
	function end date	>[Vandaag - 3 maanden];[]
Tools4ever - HelloID - T4E_HelloID_Groups	usergroup blocked	=N
	Group	!=Iedereen
Tools4ever - HelloID - T4E_HelloID_UserGroups	Group	!=Iedereen
	User	![]
	user blocked	=N
	usergroup blocked	=N
Tools4ever - HelloID - T4E_HelloID_Users	contract start date	<[Vandaag + 1 maand]
	contract end date	>[Vandaag - 3 maanden];[]
	user blocked	=N

Setup the PowerShell connector

1. Add a new 'Source System' to HelloID and make sure to import all the necessary files.

   • configuration.json
   • personMapping.json
   • contractMapping.json
   • persons.ps1
   • departments.ps1

2. Fill in the required fields on the 'Configuration' tab.

For more information about our HelloID PowerShell connectors, please refer to our general Documentation page

HelloID Docs

The official HelloID documentation can be found at: https://docs.helloid.com/