Difference between revisions of "Testscenario test author dutch"

Line 6: Line 6:
 
To execute the scenario, you need the following user accounts:
 
To execute the scenario, you need the following user accounts:
 
# A general author account
 
# A general author account
 +
# Access to the project as an author: https://decor.nictiz.nl/art-decor/decor-project--snictiz-
  
 
=Steps to perform for this scenario=
 
=Steps to perform for this scenario=
Line 16: Line 17:
 
===General tab / Algemeen===
 
===General tab / Algemeen===
  
# Add or change a description
+
# Login as project author
 +
# Add or change the description of the project
 
# Add building block repositories with prefixes 'ad1bbr-' & 'ad2bbr-' by clicking on the + next to 'Repository references'. Note that this action can only be performed by a 'decor-admin'
 
# Add building block repositories with prefixes 'ad1bbr-' & 'ad2bbr-' by clicking on the + next to 'Repository references'. Note that this action can only be performed by a 'decor-admin'
 +
# Check that building block repository 'zib2017bbr-' is added, or add it yourself
  
 
===Copyright tab===
 
===Copyright tab===
Line 24: Line 27:
 
# Enter name and contact information.
 
# Enter name and contact information.
 
# Add a logo from your computer by clicking on add and then browse.
 
# Add a logo from your computer by clicking on add and then browse.
# Enter the correct Copyright years.
+
# Enter the correct Copyright years. Examples are: 2012-2016, 2012-
  
 
===Authors tab===
 
===Authors tab===
Line 34: Line 37:
 
