Contact

Le Deep Linking

Accueil / Tutoriels/Le Deep Linking

28Nov, 2022

2Réaction(s)

Le Deep Linking

Catégorie / Tutoriels Étiquettes : Deep Linking Par Nathalie Castagnier

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 :

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

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

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

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.