HTML properties define display characteristics for columns in a report. This article shows you how to add an image or link HTML property to a report column. When you include an image or link in a column of the report, the user can click the image or link to view a popup window. For example, you could configure the window to include additional information for the object of the row.

Note: You can select from a list of images in binary file rules by choosing Tools > Image Catalog or you can upload and save your own images as Rule-File-Binary instances.

 

 

Suggested Approach

Note: Before you add an image or link to your report, create an activity and HTML section rule to display the target reference. See Creating the HTML stream to display in the target reference and Creating an activity for reporting_image and reporting_link HTML properties.

1. 1. Create or edit a list or summary view rule.
   2. For a list view, open the Display Fields tab. For a summary view, open the DrillDown tab and choose Detailed View.
   3. Locate the property that you would like to display as an image or with a link.
   4. In the HTML Property field of the property row, choose reporting_image or reporting_link from the dropdown list.

1. 1. Click the Display Formats icon () located to the right of the HTML Property field.
   2. In the Value fields, enter the
      • ImageSourceName (reporting_image HTML property only) - name and location of the image file to display in the report
      • ActivityName - the name of the activity that is called when the image or link is clicked.
      • ActivityClassName - the class name of the activity
      • Target- the name of the window. In addition, the following values can be used:
        • _blank - the HTML is loaded into a new, unnamed window
        • _parent - the HTML is loaded into the current frame's parent. If the frame has no parent, this value acts like the value "_self"
        • _self - the current document is replaced with the specified HTML
        • _top - the HTML replaces any framesets that may be loaded. If there are no framesets defined, this value acts like the value "_self"

Note: You can specify the size and other characteristics of the display using the remaining parameters.

1. 1. Click Save in the Param window.
   2. Click the Save toolbar button. .
   3. Click the Run icon. The view displays with the column of images or links, in the figure the column is Premium Results.

      

   4. Click an image or link and the target reference opens.

Creating the HTML stream to display in the target reference

To define the HTML stream to display when the user clicks an image or link, use the steps described in the following example:

1. Create a new HTML rule.
2. Enter the HTML stream source code.

   

3. Click the Save icon.

Creating an activity for reporting_image and reporting_link HTML properties

To define a new activity to be called when the image or link is clicked, use the steps described in the following example as a guide. These steps were used to create the report in this article.

1. 1. Create a new activity rule, in this example, LaunchImage.
   2. In the Parameters tab, enter any parameters you may be passing to the activity, in this example, pyID.

1. 1. In the Pages & Classes tab, enter the page name and it's class, in this example, ObjectPage.

1. 1. In the Steps tab, specify a method that opens the work object using its pzInsKey, in this example, Obj-Open-By-Handle.
   2. Expand Step 1. In the InstanceHandle field, enter param.Key.

1. 1. Specify a method that displays the HTML in the target window, in this case, Show-HTML.

1. 1. Expand Step 2. In the HTMLStream field, choose the name of the HTML section rule from the SmartPromt list, in this example, PremiumResults.
   2. Enable Read Only.

1. Click the Save toolbar button.