For more information: [[ART_Project_Editor#Maintaining_a_local_OID_Registry|Project editor manual]].
 
For more information: [[ART_Project_Editor#Maintaining_a_local_OID_Registry|Project editor manual]].
  
# Add external an external Id by clicking on the +.
+
# Add an external Id by clicking on the +.
 
# Fill in the Id (e.g. 1.2.3), Designation (en-US) and some Display name
 
# Fill in the Id (e.g. 1.2.3), Designation (en-US) and some Display name
  
Line 41: Line 44:
 
For more information: [[Dealing_with_Governance_Groups|Dealing with governance groups]].
 
For more information: [[Dealing_with_Governance_Groups|Dealing with governance groups]].
  
# Make the project member of a governance group (e.g. ART-DECOR) by clicking on the + to the left of the governance group name.
+
# Make the project member of a governance group (e.g. Nictiz) by clicking on the + to the left of the governance group name.
  
 
==Datasets==
 
==Datasets==
Line 59: Line 62:
 
For more information check the [[ART_Dataset_Editor|Dataset editor manual]].
 
For more information check the [[ART_Dataset_Editor|Dataset editor manual]].
  
Use the "Concepts Test dataset" tab. Recreate the concept "Person" (and underlying concepts) from the demo5 project dataset, see [[https://art-decor.org/art-decor/decor-project--demo5-]] or [[https://sourceforge.net/p/artdecor/code-0/HEAD/tree/branches/stable/decor/data/examples/demo5/demo5-decor.xml]]
+
Use the "Concepts Test dataset" tab. Recreate the concept "Person" (and underlying concepts) from the demo5 project dataset, see [[https://art-decor.org/art-decor/decor-datasets--demo5-?id=2.16.840.1.113883.3.1937.99.60.5.1.1&effectiveDate=2014-07-08T00%3A00%3A00&conceptId=2.16.840.1.113883.3.1937.99.60.5.2.10&conceptEffectiveDate=2014-07-08T00%3A00%3A00&language=en-US]]
  
 
# Add the Person concept by clicking on the +  
 
# Add the Person concept by clicking on the +  

Revision as of 17:11, 24 March 2020

Introduction

This is a testscenario for ART-DECOR information standards. During the test an ART-DECOR project is recreated, based on the demo5 project from ART-DECOR examples (see see [[1]] or [[2]]). Note that some content such as ZIBs/HCIM are only used in a Dutch context.

To execute the scenario, you need the following user accounts:

  1. A general author account
  2. Access to the project as an author: https://decor.nictiz.nl/art-decor/decor-project--snictiz-

Steps to perform for this scenario

Start with clean setup

Delete the contents (only datasets/scenarios/terminology/issues/templates) of the project if it already exists.

This can be done only by having low level access with admin rights to the underlying eXist database: Delete the collection the project's data resides in. For this test project: /db/apps/decor/data/projects/test

Project tab

General tab / Algemeen

  1. Login as project author
  2. Add or change the description of the project
  3. Add building block repositories with prefixes 'ad1bbr-' & 'ad2bbr-' by clicking on the + next to 'Repository references'. Note that this action can only be performed by a 'decor-admin'
  4. Check that building block repository 'zib2017bbr-' is added, or add it yourself

Copyright tab

  1. Add a Contributer by clicking the +.
  2. Enter name and contact information.
  3. Add a logo from your computer by clicking on add and then browse.
  4. Enter the correct Copyright years. Examples are: 2012-2016, 2012-

Authors tab

  1. Add an author by clicking on the +.

Ids tab

For more information: Project editor manual.

  1. Add an external Id by clicking on the +.
  2. Fill in the Id (e.g. 1.2.3), Designation (en-US) and some Display name

Governance Groups tab

For more information: Dealing with governance groups.

  1. Make the project member of a governance group (e.g. Nictiz) by clicking on the + to the left of the governance group name.

Datasets

Login as project author. For this section, click on the Datasets menu (in the top menu bar).

Basic dataset changes

Use the "Datasets" tab. Make some basic changes to the test dataset:

  1. Add a version label.
  2. Fill in a dataset description
  3. Save

Add concepts

For more information check the Dataset editor manual.

Use the "Concepts Test dataset" tab. Recreate the concept "Person" (and underlying concepts) from the demo5 project dataset, see [[3]]

  1. Add the Person concept by clicking on the +
  2. Enter Description, Source, Rationale, Operationalization, Comment.
  3. For each concept:
    1. Select the right kind of type (group or item)
    2. Add a name for the concept.
    3. At 'Value' select the type
  4. To add a new Property click on the + next to the word 'Properties'.
  5. Change the dataset status to:
    1. final (green bullet, top right)
    2. Deprecated (Blue bullet, top right)

Scenarios

For this section, click on the Datasets menu (in the top menu bar).

Add actors

Use the Actors tab.

  1. Add two actors by clicking on the +

Scenarios tab

Use the Scenarios tab.

  1. Add a scenario by clicking the + next to Scenarios.
    1. Fill in a name and description for the new scenario
    2. Save
  2. Open the scenario by clicking on the + left of its name in the tree view on the left.
  3. Click on the default group "Group"
  4. Click on the + at the top of the tree view. This will create a new group.
    1. Fill in a name and description for the new group
    2. Save
  5. Select (in turn) in the tree view the transactions of the group (called Initial and Response)
    1. Edit them (by clicking the pencil in top right)
    2. Fill in some data (label, description, change name)
    3. [TBD does not work] Add templates in the concepts section by clicking on the pencil next to the word Template in Concepts. Select a template and then choose 'Select dynamic' or 'Select static'.
    4. Save

[TBD does not work] You can add Concepts to the added template by clicking on the pencil next to the word 'Concepts'. This pencil is only visible when the Transaction is not in edit mode, so make sure you save the transaction before trying to add concepts. To add concepts in the transaction click on the + next to the concepts you want to add. Click save and then close the window to go back to the transaction.

You can always edit a transaction or transaction group by clicking on it in Scenarios. Then click on the pencil next to the word 'Transaction' to edit. For more information check the Scenario Editor manual

Value Sets (in Terminology)

For this section, click on the Terminology menu (in the top menu bar) and choose Value Sets.

For more information: Value Set Editor manual

  1. Create a new valueset.
    1. Click on the + above the tree view on the left-hand side. A new window opens.
    2. Fill in Version label, Display Name (mandatory) and Name (mandatory). The display name may hold spaces but the Name has to be one word.
    1. Add first value
      1. Change the source to ATC, click Select to activate it, this will show a popup which the search window for the codesystem.
      2. Enter search term: atc
      3. Click button: Add to valueset
      4. Click button: Close
    2. Add second value
      1. Add manual data by clicking on the + to the left of Values to create a new code line. Fill in a Level en select a Type (L, A, S, D). Also fill in a code (required) and a Display name (required).
    3. Save the value set (When the save button is not clickable you probably did not fill in one of the mandatory fields. Also check if the 'Name' really is only one word and if the Code only contains numbers and dots.)
  1. [TBD does not work] Create a reference
    1. Precondition: repository reference to a bbr project is already present
    2. Click on the "chain" icon above the tree view on the left-hand side
    3. Search for a valueset, and select it to save it to this project

REMARK: To see the newly created value set in the Value Sets screen you have to refresh it!

Templates

For this section, click on the Templates menu (in the top menu bar) and choose the Templates menu entry.

For more information: Template editor manual

  1. Create a template. Click on the + above the tree view on the left-hand side. A new window opens.
    1. Select a prototype

[TBD does not work properly now] For Heart rate choose the CDA Observation template and then click Select. Now you can fill in a Version label, Display Name and Name. The display name may hold spaces but the Name has to be one word. Fill in a description. Add an Example by clicking on the little + next to the word. Then add or delete xml attributes by clicking the little + or 'x' next to the attributes. Click on 'Create template' when you're done. The window will close and you'll be send back to the 'Templates'

You can always edit a template by clicking on it in Templates. Then click on the pencil next to the name of the template to edit.

Issues

For this section, click on the Issues menu (in the top menu bar).

For more information: Issue manual.

  1. Add an issue by clicking on the flag to the right
    1. Select the correct type (incident, change request, for future consideration, request for information/education)
    2. Fill in a title.
    3. Select the desired priority (Lowest, Low, Normal, High, Highest).
    4. Fill in description
    5. Assign issue to an author
    6. Save