Référence de classe WorkflowPage

WorkflowGen Développement de formulaires Web dans

Documentation Forum Support

Rechercher…

Aperçu

Aperçu des formulaires Web

Prérequis

Définition de processus

Développement de formulaires Web : Mode simple

Développement de formulaires Web : Mode avancé

Mode AJAX

Référence de classe WorkflowPage

Propulsé par GitBook

Référence de classe WorkflowPage

Méthodes accessibles
void FillFormData(DataSet ou XmlDocument)
Utilisez cette méthode pour charger le fichier XML de données de formulaire temporaire (dataOUT.xml) à partir du répertoire de travail de l'action en cours dans le paramètre IN form data. Vous pouvez utiliser un DataSet ou un objet XmlDocument pour recevoir les données du formulaire.
Référez-vous à la propriété de classe StoragePath de WorkflowPage pour l'emplacement du répertoire de travail de l'action en cours.
1
protected void Page_Load(object sender, System.EventArgs e)
2
{
3
     // ...
4
     
5
     // Remplissez vos données de formulaire
6
     FillFormData(formData);
7
     
8
     // ...
9
}
Copied!
S'il y a déjà des données dans votre DataSet ou XmlDocument, les données seront vidées avant d'être remplies.
void SaveFieldsData(DataSet)
Cette méthode tentera de trouver des contrôles dans la page qui ont le même ID que les colonnes dans Table1 de vos données de formulaire. Lorsqu'il en trouve un, il met à jour la valeur des données du formulaire avec la valeur du contrôle.
Si la propriété DataType de la colonne en cours de remplissage est Date ou Double, le type de données de la valeur du formulaire Web sera validé et formaté à l'aide du code de culture actuel avant d'être poussé dans le DataSet. Si la valeur n'est pas cohérente avec le type de données, une exception FormatException est lancée avec un message approprié vous indiquant quel champ n'est pas une date valide ou une valeur double.
Pour un contrôle FileUpload ou HtmlInputFile, seul le nom du fichier est poussé dans l'ensemble de données, vous devez donc toujours appeler la méthode SaveFileAttachment afin d'enregistrer le fichier dans le chemin de stockage EFORMASPX.
Pour utiliser cette méthode, vous devez utiliser un DataSet comme source de données de formulaire.
Si un ListBox avec mode de sélection multiple ou un CheckBoxList est trouvé pour les données d'un formulaire, la valeur sera toutes les valeurs sélectionnées (ou cochées) séparées par des virgules.
Les contrôles Web suivants sont supportés :
TextBox
Label
DropDownList
ListBox
CheckBox
CheckBoxList
RadioButton
RadioButtonList
FileUpload
HtmlInputFile
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
    // ...
4
​
5
    // Enregistrer les pièces jointes dans le chemin de stockage EFORMASPX
6
    this.SaveFileAttachment(TEST_UPLOAD.PostedFile);
7
​
8
    // Mettre à jour automatiquement les données du formulaire
9
    // avec les valeurs des champs du formulaire Web
10
    this.SaveFieldsData(formData);
11
​
12
    // ...
13
}
Copied!
void BindFormDataToFields(DataSet, bool isPageDataBind = true)
Utilisez cette méthode lorsque vous souhaitez lier automatiquement tous vos champs de formulaire Web à l'aide de votre DataSet de données de formulaire. Les contrôles supportés sont exactement les mêmes que ceux supportés par la méthode SaveFieldsData.
Définissez le paramètre isPageDataBind sur false si vous souhaitez ignorer l'appel de Page.DataBind() au début de cette méthode. Sinon, par défaut, un Page.DataBind() est appelé au début pour s'assurer que les autres contrôles sont liés avant de lier vos propres contrôles de formulaire Web.
Dans certains cas, un appel à l'événement de liaison de données de page peut ne pas être souhaité (p.ex. sauter la liaison de données de page qui a déjà été effectuée auparavant), ou si vous souhaitez contrôler exactement quand exécuter l'événement de liaison de données de page à la place.
1
protected void Page_Load(object sender, EventArgs e)
2
{
3
    // ...
4
​
5
    // Lier les contrôles de formulaire Web avec les données du formulaire
6
    // lors du chargement de la première page
7
    if (!Page.IsPostBack)
8
    {
9
        BindFormDataToFields(formData);
10
    }
11
    
12
    // ...
13
}
Copied!
void SaveFormData(DataSet ou XmlDocument)
Utilisez cette méthode pour écrire un form data dans le fichier XML de données de formulaire temporaire (dataOUT.xml) dans le répertoire de travail de l'action en cours. Vous pouvez utiliser un DataSet ou un objet XmlDocument pour mettre à jour le fichier XML de données de formulaire.
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
    // ...
