2022.1

Note
When user of the COTG app clicks or touches the Submit button in a Form, the name
and value of form elements are submitted. Normally, the name and value of an
unchecked Checkbox or Radio Button would not be submitted, but in Connect, they
are. Connect uses the workaround described in the following topic: "Getting the
status of unchecked checkboxes and radio buttons" on page632.
The Form's validation should ensure that the data that the user submits is valid (see
"Changing a Form's validation method" on page754 and "How to make COTG
elements required" on page629).
2. Create a data mapping configuration
The next step is to use the sample data - an XML file - to create a data mapping
configuration (see "Data mapping configurations" on page222).
1. Choose File > New > Data mapping Wizards > From XML file.
2. Select the XML data file as its source and click Next.
3. Set the XML Elements option to /request/values. This will automatically add an
extraction step for the submitted form fields.
4. Click Finish. The file is opened in the DataMapper and the form fields are
automatically extracted, including the data for the Signature and Camera object.
5. Save the data mapping configuration.
3. Create a template
Finally, create a Designer template and personalize it using the data mapping
configuration (see "Personalizing content" on page830). Strings, base64-encoded strings
and SVG data stored in data fields using the DataMapper can be added to the template
just like any other variable data (see "Variable Data" on page846). They will show up in
the template as they are. SVG data will be interpreted and displayed as an image.
Strings and base64-encoded strings show up as strings. In order for a base64-encoded
string to be interpreted as an image, it must be added to the URL of an image.
Adding Camera data to the template
The Camera widget submits a base64-encoded string, which can be put in a data field using
the DataMapper. When this data field is dragged into a template, the string will show up in the
content, instead of the image.
To make the image appear in a template, the data has to be used as the URL of an image.
Page 651