void FillFormData(DataSet or XmlDocument)
dataOUT.xml
) from the current action working directory into the form data
IN parameter. You can use a DataSet or an XmlDocument object to receive the form data.StoragePath
WorkflowPage class property for the location of the current action working directory.void SaveFieldsData(DataSet)
Table1
; when it finds one, it will update the form data value with the control value.DataType
property of the column being filled is Date
or Double
, the data type of the web form value will be validated and formatted using the current culture code before being pushed into the DataSet. If the value is not consistent with the data type, a FormatException
is thrown with an appropriate message telling you which field is not a valid date or double value.FileUpload
or an HtmlInputFile
control, only the file name is being pushed into the dataset, so you still need to call the SaveFileAttachment
method in order to save the file into the EFORMASPX storage path.TextBox
Label
DropDownList
ListBox
CheckBox
CheckBoxList
RadioButton
RadioButtonList
FileUpload
HtmlInputFile
void BindFormDataToFields(DataSet, bool isPageDataBind = true)
SaveFieldsData
method.isPageDataBind
parameter to false
if you want to skip the call of Page.DataBind()
at the beginning of this method. Otherwise, by default, a Page.DataBind()
is called at the beginning to ensure that other controls are bound before binding your own web form controls.
In some cases, a call to the page databind event might not be desired (e.g. skipping the page databind that was already performed before), or if you want to control exactly when to execute the page databind event instead.void SaveFormData(DataSet or XmlDocument)
form data
into the temporary form data XML file (dataOUT.xml
) in the current action working directory. You can use a DataSet or an XmlDocument object to update the form data XML file.void SaveFormData (DataSet, bool saveFieldValues)
form data
(saveFieldValues
set to true
) then write the form data
into the temporary form data XML file (dataOUT.xml
) in the current action working directory.form data
is a DataSet object.saveFieldValues
parameter to true
if you want to save the current state of the web form field values into theform data
. This will ensure that the form data values are in sync with the values from the web form fields prior to any manipulations of the web form or form data.
For example, it is required to save the web form field values when injecting custom data into the form data prior to reloading the web form using the BindFormDataToFields
method. Otherwise, the current state of web form field values could be lost after the refresh.
In most scenarios, we suggest setting the saveFieldValues
parameter to true
before any manipulations that could change the web form or form data. void SubmitToWorkflow()
void SubmitToWorkflow(isDraftMode)
isDraftMode
set to true
). This will skip all of the required fields including GridViews. (This method is available since WorkflowGen.My version 2.2.5.)void SubmitToWorkflow(DataSet or XmlDocument)
void SubmitToWorkflow(DataSet, Boolean saveFieldValues)
saveFieldValues
set to true
), save your form data, and then redirect from the web form to WorkflowGen.string SaveFileAttachment(HttpPostedFile)
upload
. This method returns the name of the file.string SaveFileAttachment (HttpPostedFile, string)
upload
and you want to specify a file name to use. This method returns the name of the file.string GetFormArchive()
void ChangeFormArchiveLayout()
void ChangeFormLayout()
string CurrentWorkflowActionName
(read-only)CURRENT_ACTION
parameter to your action.string LangId
(read-only)en-US
string StoragePath
(read-only)DRIVE:\inetpub\wwwroot\wfgen\App_Data\Files\EFORMASPX
string RequiredFieldsErrorMessage
(read and write){0}
field is required.
{0}
and will contain the field name.string FormArchiveFileName
(read and write)form_archive.htm
string FormArchiveCssPath
(read and write)\css\form_archive.css
Color ReadOnlyFieldsBorderColor
(read and write)Color.Empty
, the color will not be affected.
Color.Empty
Color RequiredFieldsBorderColor
(read and write)Color.Empty
, the color will not be affected.
Color.Red
ColorizationType FieldsColorization
(read and write)Automatic
, Css
, None
Automatic
Boolean IsStandAloneMode
(read-only)Boolean IsSimpleMode
(read and write)true
Boolean HandleSubmitButton
(read and write)SubmitButton
. If the property is set to true
, you don't have to manage the SubmitButton code.
true
DataSet FormData
(read-only)string RequiredGridViewsErrorMessage
(read and write)The {0} list needs to have at least one filled row.
{0}
; this symbol will contain the field name.string InvalidNumberGridViewErrorMessage
(read and write)You have entered an invalid number in the {0} column.
{0}
; this symbol will contain the field name.string InvalidCurrencyGridViewsErrorMessage
(read and write)You have entered an invalid number in the {0} column. Do not enter the currency symbol in the value.
{0}
; this symbol will contain the column header text.string RequiredColumnsInGridViewsErrorMessage
(read and write)The {0} column is required.
{0}
; this symbol will contain the column header text.string InvalidDateGridViewErrorMessage
(read and write)You have entered an invalid date in the {0} column.
{0}
; this symbol will contain the field name.boolean ColorizeRequiredColumnsInGridViewHeader
(read and write)true
, the required column headers in the GridViews will have their ForeColor
property affected by the RequiredFieldsBorderColor
color.
false
string InvalidNumberErrorMessage
(read and write)You have entered an invalid number in the {0} field.
{0}
; this symbol will contain the field name.string InvalidCurrencyErrorMessage
(read and write)You have entered an invalid number in the {0} field. Do not enter the currency symbol in the value.
{0}
; this symbol will contain the field name.string InvalidDateErrorMessage
(read and write)You have entered an invalid date in the {0} field.
{0}
; this symbol will contain the field name.string ParamsXPath
(read-only)ParamsXPath
parameter you passed in the WorkflowGen action.
NewDataSet/Table1
boolean IsSessionLess
(read and write)true
, the ViewState will be used to store all the internal settings for WorkflowPage instead of using the Session.
false
boolean SaveFormDataWithSchema
(read and write)false
, the FormData will be saved without its schema.
true
boolean RemoveValidatorsInFormArchive
(read and write)true
, all the validators will be automatically hidden in the form archive.
true
boolean ValidateRequiredFields
(read and write)false
, all of the required fields' validations will be deactivated except the required fields in the GridView controls.
true
OnLoadComplete
event.IsSessionLess
property, to store the EFORMASPX parameters it receives and to store some other internal settings it needs to keep, so the ViewState or the Session of the web form should never be deactivated in order to use WorkflowPage.WFGEN_INSTANCE_PATH
WFGEN_STORAGE_PATH
WFGEN_REPLY_TO
WFGEN_CURRENT_ACTION
WFGEN_IS_STAND_ALONE
WFGEN_GRID_VIEW_INSERTING
WFGEN_GRID_VIEW_SHOW_CANCEL
WFGEN_PARAMS_XPATH
WFGEN_BACKUP_CONTROL_FORECOLOR
WFGEN_BACKUP_CONTROL_BORDERCOLOR
WFGEN_BACKUP_CONTROL_BACKCOLOR
WFGEN_BACKUP_CONTROL_BORDERWIDTH
WFGEN_BACKUP_CONTROL_CSSSTYLE
WFGEN_BACKUP_CONTROL_CSSCLASS
WFGEN_ALL_SIMPLE_MODE_TABLES
WFGEN_ALL_SUPPORTED_CONTROLS
WFGEN_USER_TZ
WFGEN_SIMPLE_MODE_DATASET_STRUCTURE
WFGEN_VALIDATE_REQUIRED_FIELDS
USER_LANG