4
    
5
    // Habituellement, vous souhaiterez enregistrer les données de
6
    // votre formulaire avant de soumettre
7
    this.saveFormData(formData);
8
​
9
    // ...
10
}
Copied!
void SaveFormData (DataSet, bool saveFieldValues)
Utilisez cette méthode pour enregistrer les valeurs de champ de formulaire Web dans des données de formulaire (saveFieldValues défini sur true), puis pour écrire les données de formulaire dans le fichier XML de données de formulaire temporaire (dataOUT.xml) dans le répertoire de travail de l'action en cours.
Cette surcharge de méthode n'est disponible que si votre form data est un objet DataSet.
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
    // ...
4
​
5
    // Habituellement, vous souhaiterez enregistrer les données de
6
    // votre formulaire avant de soumettre
7
    this.SaveFormData(formData, true);
8
​
9
    // ...
10
}
Copied!
Vous devez définir le paramètre saveFieldValuessur true si vous souhaitez enregistrer l'état actuel des valeurs de champ de formulaire Web dans form data. Cela assurera que les valeurs des données du formulaire sont synchronisées avec les valeurs des champs du formulaire Web avant toute manipulation du formulaire Web ou des données du formulaire.
Par exemple, il est nécessaire d'enregistrer les valeurs du champ du formulaire Web lors de l'injection de données personnalisées dans les données du formulaire avant de recharger le formulaire Web à l'aide de la méthode BindFormDataToFields. Sinon, l'état actuel des valeurs des champs de formulaire Web pourrait être perdu après l'actualisation.
Dans la plupart des scénarios, nous suggérons de définir le paramètre saveFieldValues sur true avant toute manipulation susceptible de modifier le formulaire Web ou les données du formulaire.
void SubmitToWorkflow()
Utilisez cette méthode lorsque vous souhaitez soumettre le formulaire Web à WorkflowGen et le rediriger du formulaire Web vers WorkflowGen.
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
    // ...
4
​
5
    // Soumet tout au workflow et crée automatiquement
6
    // l'archive de formulaire si nécessaire.
7
    this.SubmitToWorkflow();
8
    
9
    // ...
10
}
Copied!
void SubmitToWorkflow(isDraftMode)
Utilisez cette méthode lorsque vous souhaitez soumettre le formulaire Web à WorkflowGen et le rediriger du formulaire Web vers WorkflowGen en mode DRAFT (isDraftMode défini sur true). Cela ignorera tous les champs obligatoires, y compris les GridViews. (Cette méthode est disponible depuis la version 2.2.5 de WorkflowGen.My.)
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
    // ...
4
​
5
    // Soumet tout au workflow et crée automatiquement
6
    // l'archive de formulaire si nécessaire.
7
    this.SubmitToWorkflow(true);
8
    
9
    // ...
10
}
Copied!
void SubmitToWorkflow(DataSet or XmlDocument)
Utilisez cette méthode lorsque vous souhaitez soumettre le formulaire Web à WorkflowGen, enregistrer les données de votre formulaire et rediriger du formulaire Web vers WorkflowGen.
Cette surcharge de méthode n'est disponible que si les données de votre formulaire sont un objet DataSet.
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
    // ...
4
​
5
    // Soumet tout au workflow et crée automatiquement
6
    // l'archive de formulaire si nécessaire.
7
    this.SubmitToWorkflow(formData);
8
    
9
    // ...
10
}
Copied!
void SubmitToWorkflow(DataSet, Boolean saveFieldValues)
Utilisez cette méthode lorsque vous souhaitez soumettre le formulaire Web à WorkflowGen, enregistrer les valeurs de vos champs dans vos données de formulaire (saveFieldValues défini sur true), enregistrer vos données de formulaire, puis rediriger du formulaire Web vers WorkflowGen.
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
​
4
    // ...
5
​
6
    // Soumet tout au workflow et crée automatiquement
7
    // l'archive de formulaire si nécessaire.
8
    this.SubmitToWorkflow(formData, true);
9
    
10
    // ...
11
}
Copied!
string SaveFileAttachment(HttpPostedFile)
Utilisez cette méthode lorsque vous souhaitez enregistrer une pièce jointe dans le chemin de stockage de EFORMASPX dans un sous-répertoire appelé upload. Cette méthode renvoie le nom du fichier.
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
    // ...
4
​
5
​
6
    // Enregistrer la pièce jointe dans EFORMASPX
