Please see the Asset Collection Guide for all the general features of asset collections such as import/export, editing, user permissions, reports and settings. Specific taxonomy only information is contained within this page.

In the current EDG release, there are two choices for editors. This documentation focuses on the “new editor”. Please see the previous documentation at doc.topquadrant.com for the “old editor”.

Working with Taxonomies

 

A taxonomy is an asset collection based on SKOS, the W3C standard ontology designed for representing taxonomies, thesauruses, and subject heading schemes.

In EDG, Taxonomies are SKOS-based datasets, whereas other datasets typically do not include SKOS, although they may. When a new taxonomy is created, EDG will automatically include in it SKOS ontology. SKOS provides a definition of concept classes (types) and their properties e.g., fields like preferred and alternative labels, various notes and relationships.

Every taxonomy is expected to have at least one concept scheme that identifies “top concepts” in a scheme.  A taxonomy can have multiple concept schemes; however, a better practice can be to use a single concept scheme per individual taxonomy. Since taxonomies can, as all asset collections, be included into each other, a taxonomy with multiple concept schemes can be assembled through inclusion of several single concept scheme taxonomies.

Use of the pre-defined SKOS fields can be configured locally for a given taxonomy, globally for the entire EDG or for a subset of taxonomies e.g., all taxonomies associated with some business area. You can disable fields for all or a group of taxonomies by taking advantage of the Ontology modeling functionality in EDG. Rules and constraints specified by SKOS are also included by default as well as other common constraints for taxonomies e.g., a concept must have a broader parent or be a top concept of some scheme. If desired, they can be disabled. 

Ontologies are also used to define custom, non-SKOS properties for taxonomy concepts and to define specializations (sub classes of concepts). If you customize SKOS, you need to make sure that the ontology with your customizations is included in the taxonomies these customizations apply to. There is a system-wide setting your EDG administrator can use to ensure that the customized model is included in every new taxonomy. If customization only applies to a subset of taxonomies, creator of a taxonomy can use the Includes dialog to include the desired customized model.

Taxonomy Editor

 

For taxonomies, the default editor layout is the Taxonomy Concepts Panel tree view and the details Form Panel. Just like the other collection editors, the UI for this editor can be customized and arranged and comes with many panels and layouts. For more information on using EDG editors please see Asset Collection Guide – Editor

 

 

Taxonomy Concepts Panel

This panel displays taxonomy concepts organized into concept schemes. It also lets you create new concepts and schemes.

A concept scheme provides an additional organizing context for a collection of concepts in a taxonomy. A concept is said to belong to a concept scheme if it is a child (directly or indirectly) of a top concept. Once a scheme is created, top concepts are added to it. A concept must belong to at least one concept scheme in order to be displayed in the Taxonomy panel, but it can also belong to more than one, if needs be.

You can create concept schemes and concepts using icons positioned in the header of the panel.

 

 

Taxonomy Concept panel has a quick search field. It lets you quickly look up concepts of interest. Lookup will only search for concepts presented in this panel i.e., those that are connected to concept schemes. The icon to the right of the Quick search field will switch from autocomplete lookup based on the preferred label to the full text search across all string properties.

If you right click on a concept scheme in this panel, EDG will display the right click menu with the following options.

 

Create Top Concept

Lets you create a top concept for a scheme.

 

Add to Asset List

Adds selected class to a sharable asset list. Asset lists are available in the Asset List Panel and used for bookmarking or bulk actions.

 

Add to Basket

Basket is similar to Asset List but for all of EDG. It is located in the left navigation menu. Here you create create new versions of collection or bookmark assets or collections. This is per user and not shared. 

Open on new Form

This opens the Form Panel for the selected class.

 

Start Workflow

Starts a workflow for this selected class in this collection.

 

Explore Menu

Provides access to the following operations:

  • Find Similar Assets … – will open a search dialog to select similarity criteria
  • Find Usages in other Asset Collections… – Shows references to this asset in other asset collections that you have access to
  • Show Affected Workflows … – will check if any active workflows contain any changes to the selected class
  • Show Comments … – will let you view already created comments for the selected class and will let you create new comments
  • Show Tasks … – will let you view already created tasks for the selected class and will let you create new tasks
  • Show NeighborGram – will display NeighborGram panel for selected class
  • Show Relationship Tree – will display Relationship Tree panel for selected class

Modify Menu

