Inserting Click-to-Action encodeProperties

You can allow users to send multiple source output properties (encodeProperty values) to targets on the page with a single click by inserting the

Click-to-Action Output Properties (encodeProperties) object.

To insert Click-to-Action Output Properties (encodeProperties), perform the following steps:

1. Open a JSP file in the Design page in the Page Designer.

2. Select the Portlet drawer in the Palette view.

3. Drag and drop the

   Click-to-Action Output Properties object onto the page. Alternatively, select Insert > Portlet >

   Click-to-Action Output Properties from the menu. The Insert Click-to-Action Output Properties dialog opens.

4. Provide values for the applicable fields:

   Label (Required)

   Specify a short string about the action that is suitable for displaying in the portlet user interface. For translated captions, specify the name of the key in the resource bundles using a dot (.) rather than a space between words in this field.

   Resource bundle

   Specify the base name of an NLS resource file containing translated text that corresponds to captions and descriptions of actions and properties. The specified base name will be defined by the c2a-nls-file configuration parameter in the portlet deployment descriptor, and a resource bundle will be generated under the JavaSource node. For example, if you enter nls.shippingc2a, then you will edit language-specific resource bundles, nls\shippingc2a<_lang>.properties, under the JavaSource node to specify translated captions and descriptions in the key=translated texts format.

   Source portlet (Required)

   Specify the concrete portlet to be enabled as the cooperative source.

5. The inserted output properties (encodeProperties) object is shown in the JSP page in the Design page as an output properties icon (

   ).

6. Specify the menu label to display in the portlet user interface and the output property (encodeProperty) data to enclose. Both are required. To do this, edit the properties using the Properties view. Refer to Editing Click-to-Action encodeProperties for more details.

Inserting the

Click-to-Action Output Properties object performs the following tasks:

1. Enabling cooperative sources, if necessary.

2. Inserts an empty <c2a:encodeProperties> tag and the taglib directive in the JSP file.

3. Generates a resource bundle file that includes the key value (from the key=translated string text format) that was specified in Label field in the Click-to-Action Output Properties dialog.

 

Related concepts

Developing cooperative portlets

 

Related tasks

Enabling existing portlets for cooperation
Enabling cooperative sources
Enabling cooperative targets
Inserting Click-to-Action encodeProperty
Editing Click-to-Action encodeProperty
Editing Click-to-Action encodeProperties

Related information
Web