User Guides
In this section you will find a variety of user guides which explain how to use Mauro Data Mapper. You don't need to follow them all in sequence - just dive into a guide that interests you!
Our current User Guides:
- Create a Data Model
- In this user guide we explain how to use the web interface to create a new folder and a new Data Model from scratch, including selecting some default Data Types.
- Organising Data Models
- This user guide summarises how to organise Data Models including rearranging folders, adding classifiers and selecting favourites.
- Finalising Data Models
- This user guide explains how to finalise catalogue items such as Versioned Folders and Data Models.
- Branching, versioning and forking Data Models
- This user guide explains how to create a new draft of a Finalised Data Model by either creating a new Version, a new Branch or a new Fork. It also explains how to view a merge graph of a model.
- Merging Data Models
- This user guide explains how to merge Data Models including comparing and committing changes as well as how to successfully resolve conflicts.
- Document a Health Dataset
- This longer guide explains how to add structure to your Data Model such as incorporating Data Classes and Data Elements.
- Bulk editing
- This user guide will explain how to modify multiple catalogue items at once using Profiles.
- Exporting Data Models
- This user guide will explain how to export a Data Model using a variety of exporters including XML, JSON, XML Schema, Grails and Excel.
- Import a Data Model from Excel
- This guide presents the steps for uploading a Data Model from an Excel Spreadsheet, and explains how you can use the import / export capabilities to 'round-trip' documentation with external users.
- How to search
- In this guide we walk you through the searching capabilities of Mauro Data Mapper, including the different search types, the syntaxes used as well as tips on how to conduct specific searches.
- Semantic links
- This is a short guide which explains the steps required to add, edit and delete Semantic links.
- Publish/Subscribe
- This guide explains how to connect to another Mauro Data Mapper instance to consume its Atom feed of Federated Data Models. Each Federated Data Model can then be subscribed to for use in your own Mauro Data Mapper instance.
- User Profile
- This short guide explains how to update your User profile within the Mauro Data Mapper web interface and how to change your login password.
- Admin functionality
- This user guide will walk you through all the options and settings that are available to administrators on Mauro Data Mapper.
- User permissions
- This user guide explains the multiple levels of access to catalogue items and adminstration supported in Mauro Data Mapper.
- Feature switches
- This user guide will walk you through feature switches that allow administrators to enable or disable certain Mauro features.
- Dynamic Profiles
- This user guide walks through the steps for creating and managing dynamic profiles. These are profiles which are defined by a model elsewhere in the system.
- Digital Object Identifiers
- This user guide explains how to set-up the Mauro Digital Object Identifier plugin to allow you to use, edit and remove DOI profiles. You will also find out how to create, submit and retire profile names.