Bookshelf Home | Contents | Index | Search | PDF

Applications Administration Guide > D&B Integration >

About Configuring D&B Integration

---

For general guidance on configuration, refer to Table 32.

Table 32.  What to Configure?

If You Need to Customize the...	Then...
Single task server processes for D&B Update Manager (D&B) or D&B Update Manager (Siebel)	Edit the dnbmaps.sql file in the ...\siebelserver\SQLTEMPL directory. Determine and make, if necessary, corresponding changes for account promotion.
Multiple task server processes for D&B Update Manager (D&B) or D&B Update Manager (Siebel)	Edit the dnbmaps.tsq file in the ...\siebelserver\SQLTEMPL directory. Determine and make, if necessary, corresponding changes for account promotion.
Account promotion	Configure the maps listed in Table 38. Determine and make, if necessary, corresponding changes in the update server processes.

A number of specific configuration topics are discussed in this section:

• Update Server Process Configuration
• Account Promotion and Prospect List Creation Configuration
• Running the D&B Update Manager (Siebel) Process Without Updating Account Name or Account Location

Update Server Process Configuration

The D&B update server processes use the Batch Real-Time Integration (RTI) technology and the RTI configuration files (dnbmaps.sql for single task and dnbmaps.tsq for multiple tasks). You can edit the RTI configuration files to suit your business requirements.

The general syntax of the RTI maps specified in the configuration files is as follows:

UPDATE_SOME_TABLE.MOD1TABLE = [Target Table to update]

UPDATE_SOME_TABLE.MOD1WHERE = [A WHERE clause]

UPDATE_SOME_TABLE.MOD1INSERT = [TRUE/FALSE]

UPDATE_SOME_TABLE.MOD1UPDATE = [TRUE/FALSE]

UPDATE_SOME_TABLE.MOD1DELETE = [TRUE/FALSE]

UPDATE_SOME_TABLE.MOD1SQL = [A Valid SQL Query]

The RTI configuration files are located in the ...\siebelserver\SQLTEMPL directory.

Field Mapping for the D&B Update Manager Process lists the default mapping for the D&B Update Manager (Siebel) server component.

Use caution when making changes to these RTI configuration files. It is recommended that you engage a qualified professional for your customization process.

CAUTION:  Do not change the default DELETE setting in the existing UPDATE* sections. Do not set DELETE to TRUE. If your business need necessitates deleting rows in the target table as part of the D&B Update Manager process, consult Siebel Professional Services for help with this customization process.

Account Promotion and Prospect List Creation Configuration

You can select specific fields that will be populated by the D&B promotion to a Siebel account or by the D&B list-creation process. These are controlled by maps in the business component user properties within the DNB Account and DNB Contact business components. These maps are listed in Table 38.

Using Siebel Tools, you can change, add, or delete source and destination field mapping. Reference the map descriptions given in Table 38 to determine which map to use for a given set of source and destination fields.

Use caution when making changes to these maps. It is recommended that you engage a qualified professional for your customization process.

CAUTION:  Although the delete capability is available, it is recommended that you deactivate unwanted map entries instead of deleting them. This is safer and can be accomplished by checking or clicking the deactivate column for the undesired entry.

You can add an entry using the following syntax:

Name Column: [MAP NAME]: [DESTINATION FIELD]

Value Column: [D&B SOURCE FIELD]

NOTE:  Each map works only with a specific Destination Business Component and a specific Source Business Component.

Running the D&B Update Manager (Siebel) Process Without Updating Account Name or Account Location

Depending on your business process, you may want to run the D&B Update Manager (Siebel) server component without updating the existing account names and account locations. This is done by editing the RTI configuration file.

TIP:  When debugging in your test environment, increase the event log level to 4 to see more details in the log file. However, it is strongly recommended that you set the level to 1 (the default) when you run in a production environment in order to prevent the log file from overflowing. For information on event logging, see Siebel Server Administration Guide.

To edit the RTI configuration file so that account names are not updated

1. Open the RTI configuration file (dnbmaps.sql for single task or dnbmaps.tsq for multiple task) in a text editor.
2. Search for UPDATE_SIEBEL_ACCOUNT.MOD1SQL under the Oracle, Microsoft SQL Server, or DB2 SQL statements.
3. Search for dnb.BUSINESS_NAME within the UPDATE_SIEBEL_ACCOUNT.MOD1SQL SELECT statement.
4. Comment out the line that begins dnb.BUSINESS_NAME... as shown.

   UPDATE_SIEBEL_ACCOUNT.MOD1SQL =

   SELECT acct.ROW_ID              ROW_ID,

   ;dnb.BUSINESS_NAME             NAME,

5. Save and close the file.

To edit the RTI configuration file so that account locations are not updated (single task)

1. Open the dnbmaps.sql file in a text editor.
2. Search for the UPDATE_SIEBEL = UPDATE_SIEBEL_ADDR_PHY... statement. This statement specifies the Siebel Table Groups to be updated when D&B Update Manager (Siebel) server component is run.
3. Within this statement, remove COMMIT, UPDATE_SIEBEL_LOC1, COMMIT, UPDATE_SIEBEL_LOC2, COMMIT, UPDATE_SIEBEL_LOC3.
4. Save and close the file.

To edit the RTI configuration file so that account locations are not updated (multiple task)

1. Open the dnbtask.cfg file in a text editor.
2. Under the [Siebel] section, comment out the line that begins Task5... as shown.

   ;;Task5 = UPDATE_SIEBEL_LOC1, COMMIT, UPDATE_SIEBEL_LOC2, COMMIT, UPDATE_SIEBEL_LOC3

3. Save and close the file.

Bookshelf Home | Contents | Index | Search | PDF