PayForms - Support - 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)


Identifiant:
Code de vérification:
Mot de passe:
	Se souvenir de moi
	Mot de passe oublié ? Identifiant oublié ?
Entrez votre Email:	Envoyer


Anrede:
Identifiant:
Prénom:
Nom:
Nom affiché:
Adresse:
Code postal:
Ville:
Telephone:
Doctor Code:
GLN_Nummer:
Firma:
Email:
Mot de passe:
Confirmation:

Le formulaire

Connexion

Pour créer un compte remplissez ce formulaire ...