Concepts and XML Schema Prerequisites

An adaptation model is a data model for a set of Master Data. It is an XML Schema document and as such provides a rich typing system that is exploited by webMethods MDM for ensuring Master Data consistency and making it easy to manage them. Rich typing involves 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, ....

webMethods MDM also uses XML Schema extensibility features for other useful informations, like :

• Useful predefined types (locale, resource, html, ...) ;
• Definition of tables and integrity controls ;
• Mapping of Master Data to Java beans ;
• Advanced validation constraints (extended facets), like dynamic enumerations ;
• Presentation information : label, description, data format, error messages...

References

For an introduction to XML Schema, we recommend the W3School web site.

W3C specification documents: XML Schema Part 0: Primer, Part 1: Structures, Part 2: Datatypes.

Links between adaptations and adaptation models

An adaptation model is registered in webMethods MDM by its root adaptation. This root adaptation is created with webMethods Master Data Manager, by indicating the XML Schema URI.

In order to create a root adaptation, log in webMethods Master Data Manager - Provider profile:

• http://localhost:8080/mdm/
• Default login: provider
• Default password: provider

On the left side of the screen, click on the create link. You have to type a valid XML Schema address. The URI can be absolute or relative.

You must then type a name for the root adaptation. This name identifies the adaptation in the current webMethods MDM repository, in a unique and persistent way. It will also identify it in the webMethods MDM repositories where the adaptation will be deployed.

Pre-requisite for XML Schemas

In order to be accepted by webMethods MDM, an XML Schema must include a global element declaration that have the attribute mdm:access="--".

Conventions

By convention , namespaces are always defined as below:

Schemas with reserved names

Several schemas have reserved names on webMethods MDM.

We considered as reserved every reference to another schema (attribute schemaLocation of a tag import, include or redefine) that ends with one of the following strings:

• common_1.0.xsd
• org_1.0.xsd
• coreModel_1.0.xsd
• session_1.0.xsd

Those files correspond to the schemas provided for the module “mdm-root”, path /WEB-INF/mdm/schemas. The attribute schemaLocation can reference those files at this location or reference a copy, if the file name is the same. This is useful if you want to avoid the module dependency to “mdm-root”.

For security reasons, webMethods MDM takes back an internal definition of those schemas (to avoid any modification).

Concepts et prérequis XML Schema

Un modèle d’adaptation webMethods MDM 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 , ....

webMethods MDM 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 de contrôles d'intégrité ;
• 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...

Références

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

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

Lien entre adaptations et modèle d'adaptation

Un modèle d'adaptation est référencé dans webMethods MDM par son adaptation racine. Cette dernière est créée à l'aide de l'outil webMethods Master Data Manager en indiquant l'URI du schéma XML.

Pour créer une adaptation racine, connectez vous à l'outil webMethods Master Data Manager en profil Fournisseur :

• http://localhost:8080/mdm/
• Default login: provider
• Default password: provider

En dessous de la liste à gauche de l'écran, cliquez sur le lien créer... Vous devez saisir l'adresse d'un schéma XML. L'URI peut être absolue ou relative.

Vous devez ensuite saisir un nom pour l'adaptation racine. Ce nom identifie de manière unique et persistente l'adaptation dans le référentiel webMethods MDM courant. Il devra aussi l'identifier dans les référentiels webMethods MDM où elle sera éventuellement déployée plus tard.

Enfin, vous pouvez modifier l'intitulé de l'adaptation racine qui apparaît dans webMethods Master Data Manager. Par défaut, le nom saisi précédemment est utilisé.

Prérequis pour XML Schemas

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

Conventions

Par convention, les espaces de namespaces 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 webMethods MDM.

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 “mdm-root”, chemin /WEB-INF/mdm/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 “mdm-root”.

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