Using the Generator

The Visokio Generator automates the creation and deployment of on-demand, personalised snapshots of database views/tables as Omniscope .IOK/.IOM files or .SWF Flash DataPlayers. The Visokio Generator allows on-demand generation of .IOK/.IOM and .SWF files according to the settings in a Template .IOK/.IOM or .FFC file configured future refreshed and personalised files. When fully populated and refreshed, the Template files become Source files which can be distributed as User files. User files can be configured to continuously refresh from Source files, which in turn are refreshed on demand from their own database views/tables.

The Generator runs on a continuously-running server machine and acts as a server which can be connected to using the HTTP protocol.

How to install the Generator: We have prepared an introductory installation document available here.

Generator Toolkit:  We have prepared a toolkit for Java applications containing utility methods for connecting to the server, a servlet implementation, source code, JavaDoc and an example servlet application to load data from SQLServer into an .IOK file on demand. You can download the toolkit here.

The Generator uses the HTTP protocol to receive requests, so you can use any programming language to access it, though we do not have examples of other implementations. The general information the Generator requires is shown below:

The Generator http request takes the form of a http post with a multi-part type to:

'http://localhost:8301' (port will be configurable soon)

with the following parameters:

• templateIok which is multipart request file containing an IOK "template" file configured to look the way you want the final file to appear.  This should be binary data with MIME type "application/vnd.visokio.omniscope-iok"
• templateIom (alternative for IOM files - depending on your needs and/or license), MIME type "application/vnd.visokio.omniscope-iom"
• applyHistory which is a boolean option, default false, to re-apply any structural changes to the updated data
• dataXml which is another multipart request file containing the data in the xml format specified at http://www.visokio.com/xmldata/ 

Back to Automation options