Help

Do you need help? Check the topics below and the Frequently asked questions.


Help topics


Substances

Substances are the top-level elements in the web tool hierarchy. The first step to use the tool is to create a substance. Once a substance is created, test data can be added to it and assessments on desired endpoints can be run.

The starting point to manage substances is the Substances page, that can be accessed using the lateral menu. Substance-related pages and operations are described below.


Back to top


Substance list

This page lists the substances that belong to the user, provides access to substance details and to the new substance page.

List items are linked to the substance detail page, and the New substance button allows the user to create a new substance.


Back to top


Substance detail

The page presents detailed information about a substance. It shows study records and assessmentes that belong to the substances, and provides access to substance-related actions.

The top section of the page shows detailed information on the substance: name, CAS registry number, chemical name, and the creation and modification data. Click on the Edit substance buttons to modify this information, click on the Delete substance to delete it (confirmation is asked before deletion) and click on the Import data button to import IUCLID5 data into the substance.

Below the buttons are shown the list of assessments and study records that have been created for the substance.

Use the appropiate New button to create study records and assessments.


Back to top


New substance

New substance creation page. The new substance will be accessible to the current user only.

Three fields are required:

  • The name of the substance. The name is the substance identifier for the user, it is not used internally by the tool. Any name can be used, but two substances cannot have the same name.
  • The CAS Registry Number. It is used internally by the tool to retrieve existing information on the substance (to be implemented). It is checked that the provided CAS number has the correct format.
  • The data information requirement: a list of available requirements is provided. The data information requirements set the information targets for the assessments, and they are used by the ITS to decide if there is enough information available to reach a conclusion.

The chemical name is optional. It is not used by the tool, and its purpose is to help the user to identify the substance.


Back to top


Edit substance

This page allows the user to modify a substance.

Two fields are required:

  • The name of the substance. The name is the substance identifier for the user, it is not used internally by the tool. Any name can be used, but two substances cannot have the same name.
  • The CAS Registry Number. It is used internally by the tool to retrieve existing information on the substance (to be implemented). It is checked that the provided CAS number has the correct format.
  • The data information requirement: a list of available requirements is provided. The data information requirements set the information targets for the assessments, and they are used by the ITS to decide if there is enough information available to reach a conclusion.

The chemical name is optional. It is not used by the tool, and its purpose is to help the user to identify the substance.


Back to top


Delete substance

This page asks for confirmation before deleting a substance. This operation cannot be undone.

If the Delete button is clicked, the substance will be definitively deleted from the database. All items associated with the substance like test data, in silico data, physicochemical properties and assessments will be deleted as well.


Back to top


Import data

Data import from IUCLID 5 is performed in three steps.

  • First step. A form to upload a IUCLID 5 data exchange container file (.i5z extension) is shown. The selected file should include study records for the current substance. The maximum file size allowed is 5 MB.

    Once the file is selected using the Browse... button, the user clicks the Import file button in order to start the import process.

  • Second step. Once the file has been uploaded, a list of study record items contained in the file is shown. The substance name which the container file was generated for is also shown.

    The user selects the items to import into the current substance and click the Import selected items button. The study records that are not currently supported by the webtool are disabled and cannot be selected.

  • Third step. Once the selected items have been imported and saved, a summary page is presented. The first sections of this page list the imported study records that have been saved into the database. The last section lists the problems that may have occurred during the import process: renaming of study records, data validation problems, etc.

    The Finish button terminates the import process and returns to the substance detail page.


Back to top



Tests

Test data are required to perform any assessment on a substance. Test data are introduced by users, imported from IUCLID5 files or automatically obtained from databases (this feature is still in development).

The starting point to manage test data is the Substance detail page of the substance of interest, that can be accessed using the lateral menu. Test-related pages and operations are described below.


Back to top


Test / In silico data detail

This page shows detailed information about a test/in silico data item. It also allows the user to modify and delete the study record item.

The first section of the page shows detailed information on the study record: name, type of test, substance, reliability, guideline used (if any), and the creation and modification authors and dates.

The second section shows the references associated with this test.

The third section shows the results data and other information that depends on the test type, for instance the test organism.

Different operations on the test can be performed from this page: edit the test, remove the test from the assessment and delete the test. The delete test option is only available if the page is accessed from the Substance detail page, and the remove from the assessment option is available if the page is accessed from the Assessment detail page


Back to top


New test / in silico data

The creation of a new test/in silico data item is a two-step process.

  • First step. The user selects the test type to be created. The webtool provides a list of available test types. Once a test type is selected, a specific form for the selected test type is displayed in next page.

  • Second step. This page presents a form to create a new test/in silico data of the type selected in the previous page. Some sections of the page are common to all test types, and other sections are test-specific.

    The General section is present for all test types. It includes the name of the test (required field), its reliability score, the guideline and the guideline modifier. Note that some guideline modifiers (according to for instance) require a guideline to be selected. Some test types include also a field to select the type of study.

    The References section is present for all test types. To add a reference just fill in the field. To add more references click the Add more references button. To delete a reference, select it and click Delete checked references. To save the changes click the Save button at the bottom of the page.

    The Results section is present for all test types, but its content depends on the test type.

    The Test organisms section is present for test types that require to specify the organism the test applies to.

    The Species/strains section is present for test types that require to specify the species or strain the test applies to. Several species/strains can be included in the test. To add a species/strain select it from the list. To add more species/strains click the Add more button. To delete a species/strain, select it and click Remove checked strains. To save the changes click the Save button at the bottom of the page.


