Futurama Logo

Welcome to the Futurama Support Site

The Futurama Support Site is the website where you can find Futurama and Futurama Vision documentation. If you have any questions about the support pages or if you want to provide us feedback please send us an e-mail.




Index Futurama Server - Management Site
Previous  |  Next

 1      About Futurama
 1.1        Version information
 1.2        Getting Started
 1.2.1          Futurama Website
 1.2.1.1            Behavior of Futurama regarding TimeOuts, Login and Logoff
 1.2.1.2            Replacing an existing Futurama Session
 1.2.2          Futurama Webservice
 1.2.2.1            warmUpDocuments
 1.2.3          Futurama Export
 1.3        Overview - Futurama Modules
 1.3.1          Overview - Futurama Accounts
 1.3.2          Overview - Futurama Server
 1.3.3          Overview - Futurama Monitor
 1.3.4          Overview - Futurama Insight
 1.3.5          Overview - Futurama Console
 1.3.6          Overview - Futurama Webservice
 1.4        Loadbalancing Futurama applications
 1.4.1          Getting the most out of Futurama Web using the Load-Balancer
 1.4.2          Application Request Routing
 1.5        Text management and Multi-language
 2      Installation – Configuration – Testing
 2.1        Installation - Futurama Website Edition
 2.1.1          Installation Futurama HTML
 2.1.2          Installation Futurama Monitor
 2.1.3          Installation Futurama Insight
 2.1.4          Installation Futurama Accounts
 2.1.5          Installation SAML2LoadBalancer
 2.2        Installation - Futurama Export Edition
 2.2.1          Installation Futurama Console
 2.2.2          Installation Futurama Server
 2.3        Installation - Futurama Webservice Edition
 2.3.1          Installation Futurama Webservice
 2.4        Installation Futurama Editor
 2.5        Configuration
 2.5.1          Configuration - Cache
 2.5.2          Configuration - Calculation
 2.5.3          Configuration - Debug
 2.5.4          Configuration - File manager
 2.5.5          Configuration - Fileproviders
 2.5.6          Configuration - Format
 2.5.7          Configuration - History
 2.5.8          Configuration - Identity Provider
 2.5.9          Configuration - Log
 2.5.10           Configuration - Mail
 2.5.11           Configuration - Mapping
 2.5.12           Configuration - Monitor
 2.5.13           Configuration - PlugIns
 2.5.14           Configuration - Rendering
 2.5.15           Configuration - ScenarioRecording
 2.5.16           Configuration - Security
 2.5.17           Configuration - Server
 2.5.18           Configuration - Vision
 2.5.19           Configuration - WebAPI
 2.6        Logging
 2.7        Troubleshooting
 2.8        Security - hardening
 3      Updating and file compatibility
 3.1        Updating Futurama - Compatibility behavior
 3.2        Converting Futurama documents
 3.3        12819 - DataTable file updates
 3.4        12889 - DataTable file updates
 3.5        Conversion web.config to .NET Framework 4
 3.6        Deprecated conversion formulas
 4      Futurama Editor - How to
 4.1        At first glance
 4.2        Developing in the Futurama Editor
 4.2.1          Working with objects
 4.2.2          Evaluating objects
 4.2.3          Finding objects
 4.3        Transferring objects
 4.4        Testing objects
 4.5        Validating objects
 4.6        Troubleshooting objects
 4.7        Advanced/special functionality
 4.8        Checking the layout of objects
 5      Futurama - Formulas
 5.1        Futurama Formulas - Date and time
 5.1.1          Date
 5.1.2          Day
 5.1.3          Days360
 5.1.4          Days360Excel
 5.1.5          DaysInMonth
 5.1.6          DaysInPeriod
 5.1.7          Min
 5.1.8          Max
 5.1.9          Month
 5.1.10           Now
 5.1.11           WeekDay
 5.1.12           Year
 5.2        Futurama Formulas - Math
 5.2.1          Abs
 5.2.2          Add
 5.2.3          Divide
 5.2.4          Floor
 5.2.5          Ln
 5.2.6          Log
 5.2.7          Log10
 5.2.8          Mod
 5.2.9          Multiply
 5.2.10           Pi
 5.2.11           Power
 5.2.12           Rand
 5.2.13           Round
 5.2.14           RoundDown
 5.2.15           RoundUp
 5.2.16           SquareRoot
 5.2.17           Subtract
 5.3        Futurama Formulas - Statistical
 5.3.1          AverageDeviation
 5.3.2          Beta
 5.3.3          Binomial
 5.3.4          Covariance
 5.3.5          Factorial
 5.3.6          Gamma
 5.3.7          GeometricMean
 5.3.8          Lognormal
 5.3.9          Max
 5.3.10           Median
 5.3.11           Min
 5.3.12           Normal
 5.3.13           StandardDeviation
 5.3.14           Uniform
 5.3.15           Variance
 5.4        Futurama Formulas - Text
 5.4.1          CalculateBase64Hashcode
 5.4.2          CalculateXmlHashcode
 5.4.3          Concatenate
 5.4.4          ConcatenateBase64
 5.4.5          ContainsText
 5.4.6          Convert.CSV.2.XML
 5.4.7          ConvertFromBase64
 5.4.8          ConvertToBase64
 5.4.9          ConvertXml
 5.4.10           DecodeURL
 5.4.11           DecryptXml
 5.4.12           EncodeURL
 5.4.13           EncryptXml
 5.4.14           Find
 5.4.15           HashBase64EncodedFile
 5.4.16           HashBase64EncodedFileWithBase64
 5.4.17           HashText
 5.4.18           HashTextWithBase64
 5.4.19           Left
 5.4.20           Len
 5.4.21           Linefeed
 5.4.22           Lower
 5.4.23           Mid
 5.4.24           Proper
 5.4.25           ReadConfigKey
 5.4.26           ReadDirectoryNames
 5.4.27           ReadFile
 5.4.28           ReadFileAsBase64
 5.4.29           ReadFileNames
 5.4.30           ReadFileWithEncoding
 5.4.31           ReadXPathScalar
 5.4.32           ReadXPathVector
 5.4.33           Repeat
 5.4.34           Right
 5.4.35           Substitute
 5.4.36           Trim
 5.4.37           TrimLeft
 5.4.38           TrimRight
 5.4.39           Upper
 5.4.40           ValidatePattern
 5.4.41           XsdMessages
 5.5        Futurama Formulas - Logical
 5.5.1          And
 5.5.2          IsEmpty
 5.5.3          If
 5.5.4          IsEqual
 5.5.5          IsEven
 5.5.6          IsGreater
 5.5.7          IsGreaterEqual
 5.5.8          IsIBANChecksumValid
 5.5.9          IsLess
 5.5.10           IsLessEqual
 5.5.11           IsMemberOfGroup
 5.5.12           IsNotEqual
 5.5.13           IsOdd
 5.5.14           IsValidXml
 5.5.15           Not
 5.5.16           Or
 5.5.17           ValidateNPR
 5.6        Futurama Formulas - Table
 5.6.1          FindNextRow
 5.6.2          FindPreviousRow
 5.6.3          FindRow
 5.6.4          Sort
 5.6.5          VLookUp
 5.7        Futurama Formulas - Document
 5.7.1          CountErrors
 5.7.2          GetPathToDataFiles
 5.7.3          GetPortNumber
 5.7.4          GetRelativePathToDataFiles
 5.7.5          GetSessionID
 5.7.6          IsLicenceAvailable
 5.7.7          ReadError
 5.7.8          ReadIdentityProviderResult
 5.7.9          ReadRequestIP
 5.7.10           ReadRequestParameter
 5.7.11           ReadUserAgent
 5.7.12           ReadVersionNumber
 5.7.13           SessionTimeOut
 5.7.14           URL
 5.7.15           UserName
 5.8        Futurama Formulas - Conversion
 5.8.1          Convert.Excel.to.XML
 5.8.2          ConvertJSONtoXml
 5.8.3          ConvertTextToDate
 5.8.4          ConvertTextToNumber
 5.8.5          ConvertToBoolean
 5.8.6          ConvertToDouble
 5.8.7          ConvertToLong
 5.8.8          ConvertToString
 5.8.9          FormatDate
 5.8.10           FormatNumber
 5.8.11           Value
 5.9        Futurama Formulas - Matrix
 5.9.1          AddMatrices
 5.9.2          AddScalarToMatrix
 5.9.3          Cumulative
 5.9.4          CumulativeProductMatrix
 5.9.5          Distinct
 5.9.6          DivideMatrices
 5.9.7          DivideMatrixScalar
 5.9.8          DivideScalarMatrix
 5.9.9          Exponent
 5.9.10           First
 5.9.11           Floor
 5.9.12           If
 5.9.13           Index
 5.9.14           Inverse
 5.9.15           IsEqual
 5.9.16           IsGreater
 5.9.17           IsGreaterEqual
 5.9.18           IsNotEqual
 5.9.19           IsLess
 5.9.20           IsLessEqual
 5.9.21           Join
 5.9.22           Last
 5.9.23           Length
 5.9.24           MatrixProduct
 5.9.25           Max
 5.9.26           MaxScalarMatrix
 5.9.27           Mean
 5.9.28           Mid
 5.9.29           Min
 5.9.30           MinScalarMatrix
 5.9.31           MultiplyMatrices
 5.9.32           MultiplyMatrixVector
 5.9.33           MultiplyScalarMatrix
 5.9.34           Percentile
 5.9.35           PowerMatrix
 5.9.36           PowerMatrixScalar
 5.9.37           PowerScalarMatrix
 5.9.38           ReadMatrixFromXml
 5.9.39           Repeat
 5.9.40           Replace
 5.9.41           Reshape
 5.9.42           ReverseCumulativeProductMatrix
 5.9.43           ReverseMatrix
 5.9.44           Size
 5.9.45           Split
 5.9.46           SquareRootMatrix
 5.9.47           Step
 5.9.48           SubtractMatrices
 5.9.49           SubtractMatrixScalar
 5.9.50           SubtractScalarMatrix
 5.9.51           Sum
 5.9.52           Transpose
 5.9.53           UnitMatrix
 5.9.54           Vector
 5.10         Creating custom formulas in Futurama
 6      Futurama - Objects
 6.1        Action
 6.2        Aggregation
 6.3        Button
 6.4        ChangeValue
 6.5        CheckBox
 6.6        ClearCache
 6.7        DatabaseField
 6.8        DatabaseView
 6.9        DataTable
 6.10         DateBox
 6.11         DocConverter
 6.12         Document
 6.13         Download
 6.14         DropDownList
 6.15         EmailConverter
 6.16         ExcelConverter
 6.17         FileSaver
 6.18         FileUploader
 6.19         Fixed
 6.20         Formula
 6.21         GraphConverter
 6.22         HTMLInclude
 6.23         InterfacesNode
 6.24         LogMessage
 6.25         Navigator
 6.26         Node
 6.27         RadioButton
 6.28         RadioGroup
 6.29         Range
 6.30         Reference
 6.31         SubDocument
 6.32         TextBox
 6.33         UserTable
 6.34         UserVariable
 6.35         WebLabel
 6.36         WebListBox
 6.37         WebPage
 6.38         WebPanel
 6.39         WebReference
 6.39.1           WebReference - WCF Configuration
 6.40         WebService
 6.41         WebSlider
 6.42         WordConverter
 6.43         XmlBuilder
 6.44         XmlConverter
 6.45         XmlField
 6.46         XmlNode
 7      Futurama - Vision References
 7.1        Data
 7.1.1          ReadData
 7.1.2          WriteMessage
 7.1.3          GetPersonIdentifiers
 7.1.4          CreatePerson
 7.2        DataStore
 7.2.1          DeleteDataItem
 7.2.2          DeleteDataItemHierarchy
 7.2.3          DeleteDataItems
 7.2.4          GetDataItem
 7.2.5          GetDataItemHierarchy
 7.2.6          GetDataItems
 7.2.7          StoreData
 7.3        Accounts
 7.3.1          Activate Account
 7.3.2          Change Account
 7.3.3          Create Account
 7.3.4          GetQuestion
 7.3.5          GetQuestions
 7.3.6          Login
 7.3.7          ReadData
 7.3.8          ReinitializeAccount
 7.4        General
 7.4.1          TestConnection
 8      Futurama Vision
 8.1        Installation Futurama Vision
 8.1.1          Installation Futurama Vision Management Site
 8.1.2          Installation or Upgrade of the Futurama Vision Database
 8.2        Futurama Vision Management Site
 8.2.1          Futurama Vision Management Site - Admin
 8.2.2          Futurama Vision Management Site – Security
 8.2.3          Futurama Vision Management Site – Skinning
 8.2.4          Importing data into Futurama Vision
 8.2.4.1            Importing data by webservice
 8.2.4.2            Importing data from a Zip-file
 8.2.4.3            Importing data with Futurama Vision Batch
 8.2.4.4            Futurama Vision Webservice Security
 8.2.5          Further processing of data into Futurama Vision
 8.3        Futurama Vision File manager
 8.4        Activity overview
 8.5        Storing data in Vision from a Futurama application
 8.6        Futurama Vision – Data
 8.7        Futurama Accounts - Management Site
 8.7.1          Futurama Accounts - Table in Vision Database
 8.8        Futurama Server - Management Site
 8.8.1          Special Futurama Server Jobs
 8.9        Futurama Register - Management Site
 8.9.1          Configuration - Futurama Register
 8.10         Retrieving AppEvents from Futurama Vision
 8.11         Adding CustomPages to Vision
 9      Futurama Intermediate Control Output (FICO)
 9.1        FICO example - Change/Add HTML headers
 9.2        FICO example - Change Graph
 9.3        HTML5 Template
 10       Futurama Web API
 10.1         Postbacks of Futurama webcontrols
 10.2         Retrieving Resources using Web API
 10.3         WebAPI Session management
 11       Tutorials - Overview
 11.1         Tutorials - Examples and Downloads
 11.2         Beginners
 11.2.1           Creating formulas with Futurama
 11.2.1.1             Exercise 1: Pythagorean Theorem (Easy)
 11.2.1.2             Exercise 2: Newspaper stall (Medium)
 11.2.1.3             Exercise 3: Recursive functions (Difficult)
 11.2.1.4             Exercise 4: Leap Year (Difficult)
 11.2.1.5             Exercise 5: The Guessing Game I (Medium)
 11.2.2           Creating a Website Application
 11.2.2.1             Exercise 1: Creating a Website (Easy)
 11.2.3           Styling your website with CSS
 11.2.3.1             Exercise 1: Adding CSS (Easy)
 11.2.4           Adding interactivity to your website
 11.2.4.1             Exercise 1: Summation (Easy)
 11.2.4.2             Exercise 2: The Guessing Game II (Medium)
 11.2.4.3             Exercise 3: Nationality (Medium)
 11.2.4.4             Exercise 4: Nationality - RepeatTarget (Medium)
 11.2.4.5             Exercise 5: Reversed Guessing (Difficult)
 11.2.5           Working with Tables
 11.2.5.1             Exercise 1: Average (Easy)
 11.2.5.2             Exercise 2: Boundary values (Difficult)
 11.2.5.3             Exercise 3: Standard Deviation (Medium)
 11.2.6           Reading and processing XML-data in Futurama
 11.2.6.1             Exercise 1: Shares (Medium)
 11.2.7           Adding Graphs in Futurama
 11.2.7.1             Exercise 1: World Population (Easy)
 11.2.8           Working with Actions in Futurama
 11.2.8.1             Exercise 1: Changing Colors (Easy)
 11.2.8.2             Exercise 2: On and Off (Medium)
 11.2.8.3             Exercise 3: The ChangeValue object (Difficult)
 11.2.8.4             Exercise 4: The Guessing Game III (Medium)
 11.2.8.5             Exercise 5: CheckBox (Medium)
 11.2.9           Multiple Pages and Navigation
 11.2.10            Using XSLT to display data
 11.2.10.1              Exercise 1: Overview Summation (Easy)
 11.2.10.2              Exercise 2: Persons (Medium)
 11.2.10.3              Exercise 3: Leap Year Overview (Difficult)
 11.2.11            Webservices in Futurama
 11.2.11.1              Exercise 1: Example (Easy)
 11.2.12            Creating a Webservice Application
 11.2.12.1              Exercise 1: Add (Easy)
 11.2.12.2              Exercise 2: Webservice Nationality (Medium)
 11.2.13            Creating a Console Application
 11.2.13.1              Exercise 1: Adding extra fields (Easy)
 11.2.14            Generating Documents
 11.2.14.1              Exercise 1: Tax Rate (Medium)
 11.2.14.2              Exercise 2: Tax Rates Table (Difficult)
 11.3         Advanced
 11.3.1           Responsive Design
 11.3.1.1             Exercise 1: Orientation
 11.3.1.2             Exercise 2: Target different screen sizes
 11.4         Older Tutorials (Futurama Version 3.2)
 11.4.1           Futurama Editor Tutorial 1: The first sum
 11.4.2           Futurama Editor Tutorial 2: An annuity
 11.4.3           Futurama Editor Tutorial 3: Working with tables
 11.4.4           Futurama Editor Tutorial 4: Modelling a DB pension plan
 11.4.5           Futurama Editor Tutorial 5: Working with XML
 11.4.6           Futurama Web Tutorial 1: Hello world
 11.4.7           Futurama Web Tutorial 2: Buttons and Actions
 11.4.8           Futurama Web Tutorial 3: Textboxes
 11.4.9           Futurama Web Tutorial 4: DropdownLists
 12       Miscellaneous
 12.1         Responsive website
 12.2         Reducing memory usage for XmlNodes and XmlFields
 12.3         Explaining caching for websites and webservices
 12.4         Certificates - basic information
 12.5         Performance XML operations
 12.6         Creating XSD files and using them in combination with Futurama
 13       Templates
 14       Safe2Save WebAPI Sample
