Le formulaire

  • Création des champs

    Les formulaires disposent de zones dédiées à l'agencement des champs (zones qui apparaissent délimitées en pointillés dans le formulaire).
    Un clic droit avec la souris dans ces zones fait apparaitre un menu contextuel qui liste les types de champs pouvant être créés.

  • Agencement des champs

    L'agencement des champs est réalisée au moyen de la souris.
    Pour déplacer un champ il suffit de maintenir le clic de la souris sur celui-ci en la déplaçant.
     
  • Intégration/Utilisation des formulaires

  • Les données nécessaires à l'intégration et à l'utilisation des formulaires peuvent être récupérées de deux façons :
    - A partir du mail envoyé par le système lors de l'activation de la campagne.
    - A partir de l'onglet Intégration disponible dans la fenêtre d'édition de la campagne

    Vous récupérez les informations suivantes :

    - Un lien public vers le formulaire d'inscription/de commande/de contribution, que vous pouvez insérer sur votre site ou envoyer par mail
    - Un exemple de code HTML qui permet d'afficher le formulaire et la liste des opérations directement sur votre site, plutôt que sur la page dédiée de votre événement.
    Ce code peut être adapté, puis est à insérer dans le code HTML de la page qui sert par exemple à présenter votre événement

    Dans les deux cas les paramètres qui sont reconnus par le système sont les suivants :

    - PAYFORMS_OPEN=Form, Operations ou Description
    Obligatoire
    Important : ce paramètre doit être en première position dans la liste des paramètres

    - PAYFORMS_GUID=Identifiant de la campagne généré par le système
    Obligatoire

    - PAYFORMS_GENDER=Mr ou Mme ou Mlle, à pré sélectionner dans le formulaire
    Facultatif

    - PAYFORMS_FIRSTNAME=Le prénom à pré renseigner dans le formulaire
    Facultatif

    - PAYFORMS_LASTNAME=Le nom à pré renseigner dans le formulaire
    Facultatif

    - PAYFORMS_ADDRESS1=La première ligne d'adresse à pré renseigner dans le formulaire
    Facultatif

    - PAYFORMS_ADDRESS2=La deuxième  ligne d'adresse à pré renseigner dans le formulaire
    Facultatif

    - PAYFORMS_CITY=La ville à pré renseigner dans le formulaire
    Facultatif

    - PAYFORMS_POSTALCODE=Le code postal à pré renseigner dans le formulaire
    Facultatif

    - PAYFORMS_TELEPHONE=Le numéro de téléphone à pré renseigner dans le formulaire
    Facultatif

    Exemple de lien :

    http://www.payforms.fr/PAYFORMS/PayForms-site.aspx?PAYFORMS_OPEN=Form&PAYFORMS_GUID=B40F1F06-1E63-483B-8154-A1CB8898A3ED&PAYFORMS_FIRSTNAME=Alain&PAYFORMS_LASTNAME=Dupond

    Exemple de code pour créer un bouton ouvrant le même formulaire

    
            <script type="text/javascript" src="http://www.payforms.fr/PAYFORMS/js/client.js">
            </script>
            <input onclick="GoPayForms('PAYFORMS_OPEN=form&PAYFORMS_GUID=B40F1F06-1E63-483B-8154-A1CB8898A3ED&PAYFORMS_FIRSTNAME=Alain&PAYFORMS_LASTNAME=Dupond');" style="width:150px" type="button" value="Commmander" />
        

     

  • Edition des propriétés, suppression, duplication d'un champ

    Un clic droit avec la souris sur un champ fait apparaitre un menu contextuel qui liste les opérations possibles sur le champ.
  • Utilisation de la gestions de stock/d'article

    Deux conditions sont nécessaires pour gérer un article en stock

    - Créer évidement l'article dans le stock, avec son libellé, la valeur du stock, son prix, le message renvoyé en cas de stock insuffisant (onglet Stocks dans la fenêtre d'édition de la campagne)
    - Avoir dans le formulaire un champ dont la propriété Contient le libellé d'un article en stock est cochée ET dont le libellé, ou la valeur renvoyée au moment de la validation, est strictement égale (attention aux majuscules et aux minuscules) au libellé de l'article en stock.

    Au moment de la validation du formulaire le système cherchera à faire un lien entre le champ et un libellé dans le stock.

    Valeur utilisée pour récupérer l'article en stock et la quantité consommée

    - Champ Texte : Valeur - La valeur saisie dans le champ : Quantité - 1
    - Champ Quantité : Valeur - Le libellé du champ : Quantité  - La valeur saisie x la valeur unitaire
    - Champ Liste et Boutons Radio : Valeur - Le libellé de l'élément sélectionné : Quantité - 1
    - Champ Case à cocher : Valeur - Le libellé du champ : Quantité - 1

  • Gestion du stock

    Vous pouvez modifier à tout moment, y compris pendant le déroulement de votre événement, le contenu de votre stock (Libellé des articles, quantités, messages).
    Pour interrompre la gestion d'un article en stock au cours d'un événement il suffit de décocher la propriété Contient le libellé d'un article en stock pour le champ concerné, ou de supprimer l'article dans le stock, ou de modifier son libellé.
    (Attention, la suppression d'un article du stock entraine la perte de la valeur de consommation associée)

  • Formule de calcul de valeur et de validation des champs

  • Notation des valeurs :

    Entier  
    1234456
    Décimaux

    Dans les formules utiliser le . comme séparateur décimal

    Particularité : 
    Pour utiliser un nombre décimal dans une formule il faut convertir sa valeur en utilisant la fonction n()
    =n([CF3]) * n(3.14)

    123.45
    Dates  
    #15/06/2014#
    Textes Les  textes contenus dans les formules sont sensibles aux majuscules/minuscules.
    Exemples :
    - si le champ CF11 contient "Toto", le système évalue l'expression  "= ([CF11] = 'toto')" à "=('Toto' = 'toto'), ce qui donne FAUX;
    'Hello'
    Références  

    Pour le formulaire

    [Form]

    Pour les champs standards

    [CF1] ... [CF80]

    Pour les champs spéciaux

    [CFMail]
    [CFGender]
    [CFFirstname]
    [CFLastname]
    [CFAddress1]
    [CFAddress2]
    [CFCity]
    [CFCountry]
    [CFPostalCode]
    [CFTelephone]

    Notations :

    [CFxxxxxx] ou [CFxxxxxx.Value]
    Retourne une valeur Texte qui correspond à ce qui est 'affiché' dans le champ.
    C'est cette valeur que le système enregistre pour chaque champ d'un formulaire et affiche dans la liste des opérations.

    [CFxxxxxx.ItemValue]

    Retourne la valeur numérique associée à la valeur affichée dans le champ, utilisée lors de la validation du formulaire pour calculer le montant à payer

    [CFxxxxxx.ExtraValue]

    Retourne une valeur spécifique au type du champ utilisé.


    Particularités :
                          

    - Référence [Form]

    [Form.Value] retourne le montant du paiement à réaliser.
    [Form.ItemValue] retourne le montant du paiement à réaliser.
    [Form.CustomerItemCharges] retourne le montant des frais pour l'utilisateur.
    [Form.SellerItemCharges] retourne le montant des frais pour l'organisateur.

    - Champ Case à cocher

    [CFxxxxxx.Value] retourne 'Oui' si la case est cochée et 'Non' dans le cas contraire
    [CFxxxxxx.ItemValue] retourne la valeur par défaut du champ (voir Visites / Le formulaire, les propriétés d'un champ)

    - Champs Liste et Boutons radio

    Pour ces champs chaque élément de liste ou bouton est composé d'une paire (Texte/Valeur)
    La partie Texte correspond à la partie affichée de l'élément de liste ou au texte affiché à droite d'un choix de bouton radio.
    La partie Valeur peut être composée d'une partie ItemValue et d'une partie Value séparées par #, ou simplement d'une partie Value.

    [CFxxxxxx.Value] retourne la partie droite de la valeur par rapport au signe #, ou toute la valeur s'il n'y a pas de signe #

    [CFxxxxxx.ItemValue] retourne la valeur numérique de la partie gauche de la valeur par rapport au signe #, ou la valeur numérique de la valeur s'il n'y a pas de signe #

    [CFxxxxxx.ExtraValue] retourne la position de l'élément sélectionné dans la liste ou dans le bouton radio (le premier élément se trouvant à la position 0)


    Exemple d'éléments de liste :

    (Rame de papier/10#Rame) - Partie Texte : Rame de papier - Partie Value : Rame - Partie ItemValue : 10
    (Rame de papier/10) - Partie Texte : Rame de papier - Partie Value : 10 - Partie ItemValue : 10

    Opérateurs reconnus :

    Opérateurs logiques

    Exemple de formule de validation

    = (( n([CF1]) <  2) and ([CF3] = 'herbe'))
    and, or, not
    Opérateurs relationnels Exemple de formule de validation

    = (( n([CF1]) <  2) and ([CF3] = 'herbe'))
    =, <>, <, <=, >, >=
    Opérateurs mathématiques Exemple de formule de calcul

    = ((n([CF4]) * n(3.14)) + n([CF6]))
    +, -, *, % (modulo)
    Concaténation de texte Exemple de formule de validation

    =( [CF2]+[CF5] = 'Hello')

    "Assemblage" de valeurs de champs sous forme de texte dans une formule.

    Fonctions reconnues :

     Fonctions de texte  
    substring(texte, position de départ, longueur)

    Retourne longueur caractères d'un texte à partir de position de départ (le premier caractère d'un texte se trouve à la position 0)

    Exemple :
    = substring('Hello',1,3) retourne 'ell'

    toupper(texte)

    Retourne texte transformé en majuscule

    Exemple :
    = toupper('Hello') retourne 'HELLO'

    indexof(texte, texte à trouver)

    Retourne la position de texte à trouver dans texte ou -1 si texte à trouver n'existe pas dans texte

    Exemple :
    = indexof('abcdefgh','def') retourne 3

    startswith(texte, texte à trouver)

    Retourne VRAI si texte commence par texte à trouver, sinon FAUX

    Exemple :
    = startwith('VTT 35km','VTT') retourne VRAI

    endswith(texte, texte à trouver)

    Retourne VRAI si texte se termine par texte à trouver, sinon FAUX

    Exemple :
    = endwith('VTT 35km','kms') retourne FAUX

    len(texte)

    Retourne la longueur de texte

    Exemple :
    Si la valeur dans le champ CF10 est Bateau
    = len([CF10]) retourne 6

     trim(texte) Retourne texte avec les espaces de début et de fin supprimés

    Fonctions d'information  
    today() Retourne la date du jour sous forme de date

    Exemple :
    Si aujourd'hui nous sommes le 01/12/2014 la formule
    =(today() = #01/12/2014#) retourne VRAI (la notation #JJ/MM/AAAA# désigne une valeur date)
    year(date) Retourne la partie année d'une date au format texte sous forme de valeur numérique

    Si le champ CF2 contient la valeur 01/12/2014, la formule
    =(year([CF2]) = 2014) retourne VRAI
    istn(texte, code pays, type) Retourne VRAI si texte est un numéro de téléphone du type attendu et valide pour le code pays

    code pays  : Code pays de la nomenclature ISO (France = FR, Suisse = CH ...) ou '' pour le code pays FR par défaut
    type : Type de numéro attendu, 'FIXE' (numéro de tel. fixe), 'MOBILE' (numéro de tel. mobile) ou '' pour l'un ou l'autre

    Exemple :
    Si la valeur dans le champ [CF2] est +3304789012
    =istn([CF2],'FR','') retourne VRAI
    =istn([CF2],'','MOBILE') retourne FAUX
    isn(texte)

    Retourne VRAI si texte est un nombre

    Exemple :
    Si la valeur dans le champ [CF2] est 12,5
    = isn([CF2])  retourne VRAI

    isd(texte)

    Retourne VRAI si texte est une date

    Exemple :
    Si la valeur du champ [CF1] est 20/05/2014 00:40
    =isd([CF1]) retourne VRAI

    opcount('Valeur', 'champ',ExclureOperationCourante)

    Retourne le nombre de fois ou, dans les opérations enregistrées pour une campagne, valeur apparait dans le champ champ, ou -1 si champ n'existe pas.
    Si l'option ExclureOperationCourante est égale à true (VRAI) l'opération courante n'est pas prise en compte, sinon false (FAUX) elle est prise en compte..

    Exemple :
    Si dans le formulaire le champ CF1 est utilisé pour récupérer l'age et que dans la campagne il existe 10 inscriptions (dont la courante) avec un age de '35'
    =opcount('35','CF1',true) retourne 9
    =opcount('35','CF1',false) retourne 10

    formcount('Valeur', champ1, champ2,...,champN)

    Retourne le nombre de fois ou, dans le formulaire, valeur apparait dans une liste de champs.

    Exemple :
    Si la valeur du champ CF2 est 'chaise', celle du champ CF4 'bureau'
    =formcount('chaise',CF2,CF4) retourne : 1

    Fonctions de conversion  
    n(texte)

    Retourne la valeur de texte convertie nombre, ou 0 si texte n'est pas un nombre

    Exemple :
    Si la valeur dans le champ [CF2] est 12,5
    = n([CF2]) retourne 12.5
    (en interne les nombres à virgule sont représentés avec le point comme séparateur)

    Remarque :
    Par défaut la référence à un champ renvoyant une valeur Texte, pour faire la somme numérique de deux champs il faudra utiliser la fonction n() pour convertir leur valeur en numérique.

    d(texte)

    Retourne la valeur de texte convertie en date, ou 01/01/1900 00:00:00 si texte n'est pas une date

    Exemple :
    Si la valeur dans le champ [CF3] est 20/05/2014
    = d([CF3]) retourne 20/05/2014 (#20/05/2014# en notation interne)

    Remarque :
    Par défaut la référence à un champ renvoyant une valeur Texte, pour faire une comparaison de date entre deux champs il faudra utiliser la fonction d() pour convertir leur valeur en date.

    s(valeur) Retourne valeur sous forme de texte

    Exemple :
    Si des champs contiennent les formules suivantes 
    =1 + 2  le résultat affiché sera 3
    = s(1) + s(2) le résultat affiché sera 12 (concaténation de la chaine '1' et de la chaine '2')
    Fonctions autres  
    age(date de naissance,[date de référence]) Retourne l'age par rapport à date de référence en valeur entière pour date de naissance  ou -1 en cas d'erreur

    date de naissance
    : date sous forme de texte au format 'JJ/MM/AAAA'
    date de référence (facultatif) : date sous forme de texte au format 'JJ/MM/AAAA' utilisée comme référence pour calculer l'âge
    Si la date de référence n'est pas fournie la date de référence utilisée est la data courante

    Exemple :
    Si aujourd'hui nous sommes le 09/12/2015
    =age('01/01/2014') retourne 1
    if (test, valeur si vrai, valeur si faux)

    Retourne valeur si vrai si test est évalué à VRAI sinon valeur si faux si test est évalué à FAUX

    Exemple :
    Si la valeur dans le champ [CF4] est 2
    = if ((n([CF4]) * 3) = 12, 'Ok','Erreur') retourne 'Erreur'

    in(valeur, valeur 1, valeur 2,..., valeur n)

    Retourne VRAI si valeur existe dans une liste de valeurs, sinon FAUX

    Exemple :
    = in('VTT','Route','Vtt','Bmx') retourne FAUX


    Erreurs renvoyées :

    #EVAL Erreur dans l'évaluation de la formule.
    Le plus souvent liée à une syntaxe incorrecte dans l'expression
    Exemples:

    = ( ( n([CF1]) <  2) and ([CF2] = 3) )
    Erreur générée par la comparaison entre un texte et un nombre.

    = ( ( n([CF1]) <  2) and (n([CF2]) = 3)
    Il manque une parenthèse à la fin de l'expression
    #CIRCREF Référence circulaire dans la formule.
    La formule fait référence à un champ qui fait référence au champ de la formule (boucle infinie).
    Les références circulaires concernent les formules utilisées pour calculer la valeur d'un champ.
    Exemples :

    formule de calcul de la valeur du champ CF3:
    = (( n([CF1]) * 4) + n([CF2]))

    formule de calcul de la valeur du champ CF1 :
    = ( n([CF3]) + 2)

  • Les jetons

  • PayForms utilise un système de jetons qui vous permet d'incorporer dans certains textes, messages des données ou des paramètres de la campagne.
    Un jeton possède un nom et renvoi une valeur.

    (Voir la rubrique Support / Les jetons)

    Connexion

    Identifiant:
    Mot de passe:
    Mot de passe oublié ?