Report - Images
The Image component lets you embed images into reports. Images can be dragged from a local computer, shared drive, webpage, or the Image Management Tool as files onto reports. They can also be pulled as binary data from a datasource. If no Key is associated with the image component, the dropped image will be used. If the Key does not link to a valid image, no image will be shown. The image displayed in the Report Designer is a placeholder. It will be replaced with the image associated with the image's Key when the report is generated or previewed.
In the image component's Property Inspector, you can drag a parameter or a datasource column from the Key Browser into the Key field. The Data Key can resolve to a byte array, such as an image retrieved from a database, or a URL that points to an image on the web, or an image file on a disk. Remember that reports are generated on the Gateway, so the image source needs to be accessible from the Gateway computer.
Keychain Expressions can not be used in the data key, but the Key can be a parameter or datasource that dynamically constructs a path to an image. This allows you to easily change images in reports without changing the image component.
Report Design Component Palette Icon:
Properties​
| Property | Description |
|---|---|
| Fill | If true, the shape will fill its space with color. |
| Fill Selected | If fill is selected, the color that will fill the shape. |
| Opacity | How opaque the fill color is, between 0 and 1. |
| Stroke Style | What style of stroke or border to use: Hidden, Shape Outline, Border, or Double. To learn more about stroke styles, refer to Stroke and Fill Properties. |
| Stroke | Details for the chosen stroke. Each Stroke has its own properties depending on the Stroke Style chosen. |
| Grow to Fit | If true, rescale the original image to fit the shape. |
| Key | Data Key for this image. |
| Padding | Padding between the image and the shape's bounds. |
| Page Index | For multi-page images, sets the page index to use. |
| Preserve Aspect Ratio | If true, preserve the aspect ratio when resizing the image. |
| Radius | The amount to radius the corners of this shape. |
| Roll | Number of degrees this shape is rotated clockwise. |
| Scale X | Amount to scale the width of this shape. 1 is scale to 100%. |
| Scale Y | Amount to scale the height of this shape. 1 is scale to 100%. |
| URL | New in 8.1.19 A link to attach to this reporting component. Will be a clickable hyperlink if the report is exported as a PDF. You can use the values below to link to internal pages. |
| Visible | If true, the shape will be visible. |
| Width | Width of this shape in pixels. |
| Height | Height of this shape in pixels. |
| X | Horizontal distance in pixels between the left edge of this shape and the left edge of the page. |
| Y | Vertical distance in pixels between the top edge of this shape and the top edge of the page. |
Example​
| Property | Value |
|---|---|
| Key | Image Path |
The image in this report was created using a Parameter that resolved to a URL.