The NEW XpressDox Version 14 is now available!

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

User Reference

The SetInterviewDataOnly Command

If the sole purpose of a template is to construct an interview, but the document merged from that template is not required, then the SetInterviewDataOnly command can be included in the template, and the merged document will be ignored. A typical usage of this would be in conjunction with the

Read More »

The ShowIfHasValue Function

This function is used mainly to get rid of empty paragraphs in a document. «ShowIfHasValue(AddressLine3)» will insert the value of the AddressLine3 data element only if that data element has a non-empty value.  If the value IS empty, then the entire paragraph containing the field is removed. Note that this

Read More »

The PlaceHolder Command

«PlaceHolder(DummyDataElement)» will create an invisible control on the interview, but will enable Headings or Footings to be attached to that control. This would be used to include text into an interview screen, and in particular to include text which must appear or disappear depending on certain conditions. For example: «ChooseFromRDBList(PartyType,Company,Individual)»

Read More »

The SetWebButtonText command

SetWebButtonText Any template run on the web, will include a button on which the user can click to finish off the interview and begin the merge process to generate the document. By default the text on this button is ‘Assemble’. The «SetWebButtonText()» command will allow the template author to change

Read More »

The SetWebReturnURL command

SetWebReturnURL After an XpressDox template has been run from within your own web application or website, the «SetWebReturnURL» command can be used to specify a result page i.e. where the browser should point now that the document has been assembled. The return URL can be written into the application via

Read More »

The SendWebEmail Command

From v14: Whilst the «SendWebEmail» command remains active and supported, v14 introduces new commands «SaveAsEmail» and «SendAsEmail». These commands offer more flexibility in terms of the email design (no html files required), and all the XpressDox commands and functions can be used.   SendWebEmail: Upon the completion of a document

Read More »

The ChooseFromDataSource Command

