You can use this expandable item to view and modify the delimited text file schema saved in the configuration database.
When you create a connection to a delimited text file, 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 configuration database. 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 could correctly handle (read and write) the data in the changed file.
This expandable item provides the following options:
-
Attributes: Lists the names of 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 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 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 configuration database.
-
Edit: Allows you to edit the name of the selected 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 configuration database. Also you can use this button to edit the display name of a 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 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 configuration database.
-
Reload scheme: Allows you to update the file schema saved in the configuration database by reloading the schema from the file to the configuration database. As a result, the file schema saved in the 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.
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.
This section describes how to create or modify a connection to Microsoft SQL Server so that could work with data in that data system.
To create a connection to Microsoft SQL Server, use the Microsoft SQL Server Connector included by default in the Active Roles .
The Microsoft SQL Server Connector supports the following features:
Table 41: Microsoft SQL Server Connector – Supported features
Bidirectional synchronization
Specifies whether you can both read and write data in the connected data system. |
Yes |
Delta processing mode
Specifies whether the connection can process only the data that has changed in the connected data system since the last synchronization operation. This reduces the overall synchronization duration. |
No |
Password synchronization
Specifies whether you can synchronize user passwords from an Active Directory (AD) domain to the connected data system. |
Yes |
You can create a new Microsoft SQL Server connection in the .
To create a new connection
- In the , open the Connections tab.
- Click Add connection, then use the following options:
-
Click Next.
-
On the Specify connection settings page, use the following options:
-
SQL Server: Type or select the name of the SQL Server computer that hosts the database you want to participate in data synchronization operations.
-
Access SQL Server using: Select an access option:
-
Use Windows authentication: Allows you to access the SQL Server in the security context of the account under which the is running.
-
Use SQL Server authentication: Allows you to access the SQL Server in the security context of the SQL Server user account whose user name and password you specify below this option.
-
Test Connection: Click this button to verify the specified connection settings.
-
Click Next.
-
On the Specify how to select and modify data page, use the following options:
-
Use data from this table: Allows you to select a database table that includes the data you want to participate in the synchronization operations. You can click Preview to preview the database table you have selected.
-
Use an SQL query to specify data: Allows you to compose an SQL query that provides a more flexible way for specifying the data for synchronization. For example, you can use this option to specify multiple database tables.
-
Configure Settings: Provides settings for modifying data in the connected system during synchronization operations. For example, you can specify the database tables in which you want to insert, update, or delete data during synchronization operations.
-
Click Next.
-
On the Specify attributes to identify objects page, use the following options:
-
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.
-
To finish creating the connection to the Microsoft SQL Server database, click Finish.