The RESTful web service Text Control ReportingCloud is a Web API powered reporting platform that provides the mail merge and reporting functionality of the powerful .NET component TX Text Control. The web service exposes these powerful reporting features using easy-to-use HTTP methods.

This article explains the typical scenarios and functions of ReportingCloud.

Merging Templates

http://api.reporting.cloud/v1/document/merge

The most typical application of ReportingCloud is to merge MS Word compatible templates with JSON data. These templates contain merge fields and repeating blocks that get populated with hierarchical data. ReportingCloud is matching the fields and merge blocks automatically with data from your JSON data in form of arrays.

Templates can be uploaded and used from the ReportingCloud template storage and they can be send with the HTTP request including the merge data. Additionally, a variety of settings can be adjusted to control the merge process or to set the document properties:

Key Value Type Value Description
removeEmptyFields Boolean Optional. Specifies whether empty fields should be removed from the template or not. The default value is true.
removeEmptyBlocks Boolean Optional. Specifies whether the content of empty merge blocks should be removed from the template or not. The default value is true.
removeEmptyImages Boolean Optional. Specifies whether images which don't have merge data should be removed from the template or not. The default value is false.
removeTrailingWhitespace Boolean Optional. Specifies whether trailing whitespace should be removed before saving a document. The default value is true.
author String Optional. Sets the document's author.
creationDate DateTime (String) Optional. Sets the document's creation date which will be saved in the document.
lastModificationDate DateTime (String) Optional. Sets the date the document is last modified.
creatorApplication String Optional. Sets the application, which has created the document.
documentSubject String Optional. Sets the document's subject string which will be saved in the document.
documentTitle String Optional. Sets the document's title that will be saved in the document.
userPassword String Optional. Specifies the password for the user to open the document.

Output formats of resulting documents are DOC, DOCX, RTF, HTML, PDF and PDF/A.

Master-detail Nested Blocks

A master-detail relationship is a 1:n (one-to-many) type relationship. A typical example for such a relationship is a purchase order and a set of items that belongs to each purchase order. This allows you to create complex nested reports in a very easy way. ReportingCloud's repeating blocks can be nested in unlimited levels. Those nested blocks can be inserted in the same way like usual merge blocks.

These blocks can be easily inserted using the HTML5 based online template designer that exposes usable merge blocks automatically based on your data source excerpt fields.

Converting Documents

http://api.reporting.cloud/v1/document/convert

ReportingCloud can be also used to convert documents from and to industry standard formats including the binary MS Word format DOC, the Office Open XML format DOCX, Adobe PDF and Rich Text Format (RTF) documents. Using a simple HTTP call, source documents can be send to the service in order to retrieve the converted document.

Create Images or Thumbnail Images from Documents

http://api.reporting.cloud/v1/templates/thumbnails

The Web API also supports rendering document pages to a variety of image formats such as PNG, JPG, BMP and GIF with the highest available accuracy and quality.

Besides powerful reporting and conversion processes, the API method /v1/templates/thumbnails creates and returns images of document pages. It can be used for templates and resulting documents. If a document has been created using /v1/document/merge or /v1/document/convert, you can upload the document to your template storage in order to create the images using /v1/templates/thumbnails.

Creating Documents with 1D and 2D Barcodes

In today's processes, barcodes are included everywhere: Invoices, delivery notes or boarding passes. Barcodes are used to store digital data on paper that can be acquired easily for further processing using laser-based scanners, cameras or mobile phones.

Using ReportingCloud, adding dynamic barcodes is as easy as inserting merge fields into a template. A barcode placeholder will be added to the template and sized to your preferred dimension and location. The barcode object gets a name just like any other merge field. ReportingCloud is encrypting the matching data string from your JSON data in order to render the resulting barcode into your document.

All industry format barcode types are supported including QR Code, Maxicode, PDF417, EAN and Postnet. More than 20 formats are supported out-of-the-box.

Adding Charts to Your Reports

Powerful data visualizations in a report or any other document are essential to get the "big picture". Charts indicate trends and can be used to attractively visualize large volumes of data.

Bars, donuts, pies or financial series - more than 30 fully programmble diagram types can added to the template in the same way like a barcode object. ReportingCloud is filling the chart series automatically with the matching data of your JSON array.

These are just some possibilities of the ReportingCloud platform. Whether you need to create invoices, quotes, tickets, stickers, labels or any other dynamic document - ReportingCloud is your Web API powered platform to create those documents for your desktop, web or mobile application.

Start today with ReportingCloud and sign up for a free trial account.