About Images

The image component enables you to include a graphic in the layout.

Publisher supports the following methods for including an image:

  • Static image: Upload a static image that is saved in the report file. An uploaded image file must be in one of the following graphic file formats: GIF, JPEG, PNG, or BMP. The image file cannot be larger than 500 KB.

  • Static URL: Specify a static link to a URL where an image is stored.

  • Dynamic URL: Include the image URL in an element of the data. The value of the element is evaluated at runtime enabling dynamic insertion of images.

  • Images from a Content Server: Embed dynamic images from a Content Server (UCM) in RTF and XPT templates. The administrator has to create a connection to the Content Server where the images are stored. The data model should use the Content Server as the data source.

    Limitations:

    • The XPT template supports dynamic images from a Content Server only in the repeating sections.
    • The XSLX output format doesn’t support inclusion of images from a Content Server.
    • The default size for rendering images from a Content Sever (UCM) is 1 MB.

Note:

You can’t embed an SVG image in a PDF report.
To include an image in a layout:
  1. Drag and drop the image component to the layout.
  2. In the Insert an Image dialog, specify one of the following sources for the image:
    • Location: Click Browse to specify the file name and directory of the image on a local or mapped drive to upload the image.

    • URL: Enter the URL where the image is stored.

    • Field:

      Image URL: Select the field from the data that contains a URL to an image.

      Alternative Text: If the data includes a field that contains alternative text for the image, then select that field to display alternative text when the report is viewed as HTML.

    The following figure shows the Insert an Image dialog set up to retrieve an image URL dynamically from the "Image" data element. The value of the "Name" element is used as alternative text.

  3. Optional: Resize the image in one of the following ways:
    • Drag the right bottom corner of the image. To preserve the aspect ratio when resizing an image, press and hold the Shift key before starting to drag the corner.

    • Modify the width and height in the Properties pane.

Add BLOB Image

You can add a Binary Large Object (BLOB) image in an RTF or XPT template. Usage of an RTF template is recommended for BLOB images.

To add a BLOB image in XPT layout:
  1. Specify the data column type as Binary Large Object (BLOB).
  2. Insert the image in the BLOB column, and then select the BLOB column data element to display as image.
    To add multiple BLOB data rows in tabular format, use Repeating Group. Include a Layout Grid to create a tabular format, and add the BLOB column in the Layout grid.
  3. In the column preceding the BLOB image, type "data:image/jpeg;base64," along with the quotes.