Difference between revisions of "System Values"

From Keyfax Wiki
Jump to: navigation, search
(Created page with "Home > Databoxes > System Values System Values A System Values Databox can be one of a number of System Values according to the System Value selected on creation of the Data...")
 
Line 1: Line 1:
Home > Databoxes > System Values
+
A System Values databox can be one of a number of system values according to the system value selected on creation of the databox. For clarity, the databox name should reflect the selected type.
  
System Values
+
[[File:systemvalue41.png]]
  
A System Values Databox can be one of a number of System Values according to the System Value selected on creation of the Databox. For clarity, the Databox name should reflect the selected type.
+
The value returned for each system value is described in the sections below.
  
 +
==DataViewURL==
 +
This returns the DataView URL for the current configuration and should only be used when DataView is installed (requires a separate licence). The URL returned will be formatted with the current users credentials each time the script is executed and the databox value is referenced.
  
 +
This is typically used in message help button links with additional parameters to direct the advisor to specific additional data within DataView.
  
The value returned for each System Value is described in the sections below.
+
==Date==
 +
This returns the current date and time.
  
DataViewUrl
+
==CallRef==
 +
This returns the Order Id reference where a service (SOR code) has been generated by the script. It can only be used as a task bookmark as the Order Id is not generated until after the system results script and only if any service has been generated by the script.
  
 +
==Services==
 +
This returns details of all services recorded in a script in an XML format as in the sample below. This is typically used in conjunction with a Transform expression to format the results into an html table for inclusion in an email.
  
 +
Specific elements and names may vary according to individual integration requirements. Other templates are available such as Services2SMV to include the Standard Minute Value. Please contact Omfax if you have any custom requests.
  
+
[[File:xml.png]]
  
 +
'''Transform Example''':
 +
[[File:ServicesTransform.png]]
  
Date
+
==ScriptPath==
+
This returns an HTML formatted list of questions and responses.
  
 +
==TaskCode==
 +
This should only be used in a task template and returns the task action code for the 'current' task being processed. This is typically used to place the task code on the template as a visible 'stamp' to identify the source of a letter or email after it has been sent.
  
CallRef
+
==TaskId==
+
This returns the ContactView Task Id reference and is only relevant for installation with ContactView configured (requires a separate license). It can only be used as a template bookmark as the ContactView Task Id is not generated until after the system results script.
  
 
+
==TotalCost==
Services  
+
This returns the total cost based on the Services generated by a script. The total cost is based on the recorded services and quantities with a configurable fee plus VAT. This is formatted to 2 decimal places.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
ScriptPath
 
 
 
 
 
 
TaskCode
 
 
 
 
 
 
TaskId
 
 
 
 
 
 
TotalCost
 

Revision as of 15:58, 21 February 2018

A System Values databox can be one of a number of system values according to the system value selected on creation of the databox. For clarity, the databox name should reflect the selected type.

Systemvalue41.png

The value returned for each system value is described in the sections below.

DataViewURL

This returns the DataView URL for the current configuration and should only be used when DataView is installed (requires a separate licence). The URL returned will be formatted with the current users credentials each time the script is executed and the databox value is referenced.

This is typically used in message help button links with additional parameters to direct the advisor to specific additional data within DataView.

Date

This returns the current date and time.

CallRef

This returns the Order Id reference where a service (SOR code) has been generated by the script. It can only be used as a task bookmark as the Order Id is not generated until after the system results script and only if any service has been generated by the script.

Services

This returns details of all services recorded in a script in an XML format as in the sample below. This is typically used in conjunction with a Transform expression to format the results into an html table for inclusion in an email.

Specific elements and names may vary according to individual integration requirements. Other templates are available such as Services2SMV to include the Standard Minute Value. Please contact Omfax if you have any custom requests.

Xml.png

Transform Example: ServicesTransform.png

ScriptPath

This returns an HTML formatted list of questions and responses.

TaskCode

This should only be used in a task template and returns the task action code for the 'current' task being processed. This is typically used to place the task code on the template as a visible 'stamp' to identify the source of a letter or email after it has been sent.

TaskId

This returns the ContactView Task Id reference and is only relevant for installation with ContactView configured (requires a separate license). It can only be used as a template bookmark as the ContactView Task Id is not generated until after the system results script.

TotalCost

This returns the total cost based on the Services generated by a script. The total cost is based on the recorded services and quantities with a configurable fee plus VAT. This is formatted to 2 decimal places.