OntoME wiki

http://ontome.dataforhistory.org/

User guide

Work in progress!

Menu overview

Classes menu

Classes list

This list displays all classes created or imported into OntoME with the namespace to which they belong. Click on a label to open the class details. You can filter this list by using the Search box at the top right. The search is performed on labels and namespaces. For example, try entering “CIDOC”. You can adjust the number of lines displayed by using the drop-down menu at the top left.

Classes tree

The tree structure allows you to graphically display the complete class hierarchy. Please note the display is currently not fully functional.

Classes details

[…]

Properties menu

Properties list

This list displays all properties created or imported into OntoME with their domain and range classes, quantifiers and namespaces to which they belong. Click on a label to open the details. You can filter this list by using the Search box at the top right. The search is performed on properties labels, domain and range classes labels and namespaces. For example, try entering “CIDOC”. You can adjust the number of lines displayed by using the drop-down menu at the top left.

Properties tree

The tree structure allows you to graphically display the complete tree hierarchy. Please note the display is currently not fully functional.

Property details

[…]

Namespaces menu

The menu directly displays the list of namespaces created or imported into OntoME with their URI and labels. Click on a label to open the namespace details. You can filter this list by using the Search box at the top right. For example, try entering “CIDOC”.

Namespace details

[…]

Projects menu

The menu directly displays the list of projects. Click on a label to open the project details. You can filter this list by using the Search box at the top right.

Project details

[…]

Profiles menu

This menu directly displays the list of profiles with their project to which they belong. Click on a label to open the details.

Profile details

[…]

Dashboard menu [for registered users only]

This menu displays your account and application preferences.

User guide menu

This menu links to this page

Creating and aligning entities

Classes

Adding a new class

After login, select the ongoing namespace to which you want to add a class.

In the “Classes” tab of the ongoing namespace, check first the class you want to create does not already exist. If this is the case, click on the blue “Add” button to open the add form.

Identifier in namespace: add the identifier of the class in the namespace. For example, “E99”. Note: in most case, you don't have to add an identifier, OntoME will create it for you with the instructions given by the project.

Label: add the standard label in the language you select in the list just below. English is the default language. You can only add one label when creating the class. You can add more labels (standard labels in other languages, projects labels…) once the class is created.

Scope note: type or copy/paste the scope note in this field. Use only plain text format if you copy/paste a note to clean up all unnecessary tags. You can edit your text using the included rich text editor functions. Select the required language in the list below. English is the default language. You can only add one scope note when creating the class. You can add more scope notes in other languages one the class is created.

If you want to add an example, click on “Add an example” below the form. At the moment, you can only add one example when creating the class. You can add more examples once the class is created.

Click on the “Save” button, your class is created!

Editing an existing class

Select a class and switch to edit mode by clicking the large green button on the upper right.

Definition tab

Click on the small green buttons to edit an existing scope note or example.

Click on the blue buttons to add a new scope note or a new example.

Properties tab

Click on the blue buttons to add a new ongoing or incoming property.

Identification tab

Click on the small green button to edit an existing label.

Click on the blue button to add a new label.

Hierarchy tab

Click on the small green button to edit the hierarchical association (only with a parent class).

Click on the blue button to add a new parent class.

Properties

Adding a new property

Check first the property you want to create does not already exist by searching the property list.

If this is the case, select the class to which you want to add a property. Note: you can only add a property to a class that is part of a namespace managed by a project you're belonging to.

In the “Properties” tab, switch to edit mode by clicking the green button on the upper right.

Click on the required blue “Add” button to open the add form for an ongoing property or an incoming one:

Identifier in namespace: add the identifier of the property in the namespace. For example, “P210”. Note: in most case, you don't have to add an identifier, OntoME will create it for you with the instructions given by the project.

Range (for an ongoing property) or Domain (for an ingoing property): select the required class. At the moment, when creating an ingoing property, you can only choose a domain class that is part of the same namespace as the range class.

Quantifiers: four quantifiers are provided: Domain instances min quantifier; Domain instances max quantifier; Range instances min quantifier; Range instances max quantifier.

Label: at the moment, you can only add the ongoing label. Adding the ingoing label will be implemented soon. Select the required language in the list below. English is the default language.

Scope note: type or copy/paste the scope note in this field. Use only plain text format if you copy/paste a note to clean up all unnecessary tags. You can edit your text using the included rich text editor functions. Select the required language in the list below. English is the default language.

If you want to add an example, click on “Add an example” below the form. At the moment, you can only add one example when creating the property. You can add more examples once the property is created.

Click on the “Save” button, your property is created!

Editing an existing property

Select a property and switch to edit mode by clicking the large green button on the upper right.

Definition tab

Click on the small green buttons to edit an existing scope note, example or additional note.

Click on the blue buttons to add a new scope note, a new example or a new additional note.

Identification tab

Click on the pen icon right “Domain and range” to edit the domain, range and quantifiers.

Click on the small green button to edit an existing label.

Click on the blue button to add a new label.

At the moment, you can't edit the domain/range classes.

Hierarchy tab

Click on the small green button to edit the hierarchical association (only with a parent property).

Click on the blue button to add a new parent property.

Hierarchy

Adding a new parent entity

Select the class/property to which you want to add an existing parent class/property. Note: you can only add a hierarchical association to a parent class/property that is part of a namespace managed by a project you're belonging to.

In the “Hierarchy” tab, switch to edit mode by clicking the green button on the upper right.

Click on the blue “Add” button to open the hierarchical association form with a parent entity (corresponds to rdfs:subclassOf/subpropertyOf):

Parent class/property: select the required class/property.

Scope note [Justification]: type or copy/paste the justification note in this field. This note (which can be short) should explain why you chose this hierarchical association. Select the language in the list below. English is the default language. Use only plain text format if you copy/paste a note to clean up all unnecessary tags.

If you want to add an example, click on “Add an example” below the form. At the moment, you can only add one example when creating the association. You can add more examples once the association is created.

Click on the “Save” button, your hierarchical association is created!