Vue d'ensemble

Un Scenario est un circuit de livraison unique au sein d'une interface, pour un seul thème. 

Un template (interface) correspond à l'intégration complète. Il contient plusieurs Scenarios.

Chaque scenario porte un nom et se compose d'un ensemble de records. Un record indique comment certains champs du système source sont associés aux champs du système cible.

Analogie : Imaginez le tri du courrier. L'application cible est votre classeur, l'application source est le courrier entrant, et chaque Scenario est un employé qui range le courrier entrant dans le bon tiroir.

Qu'est-ce qu'un scenario

Qu'est-ce qu'un Scenario ?

Le système RH source et le système de paie cible sont tous deux organisés par thèmes, comme les données personnelles, les adresses, le contrat, le salaire, etc. 
BrynQ traite vos données thème par thème, et un Scenario définit la manière dont un thème est traité.

Plus précisément, un Scenario décrit à quoi ressemble un thème dans les deux systèmes, et comment BrynQ synchronise les données de ce thème entre eux.

Points clés à retenir sur les Scenarios :

1. L'interface est divisée en Scenarios : un par thème.
2. Chaque Scenario définit QUELLES données sont synchronisées et COMMENT : il décrit les données et la logique de synchronisation pour ce thème.
3. Chaque Scenario correspond généralement à une seule destination dans le système de paie cible : côté source, les données peuvent en revanche provenir de plusieurs emplacements du système RH.
4. Les Scenarios s'exécutent dans un ordre fixe : lorsqu'une synchronisation est lancée, l'interface exécute chaque Scenario l'un après l'autre, selon une séquence précise.

Important : les Scenarios sont toujours structurés autour du système cible. Comme BrynQ envoie les données vers le système de paie cible, la configuration de chaque Scenario suit la façon dont ce thème est organisé dans le système cible, et non dans le système source.

Les Scenarios rendent l'intégration fiable :

• Dépannage facilité
• Acheminement précis : le système sait toujours où chaque modification doit aller
• Vue ciblée : vous ne voyez que les champs utiles pour cette destination

Où trouver les scenarios ?

Prérequis : vous disposez d'une interface en mode live ou brouillon. Les Scenarios font partie d'une interface.

Accédez aux scenarios de votre interface

 

Naviguer dans l'écran Scenarios

Ouvrez une interface et cliquez sur l'onglet Scenarios.

Panneau de gauche : liste des Scenarios

• Cliquez sur le nom d'un Scenario pour l'ouvrir
• Faites glisser la poignée en pointillés pour réorganiser les Scenarios
• Cliquez sur le menu ⋮ à côté d'un nom pour :
  • Disable scenario : arrête l'envoi de données mais conserve la configuration
  • Delete scenario : disponible uniquement pour les Scenarios que vous avez créés ; les Scenarios issus d'un template peuvent seulement être désactivés
• Cliquez sur Add new scenario pour en créer un nouveau

Remarque : avec certains abonnements, l'ajout de nouveaux Scenarios est verrouillé. Si c'est le cas pour votre compte, un message vous invite à passer à une offre supérieure.

Les Scenarios désactivés apparaissent sous Inactive scenarios, en bas de la liste. Cliquez sur l'icône de flèche circulaire pour en réactiver un.

Un triangle d'avertissement rouge (⚠) à côté du nom d'un Scenario signale un problème de configuration. Ouvrez le Scenario pour l'examiner et le corriger.

Panneau de droite : détail du Scenario

En haut, vous pouvez modifier :

• Name : le titre du Scenario
• Description : une courte note sur ce que fait ce Scenario (500 caractères maximum)
• Additional comments : des notes internes pour votre équipe (affichées en bas du panneau)

Sous ces champs se trouve la liste des Records.

Qu'est-ce qu'un Record ?

Un Record est une ligne d'un Scenario. Il définit une correspondance :

"Prendre cette valeur dans la source. La placer ici dans la cible."

Chaque ligne comporte quatre colonnes :

La Unique key

La Unique key indique à BrynQ comment identifier un enregistrement précis (une personne, un contrat, une adresse, etc.) dans l'application cible. Sans elle, le système ne peut pas rattacher les données entrantes à la bonne entrée.

Important : chaque Scenario doit comporter au moins une ligne marquée comme Unique key. Si aucune n'est définie, BrynQ affiche ce message et ne traite pas le Scenario :
"Your scenario needs at least one unique key in order for your scenario to be processed."

Vous pouvez marquer plusieurs lignes comme Unique key. Ensemble, elles forment un identifiant combiné, par exemple matricule + numéro de contrat.

Désactiver un Record

Certaines lignes peuvent être désactivées si elles ne sont pas nécessaires. En revanche, les lignes marquées Required ou Unique sont verrouillées et ne peuvent pas être désactivées.

Relations entre champs (1:1, 1:N, N:1, N:M)

Vous ne définissez pas le type de relation manuellement. BrynQ le détermine automatiquement selon le nombre de champs sélectionnés de chaque côté :

La plupart des lignes sont en 1:1.

Quand avez-vous besoin de N:M ? Lorsqu'un seul champ source ne fournit pas assez d'informations. Par exemple, un code fiscal qui dépend à la fois du pays et de la situation familiale : aucun des deux champs ne donne seul le bon résultat.

Pour modifier la façon dont les champs sont combinés, ouvrez la ligne et utilisez la liste déroulante Rename logic / Transformation. Les options incluent Automatic, Concatenate, Fill in order et Keep source fields. Laissez ce réglage sur Automatic, sauf raison particulière de le modifier.

Qu'est-ce qu'un Value Mapping ?

Utilisez un Value Mapping lorsque les applications source et cible représentent les mêmes données différemment.

Repérer les Value Mappings à l'écran

Dans la colonne Mapping :

• Bouton plein : un value mapping est configuré
• Bouton en contour (vide) : aucun mapping défini
• Badge ✓ : le mapping est complet
• Badge ! : le mapping est obligatoire mais pas encore défini

Cliquez sur le bouton pour ouvrir la table de mapping.

Exemple

Correspondance du pays de résidence entre Bob (source) et Zenegy (cible) :

Sans ce mapping, Zenegy rejette "Netherlands", car il n'accepte que les codes pays.

Certains Value Mappings sont obligatoires (l'application cible impose un format précis). D'autres sont facultatifs (pour nettoyer ou normaliser les données).

Stratégie de correspondance

Si les données entrantes peuvent contenir des incohérences (espaces en trop, majuscules différentes), vous pouvez ajuster le niveau de rigueur avec lequel BrynQ compare les valeurs. Choisissez une stratégie en haut de la table de mapping :

Valeur par défaut

Vous pouvez définir une valeur par défaut dans la table de mapping. Si une valeur entrante ne figure pas dans la liste, BrynQ utilise la valeur par défaut au lieu d'échouer.

Types de champs

Cliquez sur la petite icône à côté d'un champ pour en changer le type :

Library ou Custom : les Library fields sont des champs standard disponibles pour tous les clients. Les Custom fields sont des champs supplémentaires qui n'existent que dans la configuration d'un client donné.

Remarque : il existe aussi un type de champ Configuration, mais il n'apparaît pas dans le menu des types de champs côté client. Les valeurs de configuration se définissent dans l'onglet Configuration de l'interface, et le Scenario les utilise comme entrée fixe. Les types de valeurs pris en charge sont notamment le texte, le texte enrichi, le nombre, la date, la plage de dates, la sélection dans une liste et l'e-mail. Une pièce jointe peut aussi être ajoutée comme document de référence, mais elle n'est pas utilisée par l'intégration elle-même.