View  |  Print  |  PDF

451 documents found.


Futurama Server - Management Site

Futurama-Vision
Futurama-Server
User-ManagementSite

 

Concerns: Vision Management Site

Edition: Futurama Export

Module: Futurama Server

User: User Management Site

Prerequisites

- installation Futurama Server

Introduction

Description how to use the Futurama Vision Management Site to start Futurama Server jobs

 

Description

The Futurama Export edition consists of 2 modules: Futurama Console and Futurama Server. Futurama Server is an optional module of this edition. Using this module it is possible to define Futurama Server jobs. Futurama Server jobs are tasks that define which export process has to be run and which parameters have to be used for this process. The Futurama Vision Management Site can be used to run these jobs and monitor the status of the jobs. In this page the Futurama Server specific parts of the Futurama Vision Management Site are explained. Furthermore the definition of a Futurama Server job is explained.

Management Site

If you have a license for the Futurama Server module, the Server menu in the Futurama Vision Management Site can be viewed. This menu does have two submenu's. The first submenu lists all the jobs that are defined. One of the defined jobs can be selected and executed. The second submenu displays the status of the jobs that have runned. See below for more information regarding these menu's.

List jobs

This submenu displays all the Futurama Server jobs that are defined (see the paragraph 'Define Futurama Server jobs' for more information how to define a Futurama Server job). First of all the location of the Futurama Server jobs (XML-files) has to be defined. Within the <appSettings> section of the web.config of the Futurama Vision Management Site the key 'ActuIT_FuturamaServer_JobsDirectory' can be defined:

