Aller au contenu principal
Version: Next

Les classiers

Une classier est un sous-ensemble de données lié à un dataset. On peut imaginer que pour un besoin donné, les données d'un dataset sont des valeurs globales et les données d'un classier sont des valeurs spécifiques pour des cas particuliers.

Exemple

Prenons l'exemple du dataset représentant le référentiel des communes.

Dans le métier de l'assurance automobile, le tarif peut dépendre du lieu de stationnement du véhicule. Ainsi, l'assureur va établir un zonier dans lequel il va définir des classes. Chaque classe concernant un groupe de communes et/ou des départements.

Dans ce cas, on va définir un classier dont les valeurs sont les classes choisies par l'assureur. Chaque classe peut être attribuée à un ensemble de communes, de départements ou de pays.

Créer un classier

Comme pour un dataset, un classier peut être créé à partir du formulaire de création en renseignant :

  • un code qui doit être unique
  • un libellé
  • le dataset auquel il est lié
  • le type du classier

Exporter un classier

Il est possible d'exporter la définition du classier sous format JSON en cliquant sur le bouton EXPORTER dans la fiche du classier.

Exemple
{
"code": "ZONIER",
"label": "Zonier",
"datasetCode": "COMMUNES",
"type": "NUMBER",
"keys": [
{
"propertyCode": "COMMUNE",
"orderIndex": 0
},
{
"propertyCode": "DEPARTEMENT",
"orderIndex": 1
},
{
"propertyCode": "PAYS",
"orderIndex": 2
}
]
}

Importer un classier

Il est également possible d'importer la définition d'un classier à partir d'un contenu ou d'un fichier JSON. Pour cela, il suffit de coller le contenu JSON ou bien d'importer le fichier dans la zone prévue à cet effet.

attention

Le code du classier doit être unique. Il faudra veiller leur de l'import d'un JSON à ce que le code du classier présent dans la définition n'existe pas dans RuleShake Referential.

Type

Le type du classier permet de définir le format de chaque record du classier.

Un classier peut être de type primitif : Nombre, Date, Chaîne ou Booléen.

Il peut être également sous forme d'un tableau de données, on parle alors d'un type Composite.

Propriétés

Lorsque le type du classier est Nombre, Date, Chaîne ou Booléen la seule propriété créée par défaut est VALEUR qui représente la valeur du classier pour chaque record.

Dans le cas d'un classier Composite, il est possible de définir une liste de propriétés (comme pour un dataset) qui représente les données que doit porter chaque record du classier. Chaque propriété est définie par :

  • un code unique par classier
  • un libellé
  • un type parmi Chaîne, Nombre, Date ou Booléen
info

