Configure data connections

Use the Data Model > Data Connections node to configure data connections that can synchronize specific data from an external source with your environment. Before you can synchronize data, you need to configure Data Sources. A Data Source defines the external source of the data that you want to synchronize. This can be Microsoft Active Directory, a CSV file or a database. A data connection uses this Data Source to synchronize the external data with your environment. For example, if the external source is a CSV file that contains data about employees, you can configure a data connection to synchronize the employee ID and full name of each employee only.
Data connections can also be configured in the Management Portal.

  • Because the Management Portal is web based, you cannot use local paths of files in Data Sources (e.g. C:\...) . Instead, specify the host name of the specific server that stores the file (e.g: \\VM-WIN2012\Datasource\HRfile.csv) and the credentials to access this location.
  • You can configure data connections for:
  • If you edit and existing data connection and then synchronize it again, any previous data that you synchronized with the data connection is deleted. For example, if the original data connection synchronized organizational context related to Department, and you change the data connection so it now synchronizes organizational context related to Location, the organizational context related to Department is deleted.
  • If you delete a data connection, you have the option to also delete all related objects. For example, if you delete a people data connection and choose to delete all related objects, ALL people related to the data connection are marked for deletion. If you choose to keep these objects, only their relation is removed.
  • The following restrictions apply concerning administrative roles:
    • To preview data in the Data Source, you need Modify permissions to the data connection and Read or Modify permissions to the Data Source.
    • To synchronize a data connection, you need Modify permissions to the data connection and Read or Modify permissions to the Data Source.
  • Multiple data connections are synchronized in this order:
    1. Organization and People data connections
    2. Classifications, Organizational Attributes, People Attributes and Global Table Attributes data connections
  • To generate a command line that you can use to synchronize data connections, select the relevant data connection(s), right-click this selection and select Generate command line. This copies the command line to your clipboard, after which you can use it in, for example an Ivanti Automation Job.
See also