Active Roles 7.3.3 - Synchronization Service Administration Guide

Synchronization Service Overview Deploying Synchronization Service Getting started Connections to external data systems
External data systems supported out of the box
Working with Active Directory Working with an AD LDS (ADAM) instance Working with Skype for Business Server Working with Exchange Server Working with Active Roles Working with One Identity Manager Working with a delimited text file Working with Microsoft SQL Server Sample queries to modify SQL Server data Working with an OLE DB-compliant relational database Working with SharePoint Working with Microsoft Office 365 Working with Microsoft Azure Active Directory
Using connectors installed remotely Creating a connection Renaming a connection Deleting a connection Modifying synchronization scope for a connection Using connection handlers Specifying password synchronization settings for a connection
Synchronizing identity data Mapping objects Automated password synchronization Synchronization history Scenarios of use Appendix A: Developing PowerShell scripts for attribute synchronization rules Appendix B: Using a PowerShell script to transform passwords

Specify connection settings

Specify connection settings

In this expandable item, you can use the following options:

  • Delimited text file. Click Browse to locate and select the delimited text file to which you want to connect.
  • Access delimited text file using. Select an access option:
    • Synchronization Service account. Access the delimited text file in the security context of the account under which the Synchronization Service is running.
    • Windows account. Access the delimited text file in the security context of the account whose user name and password you specify below this option.
  • Test Connection. Click this button to verify the specified connection settings.

Specify delimited text file format

Specify delimited text file format

This expandable item provides the following options:

  • Delimiter. Select the delimiter used in the file you specified.
  • Use first row for attribute names. Select this check box if the first line of the specified file contains names of attributes. Otherwise, leave this check box cleared.
  • Advanced. Specify advanced options to access the delimited text file, such as encoding, row delimiter, value delimiter, and text qualifier.

Schema

Schema

You can use this expandable item to view and modify the delimited text file schema saved in the Synchronization Service configuration database.

When you create a connection to a delimited text file, Synchronization Service reads the schema in the file (that is, the fields or columns related to each record in the file), and then saves the schema in the Synchronization Service configuration database. Synchronization Service then uses the saved file schema to read and modify the data in the connected file. Should the schema in the connected file change, you will need to reflect these changes in the Schema option so that Synchronization Service could correctly handle (read and write) the data in the changed file.

This expandable item provides the following options:

  • Attributes. Lists the names of Synchronization Service attributes that correspond to certain columns or fields in the connected file. Basically, these are the names of attributes you can select and use in the Synchronization Service Administration Console for each object in the connected delimited text file.
  • Add. Allows you to add a new entry (for example, column or field) to the file schema saved in the Synchronization Service configuration database. You can use this button in case a new column or field was added to the connected file and you want to reflect this change in the file schema saved in the Synchronization Service configuration database.
  • Edit. Allows you to edit the name of the selected Synchronization Service attribute associated with a certain column or field in the connected file. For example, you can use this button in case a field or column name was changed in the connected file and you want to reflect this change in the file schema saved in the Synchronization Service configuration database. Also you can use this button to edit the display name of a Synchronization Service attribute associated with a certain column or field in the connected file.
  • Remove. Allows you to remove the selected attribute from the file schema saved in the Synchronization Service configuration database. For example, you can use this button in case a field or column name was deleted from the connected file and you want to reflect this change in the file schema saved in the Synchronization Service configuration database.
  • Reload schema. Allows you to update the file schema saved in the Synchronization Service configuration database by reloading the schema from the file to the configuration database. As a result, the file schema saved in the Synchronization Service configuration database will be completely rewritten with new data from the file.
  • Up arrow. Moves the selected attribute up.
  • Down arrow. Moves the selected attribute down.

Specify attributes to identify objects

Specify attributes to identify objects

This expandable item provides the following options that allow you to specify the attributes with which you wish to uniquely identify each object in the delimited text file:

  • Available attributes. Lists the attributes that are available in the external data system. Use this list to select the attributes whose values you want to use to generate a unique identifier for each object in the external data system. You can filter attributes by typing in the text box at the top of this list. To select multiple attributes, hold down CTRL and click to select attributes in the list.
  • UniqueID attributes. Lists the attributes whose values are currently used to generate a unique identifier for each object in the external data system.
  • Add->. Moves the selected attributes from the Available attributes list to the UniqueID attributes list.
  • <-Remove. Moves the selected attributes from the UniqueID attributes list to the Available attributes list.
  • Constructed UniqueID. Displays a combination of the attributes whose values will make up a unique identifier for each object in the external data system.
Related Documents