Back to top


Create and assign test/in silico data

This page presents a form to create a new test/in silico data of the type required by the assessment execution. Some sections of the page are common to all test types, and other sections are test-specific. The new test data is assigned to the current assessment.

The General section is present for all test types. It includes the name of the test (required field), its reliability score, the guideline and the guideline modifier. Note that some guideline modifiers (according to for instance) require a guideline to be selected. Some test types include also a field to select the type of study.

The References section is present for all test types. To add a reference just fill in the field. To add more references click the Add more references button. To delete a reference, select it and click Delete checked references. To save the changes click the Save button at the bottom of the page.

The Results section is present for all test types, but its content depends on the test type.

The Test organisms section is present for test types that require to specify the organism the test applies to.

The Species/strains section is present for test types that require to specify the species or strain the test applies to. Several species/strains can be included in the test. To add a species/strain select it from the list. To add more species/strains click the Add more button. To delete a species/strain, select it and click Remove checked strains. To save the changes click the Save button at the bottom of the page.

The page can only be accessed from the results page of an assessment execution.


Back to top


Assign test/in silico data

This page is used to select/deselect the test/in silico data that are assigned to the current assessment. Only assigned data items can be used by the assessment.

A list of test/in silico data relevant for the endpoint of the current assessment is presented. Name, test type and a result summary are shown.

Assigned items have a selected checkbox, and not assigned items are unselected. Clicking the Update button, selected items will be assigned to the current assessment. Likewise, unselected items will be removed from the assessment.


Back to top


Edit test/in silico data

This page allows the user to modify a test/in silico data item. Some sections of the page are common to all test types, and other sections are test-specific. The test type can not be changed.

The General section is present for all test types. It includes the name of the test (required field), its reliability score, the guideline and the guideline modifier. Note that some guideline modifiers (according to for instance) require a guideline to be selected. Some test types include also a field to select the type of study.

The References section is present for all test types. To add a reference just fill in the field. To add more references click the Add more references button. To delete a reference, select it and click Delete checked references. To save the changes click the Save button at the bottom of the page.

The Results section is present for all test types, but its content depends on the test type.

The Test organisms section is present for test types that require to specify the organism the test applies to.

The Species/strains section is present for test types that require to specify the species or strain the test applies to. Several species/strains can be included in the test. To add a species/strain select it from the list. To add more species/strains click the Add more button. To delete a species/strain, select it and click Remove checked strains. To save the changes click the Save button at the bottom of the page.


Back to top


Delete test/in silico data

This page asks for confirmation before deleting a test/in silico data. Clicking the Delete button the current study record will be definitively deleted from the database. Moreover, the study record item will be removed from all the assessments that have this item assigned.


Back to top



Physico-chemical properties

Physicochemical data are required to perform some assessments on a substance. Physicochemical data are introduced by users, imported from IUCLID5 files or automatically obtained from databases (this feature is still in development).

The starting point to manage physico-chemical data is the Substance detail page of the substance of interest, that can be accessed using the lateral menu. Physicochemical related pages and operations are described below.


Back to top


Physicochemical property detail

This page shows detailed information about a physicochemical property data item. It also allows the user to modify and delete the data item.

The first section of the page shows detailed information on the study record: name, type of physico-chemical property, substance, reliability, guideline used (if any), and the creation and modification authors and dates.

The References section shows the references associated with this physicochemical property.

The Results section shows the results data and other information that depends on the physicochemical property type.

Other sections may be present depending on the type of physicochemical property.

Different operations on the physicochemical property can be performed from this page: edit the physicochemical property, remove it from the assessment and delete the physicochemical property. The delete option is only available if the page is accessed from the Substance detail page, and the remove from the assessment option is available if the page is accessed from the Assessment detail page


Back to top


New physicochemical property

The creation of a new physicochemical property data item is a two-step process.

  • First step. The user selects the property type to be created. The webtool provides a list of available property types. Once a property type is selected, a specific form for the selected type is displayed in next page. Only physicochemical property types that can be used by an assessment are available.

  • Second step. This page presents a form to create a new physicochemical property of the type selected in the previous page. Some sections of the page are common to all types, and other sections are type-specific.

    The General section is present for all physicochemical property types. It includes the name of the property (required field) and its reliability score.

    The References section is present for all physicochemical property types. To add a reference just fill in the field. To add more references click the Add more reference button. The new reference will be added to the references list. To delete a reference, select it and click Delete checked references. To save the changes click the Save button at the bottom of the page.

    The Results section is present for all types, but its content depends on the physicochemical property type.

    Other sections may appear depending on the type of physicochemical property.