Provides access to the following operations:

  • Clone … – will clone the selected scheme. All top concepts associated with the selected scheme will also be associated with the clone. See Cloning and Replacing for more details.
  • Merge.. – Replaces the ID (URI) of an asset and moves all information about it that exists in the current asset collection to the new ID. See Merging below for details before using this operation. 
  • Replace … – will replace selected scheme. See Cloning and Replacing for more.
  • Delete – after confirmation, will delete the selected scheme. Deleting a scheme will not impact any concepts. See deleting an asset for details.

If you right click on a concept in this panel, EDG will display the right click menu with the following options.

Create Narrower Concept of …

Lets you create a “child” concept of the selected concept.

 

Add to Asset List

Adds selected class to a sharable asset list. Asset lists are available in the Asset List Panel and used for bookmarking or bulk actions.

 

Add to Basket

Basket is similar to Asset List but for all of EDG. It is located in the left navigation menu. Here you create create new versions of collection or bookmark assets or collections. This is per user and not shared. 

Open on new Form

This opens the Form Panel for the selected class.

 

Start Workflow

Starts a workflow for this selected class in this collection.

 

Explore Menu

Provides access to the following operations:

  • Find Similar Assets … – will open a search dialog to select similarity criteria
  • Show Affected Workflows … – will check if any active workflows contain any changes to the selected concept
  • Show Comments … – will let you view already created comments for the selected concept and will let you create new comments
  • Show Tasks … – will let you view already created tasks for the selected concept and will let you create new tasks
  • Show NeighborGram – will display NeighborGram panel for the selected concepte
  • Show Relationship Tree – will display Relationship Tree panel for the selected concept
  • Export Hierarchy to Spreadsheet – will export the tree branch starting with the selected concept into a spreadsheet format using columns to represent levels of hierarchy. This will open in your browser, save to a file and then open in a spreadsheet to convert.

For example:

Modify Menu

 

Provides access to the following operations:

  • Create multiple concepts …- will let you enter names of multiple concepts, creating them in one step.
  • Clone  … – will clone the selected concept. All children of the selected concept will be children of the clone.
  • Clone with descendants … – will clone the entire tree branch.  See Cloning and Replacing Assets for more.
  • Replace  … – will replace selected concept. See Cloning and Replacing Assets for more.
  • Refresh details of remote values … – this option will appear if a concept is mapped to a resource from a remote Knowledge Graph and some of its value are derived from data in a remote graph. It will refresh derived values.
  • Suggest matching WIkidata resources … – this option will appear if a concept type is mapped to a remote SPARQL endpoint. It will return resources from a remote Knowledge Graph that are likely matches to the selected concept.
  • Delete – after confirmation, will delete the selected concept. Children will not be impacted.
  • Delete with descendants – after confirmation, will delete the entire tree branch. Children will be deleted with the exception of children that have multiple parents and one of the parents is outside of the branch.

This panel has no Settings menu.

Merging

When you merge two concepts or concept schemes, you’re deleting one and moving its property values to another. For example, let’s say you have a concept with a preferred label of “Caribbean” selected on the concept hierarchy, and it has a scope note value of “Does not include Greater Antilles”. To merge it into the “West Indies” concept, transferring the property values to it, select Caribbean on the Concept Hierarchy and then select Merge into concept…” from the gear menu at the top of the form. Enter “West Indies” in the dialog box that displays and press Enter.

When you are finished, the Caribbean concept will no longer be there, and the West Indies one will have a scope note value of “Does not include Greater Antilles” (if it didn’t already) as well as any other values formerly assigned to Caribbean. Also if Caribbean was used by some other vocabulary (including transitive imports and usages in Tagger graphs) then those references there are also updated. One exception is the Caribbean concept’s preferred label value of “Caribbean”, which instead of becoming an additional preferred label for “West Indies”, will become a new alternative label for it, because a concept should not have two preferred labels in the same language.

From version 5.2, merge also has a transitive side-effect such that if Concept A is merged into Concept B and A was used by some other vocabulary (including transitive imports and usages in Tagger graphs) then those references there are also updated.
Note that:
1) This does not happen for working copies because by default they are not committed, so the changes cannot be propagated.
2) The changes to other graphs will not show up in the change history.

 

Replacing the ID (URI) of an asset will move all information about it that exists in the current asset collection to the new ID. This includes any references to the asset. If no other collection refers to this asset then this operation will effectively delete the “old” ID. However, any information about this asset contained in other collections will continue to refer to the “old” ID. You should proceed with this operation only if all information about the asset is contained within this collection, or you understand the implications of this change and, if needed, are prepared to adjust other asset collections.

