Chat now with support
Chat with Support

Identity Manager 8.1.4 - Target System Synchronization Reference Guide

Target system synchronization with the Synchronization Editor Working with the Synchronization Editor Basics of target system synchronization Setting up synchronization
Starting the Synchronization Editor Creating a synchronization project Configuring synchronization
Setting up mappings Setting up synchronization workflows Connecting systems Editing the scope Using variables and variable sets Setting up start up configurations Setting up base objects
Overview of schema classes Customizing the synchronization configuration Checking the consistency of the synchronization configuration Activating the synchronization project Defining start up sequences
Running synchronization Synchronization analysis Setting up synchronization with default connectors Updating existing synchronization projects Script library for synchronization projects Additional information for experts Resolving errors when connecting target systems Configuration parameters for target system synchronization Configuration file examples Glossary

Scope properties

Enter the following properties for a scope. Set a filter for the target system whose object are referenced from the connection system. For more information, see What is a scope?.

Table 57: Scope properties
Property Description
SchemaClosed Display name for the schema to which the scope will be applied.
Name Scope display name. The name must be unique within a synchronization projectClosed.
Scope hierarchy List of all schema types for the selected schema. To filter the list, click .
Show all object types All object types of the schema are displayed.
Only show hierarchically structured object types Only the object types of the schema that form a hierarchical structure are displayed.
Is filtered? All schema types with a filter are marked.
A filter is defined and effective.
A filter is effective.
Condition Specify the filter condition for the scope. Select an object type in the scope hierarchy for this.

System filterClosed

FilterClosed that immediately affects the connection system.

Enter the filter in system specific notation, for example, as Where clause for a database system or as LDAP filter for an LDAP system.

If tested against a fixed value that contains at least two dollar characters, the dollar characters must be masked.

This filter is only effective when loading the system objects.

Object filterClosed

Filter that affects loaded objects.


Formulate a query for loaded objects. Use the wizard for entering filter.


You can also store a script which determines system objects. The script must be written in the script language specified in the synchronization project.

Hierarchy filter Filter created on the bases of existing system objects. This filter limits the number of objects to load in the connected system.

This filter is only available for individual target systems.

For more information, see Creating hierarchy filters.

Related topics

Creating hierarchy filters

Certain target systems support the definition of a scope based on the hierarchy of existing target system objects. The hierarchy filterClosed limits the number of objects to load in the connected system. The hierarchy filter can only be applied to objects and not to their schema properties.

The objects are displayed in their hierarchical structure on the right-hand side of the scope view. The Synchronization EditorClosed establishes a connection to the target system to do this. using the variable set selected in the Synchronization Editor's toolbar.

To create a hierarchy filter

  • Mark all the objects in this hierarchy which are included in the scope.

    All unmarked objects remain outside the scope.

    If you enable the hierarchy's root note, new objects within the hierarchy are included by the scope. If the root node is disabled, only the marked objects are within the scope. New objects are not synchronized.

NOTE: Create an additional object filter to include schema properties as criteria in the scope definition.

A fully defined hierarchy filter can be transformed into a variable. Thus the filter can be redefined in a specialized variable set and used for other synchronization configurations.

To convert a variable into a hierarchy filter

  1. Click Convert into a variable.
  2. Confirm the security prompt with Yes.

    The hierarchy filter is saved as variable. To change the filter, edit the variable.

Related topics

Using variables and variable sets

You can use variables to create generally applicable synchronizationClosed configurations that contain the necessary information about the synchronization objects when synchronization starts. For example, you can use variables in the target system connection to synchronize different Active Directory domains with the same synchronization projectClosed.

Variables can be used in the following Synchronization EditorClosed definitions.

System connections in parameters
Scopes in the filter
SchemaClosed classes in the filter
Schema properties as defined value
Property mapping rules in the condition
Processing methods in the condition
Base objects in the definition

Variable sets are added for different instances of the variables. Each synchronization project has a default variable set, which has all the variables with a default value. The start up configuration contains a link to the variable set in use. If no variable set is given, the default variable set is used.

NOTE: If synchronization projects are updated, connection parameters from the default variable set are always used. Ensure that the variables in the default variable set contain the correct values.

A default variable set is defined if the synchronization project was creating using a default project templateClosed. You can add variables to this variable set. If the synchronization project was created without a project template, no variable sets are set up.

Create a specialized variable set to use variables with other values. You can change the values of the variables individually. Assign the specialized variable set to a start up configuration in order to use it.

The default variable set contains all variables that are required in the synchronization project. New variables are created in the default variable set. They are automatically added to all specialized variable sets, with their default values. A variable's value can also be found with a script, for example, for reading a system user's password from an external password management system.

Table 58: Meaning of icons in the variable set tool bar
Icon Meaning
Add a variable/variable set.
Delete variable/variable set.
Rename variable set.
Convert variable to script.
Convert script variable to a plain variable.
Display variable usage.
Default value for restoring the selected variable.

How to create variables

To create a variable in the default variable set

  1. Select the Configuration | Variables.

    The default variable set is displayed with all available variables in the upper part of the document view.

  2. Click in the upper view's toolbar.

  3. Edit the variable's properties.
  4. Save the changes.

To create variables from connection parameters

  1. Edit the system connection properties.

    For more information, see How to edit system connection properties.

  2. Open the Connection parameters view.
  3. Select the parameter whose value should be converted and click Convert category.

    This button is not available if the parameter has already been converted into a variable. The variable name is displayed instead.

  4. Save the changes.
Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating