Assumptions

This instructional text relies on certain assumptions about the learner’s background on the topic and working environment:

  • The user is familiar with the basic concepts of SKOS – what it is and its general data model.
  • The user is performing the tasks on a desktop computer. Mobile devices have not been fully tested.

Walkthrough

Upload an existing file

  1. To begin, download and save the JSON-based SKOS file for the LD4PE Topical Index locally to your computer:
    http://ld4pe.s3-website-us-east-1.amazonaws.com/assets/LD4PE-TopicVocab.json
  2. Visit the sandbox SKOS Editor:
    http://ld4pe.s3-website-us-east-1.amazonaws.com
  3. In the top navigation bar, click the gear icon cog icon.
  4. Under, Existing Upload select the Choose existing file button choose file CTA.
  5. From the local file selector pop-up, select the LD4PE file that you downloaded in step #1.
  6. You will see a green successful progress bar displayed once the file has been uploaded.
    choose file CTA
  7. In the top navigation bar, click on Scheme.

Edit a concept scheme

  1. The Scheme page is where a user edits the SKOS Concept Scheme metadata.
    1. You will find this form prepopulated with values that came from the LD4PE Topical Index file that was uploaded.
    2. All properties on the form are organized by tabs. The Concept Scheme form has only one tab, “General”.
    3. The properties which are associated with literal values have corresponding language terms. A language term can be modified by clicking on the term name (en-US) which then exposes an inline dropdown for language selection.
    4. If a property is designated as repeatable, it can be repeated by clicking the corresponding plus icon plus icon - repeatable.
    5. To remove a property entry, click the corresponding “x” icon.remove icon - x
    6. To save any changes, press the Submit
  2. Once you are finished editing the Concept Scheme, click on Concepts in the top navigation bar.

Edit existing concepts

The Concepts page lists all related SKOS Concepts.

  1. The left hand side of the page is where individual Concept metadata is authored and edited. The right hand side of the page displays the hierarchical ordering of related Concepts.  See the below illustration.
    concepts display
  2. Clicking on each Concept in the right hand hierarchy populates the authoring/editing panel on the left.
  3. Concept metadata can be edited and authored similar to the Scheme There are three tabs for Concepts, “General”, “Other Labels” and “Documentation”.  Each tab contains corresponding properties.
  4. To commit a change to a specific Concept, press the Submit

Add a new top concept

  1. From the hierarchy menu, deselect all nodes by pressing the Deselect All button deselect all icon.
  2. Type in a new Label and press the Submit button.
  3. The new Concept is now displayed in the right hand hierarchy as a top level item.

Add a new narrower concept

  1. To add a new Concept as a narrower item, select an existing Concept from the hierarchy.
  2. From the hierarchy menu, press the Add Narrower button add narrower icon - not selected.
  3. The Add Narrower button will now be toggled on add narrower icon - selected.
  4. While the Add Narrower button is toggled on, all new Concepts will be added as narrower items beneath the selected Concept.
  5. Type in a new Label and press the Submit button.
  6. Your new Concept appears as narrower item of the selected Concept.
  7. Repeat as often as necessary to build out narrower items.
  8. When you are finished adding narrower Concepts, turn off the narrower toggle by pressing the Deselect All button deselect all icon.

Delete a concept

  1. To delete an existing Concept (and all related narrower Concepts), select it from the hierarchy.
  2. Press the Delete button delete icon - trash can.

Expand and collapse the concept hierarchy

  1. To expand and show all Concepts and narrower items, press the Open All button open all icon.
  2. To collapse and hide all Concepts but the top level items, press the Close All button close all icon.

Filter the concept hierarchy

  1. To filter the hierarchy by Concept Status select the Filter button filter icon.
  2. Select the Concept Status you wish to filter the hierarchy by.
  3. The hierarchy will refresh showing all matching Concepts highlighted in red.
  4. To remove the filter, press the Filter button again and select the option of Clear Status Filter.

Download the SKOS file

  1. Once you are finished authoring your Concept Scheme and related Concepts, you can download the RDF/JSON version of your work locally by pressing the Download button from the top navigation bar download file icon.
  2. Press the Download button under the Download RDF heading.
  3. When prompted, save your RDF/JSON SKOS encoded file locally.
  4. You may leave the session and close your browser. You can re-upload this file at later date by following steps #2 – #7 under the aforementioned “Upload an existing file” section.