The Concept of Databoxes

From Keyfax Wiki
Jump to: navigation, search

Databoxes are used in Scripts to capture, manipulate and evaluate data. During the process of designing and creating scripts in Keyfax Inter•View, a script will capture data when entered by the user. This data may be used in a subsequent task or may be used to control the path taken within the scripts. This data capture and evaluation is carried out using databoxes. A databox can be viewed as a ‘box’ which stores information. This ‘box’ can have data put into it (write), and the same data can then be pulled out of it (read). This means the administrator does not have to worry about the technicalities of locating where the data is physically stored and how it is accessed.

These are the six types of databox and how they relate to the manipulation of data.

Script Data

A Script Data Databox is used to hold data gathered within a script e.g. an answer to a question. The information being captured or manipulated in Keyfax can be ‘written’ to a Script Data Databox and re-used at a later point within the Scripts. Typically, Script Data Databoxes are used to store data that is to be integrated into a subsequent task (such as an email or letter).

SQL Query

An SQL Query Databox is linked to a database, either the Keyfax database or an external database via a SQL query. Because of this, SQL Query Databoxes are known as ‘Read Only’. This means that they are only used to pull data from a database and not to write data back into the connected database.

Import XML

An Import XML Databox is linked to the information given by the Host System to Keyfax Inter•View when it is launched. Examples of the type of information passed are TenantID, AssetID, Tenant Address and UserID. A typical breakdown of the elements available in your Startup XML can be obtained from your Keyfax Account Manager or by reviewing the test page within the administration console.

Export XML

An Export XML Databox is linked to the information that is passed back to the Host System by Keyfax Inter•View after clicking the ‘Submit’ button. Depending on the path taken a Script, the information held in the Export XML can vary considerably. An Export XML Databox can be used to change the data passed back to the Host System. A good example of this would be the setting of a Trade or Location Code following the diagnosis of a repair in Keyfax Inter•View.

System Values

A System Values Databox is linked to information associated with the computer running Keyfax. A typical example of this would be the current time/date. These are sometimes seen as ‘Keyfax’ Databoxes.

Company Data

A Company Data Databox usually contains a list of set values that can be used within the Scripts. An example of this would be a list of email addresses set against their counterpart user names.