<add key="ActuIT_FuturamaServer_JobsDirectory" value="path"/>

The value of ActuIT_FuturamaServer_JobsDirectory determines the default path to the Futurama Server jobs.

Note: make sure that that the identity of the application pool of Futurama Vision Management Site has read permissions to the location specified.

Press the start button to start a Futurama Server job. The export process defined in the specific Futurama Server job will be executed. The status of the job can be monitored in the next submenu.

Check status

The status of Futurama Server jobs can be monitored in this submenu. For each job that is started the next information is available:

  • Name: the name of the Futurama Server job. Corresponds with the name of the job in the previous menu.
  • Status: the status of the job. The job gets the status Completed when the job is finished. Press the refresh button to refresh the status
  • Progress: the progress of the export job. See the paragraph 'Define Futurama Server jobs' how to define the progress of a job
  • # Errors: the number of errors that have occurred during the export. More information about the errors can be found in the logfiles of Futurama Service and Futurama Batch. See Installation Futurama Server for more information.

If a job consists of subjobs (see the paragraph 'Define Futurama Server jobs') the status of these subjobs can be viewed by pressing the '>'. Jobs that are started can be stopped by pressing the 'Stop' button. To delete jobs in this menu press the 'Delete' button'. Note that only the status of the job will be deleted. The job itself will remain. Stopped jobs can be restarted by pressing the "restart" button [from Futurama 2016_11]

