Use the CodesConnector
Use the CodesConnector to retrieve, create, update, and delete code entries in the various look-aside tables in the Profiles database.
Before starting
For information about how to configure your development environment for working with the IBM Tivoli Directory Integrator connectors, and where to place the connectors, see Setting up your development environment.
About this task
The function of the CodesConnector is to write changes to the COUNTRY, DEPARTMENT, EMP_TYPE, ORGANIZATION, and WORKLOC tables in the Profiles database. The mode setting of the connector determines what role the connector carries out in the assembly line. You can use the CodesConnector in the following modes.Table 1. CodesConnector modes
Mode Description Iterator In this mode, the CodesConnector connects to the codes table in the Profiles database, retrieves all the records, and handles them one by one. Lookup In this mode, the CodesConnector fetches records from the codes table in the Profiles database according to specified search criteria. Note: The CodesConnector only supports searches by codesId.
updateToDB In this mode, the CodesConnector updates the latest code records in the Profiles database. If a record does not already exist in the database, it is added as a new record. Note: The CodesConnector only supports searches by codesId.
delete In this mode, the CodesConnector deletes records in the codes table in the Profiles database according to specified search criteria. Note: The CodesConnector only supports searches by codesId.
addOnly In this mode, the CodesConnector adds a new record to the Profiles database. Ensure that the record that you want to add does not already exist in the Profiles database before you invoke the addOnly mode.
Procedure
- Start the Configuration Editor from the Tivoli Directory Integrator solution directory.
- To add the connector to the assembly line, open the assembly line, and then click Add Component in the Configuration Editor.
- Select Connectors, and then select CodesConnector from the Components list.
- Enter a name for the connector in the Name field.
- Select a mode from the Mode list, and then click Finish.
- After importing the connector, click the Connections tab and specify the table name.
- Optional: If you want to add the connector to your project's connector library, right-click the Connectors folder in the Configuration Browser, and then select CodesConnector from the Components list.
Parent topic
Developing custom Tivoli Directory Integrator assembly lines for Profiles
Related tasks
Setting up your development environment
});