41 Working With WCC Connector Configuration Files
wcs_properties.json
contains user configurable parameters that you can edit to optimize conditions for the WCC connector and to troubleshoot.41.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 wcs_properties.json
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 thewcc-mappers.ini
file. -
wcc-mappers.ini
: Contains the rule details defined in the rules wizard. This file is paired with thewcc-matchers.ini
file. -
wcc-token.ini
: Contains a token received from WebCenter Content indicating the last time the server synchronized with WebCenter Sites.
41.2 User Configurable Parameters
The wcs_properties.json
configuration file contains several system parameters that are user configurable. These parameters are not configurable in the WebCenter Sites Admin interface.
The wcs_properties.json
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:
#wcs_properties.json 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
wcs_properties.json
configuration file is created, the default batch size is set to50
. 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
wcs_properties.json
configuration file is created, this parameter is set to a default value oftrue
. You can change this value, but you cannot leave the parameter blank and you must provide a valid value. Valid values aretrue
orfalse
. -
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
wcs_properties.json
configuration file is created, this parameter is set to a default value oftrue
. You can change this value, but you cannot leave the parameter blank and you must provide a valid value. Valid values aretrue
orfalse
. -
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 isname
, 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 aboutdDocName
, 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
wcs_properties.json
configuration file is created, this parameter is set to a default value oftrue
. Valid values aretrue
orfalse
.