Résumé : Configurez des Scenarios dans un modèle d'interface afin que BrynQ sache quel processus métier le modèle prend en charge, quelles données source correspondent à quelles données cibles et quels mappings de valeurs les utilisateurs doivent compléter.

Prérequis : - Vous devez avoir accès à Admin portal et disposer des droits pour gérer les Interface templates. - Le modèle doit avoir un brouillon modifiable. Si la version du modèle est en lecture seule, utilisez d'abord Create draft ou Continue draft dans l'en-tête du modèle. - Le modèle doit déjà comporter des applications source et cible, car les scénarios utilisent les champs de ces applications.

Configurer des scénarios dans une interface modèle

Les scénarios décrivent ce que BrynQ doit faire pour un processus métier dans un modèle, par exemple créer des salariés, mettre à jour des contrats ou synchroniser des absences.

Pourquoi les scénarios sont importants

• Un Scenario regroupe les champs, les règles et les mappings pour un seul résultat. Les différents processus restent ainsi séparés et les utilisateurs ne mélangent pas des champs destinés à des actions sans rapport.
• Une ligne de scénario indique à BrynQ : lire cette valeur dans les Source fields, l'écrire ou la comparer à cette valeur dans les Target fields, et utiliser Mapping lorsque les valeurs portent des noms différents.
• La configuration des scénarios fait partie du modèle. Les utilisateurs qui créent une interface à partir du modèle voient ces scénarios ensuite et ne complètent que les valeurs ou mappings qui nécessitent encore des choix propres au client.

Ouvrir l'étape Scenarios

• Dans la navigation de gauche, ouvrez Admin portal.
• Dans Admin portal, ouvrez Interface templates et sélectionnez le modèle à modifier.
• En haut de la page du modèle, ouvrez la version modifiable avec Create draft ou Continue draft si la version actuelle n'est pas modifiable.
• Dans la navigation par étapes du modèle, sélectionnez Scenarios. La page affiche la liste des scénarios à gauche et l'éditeur de scénario à droite.

Ajouter, sélectionner ou réordonner des scénarios

• En bas de la liste des scénarios à gauche, cliquez sur Add new scenario pour ajouter un scénario au brouillon.
• Dans la liste de gauche, sélectionnez le nom d'un scénario pour modifier ses détails à droite.
• Utilisez la poignée de glissement à gauche du nom d'un scénario pour modifier l'ordre des scénarios. Cet ordre est présenté aux utilisateurs lorsqu'ils configurent une interface à partir du modèle.
• Utilisez le menu à trois points à droite du nom d'un scénario et choisissez Delete scenario lorsque le scénario doit être retiré du modèle.
• Si l'icône d'avertissement affiche This scenario has validation errors, ouvrez ce scénario et complétez la configuration manquante ou invalide avant de publier le modèle.

Remplir l'en-tête du scénario

• En haut de l'éditeur, remplissez Name of your scenario. Utilisez un nom d'action court, par exemple Create employee ou Update contract.
• Sous le nom, remplissez Description. Expliquez quand les utilisateurs doivent utiliser ce scénario et quel résultat le processus produit.
• Si Target scheme s'affiche sous Description, sélectionnez le schéma cible correspondant à ce scénario. Le schéma choisi filtre les Target fields, afin que les utilisateurs ne mappent pas les données vers la mauvaise partie de l'application cible.
• Si vous modifiez Target scheme alors que des lignes contiennent déjà des champs cibles, vérifiez à nouveau ces lignes. BrynQ supprime les champs cibles et les mappings qui ne correspondent plus au schéma choisi.

Configurer les lignes du scénario

Chaque ligne relie des données source à des données cibles. Une ligne peut aussi définir un comportement obligatoire, une correspondance unique, une transformation et un mapping de valeurs.

Comprendre les champs source, les champs cibles et le mapping

• Les Source fields sont les champs que BrynQ lit dans l'application source. Dans une application RH source, il peut s'agir par exemple de Employee number, Employment status ou Department.
• Les Target fields sont les champs dans lesquels BrynQ écrit ou qu'il vérifie dans l'application cible. Dans une application de paie cible, il peut s'agir par exemple de Worker ID, Status ou Cost center.
• Mapping est la traduction des valeurs entre les champs source et les champs cibles sélectionnés. Utilisez-le lorsque l'application source et l'application cible utilisent des valeurs différentes pour une même signification métier.
• BrynQ utilise la sélection des Source fields et des Target fields pour construire la table de mapping. Le côté source devient les colonnes d'entrée. Le côté cible devient les colonnes de sortie.
• Une ligne de la table de mapping est une règle de conversion. Elle indique à BrynQ : lorsque la valeur source est celle-ci, utiliser cette valeur cible.
• Exemple : l'application source envoie Active, mais l'application cible attend Employed. Dans la ligne du scénario, choisissez Employment status sous Source fields, choisissez Status sous Target fields, ouvrez Mapping et ajoutez Active comme valeur source avec Employed comme valeur cible.

