You can add an image to a Classic Designer report. For example, you may want to include a company logo in the report. You can also configure the image to drill to a dashboard when a user clicks on it. You can specify the image as either a file, URL, or URL expression.
If the image you want to use is a file,
the file must first be uploaded to Admin - Manage Report Catalog.
Designer supports the following file types: JPG, GIF, and PNG. Raw image files such as CMYK image formats are not supported and will not display correctly in the report.
You can provide an expression to create data-driven URLs for images. This enables you to dynamically build the URL based on the data in your report. A URL can be assembled dynamically for each row in the report using this method by placing the image in the Detail band. To set this up, the path or name of the image needs to be contained in a column in Birst while the image itself is external.
To add an image to a report
| 1. | Open the Layout tab in Classic Designer. |
| 2. | Click the Add menu, then click Image. The New Image dialog box opens. |
| 3. | Select whether you want to add an image from the catalog, use a URL to point to an image on a web site, or use a URL expression to dynamically build the URL for the image. |
| 4. | Do one of the following: |
If the image is a file, click Browse and select the file to use in the Image Location dialog box, then click Open. The name of the image file you selected will be displayed.
If the image is a URL, copy or type the URL into the text box. For example: http://www.birst.com/categories/img/cola.png.
If you are using a
URL Expression, type the expression in the Expression text box. For example:
'http://www.birst.com/categories/img/' + [Categories.Picture]
In the above example, the first part provides the URL or path to the image
on a web site and the second part identifies the column in Birst (Categories.Picture)
that contains the name of the image for a given category. If this image
was included in each row of the report (in the Detail band), and the first
category in the report was Beverages, the dynamic URL could point to a
picture of a can of cola with an image name of cola.png (URL = http://www.birst.com/Categories/img/cola.png).
If the second line of the report had a category of Produce, the dynamic
URL could point to a picture of a tomato named tomato.png (URL = http://www.birst.com/Categories/img/tomato.png).
| 5. | If you would like to drill to a dashboard from this image, check Drill To Dashboard and select the dashboard to navigate to in the Navigate to Dashboard dropdown. |
| 6. | Click Save. |
| 7. | A box representing the image appears on the canvas
designated with an i: in the top left corner
and containing the name of the file or URL. For example:  |
| 8. | Drag the image into position. |
| 9. | To change the size and position of the image, right-click the image, select Size and Position, then change the settings. |
| 10. | Click the Results tab to see how it looks in the report. |
| 11. | Click Report - Save. |
Tips:
To remove an image, right-click the image and select Remove.
To change the image file or URL to use, right-click the image and select Image Properties.
See Also
Uploading Image Files to Birst
Adding a Button to a Report
Adding a Rectangle to a Report
Adding a Hyperlink
to a Report Element
Expressions Reference