Intégrer les services qualité de données

1. Créer un compte

Pour bénéficier des services So-easyForm, il faut disposer d'un compte Amabis So-easyForm. La création du compte se situe sur la page intégration. Les clients Amabis doivent faire activer ce compte par le service client.

So-easyForm s'adresse aux professionnels et l'adresse email du compte doit être une adresse d'entreprise.

2. Déclarer le formulaire

So-easyForm analyse tout formulaire accessible via Internet en mode http ou https.

En cas d'impossibilité d'analyse automatique, parce qu'il y a plusieurs balises <form> sur la page formulaire ou pour toute autre raison, So-easyForm propose un pavé de saisie pour y copier-coller le code entre les balises <form>.

Formulaire non accessible

Pour tout formulaire Intranet, dupliquer le formulaire sur un espace Internet pour une analyse automatique ou utiliser l'espace d'analyse de code en communiquant une adresse url ne disposant pas de formulaire, ce afin d'appeler la page d'analyse du code.

Autorisation d'accès

Pour utiliser les services web qualité de données Amabis, l'adresse IP du serveur hébergeant le formulaire doit être associée au compte So-easyForm.

En cas d'adresse IP multiples, une clé d'authentification peut être privilégiée et validée via l'Espace Client Amabis So-easyForm.

3. Choix des services qualité de données

En fonction des champs déclarés, les services disponibles sont proposés avec une estimation budgétaire réalisée sur la base du nombre de formulaires traités dans l'année.