Choisir les champs source et cibles

• Dans l'en-tête de la ligne, utilisez Source fields pour choisir les données que BrynQ lit dans l'application source.
• Juste à côté, utilisez Target fields pour choisir les données que BrynQ écrit dans l'application cible.
• Dans chaque sélecteur de champ, utilisez le menu du type de champ pour choisir le type de valeur :
• Library field pour les champs standard de l'application sélectionnée.
• Configuration field pour les réponses issues de l'étape Configuration du modèle.
• Custom field lorsque l'utilisateur de l'interface pourra choisir plus tard un champ propre au client.
• Fixed value lorsque la même valeur doit toujours être utilisée.
• Empty value lorsque la ligne ne doit volontairement envoyer aucune valeur.
• Entre deux lignes, cliquez sur le bouton plus pour ajouter une ligne juste en dessous de la ligne actuelle.
• À droite d'une ligne, utilisez le bouton corbeille pour supprimer une ligne qui ne doit pas faire partie du scénario.

Configurer Mapping et Must fill

• Dans la colonne Mapping, cliquez sur le bouton de mapping pour ouvrir la fenêtre Mapping de cette ligne.
• Dans Mapping, ajoutez des lignes de conversion lorsque des valeurs source doivent être traduites en d'autres valeurs cibles, par exemple Active vers Employed, Inactive vers Terminated ou Temporary vers Fixed term.
• Utilisez Value mapping strategy lorsque BrynQ doit comparer les valeurs source de façon moins stricte. Choisissez par exemple une stratégie qui ignore la casse lorsque active et Active doivent être considérées comme la même valeur.
• Utilisez Set all unmapped values as lorsque les valeurs absentes de la table de mapping doivent recevoir une seule valeur cible par défaut.
• Activez Lock mapping for additions lorsque le mapping du modèle est complet et que les utilisateurs ne doivent pas ajouter de valeurs de mapping supplémentaires en configurant une interface à partir du modèle.
• Activez Must fill pour une ligne lorsque l'utilisateur de l'interface doit compléter ou confirmer le mapping de la ligne avant de pouvoir finaliser l'interface.
• Laissez Must fill désactivé lorsque le mapping est utile mais pas toujours nécessaire.
• Le mapping est désactivé pour les champs Fixed value et Empty value, car ces valeurs n'ont pas besoin d'une table de conversion de la source vers la cible.

Marquer les lignes Unique key et Required

• À droite d'une ligne, utilisez Unique key lorsque le champ aide BrynQ à faire correspondre les enregistrements source et cibles. Un scénario a normalement besoin d'au moins une clé unique pour que BrynQ puisse comparer les enregistrements en toute sécurité.
• Utilisez Required lorsque la ligne doit être présente pour que l'interface fonctionne correctement.
• Si le champ cible sélectionné est obligatoire dans l'application cible, BrynQ active automatiquement Required et le bouton ne peut pas être désactivé.

Ajouter Logic et Transformation

• À gauche d'une ligne, dépliez la ligne avec le bouton flèche lorsque vous avez besoin de paramètres supplémentaires.
• Dans la ligne dépliée, utilisez Logic pour de courtes notes d'implémentation ou des règles métier qui expliquent comment traiter la ligne.
• Utilisez Transformation lorsqu'un ou plusieurs champs source nécessitent une méthode de traitement spécifique :
• Automatic (based on relation) laisse BrynQ choisir le comportement selon la relation entre les champs source et cibles.
• Concatenate combine les valeurs source.
• Fill in order mappe les champs source vers les champs cibles selon leur position.
• Keep source fields conserve les champs source sélectionnés sans modification.

Vérifier et enregistrer la configuration du scénario

BrynQ enregistre automatiquement les modifications des scénarios pendant que vous travaillez dans le brouillon.

Vérifier le brouillon avant publication

• Dans la liste des scénarios à gauche, vérifiez qu'aucun scénario n'affiche encore This scenario has validation errors.
• Vérifiez pour chaque ligne de scénario les paramètres Source fields, Target fields, Mapping, Must fill, Unique key et Required.
• Vérifiez les autres étapes du modèle, comme Configuration, Mapping, Variables et Data filters, avant de publier le modèle.
• Ne publiez le modèle que lorsque tous les scénarios sont complets et que le brouillon ne présente plus d'avertissements de validation.

Plus d'informations

Limitez chaque scénario à un seul processus métier. Si un modèle prend en charge plusieurs processus, créez des scénarios distincts plutôt que de placer toutes les lignes dans un seul grand scénario. Le modèle sera ainsi plus simple à configurer pour les utilisateurs et plus facile à maintenir pour votre équipe.