Cloning and Replacing

Clone and Replace operations are available under Modify menu.

Clone creates a copy of the selected Asset. The label of the clone (preferred label in case of SKOS Concepts) will be set as the label of original asset with “ Copy” post-pended to it.

Replace, creates a clone of the selected asset using URI that you will provide and then deletes selected asset. One difference with the clone operation above is that the label will be the same as the label of the original asset, “ Copy” will not be postpended. You can use this operation if you decide that you need to modify URI identity of a resource. EDG will automatically adjust all incoming and outgoing references. However, it will do so only for the currently selected asset collection. Other asset collections will not be updated. If they contain references to the asset you are replacing, you will see broken links. To understand possible impacts of delete operations see Deleting Assets section.

Deleting Assets

You can delete assets directly in an asset collection or you can start a workflow and delete in the working copy of the collection that is managed by the workflow. Irrespective of the choice, delete options are the same. See Starting a Workflow for the information on how to start a workflow.

With asset information displayed on a form, click on Modify button and select Delete.

You can also select Modify>Delete by using a right click in the Classes, Node Shapes and Taxonomy Concepts panels.

For Taxonomy Concepts only, in addition to Delete, there is an option to Delete with descendants. This deletes an entire tree starting with the selected concept.

Since asset collections in EDG can include each other by reference, some care needs to be taken when deleting assets. Delete operation only deletes references to the deleted asset that exist in your current asset collection. Consider the following scenario:

  • Taxonomy 1 defines Concept A
  • Taxonomy 1 also defines Concept B making it a child of Concept A
  • Taxonomy 2 includes Taxonomy 1
  • Taxonomy 2 defines Concept C making it a child of Concept A
  • You go to Taxonomy 1 and delete Concept A. Concept B’s reference to A will be removed, but Concept C’s reference to A will stay. Now concept C has a broader relationship to an undefined concept

Running Problems and Suggestions report on Taxonomy 2 will report the issue and assist you in removing such references.

Similarly, deleting a class (asset type) from an ontology will not remove class instances (assets of a given type) that may be stored in another asset collection. It will make them members of undefined class. Deleting a property does not delete property values that are held in another asset collection.

Running Problems and Suggestion report will help you identify and fix these issues. Further, by going to the Settings>Included By you will see all asset collections that include your selected collection. You can then go to them and use References panel to identify what may be referring to a resource you are planning to delete.

 

Taxonomy Specific Import Considerations

In addition to generic import options, there is a taxonomy-specific import option that lets you import MultiTes files.

When importing RDF files into a Taxonomy, EDG will perform some transformations:

  • “Narrower concept” relationships will be used to generate inverse “broader concept” relationships
  • A Concept scheme will be added if none exists. Concepts without broader parents will be made into top concepts of the scheme

This is done to ensure that such concepts are visible in the Taxonomy Concepts panel.

Hierarchical spreadsheet importers will also create concept schemes.

 

Taxonomy Specific Exports

In addition to generic exports options, there are several taxonomy-specific export options.

 

Taxonomy Specific Edit Operations

In addition to create operations described in the Create New Assets and Clone and Replace sections, new taxonomy concepts can be created as follows:

  • Select a parent concept, then select Modify>Create multiple concepts… Create multiple instance dialog lets you enter labels for new concepts – one label per line. All labels must be in the same language.
  • Select a parent concept, then select Modify>Clone with descendants … This will clone an entire tree starting with the selected parent concept.

Also see Taxonomy Concepts Panel for additional information.

When you create a child concept, you may want its type to be based on the type of a parent concept. For example, you may want to make sure that all children of assets of type Continent are Countries. To get this behavior, you need to specify a constraint on the ‘narrower’ relationship in the ontology your taxonomy is based on. The constraint must be created on the inverse of skos:broader. For example:

  • Go to the Geo Ontology and select Continent. Then, create a property shape for inverse of skos:broader. Do not modify the existing shape for inverse of skos:broader declared at Concept. You want to create a new one, specifically for the Continent
  • In the create dialog, enter Country in the class field

Now, when creating a child of a continent, you will no longer be asked to select a type, it will be automatically created as a Country.

 

Taxonomy Specific Reports

 In addition to the general reports, there are two specialized reports for taxonomies:

  • Spell Check Report
  • Taxonomy Statistics Report

Visualizations

 

Displaying Relationship Trees

