Configuration properties in the infrastructure component

Configuration properties in the infrastructure component

The infrastructure component configuration file, wc-admin-component.xml, contains properties related to configuring and customizing Search Engine Optimization and Management Center features. We can change the properties to suit the requirements of the 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 the store.
Section of infrastructure component configuration file Purpose of properties within the section
SEO configuration parameters for Marketing.
productURLPatternName

Defines the URL pattern name 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 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, 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, we 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. Default 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 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

Default is false.

IBM_AttributeFolder

Default is false.

IBM_ContentFolder

Default is false.

IBM_EMarketingSpotFolder

Default is false.

IBM_CustomerSegmentFolder

Default is false.

IBM_ActivityFolder

Default is false.

IBM_ContentPageFolder

Default is false.

IBM_LayoutFolder

Default 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.

Related concepts
Customizing the infrastructure component

Related tasks
Changing configuration properties for the Infrastructure component

Related reference
Customizing the SEO component configuration properties

Section of infrastructure component configuration file	Purpose of properties within the section
SEO configuration parameters for Marketing.	productURLPatternName Defines the URL pattern name 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 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, 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, we 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. Default 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.