Share via


catalog Tag

The catalog tag is used for configuring items specific to the Product Catalog System. There is no configuration that can be done using the catalog tag alone, it is simply a container for other tags.

The catalog tag contains two tags: joinTable and catalogSets.

joinTable Tag

This tag is used for initializing the catalog runtime objects to automatically support joining data with an external data source. It exists within a catalog tag because it is specific to the Product Catalog System. Only a single instance of the joinTable tag can exist at a time.

Joins can be performed on different tables, but only one table can be joined at a time. This cannot be done using multiple tags in the web.config file; see the SetJoinTable method for more infomation.

The following table lists the attributes of the joinTable tag.

Attribute Data Type Description
joinType String The type of join being done. The following values are valid: innerJoin, outerJoinFull, outerJoinLeft, and outerJoinRight. For more information, see CatalogJoinType Enumeration.

This attribute is required.

targetTableName String The name of the target table.

This attribute is required.

sourceJoinKey String The name of the column that will act as the join key from the source table.

This attribute is required.

targetJoinKey String The name of the column that will act as the join key in the target table.

This attribute is required.

catalogSets Tag

This tag is used for configuring the names of the catalog sets that will be used by the runtime to associate users with specific groups of catalogs.

The following table lists the attributes of the catalogSets tag.

Attribute Data Type Description
defaultAuthenticated String The name of the default catalog set to use for authenticated users. The catalog set should refer to a valid catalog set as configured through the Catalog Sets module in Commerce Server Business Desk.

For more information about creating a catalog set, see Creating a Catalog Set.

This attribute is required.

defaultAnonymous String The name of the default catalog set to use for anonymous users.

This attribute is required.

Example

<catalog>
    <joinTable 
        joinType="innerJoin | outerJoinFull | outerJoinLeft | outerJoinRight" 
        targetTableName="target-table" 
        sourceJoinKey="source-join-key" 
        targetJoinKey="target-join-key" />
    <catalogSets
        defaultAuthenticated="catalog-set-name"
        defaultAnonymous="catalog-set-name" />
</catalog>

See Also

Configuration Services

Creating a Catalog Set

CatalogContext Class

Copyright © 2005 Microsoft Corporation.
All rights reserved.