6


Form
Propriétés
count Number
Nombre de questions
file_id Number
Nombre de questions Number Index de lʼétiquette FORM (usuellement zéro)
name String
Nom du fichier EZF
options Record
Options du formulaire
Méthodes
Form( name String|Stream, index Number) => Form
name : Nom du fichier Formulaire, texte XML ou flux (Stream).
index : Un fichier HTML peut contenir plusieurs étiquettes (de formulaire). Si vous ne voulez pas lire les premières dʼentre elle, spécifiez lʼindex du formulaire à lʼintérieur du fichier.
-
Lit un formualire EZF ou HTML en mémoire. Cʼest une fonctionnaité particulère de lʼinterpréteur XML. Les propriétés Question sont accédées en utilisant les méthodes getXXX() et set XXX(). Les propriétés Question que vous pouvez utiliser sont :
Name (fieldname): String
Text :String
Description:String
Length: Number
Help: String
Extra (unparsed XML within the question): String
Type: String (see below)
Responses: Record (names = codes, values = descriptions)
Options: Record
Skips: Record
Pour chacune de ces propriétés, existe une méthode a getXXX() et setXXX() dont la syntaxe est simialire aux méthodes getType() et setType() décrite ci- après.
addQuestion( Type String, Fieldname String, Text String, Description String, Responses String, Length Integer, Options String, Before Integer) => Number
Responses : Liste de codes et valeurs délimités par le caractère " | " (pipe)
Options : Liste dʼoptions délimités par le caractère " | " (pire)
Before : Insérer avant cette question (-1 => à la fin)
find( fieldname String) => Number
fieldname : Nom du champ
-
Retourne lʼindice de la question (à partir de 0) qui correspond au nom de champ indiqué.
getType( index Number) => String
index : Indice de la Question (à partir de 0)
Retrouve le type de question. Les types sont :
Text
Password
Date
Time
NumberRadio
Weighted
Check
Single
Multiple
Combo
Rank
Hidden
Section
Page
RichText
Image
PlainText
ToolButton
hasData( index Number) => Boolean
index : Indice de la Question (à partir de 0)
-
Retourne true si le champ peut contenir des données ou false sʼil sʼagit dʼun objet de mise en forme.
isPageStart( index Number) => Boolean
index : Indice de la Question
-
Détermine si la question débute une nouvelle page. Cʼest la cas si :
La question précédente a lʼattribut fin de page ("end-of-page", EZSurvey)
La question est une PAGE type (créée dans InterForm)
La question the question a lʼattribut nouvelle page ("new-page", EZSurvey)
La question est une Section suivie par une question dʼun type différent
La question est la première du formulaire
move( start Number, finish Number) => Boolean
start : Index dʼorigine de la question à déplacer
finish : Index destination
-
Déplace une question de la position de départ (start) à la position dʼarrivée (finish) dans le formulaire. Les autres questions sont réarrangées. Montrez vous prudent lors de lʼusage de cette méthode lors dʼun parcours de lʼensemble des questions.
remove( index Number) => Boolean
index : Indice de la Question
-
Supprime une question. La question après lʼindice (index) récupère lʼindice de la question supprimée. Montrez vous prudent lors de lʼusage de cette méthodes lors dʼun parcours de lʼensemble des questions.
save( filename String) => String
filename : Nouveau nom de fichier (optionel)
-
Enregistrement les modifications.
setType( index Number, type String) => String
index : Indice de la Question (à partir de 0)
type : Nouvelle valeur
-
Change le type dʼune question. Voir getType() pour la liste des types.