The template author will use this command to provide a way for the user of a template to choose data from a Data Source and those data can then be inserted into the template. Simple Form The simplest form of the command is shown in this example: «ChooseFromDataSource(Contacts,Select the contact

Read More »

The OptimizeParsing Command

During the running of a template, XpressDox creates a number of structures. The most important one is an XSLT Style Sheet, which is used to drive the engine that merges the data into the template to form the merged document as an end result. The second structure is a schema,

Read More »

The Hyperlink Command

The Hyperlink command will attach a hyperlink to a heading or footing in the XpressDox interview.  When the user clicks on the heading or footing, then the hyperlink will be launched. An example would be: «Hyperlink(Description,Heading,www.mydomain.com/help-with-description)» Variable information (sourced from data elements in the data set) can be inserted into

Read More »

The LinkToDataSource Command

LinkToDataSource links any control on the interview to a data source (a control is what the user uses to enter data, such as a straight forward text box, or a checkbox, or a dropdown, etc.).  It means that when the focus moves off that control, a call to the data

Read More »

The Plural Function

Generic documents such as contracts often have numerous places where constructs such as “is/are” or “child/children” appear, or else the singular is always used document has a preamble has words to the effect of  “masculine usage includes feminine and singular includes plural”. With document assembly, and XpressDox in particular, the

Read More »

The Gender Function

Generic documents such as contracts often have numerous places where the construct “his/her” appears, or perhaps “his” is used in the document and a preamble has words to the effect of  “masculine usage includes feminine and singular includes plural”. With document assembly, and XpressDox in particular, the template can provide

Read More »

The OrdinalSuffix Function

This function is used internally by XpressDox’s FormatDate function to form dates like March 3rd 2011.  The “rd” after the “3” is known as an ordinal suffix.  The function used to return this date would be «FormatDate(DateOfSignature,’MMMM o yyyy”)» The template author would use the OrdinalSuffix function explicitly in order

Read More »

The IncrementV Function

This function provides a useful way of adding an amount to an XpressDox variable. There are two forms of the function: «IncrementV(‘Counter’)» This will add 1 to the value of the variable ‘Counter’. «IncrementV(‘Total’, UnitPrice)» The value of the data element UnitPrice will be added to the value of the

Read More »

The Ordinal Command

Ordinal is used within a ForEach to output the ordinal value (that is, ‘first’, ‘second’, etc.) of the position in the list of the current item: «ForEach(party)» The «Ordinal(only ,first ,second ,third ,fourth ,fifth ,sixth ,subsequent )»party is «firstnames surname». «End(ForEach party)» This would result in something like this: The first party is Fred Basset. The second party

Read More »

The GetListItem Function

This function is used to extract a value from a list. In the first example, the data element contains a number (an integer) which is used to get an item from a list, where the list is coded in the fillpoint itself: «GetListItem(BondNumber,’First,Second,Third,Fourth,Fifth,Big’,’,’)» If the value of the ‘BondNumber’ data

Read More »

The HardSpace Command

This function converts spaces to “hard” or non-breaking spaces. When Word performs word-wrapping at the end of a line, a non-breaking space will not appear at the end of a line but will cause the characters on either side of it to be on the same line. «HardSpace(FormatNumber(Amount,“#,#0.00”,“ZA”))» If the

Read More »

FormatDate

Dates can be formatted according to patterns defined in the fillpoints.   Command structure: «FormatDate(Date_of_Engagement,”yyyy-MM-dd”)» «FormatDate(Date_of_Signature,”MMM d yyyy”)» «FormatDate(Date_of_Dismissal,”d MMMM, yyyy”)» «FormatDate(Date_of_Signature,”MMMM o yyyy”)» «FormatDate(Date_of_Signature,”dddd MMMM o yyyy”)»   These examples would result in something like, respectively: 2019-02-07 Feb 7 2019 7 February, 2019 February 7th 2019 Thursday February 7th

Read More »

The Max and Min Functions

Max calculates the maximum of two values: The maximum of «Number1» and 100.1 is «Max(Number1,100.1)». Min calculates the minimum of two values: The minimum of «Number1» and 100.1 is «Min(Number1,100.1)».

Read More »

The Now and Today Functions

Now The Now function inserts the current date and/or time into the document. It can be formatted in the same way as for FormatDate. «Now(“d MMMM, yyyy”)» yields ‘4 November, 2010’ «Now(“MMMM o yyyy”)» yields ‘November 4th 2010’ «Now(“yyyy/MM/dd HH:mm:ss.fff”)» yields ‘2011/04/14 17:05:23.010’ which is exactly the same as «Now()»

Read More »

NumberPhrase

NumberPhrase is used to convert a number to words, in several different languages. Command structure: «NumberPhrase(Area,”,’leave’)» Examples of usage: «NumberPhrase(Area,”en-us”,”ToUpper”)» Suppose a data element with name ‘Area’ has a value 1234:This would yield “ONE THOUSAND TWO HUNDRED THIRTY-FOUR” Parameters: Languages supported are ‘en’ (US English, the default), ‘fr’ (French), ‘de’

Read More »

The Replace Function

Replace is used to replace all occurrences of one string in a source string with another string: «Replace(Address,”Ave.”,”Avenue”)» “123 Long Ave., Cape Town” becomes “123 Long Avenue, Cape Town”

Read More »

The StartsWithVowel Function

The result of this function would typically not be included directly in the merged document, but would be used in a conditional, such as: If «When(StartsWithVowel(Fruit),an,a)» «Fruit» is ripe it tastes better than if it is rotten. The function assumes that ‘a’, ‘e’, ‘i’, ‘o’ and ‘u’ (and their uppercase

Read More »

The TableLookup Function

The TableLookup function enables the calculation of an amount from a table. Typically this is used with tax tables, or other tables of tariffs. The normal tax calculation for South Africa for the 2008/09 tax year is based on this table (reproduced from the South African Revenue Services web site):

Read More »

Change the Case of a Value

Regardless of the case of the value entered into the interview or imported from a database, that value can be converted using the following commands into a different case on the assembled document:   ToUpper This will place the UPPER CASE value of the data into the document: «ToUpper(FullName)» “Fred

Read More »