How to use a substance info page#

In this section we will look at how to use the different sections of a substance info page.

How to add or change identifiers#

What is an identifier? See FAQ

To add an identifier, klick on the pencil icon to the right of the word Identifier on your substance info page. The section Identifier will be replaced by a blue text area containing text like this:

@CAS Number: 1234-56-78

The shown example of an identifier section in edit mode already contains the identifier CAS Number. To add another identifier, lets say EC Number, add a new line with the following content: @EC Number: the actual ec number.
The text area should the look like this:

@EC Number: 987-65-432
@CAS Number: 1234-56-78

All identifiers have to be between %%Identifier in the first line and the % in the last line.

Currently the following identifiers can be used:

There are a few hot keys, making it easier to change or add identifiers.

  • When you want to add a new Identifier in a new line, press "CTRL (or ALT) and Spacebar". You will get suggestions for the identifiers you can add based on the letters you have already typed. Select the right identifier with your arrow keys and press enter to add it. You can also select with your mouse.
  • The title of the page is based on the order and availability of the identifiers of the substance page. You can move identifier entries while editing by pressing ALT and UP or DOWN to move for example a substance name up or down.

Attention: A group uses the identifier Group Name which is also shown on the top of a page. Only groups should contain Parts.

How to add a memo to a substance info page#

What is a memo? See FAQ
To write a memo, you need to first navigate to the substance you want to write the memo for. Memos can then either be created by clicking the icon right to the text MemoList or from the decision making dialog (click on a module on the left) where a button "Memo" is available at the top.
When writing a memo, please make sure to add a descriptive title and also a team, for which the memo is most relevant. Also make sure, to connect the memo to a decision making module on the left to allow better organization of the information. You can do this by selecting the module in the drop down list Module. If a module is clicked or highlighted on the left, the correct module will be selected automatically.
When you connect a memo to a module, you can also assign a decisions of that module, which will then be stored for that substance and be made available to the rest of the system (e.g. substance list). The scores (excluded, suggested and established) represent how confident you are about that decision.
If you want to connect the memo with additional modules and decisions, you can add them by clicking the button with the + sign.

How to use the Decision Making dialog?#

The decision making dialog is only active when viewing the the page of a substance (substance info page). On the left you will then see a list of modules where you can add information about the substance by answering questions. On some modules KnowSEC also has additional reasoning knowledge which automatically suggests logical decisions based on the given input by the user. You can see these decisions by clicking on the small badges to the right of the text of a module (1).
Attention: Make sure to save the changes to the Decision Making with the "Save" button on the top left (2) to store them permanently. Otherwise they are only stored temporarily while you are working on the substance (and for a short while after you left the substance page).
Only after saving is the added information available in the rest of the system, e.g. in the dynamic substance lists or in the summary in the substance info page. Only the badges on the left are updated continuously.

Screenshot of a decision making module with solution badges (1) and save button (2)

How to find information to answer most common endpoint questions#

Many questions in KnowSEC regarding substance properties can be answered by looking at registration dossiers of the substance using either IUCLID or the chemical search function on the ECHA website

To choose the right answers in the registration data, there are a few points to keep in mind:

  • Multiple studies: If there are multiple studies/tests for the same endpoint, choose the key study or the study/test with the best reliability. The reliability is given as a score between 1 and 4, reliability of 1 is the best. If there are multiple key studies or studies with reliability 1, choose the most recent one or the one that otherwise answers the your question best. Reliability and date are normally given in the administrative date at the start of the study.
  • Only unreliable study available: If there are no studies with a good reliability score, there are a few options:
    • Choose a value based on expert judgment and attach a short memo to this value explaining the reasoning behind choosing this value.
    • If a value cannot be given at all, select "unknown" (if available) and maybe also write a short memo about your reasoning.
  • Value range instead of specific value: Most of the time, KnowSEC asks for a specific value in its questions. But sometimes, the registration dossiers do not provide one single value, but a range of values, e.g. 156 - 2056. There are different ways to resolve this:
    • If the range is explained further, e.g. with a diagram showing the measured values over the time of the experiment, choose a reasonable value based on given explanation. With the given example of a diagram over the time of the experiment, a reasonable value could for example be the value, where the endpoint plateaus.
    • If there is no further explanation, a reasonable value should always be the worst case value. If a higher value is worse, use the higher value of the range. If the lower value is worse, use the lower value.
  • UVCB or multi-constituence substances: Such substances are most of the time difficult to evaluate correctly. If there is no clear cut way to get a proper value, it can be easier to just use expert judgement and write a memo explaining the chosen decision or value.

How to add a new team#

Every user may add a new team in KnowSEC. To do this click the button 'Administration' in the menu on the left hand side under 'Navigation'. Then click the button 'Team definition' under 'Teams'. Next click the 'Edit'-button and add def 'team name' under the headline 'Definition of Team Names' and > 'team name' type:: team under the headline Concept of Team Strcuture. If you want to add a team page for the new team simply type http://pan-de14:8090/KnowSEC/Edit.jsp?page='team name' in the Navigation bar and confirm that you want to add a team page. Afterwards you will finde a link to the new team page when clicking the button 'Teams' in the Navigation menu on the left hand side.
Attention: The addition of a new team will not add this team to questions of the Decision Making dialog asking for teams, e.g. Who is responsible for this substance?. The new team has to be added as an answer to such questions as well as a decision and there also has to be a rule connecting the answer to the decision. Please use the existing teams as templates for this.

How to add a new substance#

Preliminary: Currently, to create a new substance info page, you need to enter the title of the new substance info page in the address bar of your browser. Right now, the address ends with "" because you see the page with the title "HowTo". If you replace this title with the one you want to give to your new substance info page, the browser will lead you to a page asking if you want to create this new page. If you choose to do so click the words "create it". You will the see the edit view of this new page, where you need to enter the following body of a default substance info page.

Body of an empty substance info page:





Hit the button save. This will finally create the new substance info page.
At a later point, this process will be simplified with a tool allowing to conveniently create new substance info pages with the press of a button.

How to add parts to the substance info page#

What is a part? See FAQ
Analog to adding identifiers.
More to come...

How to get the complete documentation?#

KnowSEC uses the KnowWe software suit. There is an online documentation of it available under (naturally a Wiki), where you can find information espaecially useful for advance users.

How to access KnowSEC information form out KnowSEC#

If you want to try an advanced feature which let's you access a ontology from outside KnowSEC, have a look at SparqlEndpoint.

Add new attachment

In order to upload a new attachment to this page, please use the following box to find the file, then click on “Upload”.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
modules.png 98.8 kB 1 15-Feb-2016 21:06 Albrecht Striffler
This page (revision-1) was last changed on 15-Feb-2016 21:06 by UnknownAuthor