Difference between revisions of "Testscenario test author dutch"

(Terminology)
(Terminologiekoppelingen / Terminology associations)
Line 174: Line 174:
  
 
Exercise valuesets 6:
 
Exercise valuesets 6:
We will add an '''terminology association''' between the 'person/gender' dataset concept, and the SNOMED Gender code.
+
We will add a '''terminology association''' between the 'person/gender' dataset concept, and the SNOMED Gender code.
 
This works for any dataset concept.
 
This works for any dataset concept.
  
Line 184: Line 184:
  
 
Exercise valuesets 7:
 
Exercise valuesets 7:
We will add an '''valueset association''' between the 'person/gender' dataset concept, and the GeslachtCodelijst/Gender valueset.
+
We will add a '''valueset association''' between the 'person/gender' dataset concept, and the GeslachtCodelijst/Gender valueset.
 
This works because the person/gender dataset concept has waarde/value type 'Code'.
 
This works because the person/gender dataset concept has waarde/value type 'Code'.
  

Revision as of 10:10, 8 July 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-

Note that a lot of steps described below require saving after edit.

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

For documentation, see the Project Editor manual

General tab / Algemeen

Exercise project 1:

  1. Login as project author, who is also a project admin
  2. Add or change the description of the project

Exercise project 2:

  1. 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'
  2. Check that building block repository 'zib2017bbr-' is added, or add it yourself

Copyright tab

Exercise project 3:

  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

Exercise project 4:

  1. Add an author by clicking on the +.

Governance Groups tab

For more information: Dealing with governance groups. Exercise project 5:

  1. This step will only be demonstrated, since we usually do not want to change governance configuration.

Demo: Make the project member of a governance group (e.g. your own organization)

Datasets

For documentation, see the Dataset editor manual.

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

Basic dataset changes

Use the "Datasets/Datasets" tab. On this page the metadata for all datasets in the project can be managed. Documentation: ART_Dataset_Editor#Setting_dataset_attributes

Make some basic changes to the test dataset: Exercise dataset 1:

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

Add concepts

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

  1. First look at all the child concepts of 'Person'. For each concept, have a look at the Value/type, Waarde/Soort.
  1. Add your own Person concept by clicking on the +
  2. Give the Person concept a unique name, for instance: PersonYourFirstName
  3. Enter Description, Source, Rationale, Operationalization, Comment.
  4. 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. Note that we shall use Person/Gender at a later stage in this session. Check the value/type for this concept.

Inherit a ZIB group

Exercise dataset 3:

  1. Add a concept group, name 'Patient', filter below on Zorginformatiebouwstenen (ZIB) 2017
  2. Select the concept below
  3. Select the wheel icon on the right, Concept selecteren
  4. Select 'Als overerving/Inherit'
  5. Save the concept group

Scenarios

For documentation, see manual

For this section, click on the Scenario's menu (in the top menu bar).

Add actors

Use the Actors tab. Exercise scenarios 1:

  1. Add two actors by clicking on the +

Scenarios tab

Use the Scenarios tab. Exercise scenarios 2:

  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 transaction group.
    1. Fill in a name and description for the new transaction group
    2. Save
    3. Open the transaction group by clicking on the + left of its name in the treeview on the left.
  5. Select (in turn) in the treeview the transactions called Initial and Response
    1. Edit them (by clicking the pencil in top right)
    2. Fill in some data (label, description, change name)

Exercise scenarios 3:

    1. You can add Concepts to the added transaction 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 you start by selecting a parent group, while that concept group is selected, click next to Card/Conf on an option that applies: All 1..1 R, All 0..1 R, .. Click save and then close the window to go back to the transaction.

    1. Add all the 'Person' concepts you added in the dataset to a 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

FHIR Questionnaire

Note that the scenario/transaction we have just created is now available as a FHIR Questionnaire, in XML and JSON. For documentation, see manual.

The FHIR Questionnaire can be shown from the Project index.

  • Open the Project Index, by selecting the tab 'Project', 'Project Index'
  • All items in our project are listed here
  • Under 'Transactions', open the Questionnaire/html to render our transaction as a FHIR Questionnaire

Terminology

For documentation, see the Value Set Editor manual

Value Sets

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

Exercise valuesets 1:

  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.

Exercise valuesets 2:

  1. Add first value
    1. Check that the source/bron is SNOMED, click Select to activate it, this will show a popup which the search window for the codesystem.
    2. Enter search term: bloedgroep
    3. SNOMED codes may be added one by one to the valueset. Select one from the search results and 'toevoegen aan waardelijst'/'Add to valueset'
    4. Click button: Close
    5. Store the new valueset by clicking 'save'

Exercise valuesets 3:

  1. We will manually edit the valueset we just created and add a code manually
    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. Also fill in a code (required) and a Display name (required).
    2. 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.)

Exercise valuesets 4:

  1. Create a reference
    1. Precondition: repository reference to a bbr project is already present
    2. In the project where you want to add the reference: Click on the "chain" icon above the tree view on the left-hand side
    3. Usually it will help to open the repository project in a separate browser window and search the valueset first. They are accessible from 'Repository reference' and open up in a seperate browser window.
    4. In your own project: Search for a valueset, and select it to save it to this project

For instance for the zib2017bbr repository, search for 'Allergie'

Exercise valuesets 5:

  1. Check if the valueset 'GeslachtCodelijst'/Gender, is present as a referenced valueset. If not, add it as a referenced valueset to the project.

Terminologiekoppelingen / Terminology associations

For documentation, see the Terminology Editor manual

Exercise valuesets 6: We will add a terminology association between the 'person/gender' dataset concept, and the SNOMED Gender code. This works for any dataset concept.

  1. Go to Terminology / Terminologiekoppelingen.
  2. Select the dataset concept 'person/gender' from the dataset tree.
  3. Add a Terminologiekoppeling/terminology association by clicking on the plus at the right of Terminologiekoppelingen. By default 'SNOMED' is selected, but other terminology systems are available.
  4. Search for the SNOMED code you want to associate the dataset concept with, in this example 'gender'.
  5. 'Koppeling maken' to create the terminology association.

Exercise valuesets 7: We will add a valueset association between the 'person/gender' dataset concept, and the GeslachtCodelijst/Gender valueset. This works because the person/gender dataset concept has waarde/value type 'Code'.

  1. Go to Terminology / Terminologiekoppelingen.
  2. Select the dataset concept 'person/gender' from the dataset tree.
  3. Add a waardelijstkoppeling/valueset association by clicking on the plus at the right of Waardelijstkoppelingen.
  4. Select the valueset you want to associate the dataset concept with, in this example GeslachtCodelijst.
  5. 'Statische koppeling aanmaken' to create the association with this fixed version of the valueset.
  6. Go back to the dataset to view the dataset concept and associated valueset.

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

Templates

For documentation, see the Template editor manual

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

Exercise templates 1:

  1. Create a template by inheritance. Click on the + above the tree view on the left-hand side. A new window opens.
    1. Filter on zorginformatiebouwstenen repository and select a template from that project.
    2. Confirm by 'Selecteren/select'
    3. This will inherit the template into our own project

Exercise templates 2:

  1. Edit a template by selecting it and clicking on the pencil on the right of the name of the template to edit it.
  2. Make a change and save the template

Issues

For documentation, see the Issue manual.

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

Exercise issues 1:

  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