Certain target systems support the definition of a scope based on the hierarchy of existing target system objects. The limits the number of objects to load in the . 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 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.
To select all objects that match certain criteria, use the wizard.
To create a hierarchy filter using the wizard
-
In the hierarchy filter's toolbar, click 
.
-
Enter a search pattern.
Select whether you want to filter objects by wildcard or regular expression.
-
To apply the search criteria, click Assign.
You can apply different search patterns one after another.
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
-
Click Convert into a variable.
- Confirm the security prompt with Yes.
The hierarchy filter is saved as variable. To change the filter, edit the variable.
Related topics
You can use variables to create generally applicable 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 .
Variables can be used in the following definitions.
| System connections |
in parameters |
| Scopes |
in the filter |
| 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 . You can add variables to this variable set. If the synchronization project was created without a project template, no variable sets are set up.
The default variable set contains all variables that are required in the synchronization project. New variables are created in the default variable set.
Create a specialized variable set to use variables with other values. You can change the values of the variables individually. Specialized variable sets only contain variables with modified values. Assign the specialized variable set to a start up configuration in order to use it.
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 59: Meaning of icons in the variable set tool bar
|
|
Add a variable/variable set. |
|
|
Delete variable/variable set. |
|
|
Rename variable set. |
|
|
Convert variable to script. |
|
|
Convert to a plain variable. |
|
|
Display variable usage. |
|
|
Default value for restoring the selected variable. |
To create a variable in the default variable set
- Select the Configuration > Variables.
The default variable set is displayed with all available variables in the upper part of the document view.
-
Click in the upper view's toolbar.
- Edit the variable's properties.
- Save the changes.
To create variables from connection parameters
- Edit the system connection properties.
For more information, see How to edit system connection properties.
- Open the Connection parameters view.
- 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.
- Save the changes.
Related topics
NOTE: Variable labeled as system variables cannot be modified.
To edit a variable in the default variable set
- Select the Configuration > Variables category.
The default variable set is displayed with all available variables in the upper part of the document view.
- Select a variable in the default variable set.
- Edit the variable's properties.
- Save the changes.
To edit a variable in the specialized variable set
- Select the Configuration > Variables category.
All specialized variable sets are shown in the lower part of the document view.
- Open a specialized variable set in the variable set view.
- Select a variable and enter a new value.
- Save the changes.
