CatalogGroupAdd command

This command adds a new catalog group and its description, and adds a relationship between the new catalog group and the store. This command is called by the Product Management tools in the WebSphere Commerce Accelerator.

Command structure

http://host_name/path/
The fully qualified name of your WebSphere Commerce Server and the configuration path.

Diagram of the command structure: the command starts with the fully qualified name of your WebSphere Commerce Server and the configuration path, followed by the command name, CatalogGroupAdd  and the ? character. End the command with a list of parameters in the form of name value pairs. Separate each name value pair with the & character. For a detailed description of the parameters and their values, refer to the list entitled Parameter values.

Parameter values

catgroupId
(Required) The reference number of the catalog group. The catalog group ID creates a language-dependent catalog group description on a created or existing catalog group. You must specify either catgroupId or identifier.
identifier
(Required) The external identifier of the catalog group. You must specify either identifier or catgroupId.
catalogId
The ID of the catalog that the new catalog group belongs to.
catgroupIdParent
The parent catalog group of the newly created catalog group.
field1
A customizable field.
field2
A customizable field.
markForDelete
Indicates if the catalog group is marked for deletion.
display
Reserved for IBM internal use.
name
The language-dependent name of the catalog group.
published
Indicates whether or not this catalog group should be displayed for the language indicated by the descLangId: 0= no, and 1= yes.
fImage
The full image path for the catalog group.
descLangId
The description of the language's reference number.
lDesc
The long description of the catalog group.
sDesc
The short description of the catalog.
tImage
The thumbnail image path for the catalog group.
URL
The URL to be called when the command completes successfully.

Example 1

The following example creates a catalog group, with testCatalogGroup2 as the identifer and NoLangSpecified as the name, in the logon language:

http://host_name/webapp/wcs/stores/servlet/CatalogGroupAdd?identifier=
testCatalogGroup2&keyword=a keyword&field1=hello&field2=world&display=
TestJSP&name=NolangSpecified&markForDelete=0&lDesc=long 
description&sDesc=short description&URL=LogonForm

Example 2

The following example creates a category, with TestCatalogGroup3 as the identifier and NoName1 as the name, in the logon language. The newly created catalog group will be assigned as a subcategory of catalog group 9000 in catalog 7002:

http://host_name/webapp/wcs/stores/servlet/CatalogGroupAdd?identifier=
TestCatalogGroup3&field1=hello&field2=world&display=TestJSP&name=
NoName1&markForDelete=0&catalogId=7002&catgroupIdParent=9000&URL=LogonForm

Example 3

The following example creates a description, with testCatalogGroup2 as the name, for catalog group 10002:

http://host_name/webapp/wcs/stores/servlet/CatalogGroupAdd?catgroupId=
10002&display=TestJSP2&name=testCatalogGroup2&descLangId=-2&URL=LogonForm

Example 4

The following example creates a catalog group, with DemoStoreCatGroup1 as the identifier and NolangSpecified as the name, in the logon language:

http://host_name/webapp/wcs/stores/servlet/CatalogGroupAdd?identifier=
DemoStoreCatGroup1&field1=hello&field2=world&display=TestJSP&name=
NolangSpecified&markForDelete=0&URL=LogonForm

Example 5

The following example creates a catalog group, with addGroup12 as the identifier and catGroup11 as the name:

http://host_name/webapp/wcs/stores/servlet/CatalogGroupAdd?identifier=
addGroup12&field1=hello&field2=world&display=catGroup11&name=
catGroup11&descLangId=-1&URL=LogonForm

Example 6

The following example creates a catalog group, with DemoStoreCatGroup2 as the identifier and catGroup11 as the name:

http://host_name/webapp/wcs/stores/servlet/CatalogGroupAdd?identifier=
DemoStoreCatGroup2&field1=hello&field2=world&display=catGroup11&name=
catGroup11&descLangId=-1&URL=LogonForm

Behavior

Exception condition

Duplicate key (identifier) has already been used.