The NEW XpressDox Version 14 is now available!

Edit Content
Click on the Edit Content button to edit/add the content.

User Reference

The HzGroup Command

The default layout format for an interview is for the controls in the interview to be arranged vertically, one under the other. This behaviour can be modified by use of the HzGroup command (the name standing for ‘HorizontalGroup’). For instance, the command «HzGroup(Title,FirstNames,LastName)» would cause the controls for data elements Title, FirstNames and

Read More »

The Width Command

Before the advent of the Width command, the widths of controls on the interview would be variable, as the right hand side of the control is a fixed distance from the edge of the interview form.  This gives the interview a uniform look, but this can become tedious to look at,

Read More »

The SetWebInterimSaveButton Command

This command will enable a cloud user to save a partially completed interview without generating a merged document. The command provides text for the button which will appear on the interview screen, and also a URL to which the partially completed data set will be sent. The data will be in XML

Read More »

The CommasAndList Function

This function is very similar to the List command. The difference is that List operates on repeated data elements (e.g. the names of parties), whereas CommasAndList operates on a list which is contained either in one data element, or, more typically, in a variable constructed out of other values. Suppose

Read More »

The ChooseUsingTimePicker Command

This command is a variant of the CaptureDataElement command which causes a “time picker” control to be placed on the interview to help the user in choosing a time of day correctly. «ChooseUsingTimePicker(AppointmentTime)» As with all the “Choose…” commands, the ChooseUsingTimePicker command will NOT cause the chosen time of day to

Read More »

The FormatTime Function

If a value has been captured as a time of day, then it can be formatted and inserted into the merged document in a format desired by the template author.  For example, a user may have captured a time in a 24 hour format, but it can be printed in

Read More »

ChooseFromHzRDBList

This command will present a list of radio buttons arranged horizontally in the interview form.  In all other respects it is functionally equivalent to the ChooseFromRDBList command.   Command structure: «ChooseFromHzRDBList(Entity_Type,Individual,Corporate)»     By default the first value in the fillpoint will be selected, but it is possible to remove

Read More »

The YearsBetween Function

«YearsBetween(EndDate,StartDate)» returns the approximate number of years between the two dates. The reason that it is approximate is that it is calculated as the number of days between the two dates divided by 365.25. Thus for a long time period, the result will be more accurate than for a short

Read More »

The CaptureOnlyEmptyValues Command

When the data set can be populated prior to the interview becoming active, then this command can be used to present an interview which contains only those data elements which are empty. A dataset can be populated prior to the interview in a number of ways: The data are sourced via an

Read More »

The Chr Command

This function can be used to return a character based on its numeric (Unicode) value. Command structure: «Chr(13)»   Examples of usage: «Chr(13)» This will insert a carriage return.   Some further examples: Format an address block in the questionnaire: Chr will probably only be used in the context of

Read More »

The ChooseFromDataElements Command

Once the data set being captured has acquired some data (either captured in this session or included from a data source or file), then a ChooseFromDataElements command can be used to allow the user to capture the value of a data element from the values of existing data elements. For example,

Read More »

The EscapeForXml and GetValidXmlElementName Functions

These two functions are used in the context where the XpressDox template is needed to generate XML.  (By the way, this demonstrates the power of XpressDox in being able to produce not just Word documents, but also text and, in this case, transform XML from one format into another). «EscapeForXml(Text)» will translate

Read More »

The HideEmptyInterview Command

If you have a template which results in an empty interview, then the interview can be suppressed using the command «HideEmptyInterview(Yes)» The question is, why would you have such a template?  It could be that the template consists of fillpoints which merge in data from a data source, for example, and

Read More »

The SetRepeaterQualifier Command

When XpressDox builds an interview and there are repeating elements in the data set, those repeating elements are normally shown in a treeview with the name of the element (or the Caption which might have been set) followed by the value of the first data element in the form for that repeater. For

Read More »

The SaveAsText Command

Sometimes you might want the result of XpressDox merging data and template to be not a Word document but another document, for example a CSV file, or even another XML document, or programming code (yes, XpressDox can be used to generate programming code, or HTML, anything really).  In all those

Read More »

The Round Function

The Round function performs rounding.  For example: «Round(Amount)» will round the value of the Amount data element name to the nearest whole number. The Round function can take on extra optional parameter being the number of decimal places to which the number should be rounded (the default is 0).  «Round(number,3)»

Read More »

The RepeatWhile Command

Repeating information which is not in the form of repeating data in XML (i.e. multiple same-named XML elements) can be handled using the RepeatWhile command. An example of the kind of repeating data that would need a RepeatWhile would be a data element that contains a comma-delimited list of directors

Read More »

The ReadOnly Command

«ReadOnly()» will cause the named data element (or list of data elements) to be shown in the interview, but their values will not be able to be changed by the user. Simple Usage This is used typically where data are supplied from a data source (maybe via a ChooseFromDataSource command)

Read More »

OnExitSet – XpressDox

Set the value of a data element on your XpressDox template «OnExitSet()» permits the template author to specify that, when a control on the interview (the trigger) loses focus, the value of another or the same data element (the target, caption, footing or heading can be set.  If the data

Read More »

The LinkToOtherData Command

«LinkToOtherData()» enables the template author to define that when a template is being run and the user moves the cursor out of the control for the data element in the interview, that the equivalent of pressing the User Other Data button on the interview is performed.  This uses the data

Read More »

The IncludeCodeTemplate Command

This command is similar to IncludeTemplate, but is used for templates which consist entirely of XpressDox commands, and none of the text of the template is required in the merged document. When the code template is included using this command, then any of the paragraphs in the included template which

Read More »

The ExcludeFromDataSet Command

Some data are only needed during the merging of a template, and are not needed to be saved in the data set file. This would normally be the case where data are included from a data source, and any subsequent use of that data would require the data to be

Read More »

The Empty Marker

This refers to the mechanism for placing a code into the merged document to show those places where data elements do not have a value (or, rather, have an empty value).  This code is called the Empty Marker. There is a tab panel in the Configuration form, currently called “Other

Read More »

The DaysBetween Function

«DaysBetween(EndDate,StartDate)» returns the number of days between the two dates. For example: I was born on «FormatDate(DateOfBirth,‘d MMMM yyyy’)» which means I am «floor(DaysBetween(Today(),DateOfBirth) div 365.25)» years old. The MonthsBetween function has a similar functionality.

Read More »

The ChooseUsingDatePicker Command

«ChooseUsingDatePicker(DateOfBirth)» will cause a date picker control to be used when the DateOfBirth data element is required to be captured. Like other Choose commands, the ChooseUsingDatePicker command will only be included in the interview if the data element referred to is used elsewhere in the template, either directly to cause

Read More »