Find catalog entry summary 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 getCatalogEntrySummaryByID. By default, the SKUs are excluded from the search result due to performance consideration.
Request
Request BOD GetCatalogEntry Access profile WC_CatalogEntrySummaryProfile Schema /Catalog-DataObjects/xsd/OAGIS/9.0/Overlays/IBM/Commerce/BODs/GetCatalog.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-25T14:56:42.440Z </oa:CreationDateTime> <oa:BODID>2d31ffa0-acae-11db-9a59-832d45b90b7a</oa:BODID> <_wcf:BusinessContext> <_wcf:ContextData name="storeId">10001</_wcf:ContextData> <_wcf:ContextData name="catalogId">10001</_wcf:ContextData> </_wcf:BusinessContext> </oa:ApplicationArea> <_cat:DataArea> <oa:Get> <oa:Expression expressionLanguage="wcf:XPath"> {_wcf.ap=WC_CatalogEntrySummaryProfile&wc_nameOp=EQUAL&wc_searchTermScope=1&isSKUexcluded=true} /CatalogEntry[Description[contains(@ShortDescription,'Kevlar Brake Pads')]] </oa:Expression> </oa:Get> </_cat:DataArea> </_cat:GetCatalogEntry>
Response
Response BOD ShowCatalogEntry Schema /Catalog-DataObjects/xsd/OAGIS/9.0/Overlays/IBM/Commerce/BODs/ShowCatalog.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/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
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-25T14:56:44.192Z </Oagis9:CreationDateTime> <Oagis9:BODID> 2e530000-acae-11db-83a9-832d45b8fe37 </Oagis9:BODID> </Oagis9:ApplicationArea> <_cat:DataArea> <Oagis9:Show recordSetCompleteIndicator="true" recordSetCount="4" recordSetStartNumber="0" recordSetTotal="4" /> <_cat:CatalogEntry catalogEntryTypeCode="ProductBean"> <_cat:CatalogEntryIdentifier> <_wcf:UniqueID>10001</_wcf:UniqueID> <_wcf:ExternalIdentifier ownerID="7000000000000000002"> <_wcf:PartNumber>A0000101</_wcf:PartNumber> </_wcf:ExternalIdentifier> </_cat:CatalogEntryIdentifier> <_cat:Description language="-1"> <_cat:Name>Kevlar Brake Pads</_cat:Name> <_cat:Thumbnail> images/Brake_Pad1-50.jpg </_cat:Thumbnail> <_cat:ShortDescription> Kevlar Brake Pads </_cat:ShortDescription> </_cat:Description> <_cat:ListPrice> <_wcf:Price currency="USD">26.75</_wcf:Price> </_cat:ListPrice> <_cat:Price> <_wcf:StandardPrice> <_wcf:Price> <_wcf:Price currency="USD">26.75</_wcf:Price> </_wcf:Price> </_wcf:StandardPrice> <_wcf:ContractPrice minimumQuantity="1.0"> <_wcf:Price> <_wcf:Price currency="USD">26.75</_wcf:Price> </_wcf:Price> <_wcf:ContractIdentifier> <_wcf:UniqueID>10001</_wcf:UniqueID> <_wcf:ExternalIdentifier majorVersionNumber="1" minorVersionNumber="0" origin="0" ownerID="7000000000000000002"> <_wcf:Name> AdvancedB2BDirect Contract number 1234 </_wcf:Name> </_wcf:ExternalIdentifier> </_wcf:ContractIdentifier> </_wcf:ContractPrice> </_cat:Price> </_cat:CatalogEntry> <_cat:CatalogEntry catalogEntryTypeCode="ItemBean"> <_cat:CatalogEntryIdentifier> <_wcf:UniqueID>10002</_wcf:UniqueID> <_wcf:ExternalIdentifier ownerID="7000000000000000002"> <_wcf:PartNumber>A0000106</_wcf:PartNumber> </_wcf:ExternalIdentifier> </_cat:CatalogEntryIdentifier> <_cat:Description language="-1"> <_cat:Name>Kevlar Brake Pads</_cat:Name> <_cat:Thumbnail> images/Brake_Pad1-50.jpg </_cat:Thumbnail> <_cat:ShortDescription> Kevlar Brake Pads </_cat:ShortDescription> </_cat:Description> <_cat:ListPrice> <_wcf:Price currency="USD">26.75</_wcf:Price> </_cat:ListPrice> <_cat:Price> <_wcf:StandardPrice> <_wcf:Price> <_wcf:Price currency="USD">26.75</_wcf:Price> </_wcf:Price> </_wcf:StandardPrice> <_wcf:ContractPrice minimumQuantity="1.0"> <_wcf:Price> <_wcf:Price currency="USD">26.75</_wcf:Price> </_wcf:Price> <_wcf:ContractIdentifier> <_wcf:UniqueID>10001</_wcf:UniqueID> <_wcf:ExternalIdentifier majorVersionNumber="1" minorVersionNumber="0" origin="0" ownerID="7000000000000000002"> <_wcf:Name> AdvancedB2BDirect Contract number 1234 </_wcf:Name> </_wcf:ExternalIdentifier> </_wcf:ContractIdentifier> </_wcf:ContractPrice> </_cat:Price> </_cat:CatalogEntry> <_cat:CatalogEntry catalogEntryTypeCode="ItemBean"> <_cat:CatalogEntryIdentifier> <_wcf:UniqueID>10003</_wcf:UniqueID> <_wcf:ExternalIdentifier ownerID="7000000000000000002"> <_wcf:PartNumber>A0000107</_wcf:PartNumber> </_wcf:ExternalIdentifier> </_cat:CatalogEntryIdentifier> <_cat:Description language="-1"> <_cat:Name>Kevlar Brake Pads</_cat:Name> <_cat:Thumbnail> images/Brake_Pad1-50.jpg </_cat:Thumbnail> <_cat:ShortDescription> Kevlar Brake Pads </_cat:ShortDescription> </_cat:Description> <_cat:ListPrice> <_wcf:Price currency="USD">26.75</_wcf:Price> </_cat:ListPrice> <_cat:Price> <_wcf:StandardPrice> <_wcf:Price> <_wcf:Price currency="USD">26.75</_wcf:Price> </_wcf:Price> </_wcf:StandardPrice> <_wcf:ContractPrice minimumQuantity="1.0"> <_wcf:Price> <_wcf:Price currency="USD">26.75</_wcf:Price> </_wcf:Price> <_wcf:ContractIdentifier> <_wcf:UniqueID>10001</_wcf:UniqueID> <_wcf:ExternalIdentifier majorVersionNumber="1" minorVersionNumber="0" origin="0" ownerID="7000000000000000002"> <_wcf:Name> AdvancedB2BDirect Contract number 1234 </_wcf:Name> </_wcf:ExternalIdentifier> </_wcf:ContractIdentifier> </_wcf:ContractPrice> </_cat:Price> </_cat:CatalogEntry> <_cat:CatalogEntry catalogEntryTypeCode="ItemBean"> <_cat:CatalogEntryIdentifier> <_wcf:UniqueID>10004</_wcf:UniqueID> <_wcf:ExternalIdentifier ownerID="7000000000000000002"> <_wcf:PartNumber>A0000108</_wcf:PartNumber> </_wcf:ExternalIdentifier> </_cat:CatalogEntryIdentifier> <_cat:Description language="-1"> <_cat:Name>Kevlar Brake Pads</_cat:Name> <_cat:Thumbnail> images/Brake_Pad1-50.jpg </_cat:Thumbnail> <_cat:ShortDescription> Kevlar Brake Pads </_cat:ShortDescription> </_cat:Description> <_cat:ListPrice> <_wcf:Price currency="USD">26.75</_wcf:Price> </_cat:ListPrice> <_cat:Price> <_wcf:StandardPrice> <_wcf:Price> <_wcf:Price currency="USD">26.75</_wcf:Price> </_wcf:Price> </_wcf:StandardPrice> <_wcf:ContractPrice minimumQuantity="1.0"> <_wcf:Price> <_wcf:Price currency="USD">26.75</_wcf:Price> </_wcf:Price> <_wcf:ContractIdentifier> <_wcf:UniqueID>10001</_wcf:UniqueID> <_wcf:ExternalIdentifier majorVersionNumber="1" minorVersionNumber="0" origin="0" ownerID="7000000000000000002"> <_wcf:Name> AdvancedB2BDirect Contract number 1234 </_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, findCatalogEntriesSummaryByDescription, and pass the description parameter.
The expression-builder 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:
- accessProfile=WC_CatalogEntrySummaryProfile
- searchTermScope=1
- isSKUexcluded=true
A searchTermScope set to 1 indicates that the column CATENTDESC.name and CATENTDESC.shortdescription will be 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