Attention ! Cette liaison nécessite d'être bien à l'aise avec des notions informatiques de base.

On est donc sur une utilisation très avancée de Koban.



1. Paramétrage Super Forms

Dans votre extension Super Forms, vous devez activer la méthode POST par formulaire.

Pour cela, allez dans Super Forms > Réglages > Paramètres de formulaire.

Cochez ensuite le champ Activer la méthode POST par formulaire et remplissez la zone "URL de publication personnalisée" avec cette valeur :


https://addin-koban.com/Form/sbm_ext?zid=[zid]

en remplaçant zid par votre valeur de Zone Id Koban (que vous pourrez trouver dans votre Koban sous Paramètres > API).


2. Définition d'un point d'engagement

Dans Koban, vous devez lier un point d'engagement Koban à chacun de vos formulaires Super Forms. Pour cela, récupérez l'identifiant de votre formulaire Super Forms que vous trouverez en haut de votre page formulaire.


Allez ensuite dans Koban au niveau de votre point d'engagement Koban et renseignez le champ Code avec l'identifiant de votre formulaire Super Forms.





3. Liaison entre les champs Super Forms et les champs Koban, et création du fichier de correspondance


Il vous faut ensuite construire le fichier de correspondance entre Super Forms et Koban.


Ce fichier est un fichier de type bloc note à créer de toutes pièces. Il sera à télécharger dans le plugin dans Koban dans l'étape plus bas.

Le format du fichier est le suivant :

  • Une ligne par champ
  • Chaque ligne est du format suivant : [ID Champ Super Forms];[Champ Koban]

L'identifiant du champ super forms est disponible sur chaque formulaire, en face de chaque champ

Dans ce fichier, vous pourrez renseigner l'ensemble des champ SuperForms de tous vos formulaires liés.

Un exemple de fichier est disponible en pièce jointe.


Le code du champ Koban est récupérable en fonction du type de champ :

Champ Koban Standard

Vous pourrez trouver le code de chaque champ Koban standard à cette adresse :


https://github.com/Koban-CRM/coding-templates/blob/master/TrackingAPI.md

Renseignez ensuite la ligne dans le fichier de cette façon :

[ID Champ Super Forms];[Champ Koban]


Exemple :

Titre;contact_gender


Champ Koban personnalisé

Récupérez la valeur de l'identifiant du champ personnalisé sur la piste. Ajoutez Spe au début de cet identifiant.


Renseignez ensuite la ligne dans le fichier de cette façon :

[ID Champ Super Forms];Spe[Identifiant]


Exemple : 

utilisation_bouteilles_autre;Spe62625ed90dc36b58e01da94e


Champ Koban Tag

Pour un champ Tag, récupérez l'identifiant de la catégorie de tag Koban sur la fiche correspondante (champ Guid) :

Renseignez ensuite la ligne dans le fichier de cette façon :

[ID Champ Super Forms];Tag[Guid]


Exemple : 

aspect;Tag625eb8850dc3613af0ff5c70




4. Activation du Plugin dans Koban et chargement du fichier

Activez le plugin Super Forms dans Koban.

Dans le paramétrage du plugin, téléchargez votre fichier de correspondance.


Le paramétrage est terminé.

Il vous reste à bien tester en remplissant un superform et en vérifiant que la piste créée arrive dans Koban avec toutes les informations saisies.


5. Que faire si vous avez plusieurs Super forms ?


Il vous faudra : 

- créer un point d'engagement par super formulaire (rappelez vous que le point d'engagement prend le code du super form en étape 2)

- reprendre votre fichier txt pour le compléter avec les champs et tags des autres Super forms. On se retrouve alors avec un fichier assez long qui contient 1 ligne pour chaque champ ou tag présent dans au moins un des Super forms.

- puis télécharger ce nouveau fichier complété dans le plugin comme en étape 4