Module: Editor

Version: 4.2.1 +

User: Developer

Level: Beginner


In this tutorial we will show you how you can generate multiple individual documents with Futurama.


- The Futurama Editor must be installed.

- Completing the tutorials Creating a Console Application and Reading and processing XML-data in Futurama first, is recommended.

- You need a PDF reader such as Adobe PDF reader to open the generated documents


In this tutorial, we will extend the basic console application that we created in a previous tutorial.

Safe2Save needs to inform their clients about their future expected savings. Therefore they want an application that will automatically generate a large number of individual documents. We have a list of users, for which we want to create documents. We will extend our existing console application, enabling it to loop over an array of users. And, the document we will generate shall consist of some individual values, including the future expected savings. Therefore we will have to link our console application to the calculations-file we've created in previous tutorials as well.

This tutorial starts with the user-list that we will read into Futurama. We import the name and cash balance out of the user-list, depending on a user-id. We then create a loop for generating the documents. The action is executed multiple times, and each time, we use another user-id, thus the data of the next user.

Next step is that we want a document with real information in it. Therefore we use another Template-file, which we already created and consists of a decent text with multiple mergefields in it. We will have to merge this information into the document, by adding these objects to our mergedata.

One of the mergefields is the result of our savings formula. Therefore we link our application document to the calculations document. In that way, we can refer to the formula in the calculations document. When we have processed all values in the mergedata, we execute the application again, and get the list of individual merged documents as a result.

Then two last steps are made. We first give our merged values a better format, so that they are properly placed in the document. And finally, we create a requesparameter for the Interest. In that way, the Interest can be chosen as a parameter when executing the console application. We show you how to do this by editing the command line arguments.

In this tutorial we show you a very basic way to execute the console applications, by using a command line. However, Futurama can offer you a sophisticated management tool to execute, manage and monitor these applications for you. Please consult the Futurama Vision-pages for information about this.


Contents Time
1) Intro 0 - 0.57
2) Working with multiple user XML 0.57 - 7.47
3) Generating multiple individual documents 7.47 - 11.44
4) Adding content 11.44 - 19.13
5) Formatting and Requestparameters 19.13 - 25.54
image (rightclick, save as...)

Related Topics

- DocConverter: Futurama Manual Page about the DocConverter object

- Command Line Arguments: Futurama Manual Page about the Futurama Command Line Arguments

- Futurama Management Site - Server: Information about how you can manage your console applications from within the Futurama Management Site


  1. Tax Rate (Medium)
  2. Tax Rate Table (Difficult)

Updated: 2012-07-19