Home > Models

Introduction

Un modèle d'adaptation est un modèle de données enrichi pour les Master Data. Globalement, les objectifs sont de garantir la cohérence des données de référence et de faciliter leur gestion.

Concrètement, le modèle d'adaptation est un document conforme au standard XML Schema (recommandation W3C). Les principales caractéristiques standard qui sont supportées sont les suivantes :

• Une riche bibliothèque de types de données ( types simples  : integer, boolean, decimal, date, time, ...) ; 

• La possibilité de définir des structures complexes ( complex types ) ; 

• La possibilité de définir des listes simples d'éléments ( listes agrégées ) ; 

• La spécification de contraintes de validation ( facettes XML Schema ) : énumérations, unicité, bornes minimum et maximum, ...

EBX.Platform utilise également les capacités d'extension de XML Schema afin de définir des informations utiles telles que :

• Types pré-définis (locale, resource, html, ...) ; 

• Définition de tables et contraintes de clé étrangère ;

• Mapping de données et de Java beans ;

• Contraintes de validation avancées ( facettes étendues ), telles que des nomenclatures dynamiques ; 

• Informations de présentation étendues : libellé, description, messages d'erreur, ...

Remarque : EBX.Platform supporte un sous-ensemble de la recommandation du W3C, certaines caractéristiques du standard sont en effet inutiles pour les Master Data.

Outil de modélisation

Le modèle d'adaptation peut être défini en utilisant un éditeur XML Schema ou le Data Model Assistant . Ce dernier a l'avantage d'être intégré à EBX.manager et de rendre complètement transparent le langage XML un peu verbeux...

Pour les utilisateurs non techniques, il est recommandé d'ignorer la partie Modèles de la documentation et de lire directement le tutoriel du Data Model Assistant .

Références

Pour une introduction à XML Schema, nous vous recommandons de consulter le site W3School .

Documents de spécification XML Schema du W3C : Part 0: Primer , Part 1: Structures , Part 2: Datatypes .

Lien entre adaptations et modèle d'adaptation

Une adaptation instance racine est associée à un modèle d'adaptation unique.

Pour créer une adaptation racine, vous devez posséder le rôle "Fournisseur". Après vous être connecté à l'outil EBX.Manager, vous devez vous positionner sur le contenu d'une branche qui n'est pas la Référence (cliquer sur le lien "Voir ou éditer le contenu"). Dans la liste à gauche de l'écran, cliquez sur le lien "créer..." Plusieurs options de création sont alors proposées.

Prérequis pour XML Schemas

Pour être accepté par EBX.Platform, un schéma XML doit inclure la déclaration d'un élément global qui comporte l'attribut osd:access="--" .

Conventions

Par convention, les espaces de nommage sont toujours définis comme suit :

Schémas avec noms réservés

Un certain nombre de schémas ont des noms réservés pour EBX.Platform.

Est considérée comme réservée, toute référence à un autre schéma (attribut schemaLocation d’une des balises import, include ou redefine) qui se termine par l’une des chaînes de caractères suivantes : 

• common_1.0.xsd

• org_1.0.xsd

• coreModel_1.0.xsd

• session_1.0.xsd

En ce cas, les fichiers indiqués correspondent aux schémas fournis pour le module ebx-root-1.0 , chemin /WEB-INF/ebx/schemas . Plus précisément, l’attribut schemaLocation peut référencer ces fichiers à ce même emplacement ou bien en référencer une copie, la condition étant que le nom du fichier reste le même. Ceci est utile si l’on veut soustraire le module à la dépendance de ebx-root-1.0 .

Pour plus de sécurité, EBX.Platform reprend une définition interne protégée de ces schémas (au cas où par inadvertance un de ces fichiers aurait été modifié).

Home > Models