You can create custom integration with Kjarni in Journeys.
For example you can create an employee and add files to that employee:
Go to Settings->Integrations and select "Add new integration" in the top right corner:
Add logo and name and select "Add integration":
Now select "Authenticate" and insert the authentication information you have from Kjarni. This is an example we have for a development environment but you will have another Authentication URL, Client ID and Client secret.
Press "Test" and then you see whether everything is set up correctly.
Let's say you next want to add an action to create a new employee in Kjarni.
Select "Add endpoint"
The URL should be similar to: https://thirdparty-api.starfsmenn.is/kjarni/api/v2/RCApplicantApplications/CreateEmployee
But the beginning of that URL is our company address for Kjarni.
Insert this example request:
{
"employeeData": {
"EmployeeDetail": {
"Begda": "2020-06-01T00:00:00.000Z",
"Endda": "9999-12-31T23:59:59.997Z"
},
"EmployeeMaster": {
"Email": "[email protected]",
"EntityNR": "1811921519",
"BirthDate": "1985-06-27T00:00:00.000Z",
"GenderType": "None",
"EmployeeName": "TEST 50skills Journeys"
},
"EmployeeDetailOrg":
{
"Begda": "2020-06-01T00:00:00.000Z",
"Endda": "9999-12-31T23:59:59.997Z",
"EmployeeGroup": "None",
"EmployeeStatus": "None",
"OrgCompanyID": 1
}
}
}
Press "Submit" -- next make sure that the variable types are all correct (see image) and press "Test"
Now you should see this "employee" in Kjarni 🎉
Note that you can also insert more variables when creating the employee, your example request would just need to contain that data based on the Kjarni API documentation that can be found here: https://api-docs.kjarni.is/#0a99839f-83ad-48c9-99d9-d677e26eb285
Inserting a file to Kjarni
If you want to insert a file to Kjarni, you add a new endpoint.
Post to URL similar to: https://thirdparty-api.starfsmenn.is/kjarni/api/v2/FileRepositories/
Example request:
{
"Name": "TestFile",
"Extension": ".txt",
"ObjectDocumentType": 0,
"FileSource": "VGVzdA==",
"Entity_ID": 470,
"EntityType": 2
}Just replace the Entity_ID with some employeeID you have in Kjarni - to be able to see that employee with a file attached.
make sure that the "Type" for FileSource is "File":
Now you can try it out by pressing "Test".
In the Journey, you can use the response from Kjarni-Create Employee to get the Employee_ID and insert it into the add-file action.
