Home > Manager

Models and Adaptations

In order to edit your Master Data, you need first to select a branch and then:

  • select an Adaptation Model on the upper left side.
    The Adaptation Model defines Master Data structures in an XML Schema file.
    Note. The Create... link allows to reference a new Adaptation Model. If you want to design an Adaptation Model, please read the Getting Started chapter of the documentation.
  • select an Adaptation instance.
    An Adaptation instance contains Master Data values. In the screen below, we have one adaptation instance called the Root Adaptation.

Manager

Managing an adaptation instance tree

By default, there is one adaptation instance (values) for one adaptation model (structure).

EBX.Platform allows you to create additional adaptations instances that are derivated from the initial Root Adaptation. Each adaptation instance inherits from its parent. In our example below, we have created an adaptation instance tree that allows to adapt our Master Data to geographical areas and countries.

It means that, for example, France will inherit from Europe values, that will inherit from the Root Adaptation.

Manager

On an adaptation instance tree, available features are:

  • Create a new child adaptation instance
  • Duplicate an adaptation instance
  • Create a new agreement. This is used for right delegation between actors. See chapter Delegate Access Rights.

Manage an adaptation instance

Select an adaptation instance in order to get additional information and edit it.

The panel displays:

  • The reference of the adaptation instance (a unique name)
  • Last update
  • Validation messages (errors and warnings)

On the upper right side, the status of the adaptation instance is displayed:

  • Inactivated. The inactivated state means that the adaptation instance  validation will accept undefined values on "mandatory" elements (elements with minOccurs="1" in XML Schema). This feature allows to use an adaptation instance for internal EBX.Platform inheritance (on the one hand, it holds common values that will be inherited by child adaptations instances, on the other hand, other values remain undefined). 

    It also implies that an inactivated adaptation instance should not be exported to external systems or used by them, since it can be "incomplete".
  • Activated. It means that the adaptation instance is fully validated, by checking that "mandatory" elements are all present. An activated adaptation instance can be used safely by external systems, as soon as its validation is satisfactory.
  • Errors. The adaptation instance has errors and cannot be used.

At the right side, additional features are available:

  • Displays the position of the current adaptation instance in the adaptation instance tree (shows parents and children)
  • Displays the contents of the adaptation instance that has been edited (not the values that inherit from parents)
  • Delete the adaptation instance

Search in data model

You can search in the data model for attributes, tables or columns using the "Search in data model" link next to the root of the current instance. This link will display the banner below at the bottom of the screen.

After clinking on "search" button, the screen below display the search result grouped by tables or by attributes/columns. The search result is also sorted by relevancy and several terms can be entered in the input text field.

Edit adaptation instance information

Click on the Infos tab and edit information of the current adaptation instance: label, owner or description.

 

Modèles et Adaptations

Avant de mettre à jour vos données, il est nécessaire de sélectionner une branche puis de :

  • Sélectionner un modèle d'adaptation en haut à gauche de l'écran
    Les modèles d'adaptation définissent les structures des Master Data dans un fichier XML Schéma.
    Note. Le lien Créer... permet de référencer un nouveau modèle d'adaptation. Il s'agit d'une fonctionnalité réservée aux développeurs en charge de la conception de modèles (voir le chapitre Getting Started).
  • Sélectionner une adaptation instance
    Une adaptation instance contient les valeurs des Master Data. Dans l'écran ci-dessous, nous avons une adaptation instance appelée Adaptation Racine.

Gérer l'arbre des adaptations instances

Par défaut, il existe une adaptation instance (valeurs) pour un modèle d'adaptation (structure).

EBX.Platform permet de créer des adaptations instances supplémentaires qui sont dérivées de l'adaptation racine initiale. Chaque adaptation instance hérite de son parent. Dans notre exemple ci-dessous, nous avons créé un arbre d'adaptations instances qui permet d'adapter nos Master Data à des zones géographiques et à des pays.

Cela signifie, par exemple, que la France hérite des valeurs de l'Europe, qui elle-même hérite des valeurs de l'adaptation racine.

Sur l'arbre des adaptations instances, les fonctions suivantes sont disponibles :

  • Créer une nouvelle adaptation instance fille
  • Dupliquer une adaptation instance
  • Créer un nouvel accord. Cela est utilisé pour déléguer des droits à des acteurs de profil "Distributeur". Voir le chapitre Déléguer des droits d'accès.

Gestion d'une adaptation instance

Sélectionnez une adaptation instance dans l'arbre afin d'obtenir des informations et les éditer.

Le panneau ci-dessus présente :

  • La référence de l'adaptation instance (nom unique)
  • La date de dernière mise à jour
  • Les messages de validation (erreurs et avertissements)

Sur la droite figure le statut de l'adaptation instance :

  • Désactivé. L'état désactivé signifie que l'adaptation instance accepte des valeurs non définies sur des éléments qui doivent être absolument renseignés (éléments "obligatoires" avec minOccurs="1" dans le schéma XML). Cette caractéristique permet d'utiliser une adaptation instance pour l'héritage interne à EBX.Platform (d'une part, elle contient les valeurs communes qui seront héritées par les adaptations instances filles, d'autre part, les autres valeurs restent indéfinies).
    Cela implique également que les adaptations instances inactivées ne doivent pas être exportées vers des systèmes externes ni utilisées par eux, étant donné qu'elles peuvent être incomplètes.
  • Activé. L'état activé signifie que l'adaptation instance est complètement validée, en ayant vérifié que les éléments obligatoires sont bien renseignés. Une adaptation instance activée peut être utilisée sans aucun risque par des systèmes externes, du moment que la validation est satisfaisante.
  • Erreur. L'adaptation instance comporte des erreurs et ne peut être utilisée.

A droite du statut, des fonctions complémentaires sont disponibles :

  • Affiche la position de l'adaptation instance courante dans l'arbre des adaptations instances (montre les parents et les enfants)
  • Affiche le contenu de l'adaptation instance qui a été modifiée (et non pas les valeurs qui héritent des parents)
  • Supprime l'adaptation instance

Rechercher dans le modèle de données

Vous pouvez effectuer une recherche d'attributs, tables ou colonnes dans le modèle de données grâce au lien "Rechercher dans le modèle de données" à côté de la racine de l'instance courante. Cliquer sur ce lien affichera le bandeau de recherche suivant en bas de l'écran.

Après avoir cliqué sur le bouton "Rechercher", les résultats de la recherche seront affichés dans l'écran ci-dessous groupés par tables ou par attributs/colonnes. Les résultats de recherche sont également triés par degré de pertinence et plusieurs termes peuvent être saisis pour une recherche.

Editer les informations d'une adaptation instance

Cliquez sur l'onglet "Information" et éditez le libellé, le propriétaire ou la description de l'adaptation instance courante.

 

Home > Manager