Home > Introduction
Important Concepts
Use cases and actors
The illustration below presents actors involved in Master Data Management. It is important to understand the roles of each actors before using EBX.Platform.

A typical usage scenario is :
Developer
- The Developer starts by modeling Master Data. A model is called an Adaptation Model (see below) and is based on the XML Schema standard;
- He can add Services, in order to integrate Master Data with external systems or enhance MDM Features. For example, he can add Import/Export Services. Services can be interactive (they are integrated into EBX.Manager tool) or programmatic;
- Models and Services are packaged into a Module. A module is a J2EE Web Application that groups the Adaptation Model and its associated resources, so as to standardize and facilitate deployment.
Administrator
- The Administrator first installs EBX.Platform on its Java application server;
- Then he deploys Modules on EBX.Platform;
- He also administrates EBX.Platform: he defines permissions, configures some ergonomic behaviour, and so on.
Users
A user, according to his roles, is bound to a set of permissions that allows him to:
- access to Master Data;
- perform actions on Master Data and manage its life cycle by means of branches and versions.
- perform services related to Master Data.
Concepts
Before using EBX.Platform, you need to understand the following concepts:
- Branches (and versions). They define the life cycle of Master Data;
- Adaptation model. It defines a Master Data Model;
- Adaptation instance. It represents an instance of the model that contains Master Data Values;
- Nodes. They are elements of the XML schema hierarchical structure of an adaptation instance.
Branches & Versions
Master Data are frequently based on complex life cycles. For example, a company needs to manage a current version of its Master Data while working on several updates that will occur in the future. In addition, this company needs to keep track of its projects milestones as well.
EBX.Platform 4 introduces a new feature that allows to create and manage multiple "branches" in a Master Data repository. With the use of branches, it is possible to make concurrent updates on a Master Data repository (projects, environments, drafts, ...) and to compare/merge them. In addition, a versioning feature allows to take "snapshots" of branches in order to keep track of the various updates.

Adaptation model
An adaptation model is a data model for a set of Master Data. It is an XML Schema document.
XML Schema is a W3C recommendation that provides a rich and extensible datatypes system. It is used by EBX.Platform for ensuring Master Data consistency and making it easy to manage them. Rich datatypes involve features like:
- Well-defined basic datatypes (simple types : integer, boolean, decimal, date, time, ...);
- The ability to build more complex structures (complex types);
- The ability to define list of items (multiple occurrences);
- Validation constraints (facets): enumerations, minimum/maximum boundaries, ...
EBX.Platform also uses XML Schema extensibility features for other useful informations, like:
- Useful predefined types (locale, resource, html, ...);
- Definition of tables and foreign key constraints;
- Mapping of Master Data to Java beans;
- Advanced validation constraints (extended facets), like dynamic enumerations;
- Presentation information: label, description, data format, error messages, ...
Adaptation instance