It's possible to filter the list so only your own jobs are visible. By unchecking the checkbox "show only my own jobs", the jobs of other Vision users become visible. [From Futurama 2016_11]

By default only recent runs of individual jobs are shown, so when a job has been restarted multiple times, only the most recent run is shown. To show all executions of that particular job, you can uncheck the checkbox "show only recent jobs" [From Futurama 6.0+]

Should both the checkboxes be checked, then the user will be shown both the most recent execution for each job (regardless of creator). If the last execution is not a job started by the user, then the most recent execution of other users will be shown as well .

LogViewer

After execution a Futurama Server job a clickable link to the LogViewer is shown for each job. After clicking at this link the LogViewer will be opened and analyzing of the logfile is possible (from Futurama 2016_12).

Define Futurama Server jobs

As described previously Futurama Server jobs are tasks that define which export process has to be run and which parameters have to be used for this process. In this paragraph an example of a Futurama Server job is given, and the relevant parameters are explained.

Example

Mentioned below an example of a Futurama Server job. The definition of this job is in an XML-file:

<?xml version="1.0" encoding="utf-8"?>
<Job xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns="http://www.ActuIT.nl/FuturamaJob.xsd"
    Name="Testrun" Version="1.0">
    <NumberOfProcesses>2</NumberOfProcesses>
    <RepeatUntilFinished>true</RepeatUntilFinished>
    <Task Name="Create Documents">
        <File>Mailmerge.xml</File>
        <ActionID>
            <string>56817</string>
        </ActionID>
        <OutputID>57567</OutputID>
        <CheckID>56821</CheckID>
        <CheckInterval>1</CheckInterval>
        <Parameter>
            <TaskParameter>
                <Name>pdfamount</Name>
                <Value>1000</Value>
            </TaskParameter>
            <TaskParameter>
                <Name>createpdf</Name>
                <Value>TRUE</Value>
            </TaskParameter>
            <TaskParameter>
                <Name>BatchSize</Name>
                <Value>100</Value>
            </TaskParameter>
        </Parameter>
    </Task>
