Le formulaire

  • Création des champs

    Les formulaires disposent d'une zone dédiée à l'agencement libre des champs.
    Un clic droit avec la souris dans cette zone fait apparaître 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 ou plusieurs champs il faut dans un premier temps les sélectionner : 

    - En maintenant la touche CTRL enfoncée et en cliquant directement sur le champ concerné, celui-ci se colore en gris
    - En maintenant la touche CTRL enfoncée et en définissant une zone de sélection avec la souris, les champs contenus dans la zone se colorent en gris
    - Une fois le/les champs sélectionnés il suffit de cliquer sur un élément de la sélection tout en déplaçant la souris.

    Pour annuler la sélection courante, maintenez la touche CTRL enfoncée tout en cliquant sur une zone vide du formulaire
     

  • 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 direct vers la page dédiée de l'événement que vous pouvez diffuser.
    - Un lien public "humainement lisible" vers la page dédiée de l'événement que vous pouvez diffuser.
    Ce lien est dit "lisible" car l'URL contient le titre utilisé pour la page dédiée de l'événement (au lieu d'un identifiant informatique) et de ce fait peut être utilisé sur une affiche par exemple.
    - Un exemple de code HTML qui permet d'insérer et 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 différents liens le système reconnait les paramètres suivants :

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

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

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

    FIRSTNAME=Le prénom à pré renseigner dans le formulaire
    Facultatif

    LASTNAME=Le nom à pré renseigner dans le formulaire
    Facultatif

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

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

    CITY=La ville à pré renseigner dans le formulaire
    Facultatif

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

    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?OPEN=Form&GUID=B40F1F06-1E63-483B-8154-A1CB8898A3ED&FIRSTNAME=Alain&LASTNAME=Dupond

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

    
            <script type="text/javascript" src="/PAYFORMS/js/client.js">
            </script>
            <input onclick="GoPayForms('PAYFORMS_OPEN=form&GUID=B40F1F06-1E63-483B-8154-A1CB8898A3ED&FIRSTNAME=Alain&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'items

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

    Créer évidement l'item dans le stock avec ses paramètres (libellé, quantité disponible, prix, dates de disponibilités, messages renvoyés en cas de quantité insuffisante ou de non disponibilité) depuis 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 élément 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'item 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 items, quantités, messages).
    Pour interrompre la gestion d'un item en stock au cours d'un événement tout en conservant le décompte des quantités consommées vous pouvez modifier la quantité disponible et indiquer -1 (plus de limite) ou 0 (plus disponible).
    (la suppression d'un article du stock entraîne la perte de la valeur de consommation associée)
    Pour les champs de type Liste qui utilisent les items présents dans le stock la propriété Uniquement les éléments disponibles permet d'afficher uniquement les items dont la quantité est supérieure à 0.

  • Formules 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

    isvoucher() Retourne VRAI si l'opération courante est associée à une invitation/un bon de réduction
    userisorganizer() Retourne VRAI si l'utilisateur courant est l'Organisateur (accès depuis le lien privé de l'événement, le compte PayForms)
    wascreatedbyorganizer() Retourne VRAI si l'opération courante a été créée par l'Organisateur (depuis le lien privé de l'événement, le compte PayForms)
    opcfcount
    (
    'Valeur',
    'champ',
    ExclureOperationCourante,
    UniquemenrLesOpérationsConfirmées,
    IDCampagne
    )

    Retourne le nombre de fois ou, dans les opérations enregistrées pour une campagne, valeur apparaît dans le champ champ, ou -1 si champ n'existe pas.

    Si ExclureOperationCourante est égale à true (VRAI) l'opération courante n'est pas prise en compte, sinon false (FAUX) elle est prise en compte.
    Si UniquemenrLesOpérationsConfirmées est égale à true (VRAI) seules les opérations confirmées sont prises en compte (facultatif).
    Par défaut la fonction est exécutée sur la campagne associée au formulaire mais vous pouvez indiquer une autre campagne en précisant son ID (facultatif).

    Exemple :
    Si dans un formulaire d'inscription 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'
    =opcfcount('35','CF1',true) retourne 9
    =opcfcount('35','CF1',false) retourne 10

    grpcfcount'Valeur','Champ',ExclureOperationCourante) Retourne le nombre de fois ou, dans le groupe d'opérations en cours, valeur apparaît dans le champ champ, ou -1 si champ n'existe pas.

    Si 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 un formulaire d'inscription le champ CF1 est utilisé pour récupérer l'age et que dans l'opération en cours il y a 4 inscriptions créées (dont la courante) avec un age de '35'
    =grpcfcount('35','CF1',true) retourne 4
    =grpcfcount('35','CF1',false) retourne 3

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

    Retourne le nombre de fois ou, dans le formulaire, valeur apparaît 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 leurs valeurs en date.

    b(texte) Retourne la valeur de texte convertie en booléen, ou false (FAUX) si texte n'est pas soit égale à 'true' ou 'false'

    Exemple :
    Si la valeur dans le champ [CF4] est 'true', la formule suivante
    =b([CF4]) retourne true (valeur booléenne)
    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 du texte '1' et du texte '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
     diffdays(date1,date2) Retourne le nombre de jours entre date1 et date2
    Les dates date1 et date2 doivent être des dates sous forme de texte.

    Exemple :

    Si la valeur dans le champ [CF1] est '10/09/2019' et la valeur dans le champ [CF2] est '08/09/2019'
    =diffdays([CF1],[CF2]) 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é ?