Passer au contenu principal
La page Création par URL est une interface de saisie spécialisée qui permet de pré-remplir le formulaire de nouveau contact via des paramètres de requête. Elle est conçue pour l’intégration avec des systèmes tiers ou la création de formulaires de capture simplifiés.

​
1. Paramètres d’URL supportés

Le système intercepte les clés suivantes dans l’URL pour alimenter les champs du formulaire.

​
Identité et Civil

  • first_name, last_name : Texte. Requis pour déclencher la détection de doublons.
  • gender : Valeur attendue (m, f, x).
  • birthday : Date (format AAAA-MM-JJ).
  • language : Code ISO (ex: fr, de).

​
Coordonnées et Adresse

  • email, phone : Texte.
  • address, postal_code, locality, country_code : Texte.

​
Données techniques

  • licence_id, reference_id, iban : Texte.
  • type : Valeur attendue (individual ou organization).
  • company, company_role : Texte (visibles uniquement si type=organization).
  • note : Zone de texte.

​
2. Logique de détection de similarité

Dès que les champs Nom ou Prénom sont modifiés ou reçus via l’URL, le système exécute une recherche de doublons en arrière-plan.

​
Algorithme de scoring

  • Seuil d’alerte : 80% de similarité sur le hash Nom+Prénom.
  • Inclusion : Détecte si un nom est inclus dans un autre (ex: “Dupont” et “Dupont-Martin”).
  • Affichage : Liste les contacts suspects avec leur score de correspondance et un lien direct vers leur fiche d’édition pour éviter la création d’une nouvelle fiche.

​
3. Automates et Sécurité

​
Création atomique

Le bouton Créer enregistre le contact et ses relations (groupes, parents) en une seule transaction.

​
Mécanisme d’annulation (Undo)

Une fois le contact créé, une notification de succès propose un bouton Annuler.
  • Action technique : Déclenche une suppression définitive (forceDelete) de l’enregistrement fraîchement créé pour remettre la base de données dans son état initial.

​
Remplissage par défaut

Si le paramètre entry_date n’est pas fourni dans l’URL, le système applique automatiquement la date du jour comme date d’arrivée.