CatalogGroupAdd URL
This URL adds a new catalog group and its description, and adds a relationship between the new catalog group and the store.
URL structure
- http:// host_name/path/
- The fully qualified name of your Transaction server and the configuration path.
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 HCL internal use.
- name
- The language-dependent name of the catalog group.
- published
- Indicates whether 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 identifier 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
- If catgroupIdParent and catalogID are supplied, then the newly created catalog group will be a subcategory of the catgroupIdParent (a new row in the CATGRPREL table in the database will be added).
- If the catgroupId is supplied and a new language ID is supplied, then a description for the catalog group will be created. However, we recommend that you use the CatalogGroupUpdate command when creating or updating a catalog group description.
Exception condition
Duplicate key (identifier) has already been used.