La propriété CODE est systématiquement présente dans chaque classier de type `Composite et permet d'identifier de façon unique chaque record.

Lien avec le dataset

Chaque record défini dans un classier est lié à un ou plusieurs records définis dans le dataset correspondant. Ce lien se fait par le biais des propriétés du dataset.

Lors de la définition du classier, on va pouvoir choisir la liste des propriétés du dataset qu'on va utiliser pour faire la liaison. Ainsi, chaque record du classier peut être lié à un ou plusieurs valeurs d'une ou plusieurs propriétés du dataset choisies.

On va également définir l'ordre de résolution de chaque propriété utilisée.

Exemple
Définition du classier et des propriétés utilisées du dataset auquel il est lié
Figure: Définition du classier et des propriétés utilisées du dataset auquel il est lié

Dans cet exemple, le classier ZONIER est de type Nombre et lié au dataset COMMUNES.

Il utilise les propriétés COMMUNE, DEPARTEMENT et PAYS.

L'ordre de résolution est la recherche d'abord par lien avec la COMMUNE puis le DEPARTEMENT et enfin le PAYS.

Records

Selon le type du classier, un record peut être une valeur pour les types Chaîne, Nombre, Date ou Booléen, ou bien une liste de valeurs pour le type Composite.

Créer un record

Il est possible de créer un record à partir du formulaire de création à ouvrir à partir du menu ACTIONS. Ce formulaire est généré automatiquement à partir de la définition des propriétés du classier et des propriétés du dataset auquel il est lié.

Après avoir saisi un code et une valeur au record, il faudra ensuite définir le lien qu'a ce record avec les records du dateset. Dans la partie « Clés de dataset associées », on va choisir les valeurs des propriétés du dataset lié. Un record du classier peut être lié à plusieurs valeurs des différentes propriétés du dataset sélectionnées dans la définition du classier.

Exemple
Lien d'un record d'un classier avec les propriétés d'un dataset
Figure: Lien d'un record d'un classier avec les propriétés d'un dataset

Dans cet exemple, ce record a la valeur -10 et est lié aux records du dataset COMMUNES dont :

  • la propriété COMMUNE est BRON

ou

  • la propriété DEPARTEMENT est HERAULT

Exporter les records

Il est possible d'exporter les records d'un classier sous format d'un fichier CSV ou les colonnes sont :

  • CODE : le code du record
  • KEYS : les liens du record avec les propriétés du dataset lié

Si le classier est de type Chaîne, Nombre, Date ou Booléen :

  • VALUE : la valeur du record si le classier est de type Chaîne, Nombre, Date ou Booléen

Si le classier est de type Composite :

  • Une colonne par propriété du classier
Exemple
Fichier CSV des records du classier lié au dataset des communes de France
Figure: Fichier CSV des records du classier lié au dataset des communes de France

Importer les records

Il est également possible d'importer un fichier CSV (au même format que celui obtenu lors de l'export) pour créer des records en masse.

Dans le formulaire d'import, on peut choisir entre deux modes d'import :

  • Fusionner : fusionne les records du classier déjà présents dans RuleShake Referential avec ceux présents dans le CSV. En cas de conflit, c'est-à-dire deux records avec le même code, c'est le record présent dans le CSV qui sera conservé.
  • Remplacer : vide tous les records du classier dans RuleShake Referential puis importe les records à partir du CSV.

Résolution d'un classier

Par résolution d'un classier, on entend récupération du record du classier associé à un record d'un dataset.

Pour la résolution, on va effectuer une recherche dans les records du classier dans l'ordre des propriétés du dataset lié ayant comme valeurs ceux du record du dataset à résoudre.

Exemple

Prenons l'exemple du classier ZONIER qui utilise les propriétés du dataset dans cet ordre :

  1. COMMUNE
  2. DEPARTEMENT
  3. PAYS

Les records du classier sont :

CODEVALEURLIENS
BONUS-10COMMUNE = BRON ou DEPARTEMENT = HERAULT
MALUS+10DEPARTEMENT = AIN
AUTRE0PAYS = FRANCE

Pour la résolution du classier, prenons l'exemple du record du dataset des communes de France :

CODEPAYSDEPARTEMENTCOMMUNE
69029FRANCERHONEBRON

Recherche dans l'ordre :

  1. Recherche d'un record du classier lié à la commune BRON => Record trouvé ! code = BONUS

Prenons un autre exemple avec le record du dataset :

CODEPAYSDEPARTEMENTCOMMUNE
01053FRANCEAINBOURG EN BRESSE

Recherche dans l'ordre :

  1. Recherche d'un record du classier lié à la commune BOURG EN BRESSE => Aucun record trouvé ...
  2. Recherche d'un record du classier lié au département HERAULT => Record trouvé ! code = MALUS

Prenons un dernier exemple du record du dataset :

CODEPAYSDEPARTEMENTCOMMUNE
59250FRANCENORDLILLE
  1. Recherche d'un record du classier lié à la commune LILLE => Aucun record trouvé ...
  2. Recherche d'un record du classier lié au département NORD => Aucun record trouvé ...
  3. Recherche d'un record du classier lié au pays FRANCE => Record trouvé ! code = AUTRE