Section | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
E-Form Field Types | acroform Field Types | ||||||
Checkbox | Choice/Combobox (Single select) | List | Radio Button | Text | Push Button | Signature | |
---|---|---|---|---|---|---|---|
CheckBox | Mapping is done by option value. If the value of any of the selected option(s) on the e-form control matches the 'on' value of the check box, then it is selected. Otherwise it is unchecked. See NOTE below. | Select one item in choice/combo corresponding to selected checkbox options. Equate items/options by the value/option, not label. Only single select supported in some cases (depends on if field is set to multi). | Select items in list corresponding to selected checkbox options. Equate items/options by the value/option, not label. If list box is single select only one option is selected. | Select one item in radio corresponding to selected checkbox options. Equate items/options by the value/option, not label. Only single select supported. | Yes. The label text of the selected option(s) will be comma separated and used. | ||
CheckBox Option | Yes. If option selected, check box will be selected. | Yes. If selected, then option label text used. | |||||
CheckBox Comment | Yes. Only if comment is enabled. Multiple lines will be concatenated (new lines not carried over to PDF). | ||||||
Radio | Mapping is done by option value. If the value of any of the selected option(s) on the e-form control matches the 'on' value of the check box, then it is selected. Otherwise it is unchecked. | Select item in choice corresponding to selected radio option. Equate items to options by the value, not label. | Select items in list corresponding to selected radio option. Equate items to options by the value, not label. | Select one item in radio corresponding to selected radio option. Equate items/options by the value/option, not label. Only single select supported. | Yes. The label text of the selected option will be used. | ||
Radio Option | Yes. If option selected, check box will be selected. | Yes. If selected, then option label text used. | |||||
Radio Comment | Yes. Only if comment is enabled. Multiple lines will be concatenated (new lines not carried over to PDF). | ||||||
Dropdown | Mapping is done by option value. If the value of any of the selected option(s) on the e-form control matches the 'on' value of the check box, then it is selected. Otherwise it is unchecked. | Select item in choice corresponding to selected dropdown option. Equate items to options by the value, not label. | Select item in list corresponding to selected radio option. Only select one by definition. Equate items to options by the value, not label. | Select one item in radio corresponding to selected dropdown options. Equate items/options by the value/option, not label. Only single select supported. | Yes. The label text of the selected option will be used. | ||
Dropdown Option | Yes. If option selected, check box will be selected. | Yes. If selected, then option label text used. | |||||
Dropdown Comment | Yes. Only if comment is enabled. Multiple lines will be concatenated (new lines not carried over to PDF). | ||||||
Text & Text Area | Yes. Simple text transfer. | ||||||
Date, Time, DateTime | Yes. Use formatted date/time. | ||||||
Email, Phone | Yes. | ||||||
Money, Quantity, Number | Yes. | ||||||
T/F | Yes | Put a 'true' or 'false' in as appropriate. | |||||
Image | |||||||
Signature/Signed Section | Yes | Yes | |||||
Upload | Yes | ||||||
Combobox | Yes |
...
- Timezone - Times and date/times must be formatted using the form’s timezone.
- Formatting dates (and times) uses the formatting from the e-form set by the designer.
Signed Sections
You can map both the signature and signature date from a Signed Section to a PDF. However, in a workflow the Signed Section must also contain some other data in addition to the signature - an empty Signed Section will appear to map when you use the Form Viewer control on the same step as the signature, but will not be mapped on the final PDF. This is a known issue. If your business requirements call for an empty signed section, you should add a hidden text control in that section with a default value to ensure it appears on the final mapped PDF.
For example, here is a simple workflow where the employee completes Step 1, then the Manager approves Step 2 and finally, the VP approves Step 3. The Manager and VP do not need to add any information, so their Signed Sections are empty:
Each of the three signed sections is mapped to a PDF.
However, after running the workflow we get an unexpected result - the Manager Signature is not mapped to the final PDF.
- The Employee Signature is mapped because the Signed Section contains other data in addition to the signature and date.
- The Manager Signature is not mapped because it is a mid-workflow step and does not contain other data besides the signature and date. You would only see this signature mapped if you clicked a Form Viewer control on the Manager step.
- The VP Signature is mapped, even though it does not contain other data, because it is on the final step where the mapped PDF is generated.
To work around this issue, let's add a hidden text control to the Manager Section, and set the default value to "map me".
Now when we run the workflow, the Manager Signature is successfully mapped.
Mapping Selection Controls
...
A simple work-around is to put a control by the same name into the second form and uncheck the visible property. Then add the same rule to the second form to populate it. Workflows designed using Linked Activities, should not exhibit this behavior. Linked steps in flow are like a single form broken into pieces. Flows using this design pattern have a single schema which includes fields from all its steps. So when fields from a flow are mapped to a PDF, there is nothing like future fields from the PDF point of view. It is mapped to the controls in a single schema or document.
Adobe Reader Issue with Grouped Check Boxes
...