qRules 4.2 includes a nifty feature that allows you to immediately access the contents of text-based files that users attach to your form. For example, if a user attaches an ordinary text file to the form, you can extract the contents into a field bound to a textbox and immediately allow the user to edit the text, or you can just display the text in your form.
One additional feature that this new command provides is the ability to interpret the attached file as XML and add that XML to some location in one of your form's data sources. In the below screenshot, you can see a simple example of attaching an XML file with a list of clients' names, which are attached to a repeating group in a secondary data source. A textbox below also shows the extracted file text as a reference.
The command's syntax is as follows:
DecodeBase64 /sourcepath=... [/sourceds=...] [/asxml=...] [/destpath=...] [/destds=...] [/excludesourceroot=...]
Parameters surrounded with [square brackets] are optional. Below are the uses of each of the parameters:
sourcepath - The XPath location of the file to decode.
sourceds - The name of the data source where the file to decode is, if it is not in the main data source.
asxml - (Boolean, true by default) When true, treats the file contents as XML and inserts it into a location in one of the form's data sources.
destpath - When asxml is true, the XPath location where the file's XML should be inserted.
destds - When asxml is true, the name of the data source where the file's XML should be inserted, if not the main data source.
excludesourceroot - (Boolean, true by default) When true and using the asxml option, inserts everything except the file XML's root (top) node into the form's data source. When false, the root node is included.
When a file's contents have been successfully extracted as text, the text contents are placed into the QdabraRules Result field.
Do you have an InfoPath scenario that has a use for this command? Let us know in the comments.