35 Working With WCC Connector Configuration Files

During the WCC Integration process, you need to use some configuration files. The wcc-integration.ini file contains user configurable parameters that you can edit to optimize conditions for the WCC connector and to troubleshoot.

35.1 About WCC Connector Configuration Files

WCC connector configuration files consist of several INI files located in the /Shared/clustersynch/ucm/ini directory of the WebCenter Sites installation. The only file that may require editing is the wcc-integration.ini file, which is used to optimize conditions for the WCC connector and to troubleshoot.

Note:

The following configuration files must not be edited. They are used internally for data storage:

  • wcc-matchers.ini: Contains the rule statements that are created using the rules wizard in the WebCenter Sites Connector Admin tab. Each rule is listed by name and identified as either enabled or disabled. Also included are a description of the rule and its statement logic. This file is paired with the wcc-mappers.ini file.

  • wcc-mappers.ini: Contains the rule details defined in the rules wizard. This file is paired with the wcc-matchers.ini file.

  • wcc-token.ini: Contains a token received from WebCenter Content indicating the last time the server synchronized with WebCenter Sites.

35.2 User Configurable Parameters

The wcc-integration.ini configuration file contains several system parameters that are user configurable. These parameters are not configurable in the WebCenter Sites Admin interface.

The wcc-integration.ini configuration file is located in the /Shared/clustersynch/ucm/ini directory of the WebCenter Sites installation, and it uses the Java property file format, as shown in the following example:

#wcc-integration.ini
wcc.batch.size=50
wcc.batch.autorepeat=true
wcc.download.dir=C\:\\Oracle\\WebCenter\\Sites\\tomcat\\temp
wcc.download.autoclean=true
wcc.keyfield=name
wcc.rule.case-sensitive=true

Parameters listed in the example above are user configurable and defined as follows:

  • wcc.batch.size=[50]

    When you process a large amount of content in batches, this parameter specifies the maximum size of the batch.

    When the wcc-integration.ini configuration file is created, the default batch size is set to 50. You can change this value, but you cannot leave the parameter blank and you must provide a valid value.

  • wcc.batch.autorepeat=[true | false]

    If the connector runs and receives a response that the total number of items exceeds the number defined in the wcc.batch.size parameter, then you can set the connector to either automatically run again after the batch is processed (true), or the connector can wait for the next manual or next timed run (false).

    When the wcc-integration.ini configuration file is created, this parameter is set to a default value of true. You can change this value, but you cannot leave the parameter blank and you must provide a valid value. Valid values are true or false.

  • wcc.download.dir=[temporary_zip_file_location]

    This parameter defines the temporary download location of the ZIP files that are transferred from WebCenter Content.

  • wcc.download.autoclean=[true | false]

    This parameter defines whether to delete the ZIP file when processing is complete. This is a debugging parameter that either forces the temporary files to be cleaned up (true), or leaves files on disk for analysis (false).

    When the wcc-integration.ini configuration file is created, this parameter is set to a default value of true. You can change this value, but you cannot leave the parameter blank and you must provide a valid value. Valid values are true or false.

  • wcc.keyfield=[name]

    This parameter specifies the name of the asset type attribute that receives the value of the dDocName metadata field in WebCenter Content. By default, the value of wcc.keyfield is name, because name is a default attribute available in every asset type. It is uncommon to change this value.

    You can change this one time, on a new system, before rules are created, and before content synchronization begins. After synchronization starts, you should not edit this value. Otherwise, assets can be duplicated. An example situation where the default value could be changed is when the name field is in use. For more information about dDocName, see Content Identifier Attribute.

  • wcc.rule.case-sensitive=[true | false]

    This parameter is used to compare string metadata values specified in connector rules with the actual metadata values of content items. If the parameter is set to true, case-sensitivity is enabled.

    When the wcc-integration.ini configuration file is created, this parameter is set to a default value of true. Valid values are true or false.