top of page
réunion

Deep links mobiles

Dernière mise à jour : 6 mai


Deep links / Liens profonds

Le "deep linking" dans les applications mobiles est une technique permettant de créer des liens directs vers des emplacements spécifiques d'une application. Un tel lien profond est un URI, (comme une URL sur le web) qui commence par daxium-air://

Principes

Redirections entre applications

Quand une application appelle un deep link de Daxium-Air, elle passe en arrière-plan tandis que l'application Daxium-Air passe au premier plan. L'application appelante peut être fermée par le système à tout moment. Une fois le processus dans Daxium-Air terminé, l'application appelante peut être rappelée.



Limitations

Il y a certaines limitations et erreurs possibles. Par exemple, si l'utilisateur n'est pas connecté à Daxium-Air ou n'a pas accès au formulaire spécifié dans le lien, des erreurs spécifiques sont affichées. De plus, si le deep link ne suit pas le bon chemin ou si certains champs ne sont pas conformes, des erreurs peuvent survenir.


Utilisation

Créer une fiche avec valeurs paramétrées

Sans doute la fonctionnalité la plus interessante dans le contexte d'appel depuis une application tierce. Celle-ci peut ainsi :

  • cibler un formulaire spécifique à ouvrir ;

  • et pré-remplir des champs spécifiques avec des valeurs passées en paramètres.

Ici, l'identifiant du formulaire est obligatoire et des valeurs des éléments (champs) sont eux, facultatifs et peuvent être ajoutées en tant que paramètres. Une fois reçus par l'application Daxium-Air, ils sont insérés dans la fiche nouvellement créée.


Chemin racine du lien : daxium-air://editor/create/<structure_id>. Le paramètre structure_id (correspond à l'id technique du formulaire) fait partie du chemin. S'il est paramétré, il dirige vers le bon formulaire, si non, un sélécteur est présenté à l'utilisateur qui devra faire son choix parmi tous les formulaires disponibles.

Exemple

Un tel lien profond est un URI, formé comme :

daxium-air://editor/create/XXX&item1=value1&item2=value2


Exemple complet daxium-air://editor/create/137396?string=Hello, world&number=123.456&boolean=true&date=2023-08-23T13:00:52Z&email=bob@daxium.com&phone=+33612345678



Compatibilité des champs À date, les champs suivants sont supportés :

  • Texte (sans l'option texte riche)

  • Nombre

  • Date

  • Email

  • Télphone

  • Booléen


Chaque valeur de champ doit être conforme à sa typologie attendue et à son format associé, sinon elle n'est pas inséree.

Les paramètres des liens profonds ont la priorité sur les valeurs par défaut et le pré-remplissage.

Tous les autres types de champs sont ignorés par ce mécanisme, mais certains peuvent être remplis via les valeurs par défaut habituelles et le pré-remplissage défini par l'utilisateur.


Note ! Cette fonction n'est à date disponible que sur l'application Daxium-Air Android V2

Gestion des erreurs

Voici les erreurs que l'utilisateur peut rencontrer lors de l'usage d'un deep link, et leurs significations correspondantes.


Code

Message

Criticité

DAERR-DEL1001

Aucun utilisateur n'est connecté sur l'application Daxium-Air.

fatale

DAERR-DEL1002

Vous ne pouvez pas créer de telles données car vous ne disposez pas du formulaire correspondant.

fatale

DAERR-DEL1003

Vous ne pouvez pas créer de telles données car le formulaire correspondant est désactivé.

fatale

DAERR-DEL1004

Vous ne pouvez pas créer de telles données car le formulaire n'est pas de premier niveau

fatale

DAERR-DEL1005

le champ nommé structureFieldName n'existe pas dans le formulaire.

warning

DAERR-DEL1006

le champ Numéro structureFieldName a un type incorrect dans le formulaire

warning

DAERR-DEL1007

la valeur valeur dans le champ structureFieldName ne peut pas être interprétée comme un nombre

warning

DAERR-DEL1008

la valeur valeur dans le champ structureFieldName ne peut pas être interprétée comme un booléen

warning

DAERR-DEL1009

la valeur valeur dans le champ structureFieldName ne peut pas être interprétée comme une date

warning

DAERR-DEL1010

Le chemin donné est inconnu.

fatale

DAERR-DEL1011

La valeur dans le champ ne peut pas être interprétée comme une durée.

warning

DAERR-DEL1012

Le champ field ne peut pas être utilisé ici.

warning


Note ! Le parcours dans l'application Daxium-Air via ce lien profond étant limité à l'écran d'édition de fiches, il est prévu qu'une fois terminé, l'application appelante soit renvoyée en avant-plan à l'utilisateur.


En résumé, le deep linking avec Daxium-Air offre une méthode efficace pour naviguer et interagir avec l'application, mais il est important de respecter ses limitations et de gérer correctement les erreurs pour une expérience utilisateur optimale.


Mots-clés :

135 vues

Comments


Documentation Utilisateurs

bottom of page