Données # Service Descriptif
Adresse postale 1 RNVP Saisie fluide et rapide + RNVP
2 RNVP Saisie guidée + RNVP
3 RNVP + Autocompletion Saisie encadrée, assistée + RNVP
Adresse géographique 5 Géocodage Saisie rapide avec retour XY TOM TOM + IRIS
6 Zonage Saisie rapide avec retour type de zone ZUS-ZRU-ZFU-CUCS
Téléphone 7 Téléphone Inverse (Reversoform) Recherche par le téléphone
8 Renseignement Téléphonique Recherche par nom et adresse, en association avec un des services rnvp (#1 ou #2)
Email 9 Vérfication email (CheckMail) Contrôle syntaxique, existence et correction éventuelle FAI, validation User*
* Sous conditions selon les serveurs de messagerie

Association des services entre eux

So-easyForm propose les associations et enchaînements des différents services suivants :

# Service Association (enchainement)
1
2
RNVP #7 Téléphone inverse (avant la RNVP) ou #8 Recherche Téléphone (après la RNVP)
#9 email (avant ou après)
3 RNVP + Autocompletion #7 Téléphone inverse (avant la RNVP) ou #8 Recherche Téléphone (après la RNVP)
#9 email (avant ou après)
5 Géocodage #7 Téléphone inverse (avant le Géocodage)
#9 email (avant ou après)
6 Zonage #7 Téléphone inverse (avant le Zonage)
#9 email (avant ou après)
7 Téléphone Inverse (Reversform) #1, #2 ou #3 RNVP (avant ou après)
#5 Géocodage (avant ou après)
#6 Zonage (avant ou après)
#9 email (avant ou après)
8 Renseignement Téléphonique #1, #2 ou #3 RNVP (après)
#9 email (avant ou après)
9 Vérfication email (CheckMail) Tous les services (avant ou après)

A noter qu'il n'est pas possible d'associer les services "adresse" entre-eux, ni les services "téléphone" entre eux, via So-easyForm.com.

L'enchaînement de l'appel des services se fait selon l'ordonnancement des champs dans le formulaire, à l'exception de la recherche téléphone, lancée par le retour de l'un des services RNVP.

Correspondance champ du formulaire et service

A noter que So-easyForm n'effectue pas de contrôle en entrée sur la saisie du champ téléphone.

Service Champs en entrée Infos en retour
#1, #2 RNVP
#3 RNVP+autocompl.
Raison sociale (optionnelle)
3 à 5 lignes adresses (dont CP & ville, hors pays)
2 à 4 lignes adresses identifiées + CP & Ville
code retour ou statut

Le nombre de lignes en retour s'adapte au nombre de lignes en entrée

Voir les explications pour le nombre de lignes dans une adresse normalisée
#5 Géocodage 3 à 5 lignes adresses (dont CP & ville, hors pays) 2 à 4 lignes adresses identifiées + CP & Ville
code retour ou statut
Coordonnées WGS 84
Coordonnées XY
Coordonnées XY Lambert II

Le nombre de lignes en retour s'adapte au nombre de lignes en entrée

Voir les explications pour le nombre de lignes dans une adresse normalisée
#6 Zonage 3 à 5 lignes adresses (dont CP & ville, hors pays) 2 à 4 lignes adresses identifiées + CP & Ville
code retour ou statut
ZUS(OUI/NON)+N° ZUS
ZRU(OUI/NON)+N° ZRU
ZFU(OUI/NON)+N° ZFS
CUCS(OUI/NON)+N° CUCS

Le nombre de lignes en retour s'adapte au nombre de lignes en entrée

Voir les explications pour le nombre de lignes dans une adresse normalisée
#7 Tel Inverse Téléphone
3 à 5 lignes adresses (dont CP & ville, hors pays)
2 à 4 lignes adresses identifiées + CP & Ville
code retour ou statut

Le nombre de lignes en retour s'adapte au nombre de lignes en entrée

Voir les explications pour le nombre de lignes dans une adresse normalisée
#8 Recherche Tel Téléphone
3 à 5 lignes adresses (dont CP & ville, hors pays)
2 à 4 lignes adresses identifiées + CP & Ville
code retour ou statut

Le nombre de lignes en retour s'adapte au nombre de lignes en entrée

Voir les explications pour le nombre de lignes dans une adresse normalisée
#9 Email email email
code retour ou statut

4. Récupération du code

1. Uploader sur le site

A l'issue de la phase de validation des conditions d'utilisation, le code téléchargé doit être uploadé à la racine du site.

Contenu du fichier zip téléchargé

Fichier php java asp.NET Description Déploiement
amaFRMxx.js X X X javascript de paramètres des services web Fichier appelé depuis la page du formulaire
amasw.js X X X javascript d'appels des services web Fichier appelé depuis la page du formulaire
amasw.css X X X Fichier CSS de présentation des popin d'interaction Fichier appelé depuis la page du formulaire
amaconf.ini X X X Fichier de paramètres serveur Mettre ce fichier dans le même chemin du fichier amarelais.jsp
amarelais.php X     Page php pour authentifier l'appel et afficher les retours des services web
amarelais.jsp   X   Page jsp pour authentifier l'appel et afficher les retours des services web Créer une servlet qui s’appelle amaServlet pour faire des appels à cette page (Un exemple vous est fourni dans le fichier zip) ainsi que l'extrait du fichier web.xml nécessaire. Si votre site le permet, vous pouvez remplacer les appels à amaServlet par un appel direct à la jsp
amarelais.asp     X Page asp pour authentifier l'appel et afficher les retours des services web  
amabis.jar   X   Librairie de connexion java avec les webservices Amabis Intégrer cette librairie dans le dossier lib du projet web Java/JEE
gson-2.2.4.jar   X   Librairie Json pour java Intégrer cette librairie dans le dossier lib du projet web Java/JEE
javabase64-1.3.1.jar   X   Classe base64 Intégrer cette librairie dans le dossier lib du projet web Java/JEE

2. Modifier le formulaire

A PHP Error was encountered

Severity: Notice

Message: Undefined property: CI::$_data

Filename: MX/Loader.php

Line Number: 280

A PHP Error was encountered

Severity: Notice

Message: Indirect modification of overloaded property MY_Loader::$_data has no effect

Filename: views/integrer.php

Line Number: 389

A l'intérieur de la page formulaire html, copier/coller le code ci-dessous entre les balises <head> et </head>.
  1. <link rel="stylesheet" type="text/css" href="/amasw.css">
  2. <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
  3. <script>var amabis = jQuery.noConflict(true);</script>
  4. <script type="text/javascript" src="/amaFRM" . $id_form . ".js"></script>
  5. <script type="text/javascript" src="/amasw.js"></script>
En cas de dysfonctionnement, veuillez retirer, en premier lieu, la ligne concernant le bootsrap et réessayer.

FRM00 est l'identification du premier formulaire déclaré sur votre compte So-easyForm. 100 formulaires peuvent être déclarés. La personnalisation du code ci-dessus se fait donc en fonction du numéro du formulaire soumis - le nom du fichier javascript amaFRM00.js est personnalisé.

3. Personnaliser éventuellement

  • le fichier amasw.css pour personnaliser le look des popin de saisie et d'alerte
  • le fichier amaFRMxx.js pour récupérer les informations spécifiques au géocodage et au zonage, afin d'y établir une correspondance avec les champs hidden du formulaire.

Télécharger le code

Intégrer en quelques minutes

Qualité de données et formulaires : intégrer en quelques minutes


Analyse d'un formulaire

So-easyForm analyse le contenu des balises <INPUT> à l'intérieur des balises <FORM>.

Les attributs NAME et/ou ID doivent être renseignés.

Seuls les champs INPUT de type TEXT sont compatibles avec les services qualités de données.


Essai gratuit

Pendant 20 jours, les 1000 premiers appels ou requêtes tous services confondus sont gratuits !

A l'issue de cette période, le service retourne un code erreur et il vaut mieux ne plus l'appeler pour ne pas générer des messages à l'utilisateur.

Télécharger le code

IP ou Clé d'authentification

L'authentification sur les serveurs Amabis se fait par IP et/ou par clé d'authentification.


Adresse et Formulaire

Attention à respecter les contraintes de la norme postale pour gérer correctement une adresse. Plus de précision sur le nombre de lignes adresses .


Services So-easyForm

En poursuivant votre navigation sur ce site, vous acceptez l'utilisation de cookies ou autres traceurs pour vous proposer des contenus et des services mieux adaptés à vos centres d'intérêts et réaliser des statistiques de visites visant à améliorer votre expérience sur ce site.