Prefer to view the site in English? For relevant information, visit the English version of the website.
28Nov, 2022
2Réaction(s)
le-deep-linking

Le Deep Linking

Le Deep Linking, ou utilisation de lien profond, permet de façon claire et simple de diriger les utilisateurs vers un contenu spécifique de l’application mobile Kizeo Forms. Pour cela, il suffit de leur fournir un lien hypertext contenant le formalisme requis.

On vous explique tout dans ce tutoriel !

Qu’est-ce qu’un Deep Link ?

Un Deep Link est une URL, c’est à dire une adresse Web, mais son formalisme est un peu différent de l’URL classique. En effet, une URL classique commence par https:// alors que le Deep Link commence par kizeoforms://. Cette spécificité fait que certains logiciels n’interprètent pas ce lien comme une URL et ne le rendent pas cliquable. 

Pour le rendre fonctionnel, il suffit de créer un lien hypertext et de le transmettre à vos utilisateurs, dans un logiciel compatible. Ainsi, en cliquant sur le lien, Android et iOS redirigent l’URL vers l’application KizeoForms.

Important : Les Deep Link répondent aux mêmes règles que les URLs des navigateurs, c’est à dire que certains caractères ne sont pas autorisés. Il convient donc de les remplacer par leur encodage-pourcent, de plus, leur longueur maximale est de 2048 caractères.

Le formalisme du Deep Link

Les règles de base

Les règles suivantes doivent impérativement être respectées :

  • Pour ouvrir les liens, il faut impérativement être utilisateur de l’application Kizeo Forms
  • Le Deep Link commence toujours par kizeoforms://--/
  • Il s’écrit toujours en minuscule, sans accent, et sans espace
  • Les caractères spéciaux doivent être encodés
  • Le formalisme doit être respecté au caractère près
  • Le Deep Link doit être mis sous la forme d’un lien hypertext
Qu'est-ce que l'encodage-pourcent ?

C’est un mécanisme d’encodage de certains caractères utilisé dans le contexte des URL. Il consiste en la substitution d’un caractère par % suivi d’un code hexadécimal correspondant à la valeur ASCII du caractère à remplacer.

Le tableau suivant présente les caractères spéciaux avec leur encodage respectif :

codes

A savoir : D’autres codes sont disponibles sur internet, par exemple ici

Les champs compatibles avec le Deep Linking

Il est possible de préremplir uniquement certains champs, à condition qu’ils ne se trouvent pas dans un tableau. En voici la liste :

  • Le Champ de saisie
  • La Zone de texte
  • Le champ Date et Heure
  • Le champ Case à cocher
  • Le champ Slider
  • Le champ Liste. S’il s’agit d’une liste référentielle, les références de la liste externe s’afficheront automatiquement dans les champs Référence liés
  • Le champ Choix
  • Le champ Géolocalisation
  • Le champ Code-barres/QR Code
  • Le champ Tag NFC
  • Le champ Calcul. Il est possible de mettre un Deep Link dans un champ de type Calcul
Les formalismes particuliers

Si la plupart des champs acceptent les chaînes de caractères, certains ont un formalisme particulier. Par exemple :

  • Case à cocher cochée : 1, ‘1’, true ou ‘true’. Toute autre valeur sera interprétée comme faux (false)
  • Date : YYYY-MM-DD
  • Heure : hh:mm:ss
  • Date et heure : YYYY-MM-DDThh:mm:ss. Il convient de mettre T entre la date et l’heure

Cas pratiques

1 – Les Deep Link génériques

Avec les liens de base, voici ce qu’il est possible de faire :

  • kizeoforms://--/ permet d’ouvrir l’application Kizeo Forms
  • kizeoforms://--/login permet l’accès à la page d’authentification
  • kizeoforms://--/login/code permet l’accès à la page d’authentification avec un code entreprise pré-rempli. code doit être remplacé par le code entreprise souhaité
  • kizeoforms://--/forms permet l’accès à la liste des formulaires
  • kizeoforms://--/favorites permet l’accès à la liste des formulaires favoris
  • kizeoforms://--/settings permet l’accès aux paramètres de l’application
  • kizeoforms://--/forms/formId permet d’entrer dans la saisie d’une donnée sur le formulaire qui correspond au formId
  • kizeoforms://--/data permet l’accès à la liste des données saisies
  • kizeoforms://--/receipts permet l’accès à la boîte de réception

Important : Les trois premiers liens ne nécessitent pas d’être connectés à l’application alors qu’il est impératif de l’être pour les suivants.

A savoir : Si  l’utilisateur n’est pas encore connecté lorsqu’il clique sur le lien, il aura accès uniquement à la page d’authentification, alors que s’il est déjà connecté, il sera redirigé automatiquement vers la page d’accueil.

2 – Les Deep Link personnalisés

Bien qu’il ne se substitue pas au push, le Deep Linking permet de préremplir des champs d’un formulaire, grâce aux Deep Link personnalisés.