</Job>

Parameters

In the example mentioned above a number of parameters/settings are given. Below an explanation of each of these settings:

  • with the attribute 'Name' the name of the Futurama Server job is defined. This name will be shown in the menu where all the jobs are listed;
  • the <job> element defines the job to be executed. Within each <job> tasks can be defined. Each task is defined within a <Task> element. Within this element is defined which tasks has to be executed. Executing a job actually means the executing of the consecutive tasks. The <Task> element also has an attribute 'Name'. This is the name of the task within the job;
  • the parameter NumberOfProcesses defines how many parallel processes are started to execute a task. Dependable on the number of processors available at the server where the job is executed the value of NumberOfProcesses can be chosen. If NumberOfProcesses>1 then Futurama Server will start more Futurama instances to execute the job. This implies that the job will be executed faster;   
  • the value of the parameter RepeatUntilFinished is relevant only when both NumberOfProcesses equals 1 and within a task subtasks are defined (see the paragraph 'Subtasks' for an explanation about defining subtasks). If in that situation RepeatUntilFinished is True, then automatically the next subtask is executed when the previous one is completed. This process ends at the moment of the stop condition (see the paragraph 'Status' for more information). If the value of RepeatUntilFinished is False only one subtask will be executed. In the situation that NumberOfProcesses is greater then 1, the value of RepeatUntilFinished will be ignored. After completing one subtask the next one will be executed until the moment of the stop condition. 

Within a task the next settings have to be made:

  • File: the name of the Futurama document with the definition of the actions that have to be made for the job to be executed. It is possible to either give the entire path to the Futurama document or only the name of the Futurama document. In that situation it is important to define in which directory this document is saved. This can be configured in the configuration file of Futurama Batch. In the Configuration-Mapping section of the futuramaSettings the rootpath property has to be used;
  • ActionID: the ID of the Action within the Futurama document to be executed;
  • OutputID: the OutputID is the ID of the XmlBuilder in the Futurama document where the status of a job is defined (see the paragraph 'Status' for more information);
  • CheckID: the CheckID is the ID of the Futurama Object (i.e. the XMLBuilder or Action) that is used to do the iterations of the action that is executed. This is the object where the values RepeatData and RepeatTarget are used. For example when for a memberset a document has to be created, the value of the CheckID is the number of documents (i.e. the number of members for which a document is created) that has been created at any moment. This setting is optional. However, when it is not used, the progress of the server job won’t be shown in the Management Site;
  • CheckInterval: the value of CheckInterval determines how many iterations (determined by the value of CheckID) will take place before the value of the status is adjusted. Suppose that the value of CheckInterval equals 10. In that situation the status will be adjusted every 10 iterations (determined by the value of CheckID). Note that the status is not explicitly adjusted when refreshing the website, either manually or automatically. Therefore if the website is refreshed before the number of iterations stated by CheckInterval have been performed, the value of status will remain the same.;
  • Parameter: within the element 'Parameter' several TaskParameters can be defined. These TaskParameters can be used in the Futurama document with the defintions of the export process. The value of a TaskParameter can be read by using the Futurama formula Read.RequestParameter. In the example job mentioned above for example the TaskParameter 'createpdf' is defined. In the Futurama document the value of this parameter can be read. Then, for example, only when the value is 'True', for each member a PDF has to be created. These TaskParameters can be used during the development to first test the export process for a small group of members, before executing the entire export process. In the example a parameter BatchSize is used in order to restrict the export for the first 100 members.

