Find catalog entry details by description
This service request returns a list of catalog entries that satisfy the search criteria on the description. For each returned catalog entry, the level of information provided is the same as the service getCatalogEntryDetailsByID.
Request
Request BOD GetCatalogEntry Access profile WC_CatalogEntryDetailsProfile Schema /Catalog-DataObjects/xsd/OAGIS/9.0/Overlays/IBM/Commerce/BODs/GetCatalogEntry.xsd Service data object GetCatalogEntryType
Sample request BOD
<_cat:GetCatalogEntry xmlns:_cat="http://www.ibm.com/xmlns/prod/commerce/9/catalog" xmlns:_wcf="http://www.ibm.com/xmlns/prod/commerce/9/foundation" xmlns:oa="http://www.openapplications.org/oagis/9" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <oa:ApplicationArea xsi:type="_wcf:ApplicationAreaType"> <oa:CreationDateTime> 2007-01-25T16:39:52.775Z </oa:CreationDateTime> <oa:BODID>96c0abc0-acbc-11db-ab2c-832d45b923a8</oa:BODID> <_wcf:BusinessContext> <_wcf:ContextData name="storeId">511</_wcf:ContextData> </_wcf:BusinessContext> </oa:ApplicationArea> <_cat:DataArea> <oa:Get maxItems="8" recordSetStartNumber="0"> <oa:Expression expressionLanguage="wcf:XPath"> {_wcf.ap=WC_CatalogEntryDetailsProfile&wc_nameOp=EQUAL&wc_searchTermScope=1&isSKUexcluded=true} /CatalogEntry[Description[contains(@Name,'"Corrolus" wineglasses.')]] </oa:Expression> </oa:Get> </_cat:DataArea> </_cat:GetCatalogEntry>
Response
Response BOD ShowCatalogEntry Schema /Catalog-DataObjects/xsd/OAGIS/9.0/Overlays/IBM/Commerce/BODs/ShowCatalogEntry.xsd Service data object ShowCatalogEntryType The response contains the following information:
/CatalogEntry/@catalogEntryTypeCode /CatalogEntry/CatalogEntryIdentifier/UniqueID /CatalogEntry/CatalogEntryIdentifier/ExternalIdentifier/@ownerID /CatalogEntry/CatalogEntryIdentifier/ExternalIdentifier/PartNumber /CatalogEntry/Description/@language /CatalogEntry/Description/Name /CatalogEntry/Description/ThumbNail /CatalogEntry/Description/ShortDescription /CatalogEntry/Description/FullImage /CatalogEntry/Description/LongDescription /CatalogEntry/ListPrice/Price/@currency /CatalogEntry/ListPrice/Quantity /CatalogEntry/Price/StandardPrice/Price/Price/@currency /CatalogEntry/Price/StandardPrice/Price/Quantity /CatalogEntry/Price/ContractPrice/@minimumQuantity /CatalogEntry/Price/ContractPrice/Price/Price/@currency /CatalogEntry/Price/ContractPrice/Price/Quantity /CatalogEntry/Price/ContractPrice/ContractIdentifier/UniqueID /CatalogEntry/Price/ContractPrice/ContractIdentifier/ExternalIdentifier/@majorVersionNumber /CatalogEntry/Price/ContractPrice/ContractIdentifier/ExternalIdentifier/@minorVersionNumber /CatalogEntry/Price/ContractPrice/ContractIdentifier/ExternalIdentifier/@origin /CatalogEntry/Price/ContractPrice/ContractIdentifier/ExternalIdentifier/@ownerID /CatalogEntry/Price/ContractPrice/ContractIdentifier/ExternalIdentifier/Name /CatalogEntry/CatalogEntryAttributes/@displaySequence /CatalogEntry/CatalogEntryAttributes/@language /CatalogEntry/CatalogEntryAttributes/@usage /CatalogEntry/CatalogEntryAttributes/Name /CatalogEntry/CatalogEntryAttributes/Description /CatalogEntry/CatalogEntryAttributes/StringValue/Value /CatalogEntry/CatalogEntryAttributes/IntegerValue/Value /CatalogEntry/CatalogEntryAttributes/FloatValue/Value
Sample response BOD
<_cat:ShowCatalogEntry xmlns:Oagis9="http://www.openapplications.org/oagis/9" xmlns:_cat="http://www.ibm.com/xmlns/prod/commerce/9/catalog" xmlns:_wcf="http://www.ibm.com/xmlns/prod/commerce/9/foundation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Oagis9:ApplicationArea xsi:type="_wcf:ApplicationAreaType"> <Oagis9:CreationDateTime> 2007-01-25T16:56:54.203Z </Oagis9:CreationDateTime> <Oagis9:BODID> f7db9c10-acbe-11db-986f-827045b7cf58 </Oagis9:BODID> </Oagis9:ApplicationArea> <_cat:DataArea> <Oagis9:Show recordSetCompleteIndicator="true" recordSetCount="2" recordSetStartNumber="0" recordSetTotal="2" /> <_cat:CatalogEntry catalogEntryTypeCode="ProductBean"> <_cat:CatalogEntryIdentifier> <_wcf:UniqueID>51100000117</_wcf:UniqueID> <_wcf:ExternalIdentifier ownerID="7000000000000000002"> <_wcf:PartNumber>TAWI-03</_wcf:PartNumber> </_wcf:ExternalIdentifier> </_cat:CatalogEntryIdentifier> <_cat:Description language="-1"> <_cat:Name>"Corrolus" Wineglasses</_cat:Name> <_cat:Thumbnail> images/catalog/TAWI_03_sm.jpg </_cat:Thumbnail> <_cat:FullImage> images/catalog/TAWI_03.jpg </_cat:FullImage> <_cat:ShortDescription> "Corrolus" wineglasses. </_cat:ShortDescription> <_cat:LongDescription> "Corrolus" wineglasses. </_cat:LongDescription> </_cat:Description> <_cat:CatalogEntryAttributes /> <_cat:ListPrice> <_wcf:Price currency="USD">6.95</_wcf:Price> </_cat:ListPrice> <_cat:Price> <_wcf:StandardPrice> <_wcf:Price> <_wcf:Price currency="USD">7.99</_wcf:Price> </_wcf:Price> </_wcf:StandardPrice> <_wcf:ContractPrice minimumQuantity="1.0"> <_wcf:Price> <_wcf:Price currency="USD">7.99</_wcf:Price> </_wcf:Price> <_wcf:ContractIdentifier> <_wcf:UniqueID>51100000001</_wcf:UniqueID> <_wcf:ExternalIdentifier majorVersionNumber="1" minorVersionNumber="0" origin="0" ownerID="7000000000000000002"> <_wcf:Name> ConsumerDirectATP Default Contract </_wcf:Name> </_wcf:ExternalIdentifier> </_wcf:ContractIdentifier> </_wcf:ContractPrice> </_cat:Price> </_cat:CatalogEntry> <_cat:CatalogEntry catalogEntryTypeCode="ItemBean"> <_cat:CatalogEntryIdentifier> <_wcf:UniqueID>51100000118</_wcf:UniqueID> <_wcf:ExternalIdentifier ownerID="7000000000000000002"> <_wcf:PartNumber>TAWI-0301</_wcf:PartNumber> </_wcf:ExternalIdentifier> </_cat:CatalogEntryIdentifier> <_cat:Description language="-1"> <_cat:Name>"Corrolus" Wineglasses</_cat:Name> <_cat:Thumbnail> images/catalog/TAWI_03_sm.jpg </_cat:Thumbnail> <_cat:FullImage> images/catalog/TAWI_03.jpg </_cat:FullImage> <_cat:ShortDescription> "Corrolus" wineglasses. </_cat:ShortDescription> <_cat:LongDescription> "Corrolus" wineglasses. </_cat:LongDescription> </_cat:Description> <_cat:CatalogEntryAttributes /> <_cat:ListPrice> <_wcf:Price currency="USD">6.95</_wcf:Price> </_cat:ListPrice> <_cat:Price> <_wcf:StandardPrice> <_wcf:Price> <_wcf:Price currency="USD">7.99</_wcf:Price> </_wcf:Price> </_wcf:StandardPrice> <_wcf:ContractPrice minimumQuantity="1.0"> <_wcf:Price> <_wcf:Price currency="USD">7.99</_wcf:Price> </_wcf:Price> <_wcf:ContractIdentifier> <_wcf:UniqueID>51100000001</_wcf:UniqueID> <_wcf:ExternalIdentifier majorVersionNumber="1" minorVersionNumber="0" origin="0" ownerID="7000000000000000002"> <_wcf:Name> ConsumerDirectATP Default Contract </_wcf:Name> </_wcf:ExternalIdentifier> </_wcf:ContractIdentifier> </_wcf:ContractPrice> </_cat:Price> </_cat:CatalogEntry> </_cat:DataArea> </_cat:ShowCatalogEntry>
Usage
To use this service request on a JSP page use the expression-builder findCatalogEntriesDetailsByDescription. This maps to the following XPath expression:
{_wcf.ap=$accessProfile$;wc_nameOp=$nameOp$;wc_searchTermScope=$searchTermScope$;wc_isSKUexcluded=$isSKUexcluded$}/CatalogEntry[Description[contains(@ShortDescription,'$description$')]]
The defaults are the following values:
- accessProfile=WC_CatalogEntryDetailsProfile
- searchTermScope=1
- isSKUexcluded=true
A searchTermScope set to 1 indicates that the column CATENTDESC.name and CATENTDESC.shortdescription is used in the search query.
The parameter nameOP can take 2 different values: "LIKE" or "EXACT"; the parameter description specifies the term to search for. If nameOp is set to EXACT then the databean will perform an exact match search for the term description. If the nameOp is set to LIKE then the data bean will perform a like search for the term description.
This service request uses the
CatEntrySearchListDataBean data bean.
Exceptions
If there is an error the error is reported in the Response message. You can see the error details in the trace log, SystemOut.log.
Customization
The following extensions are supported:
- Create your own implementation of the interface ComposeCatalogEntryTaskCmd. The ComposeCatalogEntryTaskCmd and yourAccessProfileName control the information returned by the service.
Related concepts
../../com.ibm.commerce.business_process.doc/concepts/processFind_product_(ConsumerDirect).htm
Design pattern for Get service implementation
Related Reference
WebSphere Commerce foundation tag library