7
    SaveFileAttachment(TEST_UPLOAD.PostedFile);
8
​
9
    // ...
10
}
Copied!
string SaveFileAttachment (HttpPostedFile, string)
Utilisez cette méthode lorsque vous souhaitez enregistrer une pièce jointe dans le chemin de stockage de EFORMASPX dans un sous-répertoire appelé upload et que vous souhaitez spécifier un nom de fichier à utiliser. Cette méthode renvoie le nom du fichier.
1
protected void Submit_Click(object sender, System.EventArgs e)
2
{
3
    // ...
4
​
5
    // Enregistrez la pièce jointe dans EFORMASPX
6
   SaveFileAttachment(TEST_UPLOAD.PostedFile, "fileName.ext");
7
​
8
    // ...
9
}
Copied!
Méthodes substituables
string GetFormArchive()
Remplacez cette méthode si vous souhaitez personnaliser la sortie de l'archive de formulaire. Cette méthode doit renvoyer une page HTML complète.
1
protected override string GetFormArchive()
2
{
3
    StringBuilder htmlContent = new StringBuilder();
4
​
5
    // Créez le code HTML de votre choix dans l'objet htmlContent
6
    // ...
7
    
8
    return htmlContent.ToString();
9
}
Copied!
void ChangeFormArchiveLayout()
Remplacez cette méthode afin de personnaliser la mise en page de l'archive de formulaire.
1
protected override void ChangeFormArchiveLayout()
2
{
3
    // Effectuez des traitements personnalisés ici
4
    // ...
5
​
6
    // Assurez-vous d'appeler la base ChangeFormArchiveLayout si vous voulez
7
    // champs soient automatiquement mis en lecture seule et masquer les champs
8
    // qui sont répertoriés dans FORM_ARCHIVE_HIDDEN_FIELDS
9
​
10
    base.ChangeFormArchiveLayout();
11
}
Copied!
void ChangeFormLayout()
Remplacez cette méthode afin de personnaliser la mise en page de votre formulaire Web.
1
protected override void ChangeFormLayout()
2
{
3
    // Assurez-vous d'appeler le ChangeFormLayout de base avant de faire quoi que ce soit d'autre
4
    // car si vous l'appelez à la fin, vous remplacerez vos modifications personnalisées.
5
    base.ChangeFormArchiveLayout();    
6
​
7
    // Effectuez des traitements personnalisés ici
8
    // p.ex. :
9
    if (CurrentWorkflowActionName == "ACTION_NAME1")
10
    {
11
        // ...
12
    }
13
    else if (CurrentWorkflowActionName == "ACTION_NAME2")
14
    {
15
        // ...
16
    }
17
}
Copied!
Propriétés
string CurrentWorkflowActionName (lecture seule)
Le nom de l'action WorkflowGen actuelle

Il sera vide si vous n'avez pas ajouté de paramètre CURRENT_ACTION à votre action.
1
if (CurrentWorkflowActionName == "ACTION_NAME")
2
{
3
    // ...
4
}
Copied!
string LangId (lecture seule)
Le code de culture actuel de l'utilisateur WorkflowGen connecté

Exemple de code de culture : fr-FR
1
if (LangId == "fr-FR")
2
{
3
    // Faites un traitement spécifique à la culture ...
4
}
Copied!
string StoragePath (lecture seule)
Le chemin absolu vers le dossier de stockage temporaire du répertoire de travail de l'action en cours. Il est utilisé pour lire et écrire les données du formulaire et pour enregistrer les pièces jointes.

Exemple de valeur : DISQUE:\inetpub\wwwroot\wfgen\App_Data\Files\EFORMASPX
1
FileStream myfs = new FileStream(this.StoragePath + "\\signedXml.xml",
2
FileMode.Create, FileAccess.ReadWrite);
Copied!
string RequiredFieldsErrorMessage (lecture et écriture)
Le message d'erreur pour les champs obligatoires

Valeur par défaut : Le champ {0} est obligatoire

Cette valeur doit contenir {0} et contiendra le nom du champ.
1
this.RequiredFieldsErrorMessage = Resources.Strings.RequiredErrorMessage;
Copied!
string FormArchiveFileName (lecture et écriture)
Le nom du fichier d'archive du formulaire

Valeur par défaut : form_archive.htm
1
this.FormArchiveFileName = "my_form_archive.htm";
Copied!
string FormArchiveCssPath (lecture et écriture)
Le chemin d'accès relatif à la feuille de style de l'archive de formulaire

