Knowledge Model Editor Tutorial

This Knowledge Model Editor Tutorial will help you to create your own Knowledge Model step by step.
This tutorial has been made for the previous version of DSW and may differ in some details.
The KM (Knowledge Model) Editor is used for creating and updating Knowledge Models. This tutorial will go through the steps of creating a new KM from scratch.
Create a new Knowledge Model
1.Click on “KM Editor” in the left-hand menu of the wizard
2.Click “Create” on the top to the right
3.Fill the fields with appropriate Name (e.g. ‘KM Editor Test Model’) and Knowledge Model ID (e.g. ‘test-model’). The ID can contain alphanumeric characters and dash but cannot start or end with dash. Leave Parent Knowledge Model as is (–). Note: If you want to update or reuse an existing model, this is where you select which one.
4.Click on “Save” button
Create a chapter
Once you have created a new KM, it’s time to fill it with chapters (i.e. sections; think of them as headers of your model).
1.Write a name of the KM (e.g. ‘My test KM’)
2.Press + Add chapter
3.Write a Title (e.g. ‘Introduction’) and Text (e.g. ‘Background information’) for the chapter. Note: The Text field is where you add a description of what the chapter will contain questions about. There are two tabs, ‘Editor’ and ‘Preview’, since you can use Markdown (https://www.markdownguide.org/basic-syntax/) to format the text and check the result in ‘Preview’.
4.Press +Add question in order to create a question
Notice the grey area which gives an overview of your KM. Use this to navigate between the different parts. Whenever you want to see the result of an addition, click on another part in the KM overview (at this stage this would be the “parent” we named ‘My test KM’.
Could not load image
../_images/overview_dsw.png
Add a question
Questions can be of different types:
Options
List of items
Value
Integration
Let’s create some questions of each type to demonstrate: Value
1.Select Value as Question Type
2.Write ‘Project title’ in the Title field
3.In the Text field, write ‘Please enter the title of your project’, as an instructive text
4.Use When does this question become desirable? to indicate in which phase of the project a question should be answered, e.g. Before submitting the proposal.
5.Value type can be String, Date, Number, or Text, select Text
List of items
1.Click on Introduction in the grey overview area of the editor
2.Press +Add question in order to create a new question
3.Select List of items as Question Type
4.Write ‘Project members’ as Title
5.Write ‘Please specify the researchers participating in the project’ as Text
6.Select Before submitting the DMP as When does this question become desirable?
7.In the Item Template, click on +Add question
1.Set the Question type to Value
2.Write ‘Name’ as Title
3.Back to one level up by clicking on Project members in the grey overview part of the editor
4.Scroll down and click on +Add question in the Item Template
5.Set the Question type to Value
6.Write ‘Email’ as Title
Options
1.Click on Introduction in the grey overview area of the editor
2.Press +Add question in order to create a new question
3.Select Options as Question Type
4.Write ‘Research field’ as Title
5.Write ‘Please select the research field for this project’ as Text
6.Click on +Add answer
7.Write ‘Life science’ as Label
8.Write ‘Your project is likely going to produce a lot of data, a full data management plan will prepare you for the various challenges this will entail’ as Advice
9.Click on the Research field in the grey overview area, scroll down to Answers and click on +Add answer
10.Write ‘Other’ as Label
11.Scroll down to Follow-up Questions and click on a +Add follow-up question
12.Select Value as Question Type
13.Write ‘Which other research field?’ as Title
14.As Value Type, select Text
Save
Whenever there are changes not saved in the KM, the clickable options “Discard” and “Save” are visible in the top row of the wizard. Click on “Save”.
Notice that this automatically leads you to the top level of the KM Editor, outside your KM. If you position the mouse on your KM (‘Test of KM Editor’) you see the options of Open Editor, Publish and Delete. Click on Open Editor in order to continue editing the KM.
Add Reference and Expert
All question types have the possibility of adding references and experts, to be used for adding additional information and people to contact in order to get help, respectively. Let’s add one of each:
1.Click on the arrow at Research field in the grey overview area, and scroll down to References
2.Click on +Add reference
3.Write “https://en.wikipedia.org/wiki/List_of_life_sciences” as URL
4.Write “List of Life sciences” as Label
5.Click on Research field again and then click on +Add reference
6.Write “My science for life guru” as Name
7.Write “[email protected]” as (the fake) Email
8.Click on “Save” in top right corner, position the mouse on your KM (‘Test of KM Editor’), and click on Open Editor
Change the order of questions
It is possible to rearrange the order of questions only if they are on the same ‘level’ (but not between levels at the moment of writing this tutorial). Let’s try:
1.Click on Introduction and scroll down to Questions. The three questions created are all on the same level.
2.Position the mouse on the grey area next to Research field, hold down the left button of the mouse and drag-and-drop above Project title
If and when the need arises to move a question to another level/group of questions, there are currently two alternatives:
Rewrite the question in the new position, or
Export the Knowledge Model and edit the resulting json file in an appropriate editor, and then import it again
Preview
In order to see what the resulting questionnaire will look like, you can click on “PREVIEW” on the top row of the wizard. When you are finished just click on KNOWLEDGE MODEL on the top row, to return to editing mode.
Tags
Also on the top row of the wizard, is the “TAGS” viewer function. Tags can be used to mark questions of interest to certain stakeholders when only a subset of the questions are of interest. We have not defined any tags yet, so let’s do that:
1.Click on ‘My test KM’ in the grey overview area, and scroll down to Tags
2.Click on + Add tag
3.Write ‘Library’ as Name
4.Pick a color by clicking on one of the colored squares
5.Expand Introduction and click on Project title in the grey overview area
6.Scroll down to Tags and mark this question as of interest to the library by clicking the check box
7.Do the same for Research field
8.Click on “PREVIEW” and notice that all questions are visible. Select the Library tag, by clicking in it’s check box. Now only the two questions Project title and Research field are visible.
Publish
When you are happy with the content and look of your KM, it is time to make it available for people to use it (either as a start for their own KM or for users to fill it out in form of so-called Questionnaires):
1.Click on “KM Editor” in the leftside menu
2.Position the mouse on your KM (‘Test of KM Editor’) and click on Publish among the alternatives that becomes visible
3.Add a version number in New version (e.g. ‘1.0.0’)
4.Write a Description (e.g. ‘This is the root version’)
5.Click on “Publish”
Export
A knowledge model can be exported into a JSON formatted file:
1.Click on “Knowledge Models” in the left hand menu
2.Position your mouse on the KM (‘Test of KM Editor’) and click on View detail
3.Click on Export and save the file on your computer.
Import
A knowledge model can also be imported:
1.Click on “Knowledge Models” in the left hand menu
2.Click on “Import” in top-right corner
3.Click on “Choose file”, select the .km-file
4.Click on “Upload”
Note: If the KM already exists in the wizard it needs to be deleted first, both in the “Knowledge Model Editor” (first) and in “Knowledge Models”.
Delete Knowledge Model in Knowledge Model Editor
Templates
Last modified 27d ago