Basic-Advanced Mapping

From wiki.eclass.eu
Jump to: navigation, search

Contents

[edit] Mapping Necessity

Since eCl@ss release 7.0, a BASIC Application Class (BASIC AC) and an ADVANCED Application Class (ADVANCED AC) coexist in the same classification system. In order to be interoperable, a mapping is necessary, so that users of the ADVANCED version can interpret the content users of the BASIC version. Vice versa is not possible, as the ADVANCED content cannot be interpreted with the help of the BASIC dictionary. I.e., the user of the ADVANCED version has the possibility to read both versions, the user of the BASIC version can only read the BASIC version.

[edit] Mapping Approach

The content of the BASIC version has therefore to be included in the ADVANCED version and not vice versa. Since eCl@ss release 8.0, each classification class has two application classes: a BASIC AC and an ADVANCED AC. The BASIC version only contains the BASIC AC, the ADVANCED version contains both application classes in parallel.

The complete content of the BASIC AC is therefore mapped to content in the ADVANCED AC:

  • First, the mapping of properties of the BASIC AC is done to the corresponding properties in the ADVANCED AC, where possible
    • The path of the [BASIC AC ID] - [Property1 ID] is mapped to the path of the [ADVANCED AC ID] - ([Aspect1 ID]) - ([Block1 ID]) - [BlockN ID] - [Property 1 or Property2 ID]
    • Preconditions for the mapping is identical information in the following attributes
  • Second, all remaining properties of the BASIC AC that could not be mapped will be copied into the ADVANCED AC as "flat" properties, i.e. not structured in aspects or blocks
    • Plus, their paths are then mapped from [BASIC AC ID] - [Property1 ID] to the path of the [ADVANCED AC ID] - [Property1 ID]


The following image shows how it works:

MappingBasicAdvanced.jpg


The following example shows how differently the BASIC AC ("flat") and the ADVANCED AC (structured) are designed and how the content can be mapped:

MappingBasicAdvancedExample.jpg


[edit] Mapping File

In the mapping basic ➡ advanced file for each property in its context in the basic model the corresponding path in the advanced model of the same release is given.

Note that while the paths are written down in the form basic to advanced, also the opposite direction applies (as the mappings between basic and advanced model were made strictly 1:1).

The same explanation on paths applies as for the transaction update file.

XML Schema 1.0 (until Releases 7.1) is here.

XML Schema 2.0 (since Release 8.0) is here.

C7.png
Figure 1 – Basic Advanced Mapping eCl@ssXML-1.0

[edit] Mapping Handling in the CDP

This paragraph explains how to request canges in the mapping in the eCl@ss COntentDevelopmentPlatform (CDP).

[edit] Preconditions

User is authenticated.

ONLY the users that have the rights Mapping Manage will be able to create and edit Mappings.

ALL Users will have the rights Mapping Read, thus will be able to view Mappings.

[edit] View Mapping

All users are able to view available mapping via tab Basic-Advanced Mapping.

Step 1: To view the available mapping of a PR, click on the [Basic-Advanced Mappings] tab:

Mapping Fig01.JPG

Step 2: Click the Identification link and the system will display the details:

Mapping Fig02.JPG


[edit] Create Mapping

Basic/Advanced mapping means linking two properties: a source property present in a basic AC and a target property from an advanced AC.


Step 1: Access the function via User -> [Basic/Advanced AC Mapping] -> [Create mapping]:

Mapping Fig03.JPG

Step 2: System displays tree view and a hint regarding action to be performed:

Mapping Fig04.JPG

Step 3: In tree view, select the source property of the Basic AC. Click the link of the source property so that its details are displayed on the left hand details panel, then select it by ticking its checkbox:

Mapping Fig05.JPG

Step 4: Continue by selecting the entire path of the source property, by ticking the checkboxes of the structural elements that make up the path. Make sure that the property remains selected, i.e. its details are still being displayed on the left hand panel:

Mapping Fig06.JPG

Step 5: To select the target property, expand the node of the Advanced AC and browse to the corresponding property and tick the checkboxes forming the path:

Mapping Fig07.JPG


Step 6: click button [Select]


Observation: Only properties pertaining to the same data type can be mapped. Otherwise, the system will not allow mapping to be carried out:

Mapping Fig08.JPG

Step 6: The system displays the Set Path Equivalency dialog. Click [Save].


Mapping Fig09.JPG

The system returns to the initial view and displays the corresponding message.


[edit] Mapping Mass Data Correction Tool

Users with role “Business Rule Checker” runs Business Rule “Basic used property mapping in advanced AC”, under menu entry [User] / [Reports]. In order to start the selected Business Rule, user presses toolbar button “Start Validation”.

Basic-ADV Mapping Tool 1.png

Provided that basic PRs without mappings exist, user shall further on receive an additional report, in Excel format, containing all possible mapping suggestions of those PRs in the advanced side.

Basic ADV Mapping Tool 2.png

Based on received Report, user chooses from among the suggestions for each source AC-PR exactly one valid mapping and saves the file for a CR import. Suggestions that shall not be used, need to be deleted accordingly. After the Import file has been prepared, user with “Office Chair” role assigned, selects menu entry [User] / [Mappings] / [Browse] in order to organize CR/CP XLS Transformation Mapping Import.

Basic ADV Mapping Tool 3.png

Basic ADV Mapping Tool 4.png

After Import has been organized, system creates Path Equivalency CRs Based on the Import file loaded by user. Also, user receives an import report. Report contains an extra commented Excel file, with status of each mapping line.

Basic ADV Mapping Tool 5.png

This imported CRs/CPs will be processed during next release post-processing phase and will be placed inside the currently configured mapping plan of that release.

[edit] Manage Mappings

The function is accessible via User -> [Basic/Advanced AC Mapping]. Click [Manage mapping] and the system displays the list of mappings as change processed:

Mapping Fig10.JPG

[edit] View Details of Mapping

In the list of mappings (change processed), select the desired mapping by clicking on it. System will display the details page of the mapping change processed:


Mapping Fig11.JPG


[edit] Lock Mappings

Locking a mapping means that this mapping is set from status New in status Released and thus it cannot be changed anymore.


Step 1: Tick the checkbox the respective mapping in status New and click [Lock mappings]:

Mapping Fig12.JPG

The system displays the corresponding message and the status of the mapping changes to Released:

Mapping Fig13.JPG


[edit] Unlock Mappings

Unlocking a mapping means that this mapping is set from status Released in status New.


Step 1: Tick the checkbox the respective mapping in status New and click [Lock mappings]:

Mapping Fig14.JPG

The system displays the corresponding message and the status of the mapping changes to New:


Mapping Fig15.JPG


[edit] Delete Mappings

To delete a mapping, tick the checkbox the mapping to be deleted and click [Delete]. The system deletes the mapping and displays the corresponding message.

Personal tools