Deeplinks mobiles

Utilisez les deeplinks pour ouvrir des écrans spécifiques de l'application mobile Daxium-Air depuis des sources externes.

Le « deep linking » dans les applications mobiles est une technique permettant de créer des liens directs vers des emplacements spécifiques au sein d'une application. Chez Daxium, cette fonctionnalité a d'abord été utilisée pour décrire les actions derrière les widgets de personnalisation de l'application sur iOS et Android.

Elle s'est ensuite généralisée à la navigation dans l'application Android v2 et à la communication avec d'autres applications mobiles.

Un tel lien profond est un URI (comme une URL sur le web) qui commence par daxium-air:// pour les applications mobiles.

Principes

Redirections entre applications

Lorsqu'une application appelle un deeplink, 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 terminé dans Daxium-Air, l'application appelante peut être rappelée.

Destinations

Les deeplinks prennent en charge plusieurs destinations, notamment la page d'accueil, l'éditeur de fiche, la vue des fiches, la page de synchronisation, etc.

Les liens peuvent également ouvrir des applications externes ou permettre à l'utilisateur de se déconnecter de l'application Daxium-Air.

Limitations

Si l'utilisateur n'est pas connecté, ou n'a pas accès au formulaire spécifié, une erreur fatale s'affiche. Les chemins malformés ou les valeurs de champs non conformes génèrent des avertissements (voir Gestion des erreurs ci-dessous).

Utilisation

Actions d'un widget de personnalisation de l'application

Ces liens peuvent être utilisés pour les destinations suivantes.

• La page d'accueil — /app/home
• L'éditeur de fiche — /app/new_submission
• La vue des fiches — /app/my_submission
• La synchronisation — /app/sync
• La page des paramètres — /app/settings
• La page de recherche — /app/search
• La page des tâches — /app/my_tasks
• La page webview (qui ouvre une URL externe) — /app/webview
• Redirection vers une application externe — /app/external_app

À noter : lors de l'appel d'un deeplink, si la destination est la même que celle en cours, rien ne se passe.

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

Sans doute la fonctionnalité la plus intéressante dans le contexte d'un appel depuis une application tierce. Cette application pourrait ainsi :

• cibler un formulaire spécifique à ouvrir
• pré-remplir des champs spécifiques avec des valeurs passées en paramètre

Ici, l'identifiant du formulaire est obligatoire et les valeurs des éléments optionnels (champs) peuvent être ajoutées en paramètres.

Une fois reçues, elles sont insérées 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 configuré, il dirige vers le bon formulaire ; sinon, un sélecteur est présenté à l'utilisateur qui devra faire son choix parmi tous les formulaires disponibles.

Exemple

Un tel deeplink est un URI, formé ainsi :

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=[e-mail]&phone=[phone]

Compatibilité des champs — les champs suivants sont actuellement pris en charge

• Texte (sans option texte enrichi)
• Nombre
• Date
• E-mail
• Téléphone
• Booléen

La valeur de chaque champ doit être conforme à sa typologie attendue et au format associé, faute de quoi elle n'est pas insérée.

Les paramètres du deeplink ont priorité sur les valeurs par défaut et sur le pré-remplissage.

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

À noter : cette fonction n'est actuellement disponible que sur l'application Daxium-Air Android V2.

Gestion des erreurs

Code	Message	Criticité
DAERR-DEL1001	Aucun utilisateur n'est connecté à l'application Daxium-Air.	🔴 Fatal
DAERR-DEL1002	Vous ne pouvez pas créer de telles données car vous n'avez pas le formulaire correspondant.	🔴 Fatal
DAERR-DEL1003	Vous ne pouvez pas créer de telles données car le formulaire correspondant est désactivé.	🔴 Fatal
DAERR-DEL1004	Vous ne pouvez pas créer de telles données car le formulaire n'est pas de premier niveau.	🔴 Fatal
DAERR-DEL1005	Le champ nommé structureFieldName n'existe pas dans le formulaire.	🟡 Avertissement
DAERR-DEL1006	Le champ Nombre structureFieldName a un type incorrect dans le formulaire.	🟡 Avertissement
DAERR-DEL1007	La valeur du champ structureFieldName ne peut pas être interprétée comme un nombre.	🟡 Avertissement
DAERR-DEL1008	La valeur du champ structureFieldName ne peut pas être interprétée comme un booléen.	🟡 Avertissement
DAERR-DEL1009	La valeur du champ structureFieldName ne peut pas être interprétée comme une date.	🟡 Avertissement
DAERR-DEL1010	Le chemin fourni est inconnu.	🔴 Fatal
DAERR-DEL1011	La valeur du champ ne peut pas être interprétée comme une durée.	🟡 Avertissement
DAERR-DEL1012	Le champ ne peut pas être utilisé ici.	🟡 Avertissement

Le parcours dans l'application Daxium-Air via le deep linking étant limité à un seul écran, une fois celui-ci terminé, l'application appelante est rendue à l'utilisateur.

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