Interfaces basées sur un template

Un Template est le plan directeur d'une intégration entre deux systèmes.

Une Template Interface est le produit fini de ce plan : une intégration mise en service.

Chez BrynQ, nous définissons à l'avance la manière dont deux systèmes doivent se connecter. Le résultat est un Template, qui définit la structure et les règles garantissant que les données circulent correctement d'un système source vers un système cible.

Une Template Interface est la version en production de ce Template : elle connecte vos systèmes et assure concrètement le transfert des données entre eux. Comme elle repose sur un plan éprouvé, elle suit dès le premier jour un standard qui a fait ses preuves. BrynQ vous permet d'ajuster cette interface aux besoins spécifiques de votre organisation.

Exemple de Template :
Le Template HiBob - Nmbrs | Employee Data définit comment les données des salariés doivent passer de HiBob à Nmbrs.

L'interface créée à partir de ce Template et connectée à vos systèmes sait alors comment synchroniser ces informations (nom, date de naissance, numéro de sécurité sociale, etc.).

Personnalisation

Selon votre configuration, une Template Interface peut être ajustée à vos besoins spécifiques. Vous pouvez par exemple utiliser des champs personnalisés ou modifier le mapping de certains champs.

L'étendue des modifications possibles dépend de votre abonnement : en général, plus le niveau d'abonnement est élevé, plus vous avez de liberté pour personnaliser et affiner votre interface au-delà des paramètres par défaut.

Attention : plus vous personnalisez, moins il est probable que tout fonctionne immédiatement, et plus les tests doivent être approfondis.

Premiers pas

1. Créer votre interface

Allez dans Interfaces et cliquez sur New Interface.
Choisissez l'option template-based.
Recherchez et choisissez un template correspondant à vos apps source et cible.

Une fois l'interface créée, vous arrivez dans l'interface setup. Les nouvelles interfaces basées sur un template démarrent en tant que draft (brouillon).

Si les apps nécessaires ne sont pas encore actives, BrynQ vous invitera à les activer d'abord. Vous pouvez aussi atteindre les limites de votre offre en matière d'interfaces ou d'apps. Votre contact BrynQ peut vous aider !

2. Compléter les sections de configuration

Parcourez les sections affichées pour votre interface.
Tous les templates ne comprennent pas toutes les sections : cela dépend du template et de votre abonnement.

Un ordre habituel :

Configuration : répondez aux questions de configuration de ce template (paramètres de l'entreprise, préférences, etc.).
Scenarios : vérifiez quelles données sont échangées et comment les champs sont mappés entre les deux systèmes.
Data filters : limitez, le cas échéant, les enregistrements inclus.
Authorization : connectez les identifiants de vos apps source et cible. L'interface ne peut pas s'exécuter tant que cette étape n'est pas terminée.
Logging & monitoring : configurez la façon dont les exécutions sont journalisées et surveillées.

Résolvez les avertissements de validation avant de publier ; les sections qui posent problème sont généralement signalées dans l'en-tête de l'interface. Les modifications d'un brouillon sont enregistrées automatiquement.

3. Publier

Une fois la configuration terminée, publiez le brouillon pour mettre l'interface en production. Tant que vous ne l'avez pas fait, l'interface n'est pas prête pour la production. Selon votre template, la planification peut n'être disponible qu'après la publication.

4. Exécuter et surveiller

Depuis l'aperçu de l'interface, vous pouvez :

Exécuter manuellement : utile pour un premier test.
Définir une planification : exécution à heure fixe ou après une autre interface, dès que la planification est disponible.
Consulter les exécutions : vérifiez le statut, les logs et les erreurs après chaque exécution.
Fournir des variables : certaines interfaces demandent à chaque démarrage des valeurs propres à l'exécution, par exemple les salariés à filtrer. Ces valeurs vous sont demandées au début de l'exécution.

La manière dont les Template Interfaces sont configurées dans l'app BrynQ est améliorée en continu ; certains détails peuvent donc évoluer avec le temps.