Changing the search definition for a business object

You can change the search definition for a business object.

About this task

To change the search definition for a business object:

Procedure

Open WebSphere Commerce Developer and switch to the Enterprise Explorer view.
Complete one of the following steps:
- In the Enterprise Explorer view, expand LOBTools > WebContent > WEB-INF > src > lzx > commerce > Management_Center_component > searchDefinitions, where Management_Center_component is the name of the tool you want to customize. All search definitions for objects managed by the Management Center are stored in this directory. All search definitions are named beginning with the Management_Center_component, the name of the search definition in camel case, followed by SearchDefinition.lzx. For example, FindProductsSearchDefinition.lzx.
- In the Enterprise Explorer view, expand LOBTools > WebContent > config > commerce > Management_Center_component > searchDefinitions, where Management_Center_component is the name of the tool you want to customize. All search definitions for objects managed by the Management Center are stored in this directory. All search definition files are named beginning with the Management_Center_component, the name of the search definition in camel case, followed by SearchDefinition.def. For example, FindProductsSearchDefinition.def.

Open the file that you want to change:

Option Description

Option	Description
OpenLaszlo (.lzx) file that contains the search definition	Modify the search definition. You can make various changes to the search definition. For example: To change the displayName, change the applicable property file and associated resource bundle. To change the listClass, define a new list class for the search results. To change the listTitle, define the new title name in a property file and associated resource bundle file. To change the advancedSearchContentClass, define a new advanceSearchContent class. The following example shows how a search definition is used for the Catalogs tool: <class name="catFindAllCategoriesSearchDefinition" extends="wcfSearchDefinition" searchType="FindCategories" displayName="${catalogResources.findCategoriesSearchDefinition_DisplayName.string}" isDefault="false" listClass="catCategorySearchGrid" listTitle="${catalogResources.categorySearchTitle.string}" advancedSearchContentClass="catCategoriesAdvancedSearchContent"> <wcfSearchService name="findAllCategories" url="/cmc/FindCategories-All"> <wcfServiceParam name="storeId"/> <wcfServiceParam name="masterCatalogId"/> </wcfSearchService> </class>
Definition file (.def) that contains the search definition	Modify the search definition. You can make various changes to the search definition. For example: To change the displayName, change the applicable property file and associated resource bundle. To change the listDefinition name, define a new list definition for the search results. To change the listTitle, define the new title name in a property file and associated resource bundle file. To change the advancedSearchContentClass, define a new advanced search content class. The following example shows how a search definition is used for the Catalogs tool: <SearchDefinition advancedSearchContentClass="catCategoriesAdvancedSearchContent" definitionName="FindCategories" displayName= "${catalogResources.findCategoriesSearchDefinition_DisplayName}" icon="catalogGroupIcon" listDefinitionName="catCategorySearchGrid" listTitle="${catalogResources.categorySearchTitle}" searchType="FindCategories" tooltip="${catalogResources.searchCategoriesTooltip}" utilitiesListDefinitionName="catCategoryUtilitiesSearchGrid"> <SearchService name="findAllCategories" url="/cmc/FindCategories-All"> <ServiceParam name="storeId"/> <ServiceParam name="masterCatalogId"/> <ServiceParam name="masterCatalogIdentifier"/> <ServiceParam name="masterCatalogStoreId"/> </SearchService> </SearchDefinition>

OpenLaszlo (.lzx) file that contains the search definition

Modify the search definition. You can make various changes to the search definition. For example:

To change the displayName, change the applicable property file and associated resource bundle.
To change the listClass, define a new list class for the search results.
To change the listTitle, define the new title name in a property file and associated resource bundle file.
To change the advancedSearchContentClass, define a new advanceSearchContent class.

The following example shows how a search definition is used for the Catalogs tool:

<class name="catFindAllCategoriesSearchDefinition" extends="wcfSearchDefinition" 	searchType="FindCategories"
		displayName="${catalogResources.findCategoriesSearchDefinition_DisplayName.string}"  
		isDefault="false"  listClass="catCategorySearchGrid"  listTitle="${catalogResources.categorySearchTitle.string}" 
		advancedSearchContentClass="catCategoriesAdvancedSearchContent"> 
				<wcfSearchService name="findAllCategories" url="/cmc/FindCategories-All">
						<wcfServiceParam name="storeId"/> 
						<wcfServiceParam name="masterCatalogId"/>
				</wcfSearchService> 
</class>

Definition file (.def) that contains the search definition

Modify the search definition. You can make various changes to the search definition. For example:

To change the displayName, change the applicable property file and associated resource bundle.
To change the listDefinition name, define a new list definition for the search results.
To change the listTitle, define the new title name in a property file and associated resource bundle file.
To change the advancedSearchContentClass, define a new advanced search content class.

The following example shows how a search definition is used for the Catalogs tool:

<SearchDefinition advancedSearchContentClass="catCategoriesAdvancedSearchContent"
		definitionName="FindCategories"
		displayName=
			"${catalogResources.findCategoriesSearchDefinition_DisplayName}"
		icon="catalogGroupIcon" listDefinitionName="catCategorySearchGrid"
		listTitle="${catalogResources.categorySearchTitle}"
		searchType="FindCategories"
		tooltip="${catalogResources.searchCategoriesTooltip}"
		utilitiesListDefinitionName="catCategoryUtilitiesSearchGrid">
		<SearchService name="findAllCategories" url="/cmc/FindCategories-All">
			<ServiceParam name="storeId"/>
			<ServiceParam name="masterCatalogId"/>
			<ServiceParam name="masterCatalogIdentifier"/>
			<ServiceParam name="masterCatalogStoreId"/>			
		</SearchService>
	</SearchDefinition>

If you use a resource bundle for your Management Center search definitions, see Defining properties files and bundle keys for user interface text for more information about using a resource bundle to define search definitions.

What to do next

After you complete your customization:


Version	Steps
	Right-click LOBTools Project; then click Build OpenLaszlo Project to produce an updated ManagementCenter.swf file under the `workspace_dir`\LOBTools\WebContent directory. This setting is the default environment setting. Test your changes by viewing them in the Management Center, using this URL: https://`hostname`:8000/lobtools. Deploy your changes to your production environment.
	Test your changes by viewing them in the Management Center, using this URL: https://`hostname`:8000/lobtools. Deploy your changes to your production environment.