Valeur par défaut : \css\form_archive.css
Color ReadOnlyFieldsBorderColor (lecture et écriture)
Couleur de bordure ou couleur du texte du champ en lecture seule s'il s'agit d'une liste déroulante, d'une liste de cases à cocher ou d'une liste de boutons radio

Si la couleur est Color.Empty, la couleur ne sera pas affectée.

Valeur par défaut : Color.Empty
1
this.ReadOnlyFieldsBorderColor = Color.Green;
Copied!
Color RequiredFieldsBorderColor (lecture et écriture)
Couleur de bordure ou couleur du texte du champ requis s'il s'agit d'une liste déroulante, d'une liste de cases à cocher ou d'une liste de boutons radio

Si la couleur est Color.Empty, la couleur ne sera pas affectée.
​
Valeur par défaut : Color.Red
1
this.RequiredFieldsBorderColor = Color.Orange;
Copied!
ColorizationType FieldsColorization (lecture et écriture)
Le type de colorisation pour les champs obligatoires, en lecture seule et modifiables

Valeurs possibles : Automatic, Css, None 

Valeur par défaut : Automatic
1
this.FieldsColorization = Fields.ColorizationType.Css;
Copied!
Boolean IsStandAloneMode (lecture seule)
Cette propriété indique si le formulaire Web s'exécute ou non en mode autonome.

L'exécution en mode autonome signifie que le formulaire Web n'a pas été instancié par WorkflowGen, mais plutôt en appelant l'adresse du formulaire Web directement sans aucun paramètre WorkflowGen.
1
if (!this.IsStandAloneMode) 
2
{
3
    Page.DataBind();
4
}
Copied!
Boolean IsSimpleMode (lecture et écriture)
Cette propriété détermine si vous exécutez WorkflowPage en mode avancé ou simple.

Cette propriété doit être déterminée dans le constructeur du formulaire Web.

Valeur par défaut : true
1
this.IsSimpleMode = false;
Copied!
Boolean HandleSubmitButton (lecture et écriture)
Cette propriété détermine si WorkflowPage gère automatiquement le bouton d'envoi avec l'ID SubmitButton. Si la propriété est définie sur true, vous n'avez pas à gérer le code SubmitButton.

Cette propriété doit être déterminée dans le constructeur du formulaire Web.

Cette propriété n'est disponible qu'en mode simple.

Valeur par défaut : true
1
this.HandleSubmitButton = false;
Copied!
DataSet FormData (lecture seule)
Cette propriété contient le DataSet des données de formulaire géré par WorkflowPage si vous êtes en mode simple.

Cette propriété n'est disponible qu'en mode simple.
1
FormData.Tables["Table1"].Rows[0]["REQUEST_DATE"] = DateTime.Now.ToString();
Copied!
string RequiredGridViewsErrorMessage (lecture et écriture)
Le message d'erreur affiché à l'utilisateur final lorsqu'un GridView requis n'a pas encore été rempli.

Valeur par défaut : The {0} list needs to have at least one filled row. 

Cette valeur doit contenir {0}; ce symbole contiendra le nom du champ.
1
this.RequiredGridViewsErrorMessage =
2
 Resources.Strings.RequiredGridViewsErrorMessage;
Copied!
string InvalidNumberGridViewErrorMessage (lecture et écriture)
Le message d'erreur affiché à l'utilisateur final lorsqu'un champ numérique n'a pas été rempli avec une valeur numérique valide dans un GridView.

Valeur par défaut : You have entered an invalid number in the {0} column. 

Cette valeur doit contenir {0}; ce symbole contiendra le nom du champ.
1
this.InvalidNumberGridViewErrorMessage =
2
 Resources.Strings.InvalidNumberGVErrMsg;
Copied!
string InvalidCurrencyGridViewsErrorMessage (lecture et écriture)
Le message d'erreur affiché à l'utilisateur final lorsqu'un champ numérique n'a pas été rempli avec une valeur de devise valide dans un GridView

Valeur par défaut : You have entered an invalid number in the {0} column. Do not enter the currency symbol in the value. 

Cette valeur doit contenir {0}; ce symbole contiendra le texte d'en-tête de colonne.
1
this.InvalidCurrencyGridViewsErrorMessage =
2
 Resources.Strings.InvalidCurrGVErrMsg;
Copied!
string RequiredColumnsInGridViewsErrorMessage (lecture et écriture)
Le message d'erreur affiché à l'utilisateur final lorsqu'une colonne requise n'a pas été remplie dans un GridView et que l'utilisateur final tente de mettre à jour la ligne

Valeur par défaut : The {0} column is required. 