An adaptation instance is an instance of an adaptation model. This implies that each "node" in an adaptation instance (Master Data 's value) must conform to its definition in the adaptation model.
EBX.Platform supports an inheritance technology which makes it possible to organize adaptation model instances in a hierarchical way in order to factorize common values, and delegate Master Data management:
- Master Data Value
If a Master Data has no value defined in an adaptation instance, then the value is inherited from its parent recursively. If no ancestor defines a value, then the value is taken from XML Schema default value; - Master Data Access Rights
Master Data Access Rights define how Master Data Management is delegated to users, users' groups, or organizations. An access right is either hidden, read-only or read-write.
Adaptation model instances are persisted in EBX.Platform repository.
Note that adaptation, instance and adaptation instance terms are generally used for the same meaning.
Concepts Importants
Cas d'utilisations et acteurs
L'illustration ci-dessous présente les acteurs impliqués dans le Master Data Management. Il est important de comprendre les rôles de chacun avant d'utiliser EBX.Platform.

Développeur
- Le développeur modélise ses données de référence (Master Data). Un modèle est appelé Modèle d'Adaptation (voir ci-dessous) et est basé sur le standard XML Schema ;
- Il peut ajouter des Services, afin d'intégrer les Master Data avec des systèmes externes ou enrichir les fonctionnalités de l'outil. Par exemple, il ajoute des services d'import et d'export de données. Les services peuvent être interactifs au travers de l'outil EBX.Manager ou programmatiques ;
- Enfin, il package ses modèles et ses services dans un module. Un module est une application Web J2EE qui regroupe le modèle d'adaptation et les ressources associées afin de standardiser et de faciliter le déploiement des projets.
Administrateur
- L'administrateur installe EBX.Platform sur un serveur d'application ;
- Il y déploie les modules ;
- Il administre EBX.Platform : définition des permissions, configuration d'ergonomie, etc.
Utilisateurs
Un utilisateur, selon ses rôles, possède un ensemble de permissions lui permettant :
- d'accéder aux Master Data ;
- d'effectuer un certain nombre d'actions sur les Master Data et de gérer leur cycle de vie au moyen des branches et des versions ;
- d'exécuter des services relatifs aux Master Data.
Concepts
Avant d'utiliser EBX.Platform, il est nécessaire de connaître les concepts suivants :
- Branches (et versions). Elles définissent le cycle de vie des Master Data ;
- Modèle d'adaptation. Il définit un modèle de données qui décrit les Master Data ;
- Adaptation instance. Elle représente une instance du modèle qui contient les valeurs des Master Data ;
- Noeuds. Ils représentent des éléments de la structure hiérarchique du schéma XML d'une instance d'adaptation.
Branches & Versions
Les Master Data suivent fréquemment des cycles de vie complexes. Par exemple, une entreprise souhaite gérer une version courante de ses données, tout en effectuant plusieurs modifications en parallèle qui interviendront dans le futur. De plus, cette entreprise souhaite garder la trace des étapes de chaque projet.
EBX.Platform 4 fournit une nouvelle fonctionnalité qui permet de créer et gérer de multiples "branches" de Master Data dans un référentiel. Grace aux branches, il est possible d'effectuer des modifications concurrentes dans un référentiel (projets, environnements, brouillons, ...) et de les comparer/fusionner. De plus, une fonctionnalité de versioning permet de figer des "images" de branches afin de garder trace des modifications.

Modèle d'adaptation
Un modèle d’adaptation EBX.Platform est un modèle de données défini au moyen du standard XML Schema (recommandation W3C). Chaque nœud du modèle de données correspond à un type de données XML Schema et peut spécifier :
- Des 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 d'éléments (multiple occurrences) ;
- Des contraintes de validation (facets) : enumerations, bornes minimum/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, ...) ;
- Definition de tables et contraintes de clé étrangère ;
- Mapping de données et de Java beans ;
- Contraintes de validation avancées (extended facets), telles que des nomenclatures dynamiques ;
- Informations de présentation : libellé, description, format de la donnée, messages d'erreur, ...
Adaptation instance
Une adaptation instance est une instance du modèle d'adaptation. Chaque noeud de l'instance doit être conforme à sa
définition dans le modèle d'adaptation.
EBX.Platform supporte l'héritage. Ainsi, les adaptations instances d'un même modèle d'adaptation sont organisées sous la forme d'un arbre d'adaptations pour factoriser des valeurs communes et pour déléguer la gestion des master data :
- Valeur des master data.
Si une valeur de master data n’est pas définie dans l’adaptation instance courante alors elle est héritée des ascendants (adaptation instance mère, grand-mère, ...). Si aucune adaptation ascendante ne définit une valeur, alors la valeur est héritée par défaut du modèle de données (XML Schema) ; - Droits d’accès aux master data.
Les droits d'accès à des master data définissent comment la gestion de ces dernières est affectée à des utilisateurs, groupes d'utilisateurs, ou organisations. Un droit d'accès a l'une des valeurs suivantes : caché, lecture seule, lecture écriture.
Les adaptations instances sont persitées dans le référentiel (repository) de EBX.Platform.
Notons que les termes adaptation, instance, adaptation instance et instance d'adaptation sont utilisés indifféremment les uns des autres.
Home > Introduction