Création de nouvelles applications Utilisateur

Lors de la configuration d'une nouvelle Application utilisateur, vous travaillerez avec plusieurs configurations clés qui déterminent comment votre application externe s'intègre à la plateforme. Explorons chaque composant essentiel.

Commencez en cliquant sur la bouton dans la Applications utilisateur liste. Dans le formulaire de configuration apparu, procédez aux étapes suivantes :

1

Configurer l'URL

Spécifiez l'URL de votre application - l'adresse où votre application est hébergée ; elle sert de base pour l'intégration.

• Assurez-vous que l'URL est valide, utilise une connexion HTTPS, mène à une ressource fiable et ne contient pas plus de 1000 caractères.

• Assurez-vous que l'application a le paramètre iFrame activé de son côté, sinon vous ne pourrez pas l'ouvrir dans l'interface de la plateforme.

2

Configurer les paramètres de base

Pour personnaliser votre application, vous pouvez inclure divers paramètres dans l'URL. Vous pouvez ajouter manuellement des paramètres dans le champ URL ou utiliser l'une de nos suggestions : langue, identifiant utilisateur ou fuseau horaire. Cliquez sur une suggestion de paramètre pour l'ajouter à la fin de l'URL. Déployez la description ci-dessous pour en savoir plus sur les paramètres suggérés et voir des exemples.

Comprendre les paramètres d'URL suggérés

Nous suggérons quelques paramètres de base pour la personnalisation

1. ?locale={locale_code} Paramètre de langue qui correspond automatiquement à la langue de la plateforme de l'utilisateur.

• Exemple : https://your-app.com/dashboard?locale=en

1. ?user_id={user_identifier} Paramètre de contexte utilisateur qui transmet l'identité de l'utilisateur pour filtrer les informations personnalisées.

• Exemple : https://your-app.com/dashboard?user_id=12345

1. ?timezone={timezone} Paramètre temporel qui correspond automatiquement au fuseau horaire de la plateforme de l'utilisateur.

• Exemple : https://your-app.com/dashboard?timezone=UTC+1

Vous pouvez modifier le nom du paramètre suggéré ou spécifier une valeur précise pour celui-ci.

Exemple d'URL d'application avec paramètres

Testez votre configuration pour vous assurer que l'application se charge correctement. Cliquez pour afficher un aperçu.

3

Ajuster l'apparence

Créez une identité reconnaissable pour votre application afin de faciliter son accès. Les paramètres suivants vous aideront à le faire :

• Libellé – Ajoutez un nom unique et descriptif pour votre application (jusqu'à 24 caractères). Il sera affiché dans la barre latérale de la plateforme.

• Description – Ajoutez une brève explication avec des détails sur la fonctionnalité de l'application ou mettez en évidence des informations importantes (jusqu'à 50 caractères). Une description informative aidera vos utilisateurs à mieux comprendre l'objectif de l'application.

• Icône – Sélectionnez une icône qui représente la fonction de votre application pour une navigation encore plus native.

4

Sélectionner la méthode d'affichage

Décidez comment votre application s'ouvrira en choisissant l'une des deux options dans le Ouvrir dans menu déroulant :

• Intégré – L'application apparaît dans l'interface de la plateforme

• Nouvel onglet – L'application s'ouvre dans un onglet de navigateur séparé

Notre plateforme utilise iFrame pour l'intégration. Comme toutes les URL ne peuvent pas être traitées avec succès par cette technologie, assurez-vous de prévisualiser le résultat d'intégration. Si vous rencontrez des problèmes avec cette méthode d'affichage, envisagez d'utiliser Nouvel onglet.

5

Configurer l'authentification (facultatif)

Configurez l'authentification si votre application dépend de l'API de la plateforme. Dans ce cas, la plateforme fournira les données d'authentification directement à l'application lorsqu'elle sera ouverte, éliminant le besoin d'implémenter une fonctionnalité de connexion supplémentaire côté application. Vous pouvez choisir l'une des deux méthodes d'authentification :

• champ Clé API

  • Cette méthode est destinée aux applications où la gestion des rôles ou les autorisations utilisateur ne sont pas nécessaires.

  • La clé API correspond au niveau d'accès du propriétaire du compte. Cela signifie que fournir une clé API à un utilisateur ordinaire peut lui donner accès à toutes les données disponibles pour l'utilisateur principal. Par exemple, si votre application fonctionne avec des traceurs auxquels un utilisateur a des droits limités ou aucun accès, l'utilisation de la clé API exposera quand même tous les traceurs du compte principal.

• Clé de session

  • Cette méthode est recommandée lorsque la gestion des rôles est impliquée.

  • Transmet la clé de session de l'utilisateur courant à l'application.

La sélection de la champ Clé API méthode désactivera automatiquement la Clé de session méthode, et vice versa. Une seule méthode peut être utilisée à la fois.

Lorsque l'authentification est activée, la plateforme ajoute le ?session_key= paramètre à l'URL de votre application.

• Si vous avez sélectionné une champ Clé API, la valeur du paramètre contiendra cette clé.

• Si vous avez opté pour une Clé de session, la valeur du paramètre inclura la clé de la session utilisateur courante depuis laquelle l'application est accédée.

Assurez-vous que l'application est capable de lire et d'utiliser ce paramètre.

6

Enregistrer la nouvelle application

Cliquez sur le Enregistrer bouton. Votre application apparaîtra dans la Applications utilisateur liste et la barre latérale de la plateforme. Les applications activées deviennent automatiquement disponibles pour les utilisateurs du compte.

Exemple d'affichage d'une Application utilisateur intégrée

Conseils rapides de dépannage

Si votre application ne s'affiche pas correctement une fois intégrée, essayez :

• L'ouvrir plutôt dans un nouvel onglet

• Vérifier que votre URL est correcte et accessible

• Vérifier que tous les paramètres sont correctement formatés

Les applications créées restent entièrement configurables après leur enregistrement. Vous pouvez ajuster leurs paramètres et leur apparence à tout moment. Pour en savoir plus sur la gestion des applications, consultez Gérer les applications utilisateur existantes.