Cette valeur doit contenir {0}; ce symbole contiendra le texte d'en-tête de colonne.
1
this.RequiredColumnsInGridViewsErrorMessage =
2
 Resources.Strings.RequiredColInGV;
Copied!
string InvalidDateGridViewErrorMessage (lecture et écriture)
Le message d'erreur affiché à l'utilisateur final lorsqu'une date ou un champ de date/heure dans un GridView n'a pas été rempli avec une valeur de date ou de date/heure valide

Valeur par défaut : You have entered an invalid date in the {0} column. 

Cette valeur doit contenir {0}; ce symbole contiendra le nom du champ.
1
this.InvalidDateGridViewErrorMessage = Resources.Strings.InvalidDateGVErrMsg;
Copied!
boolean ColorizeRequiredColumnsInGridViewHeader (lecture et écriture)
Si cette propriété est définie sur true, les en-têtes de colonne requis dans les GridViews auront leur propriété ForeColor affectée par la couleur RequiredFieldsBorderColor.

Valeur par défaut : false
​
Cette propriété doit être déterminée dans le constructeur du formulaire Web.

Cette propriété n'est disponible qu'en mode simple.
1
this.ColorizeRequiredColumnsInGridViewHeader = true;
Copied!
string InvalidNumberErrorMessage (lecture et écriture)
Le message d'erreur affiché à l'utilisateur final lorsqu'un champ numérique n'a pas été rempli avec une valeur numérique valide

Valeur par défaut : You have entered an invalid number in the {0} field. 

Cette valeur doit contenir {0}; ce symbole contiendra le nom du champ.
1
this.InvalidNumberErrorMessage = Resources.Strings.InvalidNumberErrMsg;
Copied!
string InvalidCurrencyErrorMessage (read and write)
Le message d'erreur affiché à l'utilisateur final lorsqu'un champ numérique n'a pas été rempli avec une valeur de devise valide.

Valeur par défaut : You have entered an invalid number in the {0} field. Do not enter the currency symbol in the value. 
 
Cette valeur doit contenir {0}; ce symbole contiendra le nom du champ.
1
this.InvalidCurrencyErrorMessage = Resources.Strings.InvalidCurrencyErrMsg;
Copied!
string InvalidDateErrorMessage (lecture et écriture)
Le message d'erreur affiché à l'utilisateur final lorsqu'une date ou un champ de date/heure n'a pas été rempli avec une valeur de date ou de date/heure valide.

Valeur par défaut : You have entered an invalid date in the {0} field. 

Cette valeur doit contenir {0}; ce symbole contiendra le nom du champ.
1
this.InvalidDateErrorMessage = Resources.Strings.InvalidDateErrMsg;
Copied!
string ParamsXPath (lecture seule)
La valeur du paramètre ParamsXPath que vous avez passé dans l'action WorkflowGen.

Valeur par défaut : NewDataSet/Table1
boolean IsSessionLess (lecture et écriture)
Si cette propriété est définie sur true, le ViewState sera utilisé pour stocker tous les paramètres internes de WorkflowPage au lieu d'utiliser la Session.

Valeur par défaut : false
​
Cette propriété doit être déterminée dans le constructeur du formulaire Web.
1
this.IsSessionLess = true;
Copied!
boolean SaveFormDataWithSchema (lecture et écriture)
Si cette propriété est définie sur false, le FormData sera enregistré sans son schéma.

Valeur par défaut : true

Cette propriété doit être déterminée dans le constructeur du formulaire Web.
1
this.SaveFormDataWithSchema = false;
Copied!
boolean RemoveValidatorsInFormArchive (lecture et écriture)
Si cette propriété est définie sur true, tous les validateurs seront automatiquement masqués dans l'archive de formulaire.

Valeur par défaut : true
1
this.RemoveValidatorsInFormArchive = true;
Copied!
boolean ValidateRequiredFields (lecture et écriture)
Si cette propriété est définie sur false, toutes les validations des champs obligatoires seront désactivées à l'exception des champs obligatoires dans les contrôles GridView.

Valeur par défaut : true

Cette propriété doit être modifiée avant l'événement OnLoadComplete de la page.
1
this.ValidateRequiredFields = false;
Copied!
ViewState et Session
WorkflowPage utilise ViewState ou Session, selon la propriété IsSessionLess, pour stocker les paramètres EFORMASPX qu'il reçoit et pour stocker d'autres paramètres internes qu'il doit conserver, donc le ViewState ou la Session du formulaire Web ne doivent jamais être désactivés afin d'utiliser WorkflowPage.
Veillez à ne jamais utiliser les noms de variables ViewState ou Session suivants :
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