Les collections

Une collection est un ensemble de variables. Chaque collection est identifiée de façon unique par un code alphanumérique.

Créer une collection

Une collection peut être créée à partir du formulaire de création en renseignant code, libellé et tags de la collection. Les tags sont actuellement utiles pour un regroupement dans l'affichage uniquement.

Exporter une collection

Il est possible d'exporter la définition d'une collection et l'ensemble des variables qu'elle contient dans un fichier JSON en cliquant sur le bouton Exporter dans la page de la collection.

Exemple

{
  "code": "DISCOUNT",
  "label": "Discount calculation",
  "tags": [
    "samples"
  ],
  "variables": [
    ...
  ]
}

Importer une collection

Il est également possible de créer une collection à partir d'une définition JSON en collant directement le contenu JSON dans la zone prévue à cet effet ou bien en important un fichier JSON.

Plusieurs modes d'import sont possibles :

• Créer: à utiliser lorsque l'on souhaite créer une nouvelle collection. Le code de la collection étant unique, il faudra veiller leur de l'import d'un JSON à ce que le code de la collection présent dans la définition n'existe pas dans RuleShake Catalog.
• Remplacer: à utiliser lorsque l'on souhaite remplacer la définition d'une collection existante. Les variables définies dans cette collection seront supprimées pour être remplacées par les variables présentes dans le JSON importé.
• Fusionner: à utiliser lorsque l'on souhaite fusionner les variables d'une collection déjà présente dans RuleShake Catalog avec les variables présentes dans le JSON importé. En cas de conflit, c'est la variable présente dans le JSON importé qui sera conservée.

Publier une collection

Les collections de variables sont versionables et ont une période de validité. Les périodes peuvent être discontinues mais ne se chevauchent pas.

Figure: Versionning des collections

La publication consiste à exporter la définition actuelle de la collection sous format JSON et lui attribuer un numéro de version. Le numéro de version est un entier dont la première valeur est 1 qui s'incrémente pour chaque nouvelle version.

À la publication d'une collection, il est possible de choisir de releaser la version ou non.

• En choisissant de ne pas faire de release, la version sera créée dans un état brouillon. Les prochaines publications écraseront la définition de la publication et n'incrémenteront pas le numéro de version tant que le choix de la release n'est fait.
• En choisissant de faire une release, la définition actuelle de la collection sera exportée, écrasera potentiellement l'export fait précédemment si la version était déjà créée à l'état brouillon, puis la version sera figée avec l'état " releasé". La prochaine publication créera une nouvelle version en incrémentant le numéro de la dernière version.

info

L'action de publier une collection permet également de pousser la version dans RuleShake Runner.

Simuler une collection

Avant de publier une collection dans RuleShake Runner, il est possible de simuler la collection et le calcul des variables qui la composent en cliquant sur le bouton Simuler.

Formulaire de simulation

Un formulaire sera automatiquement généré en fonction de la définition des variables de la collection.

Figure: Simulation d'une collection représentant une assurance AUTO

Il sera créé un onglet pour chaque variable Composite définie à la racine de la collection. Dans l'exemple précédent, VEHICULE, CONDUCTEUR et ANTECEDENTS sont des variables Composite.

Le dernier onglet AUTRES contient les variables de type autre que Composite.

Si une variable est multiple, le lien Ajouter un(e) <libellé de la variable> est affiché en dessus de la variable ou du bloc des sous variables s'il s'agit d'une variable Composite.

Après avoir renseigné les différentes valeurs des variables, on peut cliquer sur Simuler pour exécuter l'évaluation de la collection avec les valeurs d'entrée saisies dans le formulaire.

Résultat de la simulation

Dans le résultat de la simulation, on retrouve les objets JSON représentant la requête (les valeurs des variables saisies dans le formulaire) et la réponse.

L'objet réponse contient l'ensemble des variables de la collection ou, pour chaque variable, sont présents l'ensemble des attributs. Il se peut que certains attributs n'auront pas été évalués si les variables nécessaires dans leurs calculs n'ont pas été valorisées.

Enfin, un tableau synthétise les variables de la collection en n'affichant que leurs références et leurs valeurs.

Gestion des cas de simulation

Il est possible de sauvegarder les cas de simulation pour une prochaine réutilisation.

Le bouton Sauvegarder en bas de du formulaire permet d'enregistrer le cas. La liste déroulante en haut du formulaire permet de charger le cas et remplir les champs par les valeurs enregistrées dans le cas.

La roue crantée à côté de la liste déroulante permet de gérer la liste des cas de simulation.

Résolution des variables Record

Les variables de type Record représente les données d'un record d'un dataset défini dans RuleShake Referential.

Lors de la simulation, aucun cache n'est mis en place. Ainsi, lors de l'évaluation de la variable de type Record, c'est un appel vers le service RuleShake Referential qui est effectué pour remonter les informations du record, et éventuellement les classiers liés, à partir du code renseigné dans le formulaire de simulation.