As of WorkflowGen version 7.19.0, all default.aspx
files are saved with the Page Async
property set to true
(e.g. <%@ Page Async="true" ... %>
). This allows asynchronous ASP.NET web form development (see the Using Asynchronous Methods in ASP.NET 4.5 Microsoft article for more information).
Check Enable server-side editing mode on the General tab in the Form configuration panel to activate this mode, which allows form designers to modify the content of the form's C# runat
server tag (e.g. <script runat="server"
) and JavaScript script tag (e.g. <script jseditor="true">
) directly in the generated default.aspx
file on the server (usually located in the \wfapps\webforms[PROCESSNAME]\V[VERSION]
folder) using Visual Studio Professional or Visual Studio Code.
The .NET and JavaScript editors are disabled when server-side editing mode is enabled.
You must save the form on the WorkflowGen Form screen every time you make changes to a script's code in the default.aspx
file in order to keep the form's HTML script tags (FORM_HTML
) up to date. This is mandatory before you can export the XPDL process definition for deployment on another server.
If you're using the Form Designer, you can enable AJAX mode by checking Enable AJAX mode on the General tab of the Form configuration panel.
When adding a custom control (e.g. a button to handle form submission), you must register the control ID as a postback control in the Page_Load
event's ScriptManager
object. For example:
A form created with the built-in Form Designer has one header, one or several sections, one or several fields per section, a Submit button, an optional Save as a draft button, and one footer.
Click in the toolbar to open the ASP.NET code editor, which can be used to define server-side procedures, events, and global variables to handle any specific custom tasks. This feature is mainly intended for ASP.NET server-side development.
Click in the toolbar to open the JavaScript code editor, which can be used to define server-side procedures, events, and global variables to handle any specific custom tasks. This feature is mainly intended for JavaScript client-side development.
Click in the top right corner of the Form Designer toolbar then to open the Form configuration panel.
Name
Description
Web forms
Enable server-side code editing mode
Enable AJAX mode
See AJAX mode
Header
Title
The title of the form
Width
The width of the form header
Numeric value with or without the unit of measure (px
, pt
, in
, cm
, mm
, pc
, em
, ex
, %
), e.g. 720px
Height
The height of the form header
Numeric value with or without the unit of measure (px
, pt
, in
, cm
, mm
, pc
, em
, ex
, %
), e.g. 38px
Image alignment
The alignment for the header image:
Right: The image will be aligned to the right
Left: The image will be aligned to the left
None: No alignment
Image URL
The URL of the image to be shown
Image width
The width of the image
Image height
The height of the image
Image repeat
Sets if and how the image will be repeated:
No-repeat: the image will not be repeated
Repeat: the image will be repeated both vertically and horizontally (this is the default setting)
Repeat x: the image will be repeated only horizontally
Repeat y: the image will be repeated only vertically
Sections
Width
The width for all sections
Numeric value with or without the unit of measure (px
, pt
, in
, cm
, mm
, pc
, em
, ex
, %
), e.g. 720px
Adjust width automatically
Check to apply adjusted width to all sections
Labels
Alignment
The alignment for all field labels:
Right: the label will be aligned to the right of the field
Left: the label will be aligned to the left of the field
Top: the label will be aligned on top of the field
Width
The width for all field labels
Numeric value with or without the unit of measure (px
, pt
, in
, cm
, mm
, pc
, em
, ex
, %
), e.g. 150px
Apply the width
Check to apply the width to all field labels
Buttons
Submit label
The label for the submit button
Save-as-draft label
The label for the save as draft button
Enable save-as-draft
Check to enable and display the save as draft button
Footer
Width
The width of the form footer
Numeric value with or without the unit of measure (px
, pt
, in
, cm
, mm
, pc
, em
, ex
, %
), e.g. 720px
Height
The height of the form header
Numeric value with or without the unit of measure (px
, pt
, in
, cm
, mm
, pc
, em
, ex
, %
), e.g. 22px
Image alignment
The alignment for the footer image:
Right: the image will be aligned to the right side
Left: the image will be aligned to the left side
None: no alignment
Image URL
The URL of the image to be shown
Image width
The width of the image
Image height
The height of the image
Image repeat
Sets if and how the image will be repeated:
No repeat: the image will not be repeated
Repeat: the image will be repeated both vertically and horizontally (this is the default setting)
Repeat-x: the image will be repeated only horizontally
Repeat-y: the image will be repeated only vertically
Security
Enable XML Signature
Check to enable the use of XML signature in the form data
Digital signatures are used to certify that a document has not been modified by the system or by someone who gained unauthorized access to the system. The XML signature is a W3C standard that defines the syntax and processing rules for creating and representing digital signatures. This is a method of associating a key with referenced data to insure the integrity of this data.
Misc.
Display a confirmation message for quick deletion
Check to prompt a confirmation message prior to deletion
Name
Description
Include jQuery API and jQuery UI libraries
Check this option to include the jQuery and jQuery UI libraries in runtime mode (form execution); by default, these libraries are available in design mode
Available versions:
v1.7.2 & v1.8.20
v1.10.2 & v1.10.3
v3.5.1 & v1.12.1 (default)
Free text
Custom web references to be included in the HTML head that will be available in both design and run-time modes. Only <script>
, <meta>
, <link>
, and <style>
tags are supported. When you enter a tag, the free text editor automatically inserts its closing tag.
📌 Example:
<link rel="stylesheet" type="text/css" href="mystyle.css" />
<style type="text/css">
body {background-color:yellow}
p {color:blue}
</style>
<meta name="description" content="my content" />
<script type="text/javascript">
alert("Hello World!");
</script>
<script type="text/javascript" src="myscript.js">
</script>
To fold a code block, click the down arrow next to the line number, which will insert a double-arrow icon in place of the code. To unfold the code block, click the right arrow.
Press Ctrl+Space
to display a drop-down menu that lists the available variables and keywords.
Name
Description
Select a language
The Form Designer allows you to translate form labels and error messages to the languages available in WorkflowGen. Select a language for translation from the languages available in the drop-down list.
✏️ Note: Generic language selections such as English, French, Spanish, etc., correspond to the version of the language that the administrator initially used to create a form. For example, if the administrator used English (United States) to create a form, then in this instance the selections English (United States) and English would be one and the same.
Free text
Write translated text that corresponds to the selected language. If a field is left empty, then the language will defer in the following order: Country-specific language > Generic language > Default language.
Icon
Name
Description
Save the form
Saves the current form (you can also press Ctrl+S
to save)
Duplicate a section or field
Makes a copy of the selected section or field and inserts it in the form; the duplicate section or field will appear below the selected section or field
Delete a section or field
Deletes the selected section or field from the form
Undo/redo
Undoes or redoes the most recent changes made to the form
Select a style
List of default and custom styles; select an item to change the style of the current form
Tools drop-down list
Select a tool
List of default and custom tools; select an item in order to add the tool to the form using the Insert button