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
|Display name for the schema to which the scope will be applied.
|Scope display name. The name must be unique within a .
|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.
|All schema types with a filter are marked.
|A filter is defined and effective.
|A filter is effective.
|Specify the filter condition for the scope. Select an object type in the scope hierarchy for this.
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.
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.
|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.
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 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 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
- 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.
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.
|in the filter
|in the filter
|as defined value
|Property mapping rules
|in the condition
|in the condition
|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.
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
|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.
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.