Skip to content
Martin O'Connor edited this page Jan 31, 2016 · 5 revisions

Note that this graphical interface provides a very restricted feature set. The Protégé-based Cellfie Plugin provides a much richer interface for managing Mapping Master expressions.

MappingMaster provides a graphical user interface for defining, managing, and executing mappings defined using the MappingMaster DSL.

Mappings defined using MappingMaster's DSL are saved in a mapping file. The process of defining and executing mappings on a particular source ontology in MappingMaster is as follows:

  • Load the source ontology
  • Open the spreadsheet to be used in the mapping
  • Define the desired mappings or load existing mappings from a previously created mapping file
  • Save these mappings
  • Execute the mappings
  • Review the generated OWL axioms and optionally save them into a target ontology.
The MappingMaster tab is designed to support this workflow.

Table of Contents

MappingMaster Tab

The tab is divided horizontally into two areas. The top area provides a spreadsheet preview and allows users to visualize the contents of a spreadsheet. This preview presents a standard tabular preview of a spreadsheet and has a series of tabs to show the contents of individual sheets within the spreadsheet. It does not support editing of the content of the sheets. Buttons allow spreadsheets to be opened and closed.

Here, for example, is a view of the MappingMaster tab with a spreadsheet called MMWikiExamples.xsl loaded.

TODO

The bottom area provides mechanisms to create, manage, and execute expressions in MappingMaster's DSL. It is divided into two subtabs, which are called the Control and Mappings.

The Control subtab allows mapping ontologies to be loaded, saved, and executed. It also presents a diagnostic screen to show the mapping process. Various mapping configuration options can also be selected in this subtab.

MappingMaster Expressions View

The Mapping subtab provides a tabular view of MappingMaster DSL expressions and provides a popup editor for editing these expressions.

Here is a view of this subtab with no loaded expressions.

TODO

Editing a MappingMaster Expressions

Within this subtab, the Add button can be clicked to pop up an expression editor dialog. Within this editor dynamic expansion of terms in the loaded ontology is supported. In this dialog the user can enter their mapping expression.

For example, if the user has the following spreadsheet

TODO

and wishes to enter the following MappingMaster expression:

  Individual: @**(Sale)
   Facts: hasAmount @**,
          hasProduct @B*(Product),
          hasState @*2(State)

and would like that expression to iterate over the cells D4:G6 from 'Sheet1', they can fill in this dialog as follows:

TODO

When this expression is saved, a condensed version of it will appear in a tabular view.

TODO

Executing a MappingMaster Expressions

When all expressions have been added, the user can navigate to the Mappings Control subtab to execute the mappings.

Pressing the "Map" button in this subtab will execute all mappings. If an any errors occur during mapping a dialog box will pop up.

TODO

Saving and Loading Mapping Expressions

The mappings can also be be saved using the Mapping Control tab.

To save a new set of mappings press the "Save As..." button in the "Mapping Ontology" subpanel, whereupon a dialog box will pop up that can be used to name the file.

Existing mappings can also be opened in this subtab by pressing the "Open" button. The "Save" button can be used to save any changes to an open mapping file. An open mapping file can be closed using the "Close" button.