SmalsUtils-Validation

Aperçu

Librairie qui regroupe un ensemble de validations ou d'annotations pour des entités métiers utilisées dans de nombreuses applications Angular ou Java de la sécurité sociale

Vous développez une application, service ou librairie, en Angular ou Java, et vous voulez valider le check-digit d'un identifiant (NISS, numéro d'entreprise, ...), le format d'un numéro de TVA, une adresse IP ou e-mail, ... alors embarquez la librairie ad-hoc (ngx)-SmalsUtils-Validation dans votre application, service ou librairie.

Description fonctionnelle

Il existe deux librairies, une librairie "ngx-smalsutils-validation" pour les applications dont le front-end est développé à l’aide du framework Angular et une deuxième "SmalsUtils-Validation" pour les applications Java.

Les deux librairies permettent de valider :

• Les entités utilisées dans le secteur de la sécurité sociale : numéro d'entreprise (BCE), numéro d’établissement (BCE), numéro d’identification de la sécurité sociale (NISS), les numéros d’immatriculation pour les employeurs, mandataires, commettants, chantiers, entrepreneur, curateurs et Dimona (ONSS), numéro des entités économiques étrangères (FEEN), numéro INAMI, numéro de commission paritaire...
• Les entités date, temps et année-trimestre
• Les entités comptes bancaires (IBAN, BBAN), identifiants TVA, communication structurée d’un paiement belge, adresse email, adresse IP

Description technique

Les librairies Maven et Java sont disponibles sur le système partagé Artifact Repository.

Public cible

Toute application Java ou Angular qui implémente une validation des entités mentionnées plus haut.

Remarque : Il s’agit d’une validation exclusivement formelle qui porte sur la longueur, le check digit, le range ou le format des entités.

Conditions d'intégration

La librairie Angular "ngx-smalsutils-validation" est disponible à l'adresse https://repo.ict-reuse.be où elle peut être téléchargée mais ne peut être accédée directement.

• La version 4.1 s'intègre dans les applications Angular dont la version est minimum 10 et inférieure à 16
• La version 5.0 s'intègre dans les applications Angular dont la version est minimum 16
• La version 7.0 s'intègre dans les applications Angular dont la version est minimum 17

La librairie Maven "SmalsUtils-Validation" est disponible à l'adresse https://repo.ict-reuse.be où elle peut être téléchargée ou accédée directement.

Pour cette dernière librairie, il n’y a aucun effort d’intégration si l'application suit les standards J2EE (JSR-303).

Vous pouvez accéder à la librairie "SmalsUtils-Validation" avec les paramètres suivants :

       <dependency>

                   <groupId>be.smals.smalsutils</groupId>

                  <artifactId>smalsutils-validation</artifactId>

                   <version>6.1.0</version>

       </dependency>

Remarques:

• A partir de la version 6.0, les versions Java8 et Java17 (Jakarta-ee) sont disponibles
• Si nécessaire, les versions spécifiques peuvent être accédées via le tag <classifier> "javaee" (Java8) ou "jakarta" (Java17)

Si vous n'avez pas encore les accès à ce repository, demandez la création d'un compte utilisateur à ReuseOperational@smals.be en fournissant votre Nom, Prénom, Mail professionnel et Nom de votre institution.

Ensuite suivez les étapes du "Guidelines-Reuse a library from Repository ict-reuse-FR" (voir lien ci-dessous).

Remarque: Le repository sera indisponible chaque 1er samedi du mois, en matinée.

Documentation

• Analyse fonctionnelle
• ngx-smalsutils-validation : GIT documentation
• SmalsUtils-Validation : GIT code source
• REST JAX-RS Validation
• Guidelines-Reuse a library from Repository ict-reuse-FR

Contact

Contact : ReuseOperational@smals.be