You can pass parameters to a dimension data converter that you create or modify. Use the production-property and conversion-property elements to define these parameters in the DimensionProperties.xml files for your Oracle ATG Web Commerce products. A dimension data converter will use the parameters when it converts specific production repository items before they are loaded into your data warehouse.

The production-property Element

Include the production-property element in a warehouse-property element to pass the name of a production repository item to a dimension converter component. The production-property element is shown in the example below.

<data-warehouse-repository-item item="product" natural-key="productId">
  <production-repository
    repository="/atg/commerce/catalog/ProductCatalog"
    nickname="catalog">
    <production-repository-item item="product"/>
  </production-repository>
  <property-mappings>
    <warehouse-property
      name="parentCategory"
      conversion-component="/atg/reporting/datawarehouse/process/
                            converter/ProductParentCategoryConverter">

      <production-property
        name="catalog.product"<!-- This attribute indicates the production
                                   repository item. The name "catalog" refers
                                   to the nickname of the production repository
                                   specified in the production-respository
                                   element above. -->
        conversion-context-name="product"/>

    </warehouse-property>
  </property-mappings>
</data-warehouse-repository-item>

The following table explains the attributes of the production-property element.

Attribute

Explanation

name

The identifier of a production repository item. Include the nickname of the production repository specified in the production-repository element of a data-warehouse-repository-item element. For example, catalog.product.

conversion-context-name

An identifier for the parameter. Use this identifier in your dimension data converter implementation.

The conversion-property Element

Include the conversion-property element in a warehouse-property element when you need to pass additional parameters to a dimension converter component. The conversion-property element is shown in the example below.

<warehouse-property
  name="parentCategory"
  conversion-component="/atg/reporting/datawarehouse/process/
                        converter/ProductParentCategoryConverter">
  <production-property
    name="catalog.product"
    conversion-context-name="product"/>

  <conversion-property
    property-value="1"
    property-type="java.lang.Integer"
    conversion-context-name="productIndex"/>

</warehouse-property>

The following table explains the attributes of the conversion-property element.

Attribute

Explanation

property-value

The value that is passed to the dimension data converter.

property-type

The Java data type of the value that is passed to the dimension data converter.

conversion-context-name

An identifier for the parameter. Use this identifier in your dimension data converter implementation.