EDG’s taxonomy panel displays a hierarchical tree using “broader” relationships. For example, if “dog” had a broader relationship of “mammal,” then the hierarchical tree would show “dog” as a child node of “mammal” on the tree. You can also display a horizontal graphical tree using any relationship property you like by selecting Explore > Display relationship tree from Form Panel on the editor. EDG will then show a drop-down box that lets you select from all of the relationship properties used with the selected resource, and after you select one it renders a tree with all the concepts associated with that resource by that property. If those concepts have their own values for that property, EDG will display then with a colored circle that you can click to see those values.

For example, in the following, someone has picked Display relationship tree after selecting Algeria in the sample Geography vocabulary and then selected the “has related” relationship. Clicking the colored circle with “North Africa” turned that circle white and expanded the tree to show its own “has related” properties, and then clicking the colored circle for “Middle East” did the same for that concept.

The filled circles for Asia and Egypt show that clicking them would display additional values branching off from those.

To make room, you can collapse any expanded branch. For example, clicking the white circle with “Middle East” above would turn the circle blue and hide its branches.

 

Displaying a NeighborGram of All Concept Relationships

You can display a graph diagram of all related concepts by selecting  Explore > Display NeighborGram from the Form Panel.

The NeighborGram  will open in a new browser tab. It has two panel display – navigable graph-like diagram on the left and a form showing all the information about the selected concept on the right. This option is available for classes (concept types) as well as concepts. 

SKOS-XL Taxonomies

 

SKOS-XL (SKOS eXtension for Labels) is a part of the W3C SKOS standard that lets you treat labels as resources in their own right, with their own metadata. This may be useful for adding provenance data or information for text mining tools about how to use specific labels. TopBraid EDG lets you use SKOS-XL to add any metadata you like to alternative and hidden labels. Starting with release 6.3, EDG also lets you add metadata directly to links between a concept and its textual labels. This may serve as an alternative to SKOS-XL – an alternative that supports capture of label metadata without the added complexity of managing labels as independent resources.

To activate the SKOS-XL support for a particular taxonomy, select Settings > Includes and check SKOS XL SHACL Shapes to include SKOS-XL. Then, when you edit concepts in that taxonomy, the edit forms will let you add existing label resources as the values of alternative and hidden labels. Once a label’s data has been entered, it will appear like any other relationship property value on the relevant form: as a hypertext link. You will be able create new labels using “Create New” as part of the editing concept information. Or, alternatively, you can create and work with label resources independently from concepts. To do so, switch to the Search panel (or Search layout) and select Label from the asset type navigator.

Note that SKOS-XL SHACL Shapes only provide skosXL:altLabel and skosXL:hiddenLabel relationships so that you can create separate label resources for them. A concept still needs to have a textual label. This means that even with SKOS-XL, TopBraid EDG will continue to use skos:prefLabel as a direct label of a concept. EDG uses resource’s textual label (either skos:prefLabel or rdfs:label) as a display name consistently across all the UI. Further, TopBraid EDG creates text indexes of concepts (and other resources) to facilitate auto-complete and search. The indexing process uses resource’s label.

 

SKOS-XL defines only one property for the Label class – literal form. As previously mentioned, EDG uses either skos:prefLabel or rdfs:label as resource names. There is a special “hard coded exception” from this rule for the SKOS-XL Label resources. Even-though the create dialog for them says “label”, the value entered as a label is stored in the skosXL:literalForm property. EDG will understand that for Label resources this property is used as their name. To associate a new property with a SKOS-XL label use the same Ontology customization capabilities as you would use to create new properties for concepts.

Transform SKOS-XL

On the Transform tab of Taxonomies you will find an option to convert SKOS-XL labels to reified values. This feature will convert any instances of skosxl:Label to values of their corresponding direct SKOS properties:

  • skosxl:prefLabel is converted to skos:prefLabel
  • skosxl:altLabel is converted to skos:altLabel
  • skosxl:hiddenLabel is converted to skos:hiddenLabel

If the skosxl:Label has other properties than skosxl:literalForm and rdf:type then these values will be converted into reified statements. For example, if your skosxl:Label instances have values for ex:isAbbreviation and skosxl:prefLabel was used to point to the label, then there will be a reified triple attached to the skos:prefLabel statement to store these additional values. The ontology should define suitable node shapes that define the properties such as ex:isAbbreviation for display and editing purposes, and attach them to the property shapes of properties such as skos:prefLabel using dash:reifiableBy

Optionally, the original URIs of the skosxl:Label instances will be stored as reified triples and the property dash:uri which can then be used to restore the original skosxl:Label instances as part of an exporter.