Table of contents

• Abstract 
• Step-by-step: Creating a Connector

Abstract 

Connectors need to be created to be able to access data-sources that are used for data transfers. Creating Connectors is part of the setup user role.

Step-by-step: Creating a Connector

1. Go to the Connectors page from the Setup Menu and click on the button: “+ New connector”.

        The Connectors page with the top bar menu and the “+ New connector” button highlighted.

2. Fill out the following fields in the “New connector” pop-up window:
   • Title: Give the connector a unique and descriptive title.
   • Execution component: Select which Execute component the connector will use.
   • Host system: Select which Host system the connector will apply to.

                The “New connector” pop-up window

3. As soon as you’ve selected a Host system, additional fields will become editable:
   • For SAP and Safran, you will have to provide a URL and an Authentication type.
   • For Excel, you have to provide a Path.
   • For Microsoft project, you have to proved a path and you get the option to turn off “All files have some user fields”.
   • For Primavera, more information will be provided here in the near future.
     In the case of Excel and Microsoft project, you can create the Connector after finishing this step. For SAP and Safran, one more step is required (step 4). In all cases, the connector needs to retrieve data before it can be used in IEAs. This is explained is step 5.

                    The “New connector” pop-up window after selecting SAP as Host system.

4. After selecting SAP or Safran as Host system and selecting an authentication type, the last few fields appear:
   • For SAP/Safran and Basic Authentication, a username and password are required.
   • For SAP/Safran and Windows Authentication, no extra fields are required and the connector can simply be create.
   • For SAP and AzureSAMIOauth Token, the “Create” button turns into a “Next” button which brings you to the next pop-up window where 14 more fields are required. Use the “i” button to get more information about the fields.
   • For Safran and AzureAD Authenticiaton, a directory ID, an application ID and a redirect URI are required.
      When all fields are populated, the “Create” button becomes enabled and the Connector can be created.

                    The “New connector” pop-up window after filling out all the fields.

5. NB! This last steps takes place in the ILAP Desktop app.
    Sign in to the ILAP Desktop app and go the the Connectors tab in the menu bar. Here you find the list of Connectors. Identify the Connector you want to test and click on the “Check now” button in the Test column of the table. You will receive either a “Successful” or “Failed” feedback modal including a text from the API. This text can be copied in case contact with support is required. If it returns “Successful” your connector is ready for use.

        The connectors page in the ILAP Desktop App with the “Check now” buttons highlighted.