Visit Boris website Set a value for an item within the document

Set a value for an item within the document refers to an item in a job that is associated with the template (see Item Types). The way the value is set depends on the Update mode specified below.

Main

Main screen for this action
*Description

A descriptive text to identify this action

*Unique name of item to update All items (and other objects in your template) have a unique name. This will be automatically generated by Boris but can be amended to create something more meaningful. If you do not know the unique name, click on the item that you wish to update and make a note, or copy it to the clipboard, to enter, or paste, here. Please be aware that if the form has already been used then changing the unique name can undermine data integrity and should be avoided.
*Value to set This is the value that you will allocate to the item identified in 'Unique name of item to update'.  Report processing variables can be used here.
Update mode

Update mode determines how Boris will behave when updating the attribute.  The drop-down box contains the following options:

  • Overwrite existing value – takes value entered above and replaces the existing value – useful for recording date of most recent visit
  • Append to existing value – adds new value onto whatever was there before - a full history of visit dates could be held in a string of data
  • Append to existing value with date/time heading – as above, the new value is added to the string of data but with the current date/time
  • Create value only, don't overwrite – will never overwrite/update so it will only be created once as a new value – useful for recording date of first visit

Conditions

This action will only be triggered if the conditions below are met. Leave blank if it is always to be executed.

Condition (1) If you wish to only run an action in a particular situation then you can use these conditions to specify them. The action will only occur if both conditions are satisfied. Typical uses are to only run an action if a particular answer has been given to one of the answers on the template. See Concepts-Conditions
Condition (2) If you wish to only run an action in a particular situation then you can use these conditions to specify them. The action will only occur if both conditions are satisfied. Typical uses are to only run an action if a particular answer has been given to one of the answers on the template. See Concepts-Conditions

Post-action processing (advanced)

After an action has finished running a file can be executed on the server. This could be, for instance, a .exe or a .bat file. Typically this would be used to insert data into another system.

File name to run Enter the full path and filename here.  Ensure that it is correctly spelt and that the file extension (such as .exe or .bat) is also correct.
Command line to run If the file specified above requires additional information on its command line, please enter it here. Contact your Boris expert for further help.
Folder to run from Enter the full path and folder name that the executable programme needs to be launched from.
URL Instead of running an executable file locally, an http request can be sent to the URL specified here. It can contain standard variables.
HTTP verb Choose the http verb to be sent with the request to the URL specified above.  If you do not know what this is, ask your Boris expert.
HTTP request body This will be very different in different circumstances and probably needs to defined at the implementation stage. It can contain standard variables and may contain the data entered on the form.
See Also

Templates

 

 


Parts copyright 2014 Boris Software Ltd. Parts copyright 2014 Firetronic Software Ltd. Parts copyright 1998-2014 Cadence Computing Ltd. All Rights Reserved.

Menus, prompts, fields and options are from a typical installation - some items may not appear as shown. Please contact Boris support for information on additional features.