Back to top


Assign physicochemical properties

This page is used to select/deselect physicochemical properties that are assigned to the current assessment. Only assigned data items can be used by the assessment.

A list of physicochemical properties relevant for the endpoint of the current assessment is presented. Name, property type and a result summary are shown.

Assigned items have a selected checkbox, and not assigned items are unselected. Clicking the Update button, selected items will be assigned to the current assessment. Likewise, unselected items will be removed from the current assessment.


Back to top


Edit physicochemical property

This page allows the user to modify a physicochemical property item. Some sections of the page are common to all physicochemical property types, and other sections are type-specific. The physicochemical property type can not be changed.

The General section is present for all physicochemical property types. It includes the name of the property (required field) and its reliability score.

The References section is present for all physicochemical property types. To add a reference just fill in the field. To add more references click the Add more reference button. The new reference will be added to the references list. To delete a reference, select it and click Delete checked references. To save the changes click the Save button at the bottom of the page.

The Results section is present for all types, but its content depends on the physicochemical property type.

Other sections may appear depending on the type of physicochemical property.


Back to top


Delete physicochemical property

This page asks for confirmation before deleting a physicochemical property item. Clicking the Delete button the current physicochemical property will be definitively deleted from the database. Moreover, the physicochemical property item will be removed from all the assessments that have this item assigned.


Back to top



Assessments

An assessment is the element holding the ITS and all information required to evaluate a substance on a given endpoint. The assessment contains Integrated Testing Strategies that are executed to try to reach a conclusion using all information that is associated to an assessment.

The starting point to create and manage assessments is the Substance detail page page, that can be accessed using the lateral menu. Assessement-related pages and operations are described below.


Back to top


Assessment detail

This page shows detailed information about an assessment, and provides access to assessment-related actions.

The top section of the page shows detailed information on the assessment: name, endpoint, current state, information requirements and creation and modification authors and dates. Buttons are provided to modify this information, to delete the assessment and to execute it. Links to the Assessment state and the Report pages are available next to the State label, if the assessment has been executed. The possible states are:

NEW
State assigned on assessment creation
EXECUTED
State assigned to an executed assessment that does not reach a conclusion
MODIFIED
State assigned to an executed assessment that is modified
CONCLUDED
State assigned when an assessment reaches a conclusion

The Assigned study records section shows a list of assigned study records, grouped by type. Study records can be assigned or removed by means of the assign/remove button provided for each type of study record.

The User input section shows a list of user input items that have been created for the assessment. User input elements cannot be added or removed from this page, since they are added upon a request made by the webtool after an assessment is executed.


Back to top


New assessment

This page is used to create a new assessment for the current substance. The three required fields are:

  • The name of the assessment.
  • The endpoint that this assessment applies to. It must be selected from the provided list of available endpoints.

Back to top


Edit assessment

This page allows the user to modify the name of an existing assessment. The name is required.


Back to top


Delete assessment

This page asks for confirmation before deleting an assessment. If the Delete button is clicked, the current assessment and all user input assigned to this assessment will be definitively deleted from the database. Study records assigned to the assessment will not be deleted.


Back to top


Assessment execution

This page shows the assessment execution results. Is is shown right after an assessment execution.

The top section shows basic data on the assessment.

The Execution results section shows the response of the ITS engine to the execution: three outputs from the execution are possible: a conclusion has been reached, input is required from the user or no conclusion can be reached. If input is required from the user, buttons are provided to add the data.

The Followed steps section enumerates the steps of the ITS included in the assessment execution.

The Used information section lists all data items that have been used by the ITS in the assessment execution.


Back to top


State of the assessment

This page shows the current state of the assessment, including if input is required by the user.

The top section shows basic data on the assessment, including the state of the assessment.

The Execution results section shows the response of the ITS engine to the last execution: three outputs from the execution are possible: a conclusion has been reached, input is required from the user or no conclusion can be reached.


Back to top



User input items

User input is information introduced by the user as a response to an assessment execution request. The ITS often requires to make a decision that can not be made automatically by the tool using study records. User input items are managed differently from other elements of the webtool: they are related to assessments instead of substances, and can only be created as the result of an assessment execution. User input related pages and operations are described below.


Back to top


User input detail

This page shows detailed information about a user input item: the question the user input answers, a short description of the required user input, the type of answer, and the answer given by the user. Creation and modification authors and dates are also shown.

User input can be edited or deleted using the corresponding buttons at the bottom.


Back to top


New user input

A question requiring user input is presented in this page. The answer to this question has a required name field and an optional note field, used to store the rationale to the answer given. The format of the answer depends on the question type and is always required.

This page can only be accessed from the assessment execution results page.


Back to top


Edit user input

This page is used to modify the answer and the comments of existing user input. The answer field depends on the user input type. The answer field cannot be left blank.


Back to top


Delete user input

This page asks for confirmation before deleting user input. If the Delete button is clicked, the current user input item will be definitively deleted from the database.


Back to top