Status

As mentioned above in the defintion of a Futurama Server job the OutputID is important. This is the ID of the XmlBuilder in the Futurama document where the status of a job is defined. Using this XmlBuilder it is possible to display the actual status of a job in the Futurama Vision Management Site. In order to display this status properly the XmlBuilder must have the next content (i.e. elements in the XML):

  • completed: 'completed' is the number of iterations (for example the number of documents created) for each (sub)task that is executed. The value of CheckID can be used to calculate this number. In the Futurama Vision Management Site the value of 'completed' will be used to give information about the progress of the export process;
  • total: 'total' is the number of iterations (for example the number of documents to be created) that will we executed. If the job is divided into subtasks (see the paragraph 'SubTasks') 'total' displays the total iterations for each subtask. If the job doesn't have subtasks, 'total' displays the total number of iterations to be executed for the entire job;
  • JobTotal: 'JobTotal' is only applicable when using subtasks. If no subtasks are used this parameter will be ignored. If subtasks are used, 'JobTotal' is the total number of iterations that will be executed for the entire job. This actually is the sum of 'total' for all the subtasks;
  • LastJob: 'LastJob' is only applicable when using subtasks. 'LastJob' is a Boolean and has either value 'True' or 'False'. This parameter is the stop condition for the job to be executed. When 'LastJob' gets the value 'True' the subtasks that is executed at that moment will be the last subtask. This means that no new subtask will be executed when the current is completed. To determine when 'LastJob' must get the value 'True' define Futurama formulas to count the total number of iterations to be made, the total iterations already made and the number of iterations to be executed for each subtask. If the remaining number of iterations to be made is less the the number of iterations in one subtask, then 'LastJob' must get the value 'True'. In that situation after executing the subtask all the iterations are done.

The actual value of the status of a task can be seen any time by pressing the refresh button. By itself, the website will automatically refresh every 5 seconds. Refreshing means that Futurama Server does a request for the actual status of a job. A refresh will not cause an automatic adjustment of the value of the status itself. Only when during the time between two refreshes more iterations have taken place than CheckInterval, the status will show a new value. If less iterations than CheckInterval have taken place, the value of status will remain the same.

Important: the names of the elements within the XmlBuilder must be exactly the same as defined above. This is also case sensitive. 

Subtasks

Within a job a task is defined. For example to create a number of documents in a filefolder. The task to create these documents will be divided into subtasks in the next two situations:

  1. the NumberOfProcesses>1. In that situation the execution of the task will be divided over different processors. Actually the total task will be divided into batches. Each batch will be assigned to a 'free' processor. After completing a batch, the processor will get the next batch to process as long as 'LastJob' gets the value 'True'. In the Futurama document has to be defined what the size of the batch is to be processed by each processor);
  2. the NumberOfProcesses=1 and RepeatUntilFinished=True. In that situation the processor will execute the batch size that is defined in the Futurama document until all the documents are created (the 'LastJob' gets value 'True' at that moment).

