These two functions work in tandem in those situations where calculations are to be done and the formats of the numbers involved need to be converted from regional-settings compliant format to a format where they can be used in the calculation. This latter format is referred to as “XSLT compliant”.
Calculations can give trouble when the data elements being operated on are not of the correct format. The RenderAsNumeric function will address that problem.
The Command Assistant (or Command Editor) empowers the template author by presenting a list of all the XpressDox commands, with functionality which provides wizards for completion of the command as well as supplying examples of those commands. The Command Editor also provides functionality for easily selecting the correct data element
When a template runs, XpressDox creates a number of internal structures. The most important of these is an XSLT Stylesheet. The stylesheet contains the definition of how the data from an XML data set are to be inserted into the Word template in order to generate the merged document. The
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. Typical usages of this command would be in conjunction with the
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
«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)»
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
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
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
2011-07-19 Version 3.9.2 When data is included into the data set, the sequence in which this happens is: Data from Standard Data Items in the configuration; Data from data sources configured as “Use for all templates”; Data from «IncludeDataSourceData()» commands. Prior to this release, step c. was performed before the
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. Watch a quick demo on the ChooseFromDataSource command: Simple Form The simplest form of
In troubleshooting a template, you need to know the data element names. Obviously. But looking at an interview, the data element names are not always obvious, especially if you have used the «Caption» command. Another situation is with ChooseFromDataSource, and ChooseFromFile (and the Include… variants of those commands), where XpressDox
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,
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
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
XpressDox has numerous string handling functions. The number of different applications is vast, and this article tries to provide a number of situations all in one place. Extract the last few characters of a string Suppose you have a situation where a particular data element will always contain a specific code in
A “foreign” template is a template marked up for use in another document assembly system, such as HotDocs®, GhostFill® or DealBuilder®/ContractExpress®. The discussion below applies to HotDocs when using XpressDox versions prior to version 4, but after version 4 the discussion applies equally to GhostFill, DealBuilder and documents using Word
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
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
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
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
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
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
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
901 S MoPac Expressway, Building 1, Suite #300, PMB 300127, Austin, TX, 78746, USA
85 Tottenham Court Road, London, W1T 4 TQ, UK
35 Anderson Road North, Cape Town, 7550, Western Cape, South Africa
Copyright ©2023 XpressDox. All Rights Reserved. | Website By Hello Fascination
