Change REST configuration properties in the component configuration file (wc-component.xml)

To change any properties in the component configuration file (wc-component.xml) for REST, we must create a customized version of the file in a new folder. The customized version of the file must contain only the changed properties.

Before beginning

To understand the REST-related properties that this file contains, see REST configuration properties in the component configuration file (wc-component.xml).

Procedure

1. Open WebSphere Commerce Developer and switch to the Enterprise Explorer view.

2. Create a custom component configuration file (wc-component.xml), if one does not already exist:

   1. Navigate to the following path:

      workspace_dir\WC\xml\config\

   2. In the config folder, create a new com.ibm.commerce.component_name-ext folder so the path looks like this:

      workspace_dir\WC\xml\config\com.ibm.commerce.component_name-ext\

      Where component_name is the name of the component. For example. catalog or foundation.

      If this folder already exists and it contains a customized version of the wc-component.xml file, then open the file and skip to step 4.

   3. Create an empty wc-component.xml file in the com.ibm.commerce.component_name-ext folder. This file is our custom wc-component.xml file.

3. Add the basic XML elements required for our custom wc-component.xml file:

   1. Open your empty custom wc-component.xml file in an XML editor.

   2. Copy the following code into the file:

      <?xml version="1.0" encoding="UTF-8"?>
      <_config:DevelopmentComponentConfiguration
      	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      	xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config ../xsd/wc-component.xsd "
      	xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config">
      
          <_config:extendedconfiguration>
      
      	
          </_config:extendedconfiguration>
      	
      </_config:DevelopmentComponentConfiguration>

4. Add the XML for any properties to change to our custom wc-component.xml file:

   1. Navigate to the default component configuration file at the following path:

      workspace_dir\WC\xml\config\com.ibm.commerce.component_name\wc-component.xml

      Never change properties directly in this file because our changes will be overwritten with future IBM software updates.

   2. Copy the XML elements for the properties we want to change from the default component configuration file to our custom wc-component.xml file. Insert the copied XML elements after the <_config:extendedconfiguration> element.

      Even though we are copying only certain elements, we must maintain the XML hierarchy for those elements in the file. For example, to change the property defined in a specific <_config:property> element, we must retain the parent and ancestor elements of the <_config:property> element, but we can delete all the siblings if we are not changing them. See the example at the end of this topic.

   3. Change the values for the copied properties as required.

5. Save and close the custom configuration file.

6. Test the configuration changes.