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éléphone
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.