Le formalisme d’un Deep Link personnalisé est le suivant :kizeoforms://--/forms/formId?tag1=valeur1&tag2=valeur2&tag3=valeur3

  • formId doit être remplacé par l’ID du formulaire. Il s’agit de la référence à 6 chiffres qui se trouve dans l’URL de la page de création du formulaire
  • tag1, tag2, tag3 etc… correspondent à l’identifiant des champs
  • valeur1, valeur2, valeur3 etc… sont les valeurs qui seront saisies

Voyons quelques cas concrets, en utilisant les champs suivants avec leurs identifiants respectifs.

creation-formulaire

1 - Remplir un champ

Nous souhaitons mettre le nom Kizeo Forms dans le Champ de saisie du formulaire dont l’id est 123456.

L’espace entre Kizeo et Forms est un caractère spécial, son code est %20 

Le formalisme est : kizeoforms://--/forms/formid?nom_du_champ=KizeoespaceForms

Le lien sera : kizeoforms://--/forms/123456?champ_de_saisie1=Kizeo%20Forms

remplir-un-champ

2 - Remplir un champ avec des retours à la ligne

Nous souhaitons mettre l’adresse de Kizeo avec des retours à la ligne dans le champ Zone de texte du formulaire dont l’id est 123456.

Les caractères spéciaux :

  • L’espace entre les mots, son code est %20
  • Le é de Allée, son code est %C3%A9
  • Le retour à la ligne dans l’adresse, son code est %5Cn

kizeoforms://--/forms/formid?nom_du_champ=55espaceAlléeespaceCamilleespaceClaudelretour à la ligne84000espaceAvignon

kizeoforms://--/forms/123456?zone_de_texte1=55%20All%C3%A9e%20Camille%20Claudel%5Cn84000%20Avignon

remplir-un-champ-avec-retours-a-la-ligne

3 - Remplir plusieurs champs

Nous souhaitons mettre le nom Kizeo Forms dans le Champ de saisie et l’adresse de Kizeo avec des retours à la ligne dans le champ Zone de texte du formulaire dont l’id est 123456.

Les caractères spéciaux :

  • L’espace entre les mots, son code est %20
  • Le é de Allée, son code est %C3%A9
  • Le retour à la ligne dans l’adresse, son code est %5Cn
  • Le et entre deux éléments saisis, son code est &

kizeoforms://--/forms/formid?nom_du_champ=KizeoespaceForms&nom_du_champ=55espaceAlléeespaceCamilleespaceClaudelretour à la ligne84000espaceAvignon

kizeoforms://--/forms/123456?champ_de_saisie1=Kizeo%20Forms&zone_de_texte1=55%20All%C3%A9e%20Camille%20Claudel%5Cn84000%20Avignon

remplir-plusieurs-champs

4 - Remplir un champ Case à cocher

Nous souhaitons cocher la case du champ dont l’identifiant est ouinon

Formule : kizeoforms://--/forms/formid?nom_du_champ=1 (ou nom_du_champ=true)

Lien : kizeoforms://--/forms/123456?ouinon=1 (ou ouinon=true)

5 - Remplir un champ Date et Heure
  • Nous souhaitons afficher la date du 24 Novembre 2022 dans le champ dateseule

Formule : kizeoforms://--/forms/formid?nom_du_champ=YYYY-MM-DD

Lien : kizeoforms://--/forms/123456?dateseule=2022-11-24

  • Nous souhaitons afficher l’heure 11h56 dans le champ heure

Formule : kizeoforms://--/forms/formid?nom_du_champ=hh:mm:ss

Lien : kizeoforms://--/forms/123456?heure=11:56:00

  • Nous souhaitons afficher la date du 24 Novembre 2022 et l’heure 11h56 dans le champ date_et_heure1

Formule : kizeoforms://--/forms/formid?nom_du_champ=YYYY-MM-DD

Lien : kizeoforms://--/forms/123456?date_et_heure1=2022-11-24T11:56:00


Pour aller plus loin…


N’hésitez pas à commenter cet article !

Nous sommes disponibles pour répondre à vos questions, suggestions et remarques !


Il y a 2 commentaires

  • Mikael Boyer

    12 Sep, 2023

    Bonjour

    Si je souhaites envoyer une enquête de satisfaction auprès d’usagers (qui n’ont donc pas de compte Kiseo), puis-je envoyer un deep-linking à la place (kizeoforms://–/forms/formId) ?
    Est-ce qu’il va me falloir un utilisateur « Public » dédié à cette tâche ?

    En vous remerciant,
    Mikael

    • Bastien Galzot

      17 Oct, 2023

      Bonjour Mikael,

      Oui c’est possible! Vous pouvez envoyer le lien url qui permettra à son destinataire d’accéder à la saisie d’un formulaire spécifique. Cependant, il est impératif que cet utilisateur dispose d’un profil sur votre Compte Entreprise. Vous devez donc prévoir un profil dédié à vos usagers.

      Excellente journée,

      Cordialement,

      Bastien.

Poster un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *