TX Text Control Blog

ReportingCloud: Merging images into image placeholders

Björn Meyer

Blogged by Björn Meyer on July 18, 2016 and tagged with reporting, release, reportingcloud.


Merging images is a very simple task using the Text Control ReportingCloud Web API. Using the online template editor, you can add image placeholders into your template document. These placeholders can be bound to values in your JSON data source.

In order to create a template with an image placeholder, follow these simple steps:

  1. The JSON data must contain the image binary data encoded as a Base64 string. The image can be of type JPG, PNG, BMP and GIF. In your ReportingCloud Portal, click on My Datasource Excerpts and create a new datasource excerpts file by pasting the following JSON into the Datasource Excerpt text box:

    ReportingCloud: Merging images into image placeholders

    Confirm the creation with Create Excerpt.

  2. Click on My Templates and create a new template by clicking New Template. Type in a document name, select your preferred document format such as DOCX and confirm with OK.

  3. Confirm the next dialog with Edit Template and select the created JSON excerpt file created in step 1 using the Select datasource excerpt file drop-down box. Open the template editor by clicking Edit Template:

    ReportingCloud: Merging images into image placeholders
  4. Choose Image Placeholder from the Image drop-down from the Insert ribbon tab:

    ReportingCloud: Merging images into image placeholders
  5. Right-click the image and open the Select Object Data Source drop-down box. Select Master -> image as the data source to bind the placeholder to the data column in the excerpt file.

    ReportingCloud: Merging images into image placeholders
  6. Click Preview Merge Fields in the Reports ribbon tab and confirm the opened dialog box with OK:

    ReportingCloud: Merging images into image placeholders

When merging your template with JSON data using the Web API, the image data must be provided in the same way like in the excerpt file.

 
 
Call us: +1 704-544-7445 (United States)
 
 

Products

Support

Downloads

Corporate

Buy Now

About Text Control

Founded in 1991, Text Control is an award-winning Visual Studio Industry Partner and leading vendor of word processing and reporting components for Microsoft development technologies. The products help thousands of developers add comprehensive word processing functionality to their applications. Text Control is 100% self-owned and independent of all investor decisions. Customers benefit from these years of experience, large user-base, and at the same time, appreciate developing with a mature, reliable product.

SD Times 100SD Times 100SD Times 100SD Times 100SD Times 100SD Times 100Visual Studio 2015 Launch PartnerVisual Studio 2013 Launch PartnerVisual Studio 2012 Launch PartnerVisual Studio Partner