WebSphere Commerce EnterpriseWebSphere Commerce Professional

Marketing activity template picker

The marketing activity template picker is the window that is labeled New Activity From Template that displays when a business user begins creating a new Web or Dialog activity. This window presents the available standard and custom templates for either Web or Dialog activities so that the business user can choose the appropriate template. You can customize what business users see in this window.

WebSphere Commerce ProfessionalWebSphere Commerce EnterpriseDialog activities are available only in the Professional and Enterprise editions of WebSphere Commerce.

Options for customizing the marketing activity template picker contents

The following screen capture shows the marketing activity template picker and includes callouts that identify areas that you might want to customize:


Marketing activity template picker customization
  • 1 Folder customization: You can add and remove folders, or change the names of folders.
  • 2 Template list customization: You can add or remove templates from folders, or move templates to different folders.

Sample XML definition

The marketing activity template picker properties views are contained in:
  • WebSphere Commerce Version 7.0.0.0Feature Pack 1OpenLaszlo files
  • Introduced in Feature Pack 2Definition files
Option Description
OpenLaszlo files The marketing activity template picker properties views are contained in the following files:
  • For Web activities: WebActivityTemplatePickerWizard.lzx, an instance of the mktWebActivityTemplatePickerWizard class
  • WebSphere Commerce EnterpriseWebSphere Commerce ProfessionalFor Dialog activities: DialogActivityTemplatePickerWizard.lzx, an instance of the mktDialogActivityTemplatePickerWizard class

The following snippet is the class definition for mktWebActivityTemplatePickerWizard in the WebActivityTemplatePickerWizard.lzx file; an explanation follows the snippet:

<class name="mktWebActivityTemplatePickerWizard" extends="mktBaseWebActivityTemplatePickerWizard">
    <wcfPropertyValuesFilter displayName="${mktMarketingResources.standardTemplateFolder.string}" propertyName="activityId" values="10,20,30,40,50,70" />
    <wcfPropertyValuesFilter displayName="${mktMarketingResources.customTemplateFolder.string}" propertyName="activityId" negate="true" values="10,20,30,40,50,70" />
    <wcfPropertyValuesFilter displayName="${mktMarketingResources.allTemplateFolder.string}" propertyName="activityId" values="" />
</class>

Each wcfPropertyValuesFilter entry defines a folder in the marketing activity template picker. By default, there is a Standard Templates folder, a Custom Templates folder, and an All Templates folder. Notable parameters are:

values
Specifies which templates to display in the folder. The identifiers (for example, 10,20,30,40,50,70) are the DMACTIVITY_ID of the template from the DMACTIVITY table. For the default folder labeled All Templates (shown in the fourth line of the previous example), the values parameter is left blank.
negate
Include the negate=true parameter if you want the folder to contain templates that do not match the templates that are listed in the values parameter. The default folder labeled Custom Templates (shown in the third line of the previous example) contains the negate=true parameter so that the folder contains all custom templates that business users create, but none of the standard templates.
Definition files The marketing activity template picker properties views are contained in the following files:
  • For Web activities: WebActivityTemplatePickerWizard.def, an instance of the wcfTemplatePickerWizard class that is based on the mktBaseWebActivityTemplatePickerWizard definition
  • WebSphere Commerce EnterpriseWebSphere Commerce ProfessionalFor Dialog activities: DialogActivityTemplatePickerWizard.def, an instance of the wcfTemplatePickerWizard class that is based on the mktBaseDialogActivityTemplatePickerWizard definition

The following snippet is the definition for mktWebActivityTemplatePickerWizard in the WebActivityTemplatePickerWizard.def file; an explanation follows the snippet:

<TemplatePickerWizard baseDefinitionName="mktBaseWebActivityTemplatePickerWizard"
	definitionName="mktWebActivityTemplatePickerWizard">
	<PropertyValuesFilter displayName=
			"${mktMarketingResources.standardTemplateFolder}"
		propertyName="activityId" values="10,20,30,40,50,70,80,85,90,95,100"/>
	<PropertyValuesFilter displayName="${mktMarketingResources.customTemplateFolder}"
		negate="true" propertyName="activityId"
		values="10,20,30,40,50,70,80,85,90,95,100"/>
	<PropertyValuesFilter displayName="${mktMarketingResources.allTemplateFolder}"
		propertyName="activityId" values=""/>
</TemplatePickerWizard>

Each PropertyValuesFilter entry defines a folder in the marketing activity template picker. By default, there is a Standard Templates folder, a Custom Templates folder, and an All Templates folder. Notable parameters are:

values
Specifies which templates to display in the folder. The identifiers (for example, 10,20,30,40,50,70) are the DMACTIVITY_ID of the template from the DMACTIVITY table. For the default folder labeled All Templates (shown in the fourth line of the previous example), the values parameter is left blank.
negate
Include the negate=true parameter if you want the folder to contain templates that do not match the templates that are listed in the values parameter. The default folder labeled Custom Templates (shown in the third line of the previous example) contains the negate=true parameter so that the folder contains all custom templates that business users create, but none of the standard templates.