Changing system connection settings of SharePoint Online tenants
When you set up synchronization for the first time, the system connection properties are set to default values that you can modify. There are two ways to do this:
-
Specify a specialized variable set and change the values of the affected variables.
The default values remain untouched in the default variable set. The variables can be reset to the default values at any time. (Recommended action).
-
Edit the target system connection with the system connection wizard and change the effected values.
The system connection wizard supplies additional explanations of the settings. The default values can only be restored under particular conditions.
Detailed information about this topic
Editing connection parameters in the variable set
The connection parameters were saved as variables in the default variable set when synchronization was set up. You can change the values in these variables to suit you requirements and assign the variable set to a start up configuration and a base object. This means that you always have the option to use default values from the default variable set.
NOTE: To guarantee data consistency in the connected target system, ensure that the start-up configuration for synchronization and the base object for provisioning use the same variable set.
To customize connection parameters in a specialized variable set
-
In the Synchronization Editor, open the synchronization project.
-
Select the Configuration > Target system category.
-
Open the Connection parameters view.
Some connection parameters can be converted to variables here. For other parameters, variables are already created.
-
Select a parameter and click Convert.
-
Select the Configuration > Variables category.
All specialized variable sets are shown in the lower part of the document view.
-
Select a specialized variable set or click on in the variable set view's toolbar.
-
Select the previously added variable and enter a new value.
-
Select the Configuration > Start up configurations category.
-
Select a start up configuration and click Edit.
-
Select the General tab.
-
Select the specialized variable set in the Variable set menu.
-
Select the Configuration > Base objects category.
-
Select the base object and click .
- OR -
To add a new base object, click .
-
Select the specialized variable set in the Variable set menu.
- Save the changes.
For more information about using variables and variable sets, or restoring default values and adding base objects, see the One Identity Manager Target System Synchronization Reference Guide.
Related topics
Editing target system connection properties
You can also use the system connection wizard to change the connection parameters. If variables are defined for the settings, the changes are transferred to the active variable set.
NOTE: In the following circumstances, the default values cannot be restored:
In both these cases, the system connection wizard overwrites the default values. They cannot be restored at a later time.
To edit connection parameters using the system connection wizard
-
In the Synchronization Editor, open the synchronization project.
-
In the toolbar, select the active variable set to be used for the connection to the target system.
NOTE: If the default variable set is selected, the default values are overwritten and cannot be restored at a later time.
-
Select the Configuration > Target system category.
-
Click Edit connection.
This starts the system connection wizard.
-
Follow the system connection wizard instructions and change the relevant properties.
- Save the changes.
Related topics
Updating schemas
All the schema data (schema types and schema properties) of the target system schema and the One Identity Manager schema are available when you are editing a synchronization project. Only a part of this data is really needed for configuring synchronization. If a synchronization project is finished, the schema is compressed to remove unnecessary data from the synchronization project. This can speed up the loading of the synchronization project. Deleted schema data can be added to the synchronization configuration again at a later point.
If the target system schema or the One Identity Manager schema has changed, these changes must also be added to the synchronization configuration. Then the changes can be added to the schema property mapping.
To include schema data that have been deleted through compression and schema modifications in the synchronization project, update each schema in the synchronization project. This may be necessary if:
To update a system connection schema
-
In the Synchronization Editor, open the synchronization project.
-
Select the Configuration > Target system category.
- OR -
Select the Configuration > One Identity Manager connection category.
-
Select the General view and click Update schema.
- Confirm the security prompt with Yes.
This reloads the schema data.
To edit a mapping
-
In the Synchronization Editor, open the synchronization project.
-
Select the Mappings category.
-
Select a mapping in the navigation view.
Opens the Mapping Editor. For more information about mappings, see the One Identity Manager Target System Synchronization Reference Guide.
NOTE: The synchronization is deactivated if the schema of an activated synchronization project is updated. Reactivate the synchronization project to synchronize.