Above is defined in which situation for the export process subtasks are used. In order to know which subtask is executed (and to know for which members in the next subtask an export has to be made) the SubJobID is relevant:

SubJobID

Subtasks can be identified by the parameter SubJobID. The value of this parameter gives the index nummer of the subtask. So for the 5th subtask to be executed the SubJobID equals 5. This information can be used in the Futurama document with the defintion of the export process. The Futurama formula ReadRequestParameter can be used to read the value of the SubJobID. This information can be used to divide the whole member set in batches and define which batch is the next in the row to be processed.

Defining batch size subtask

Using subtasks it is important to determine the batch size for each subtask. Recommendable is to define this batch size in the job definition file (like the example that is given at this page). The value of the batch size can be read in the Futurama document by using the ReadRequestParameter formula. With the combination of the batch size and the SubJobID the set of members can be selected for which the export process in the next subtask has to be executed.

Examples

Example1

In this example a server job is created, which creates 10 XML files. Within this server job, only the OutputID is used. The CheckID is not used here.

Downloads

Download the files used for Server job example1.

Description

  • Install version 17.12 of Futurama Server and Futurama Batch (see Installation Futurama Server).
  • Extract the zip file and place the Xml file "Execute_Job1.xml" within the folder that is defined in the configuration file of the Management Site (see the paragraph "List jobs").
  • For this example the directory "C:\FuturamaServer\Server jobs" is used. Create this directory and place the folder "Job 1" within this directory.
  • Within the folder "Job 1", a Futurama application is available. Next to this, a folder "Output" is available. After the job is executed, the created XML files will be saved here.
  • Open the file "Execute_Job1.xml". Note that the directory mentioned above is configured within this file.
  • Within this file the Action that is executed and the OutputID are defined. Within this example, the CheckID isn't defined within the server job. Because only 10 files are created, the progress of the job isn't important.
  • Execute this server job within the Futurama Management Site.
  • When the Status is "Completed", the server job is finished. Note that the Progress is still "0 of 0 completed". This is because the CheckID is not defined, thus the server job doesn't know how many files will be created.
  • Navigate to the directory "C:\FuturamaServer\Server jobs\Job 1\Output". Within this directory, 10 XML files are created.

Example2

In this example a server job is created, which creates 100 XML files. Both the OutputID and CheckID are used for this server job.

Downloads

Download the files used for Server job example2.

Description

  • Install version 17.12 of Futurama Server and Futurama Batch (see Installation Futurama Server).
  • Extract the zip file and place the Xml file "Execute_Job2.xml" within the folder that is defined within the configuration file of the Management Site (see the paragraph "List jobs").
  • For this example the directory "C:\FuturamaServer\Server jobs" is used. Create this directory and place the folder "Job 2" within this directory.
  • Within the folder "Job 2", a Futurama application is available. Next to this, a folder "Output" is available. After the job is executed, the created XML files will be saved here.
  • Open the file "Execute_Job2.xml". Note that the directory mentioned above is configured within this file.
  • Within this file the Action that is executed and the OutputID are defined. Within this example, the CheckID is also defined within the server job.
  • Execute this server job within the Futurama Management Site.
  • When the Status is "Completed", the server job is finished. Within the header 'Progress', the status "100 of 100 completed" is now visible. Within this example the CheckID is defined, so the server job knows the number of files that is created and the current number that is executed.
  • Within the file "Execute_Job2.xml", the Action that is executed and the Action that is used for the CheckID are different. However, these parameters can also be linked to the same Action. When the ActionID is changed to value '3', the server job will still work. When executed, only the UserVariable "Total created" won't be set to 0 at the start of the job. Because the default value of this UserVariable is already 0, this step is not necessary.
  • Navigate to the directory "C:\FuturamaServer\Server jobs\Job 1\Output". Within this directory, 100 XML files are created.

Related Topics

- Installation Futurama Server: Description how to install and configure Futurama Server

- ReadRequestParameter: Futurama formula that can be used to read the value of TaskParameters from the job definition file

Feedback

If you have any questions about this subject or if you want to provide us feedback please send us an e-mail.

Updated: 2018-02-15


Previous  |  Next