Overview

Estimated, overall set up time: 15 minutes

On a high-level, to set up the integration you will need to

1. upload and import a custom AFAS connector,
2. create a new user and group that will be connected to the connector,
3. unlock and finish setting up the connector. 

Side-note: on the technical side, integrations with AFAS always work through using 'connectors' that expose the required data. AFAS already provides some pre-built connectors, however, since they don't contain the data that is needed for this integration, we need to use a custom connector. 

The rest of the guide, is a detailed step-by-step introduction on how to set up the integration. 

Adding custom GetConnectors

First, download the necessary GetConnectors for applicants, vacancies, candidates and application stages. You will need them later in step 5 of creating an app connector.

Creating an app connector

1. Go to Go to General > Management > App connector:
   
   
   
2. Click "New" on the top left of the window that just opened:
   
   
   

3. Give the connector any description you like, i.e.: "App connector for integration". Then, make sure that the "Generate a token automatically" is toggled on in the dialog:
   
   
   

4. Select "Create a new user group based on App connector name" and click "Next"
   
5. Click on "Action" then "Import":
   
   
6. Click on "1. File"
   
7. Select all 4 files you downloaded earlier and click "Open":
   Note: If you're connecting to AFAS via Citrix web, you'll have to upload the connector files before they can be imported.
8. Click on "Finish"
   
9. Click on "Next"
   
10. Click on "New" in under "UpdateConnectors":
    
11. Search for "HrCreateApplicant", and toggle on the button next to it, and click on "Finish":
    
12. Click on "New" in under "UpdateConnectors" again:
13. Search for "KnSubject", and toggle on the button next to it, and click on "Finish":
14. Click on "Finish"
    
15. A new dialog should pop up, and you will be able to see your token. You won’t be able to access it again, so save it somewhere secure:
    

Tip: how to copy your token out of the Citrix workspace

If you’re accessing AFAS via remote Desktop, you can’t use your Clipboard outside the remote Desktop. If you don’t want to copy the token by writing it down, you can copy it like this:

1. Click on "Copying":
   
   
   
2. Now click the three white lines at the top middle of your screen:
   
   
   
3. A few icons should appear, click the one that looks like a clipboard:
   
4. A new window should open, you can now copy the contents by pressing "Ctrl + C" and use it anywhere outside of Citrix:
   

Unblock the app connector

1. Open the properties of the app connector. To do this, go to the app connectors page and double click the name of your connector
2. Go to "General" and make sure there is no check mark left to the field that says “Blocked”:
   
   
   
3. Click on "Save and close".

Composing the AFAS service domain

The service domain of your AFAS instance takes the form of "<environmentID>.rest.afas.online"

You have to replace the "environmentID" with the five digit number of your environment name. Your environment name can be found at the top of your Profit workspace and will look something like this: "O12345AA" (the first letter is a capital “O”, not a 0)

So in this case your service domain will be: "12345.rest.afas.online"

• ⚠️ You have to use an AFAS production environment. Production environment names are always prefixed with the capital letter “O”, so make sure it looks like this "O12345AA" and not like this "A12345AA" (which would be an “accept” environment)

Adding the integration

1. Paste the service domain and user token into the connection flow and click “Set up integration”: