registerWidgetdef input file
Use a registerWidgetdef input file to register a new widget or container for use in the Commerce Composer tool. This input file supports registration at either the site level or the store level.After you use this input file to register the widget or container, we must use the subscribeWidgetdef input file to subscribe one or more stores to the widget or container. For samples that demonstrate how to use this input file in different load scenarios, see:
- Sample: Loading Commerce Composer widgets
- Sample: Loading Commerce Composer widget descriptive information in multiple languages
- Sample: Loading Commerce Composer layout templates
- Sample: Loading Commerce Composer layouts
We can extract widget registration data with the Data Extract utility to create a registerWidgetdef.csv file that we can load with the Data Load utility. For example, to copy or move widgets between stores or instances, such as for creating one or more test environments. The sample configuration files provided for you to use with the Data Extract utility, extract widget registration data from the following database tables:
For more information about extracting Commerce Composer data, see:
- Extracting Commerce Composer data with the Data Extract utility
- Sample: Extracting Commerce Composer widgets
- Sample: Extracting Commerce Composer layouts
- Sample: Extracting Commerce Composer layout templates
- Sample: Extracting Commerce Composer pages
Definitions
- UniqueID
- (Integer) The internal reference number for the widget or container definition, for example, 10001. The UniqueID is automatically generated when you register the widget. In Delete mode, either this field or the WidgetDefIdentifier field (see next column) is required.
Note: The sample CSV file does not include this column; the sample demonstrates the use of the WidgetDefIdentifier to uniquely identify a widget. Maps to:
- PLWIDGETDEF.PLWIDGETDEF_ID
- PLWIDGETDEFDESC.PLWIDGETDEF_ID
- WidgetDefIdentifier
- (String) The external reference name for the widget or container definition, for example, ContentRecommendation. We can use any name, but the name must be unique for the store. In Insert or Replace mode, this field cannot be null and the name must be unique. In Delete mode, either this field or the UniqueID field (see previous column) is required.
Maps to: PLWIDGETDEF.IDENTIFIER
- WidgetStoreIdentifier
- (String) The unique reference name of the store in which we want to register the widget or container, for example, Aurora. Important: If we are registering a site-level widget, set the WidgetStoreUniqueID column to 0 (see next column) and leave this column empty.
Note: The sample CSV file does not include this column; the sample demonstrates the use of the WidgetStoreUniqueID to identify the store in which to register the widget.
Maps to: STOREENT.IDENTIFIER
- WidgetStoreUniqueID
- (Integer) The unique reference number of the store in which we want to register the widget or container. Valid values are:
- storeId
- Register this widget or container in a specific store. As a result, the widget or container cannot be shared with other stores. The storeId value is defined in the STORE_ID column of the STORE table. An example storeId value is 12345.
- 0
- Register this widget or container at the site level. As a result, the widget or container can be shared across stores in the site.
If you do not specify a value, the widget is registered at the store level to the store specified in the environment configuration file (wc-dataload-env.xml).
Maps to: PLWIDGETDEF.STOREENT_ID
- WidgetUIObjectName
- (String) A name that identifies the Management Center definition of this widget, for example, ContentRecommendationWidget. When creating the definition file that defines the widget for Management Center, we must specify this name for the ui_object_name attribute in the XML code.
Maps to: PLWIDGETDEF.UI_OBJECT_NAME
- WidgetType
- (Integer) The type of widget. Valid values are:
- 1 (for a widget)
- 2 (for a container)
Maps to: PLWIDGETDEF.WIDGETTYPE
- WidgetVendor
- (String) The name of the company or vendor that created the widget, for example, IBM.
Maps to: PLWIDGETDEF.VENDOR
- WidgetPath
- (String) The relative path to the entry point (top-level) JSP for the widget or container.
- For site-level widgets or containers:
- The path must be relative to the WCDE_installdir/workspace/Stores/WebContent directory.
- Start the path with a slash.
Example:
/Widgets/com.ibm.commerce.store.widgets.ContentRecommendation/ContentRecommendation.jsp- For store-level widgets or containers:
- The path must be relative to the WCDE_installdir/workspace/Stores/WebContent/storedir/ directory.
- Start the path without a slash.
Example:
Widgets/com.ibm.commerce.store.widgets.ContentRecommendation/ContentRecommendation.jsp
Maps to: PLWIDGETDEF.JSPPATH
- WidgetState
- (Integer) A flag to indicate the state of the registration: Valid values are:
- 1
- Active; this widget is used by one or more stores.
- 0
- Deprecated; this widget is not used by any stores.
Maps to: PLWIDGETDEF.STATE
- WidgetDefinitionxml
- (CLOB) The XML definition for the widget or container. Copy the full XML code into this column.
Maps to: PLWIDGETDEF.DEFINITIONXML
- LanguageId
- (Integer) The language ID for the language-specific fields in this input file. If omitted, defaults to the language specified in the business context of the environment configuration file. Examples of valid values:
- -1
- English
- -2
- French
We can look up language ID values in the LANGUAGE table.
Maps to: PLWIDGETDEFDESC.LANGUAGE_ID
- WidgetDisplayName
- The language-specific display name for the widget, for example, Content Recommendation Widget. This name is displayed in the Commerce Composer tool in Management Center to help business users identify the widget. Use the UTF-8 character set.
Maps to: PLWIDGETDEFDESC.DISPLAYNAME
- WidgetDescription
- The language-specific description for the widget, for example, Displays content, such as images, text, static HTML, and videos. Supports web activities.. This description is displayed in the Commerce Composer tool in Management Center to help business users identify the widget. Use the UTF-8 character set.
Maps to: PLWIDGETDEFDESC.DESCRIPTION
- Delete
- (String) A flag that indicates whether to delete the widget or container definition. Specify 1 to delete the row.
Related concepts
Widgets for Commerce Composer
Commerce Composer widget library
Related tasks
Creating Commerce Composer widgets
Extracting Commerce Composer data with the Data Extract utility
Related reference
Commerce Composer samples
Sample: Extracting Commerce Composer widgets
Sample: Extracting Commerce Composer layout templates
Sample: Extracting Commerce Composer layouts
Sample: Extracting Commerce Composer pages
Sample: Extracting Commerce Composer data
Commerce Composer object input file definitions