Configuration properties in the infrastructure component

The infrastructure component configuration file, wc-admin-component.xml, contains properties that are related to configuring and customizing Search Engine Optimization and Management Center features. You can change the properties to suit the requirements of your site by creating a custom wc-admin-component.xml file that contains the changed properties only.

The infrastructure component configuration file is stored at this location: workspace_dir\WC\xml\config\com.ibm.commerce.infrastructure\wc-admin-component.xml

The infrastructure component configuration file is divided into several sections, and the file itself contains embedded information and examples for the properties in each section. The following tables summarize the types of configurable properties in the file:

Configuration properties for SEORuntime

The following table summarizes the properties available for configuring SEO URLs for your store.
Section of infrastructure component configuration file Purpose of properties within the section
SEO configuration parameters for Marketing.
productURLPatternName
Defines the URL pattern name that is used for marketing content recommendation URL creation for products, this URL pattern name is defined in the pattern files. This URL pattern name is defined in the pattern files.
categoryURLPatternName
Defines the URL pattern name that is used for marketing content recommendation URL creation for categories, this URL pattern name is defined in the pattern files.
SEO configuration parameters for the SEO URL Keyword generator.
URLloadingConfigs
Specifies the 3 URL loader configuration files to load: Product_URL, Product_Item_URL and Category_URL for the SEO URL keyword generator. For example, product.xml, item.xml, and category.xml.
InvalidString
This property specifies the replacement values for characters that are invalid for URL creation, such as substituting a dash (\x3f) for the invalid question mark (?) character. The default values are
  • \x22 ,\x3F ,\x5F ,\x3D ,\x23 ,\x2F ,\x20 ,\x7E ,\x26 ,\x27 ,\x2E ,\x2C ,\x2B
  • \x25
which replace the following default invalid characters:
  • " ? _ = # / ' ' ~ & ' . , +
  • %
For customization, ensure that the InvalidString values are URL encoded values, such as \x7B for the { character.
fixedString
This property specifies the replacement values for characters that are invalid for URL creation, such as substituting a dash (-) for the invalid question mark (?) character. The default values are
  • " ,- ,- ,- ,- ,- ,- ,- ,- , , ,- , "
which replace the following default invalid characters:
  • " ? _ = # / ' ' ~ & ' . , +
autoGenerateKeywords
This property can be used to disable automatic URL keyword generation in Management Center when users create products and categories. This disablement can be helpful if you generate your SEO URL keywords by some other means, for example, by using the seourlkeywordgen script or the Data Load utility.
InvalidName
InvalidName specifies the URL string that must be changed. InvalidName is used with fixedName.
fixedName
fixedName, and InvalidName specify how to substitute strings in generated URLs. InvalidName specifies the strings that must be changed, and fixedName specifies the substitution strings to use instead.
For example, you want to replace all occurrences of ("?_) with dashes (-). Add the following configuration to the wc-admin-component.xml file:
<_config:property name="InvalidName" value="\x22\x3F\x5F"
    />
<_config:property name="fixedName" value="-"/>
Adding the configuration can change this URL http://mycompany/mystore/myproduct"?_blue"?_large to this http://mycompany/mystore/myproduct-blue-large.

InvalidName and fixedName can have more than 1 string value. Each value must be separated by a comma. For example, the following configuration replaces three quotation marks (""") with one dash (-), three question marks (???) with one dot (.), and three underscores (___)with one plus sign (+): <_config:property name="InvalidName" value="\x22\x22\x22, \x3F\x3F\x3F, \x5F\x5F\x5F"/> <_config:property name="fixedName" value="-,-,-"/>

SEO configuration parameters for the Management Center UI.
invalidURLCharactersList
Specifies that Management Center is to block users from inputting any keywords that contain the following characters. The default values that are blocked are:
  • "_,?,=,#,/,.,"
  • "%"
allowAmpersands
Specifies that Management Center is to block users from inputting any keywords that contain an ampersand (&) character. The default value is true, which allows the use of ampersands.
allowSpaces
Specifies whether Management Center is to block users from inputting spaces in SEO URLs or not. The default value is fales, which does not allow the use of spaces.
SEO configuration parameters for the Redirect Engine.
numberOfDays
Specifies how long the redirect rule remains active.
redirectHitCountBatchUpdateSize
Specifies how many redirect hits can accumulate before the Redirect Engine updates the RedirectHitCount into the database.

Configuration properties for controlling folders

The following table summarizes the available properties for configuring Management Center folders.
Section of infrastructure component configuration file Purpose of properties within the section
Configuration parameters for control folder deletion behavior for each folder usage.
AllowDeleteFolderWithChildFolders
Specifies whether business users, by default, can delete a folder if the folder has subfolders. If a folder has any objects other than subfolders within it, the folder can still be deleted. Any object that is included within a folder is not deleted with the folder, but the relationship between the folder and the object is deleted.
Each folder usage type can have a different configuration setting that indicates whether users can delete folders that contains subfolders. The usage type of a folder is indicated by the property name:
IBM_PromotionFolder
The default value is false.
IBM_AttributeFolder
The default value is false.
IBM_ContentFolder
The default value is false.
IBM_EMarketingSpotFolder
The default value is false.
IBM_CustomerSegmentFolder
The default value is false.
IBM_ActivityFolder
The default value is false.
IBM_ContentPageFolder
The default value is false.
IBM_LayoutFolder
The default value is false.
where:
true
This value indicates that users can delete a folder that contains subfolders. By deleting a folder, a user is deleting all of the contents, including subfolders, that are contained within a folder.
false
The default value. Indicates that a user cannot delete a folder that contains any subfolders. A user must first delete all subfolders before they can delete the folder. This value also indicates that users in an extended sites store model cannot delete a folder in a store if it contains subfolders that are owned by another store. For example, a user in an asset store cannot delete a folder that contains a subfolder that is owned by an extended site store.