Difference between revisions of "Testscenario test author dutch"
(→Governance Groups tab) |
(→General tab / Algemeen) |
||
Line 20: | Line 20: | ||
===General tab / Algemeen=== | ===General tab / Algemeen=== | ||
Exercise project 1: | Exercise project 1: | ||
− | # Login as project author | + | # Login as project author, who is also a project admin |
# Add or change the description of the project | # Add or change the description of the project | ||
Exercise project 2: | Exercise project 2: |
Revision as of 07:58, 8 July 2020
Contents
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:
- A general author account
- 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 more information: Project Editor manual
General tab / Algemeen
Exercise project 1:
- Login as project author, who is also a project admin
- Add or change the description of the project
Exercise project 2:
- 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
Exercise project 3:
- Add a Contributer by clicking the +.
- Enter name and contact information.
- Add a logo from your computer by clicking on add and then browse.
- Enter the correct Copyright years. Examples are: 2012-2016, 2012-
Authors tab
Exercise project 4:
- Add an author by clicking on the +.
Governance Groups tab
For more information: Dealing with governance groups. Exercise project 5:
- 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
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:
- Select a dataset
- Add a version label
- Fill in a dataset description
- Save
Add concepts
For more information check the Dataset editor manual.
Exercise dataset 2: Use the "Concepts Test dataset" tab. Recreate the concept "Person" (and underlying concepts) from the demo5 project dataset, see [[3]]
- First check al the child concepts of 'Person'. For each concept, have a look at the Value/type, Waarde/Soort.
- Add the Person concept by clicking on the +
- Enter Description, Source, Rationale, Operationalization, Comment.
- For each concept:
- Select the right kind of type (group or item)
- Add a name for the concept.
- At 'Value' select the type
- Note that we shall use Persoon/Gender at a later stage in this session. Check the value/type for this concept.
Inherit a ZIB group
Exercise dataset 3:
- Add a concept group, name 'Patient', filter below on Zorginformatiebouwstenen (ZIB) 2017
- Select the concept below
- Select the wheel icon on the right, Concept selecteren
- Select 'Als overerving'
- 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:
- Add two actors by clicking on the +
Scenarios tab
Use the Scenarios tab. Exercise scenarios 2:
- Add a scenario by clicking the + next to Scenarios.
- Fill in a name and description for the new scenario
- Save
- Open the scenario by clicking on the + left of its name in the tree view on the left.
- Click on the default group "Group"
- Click on the + at the top of the tree view. This will create a new group.
- Fill in a name and description for the new group
- Save
- Select (in turn) in the tree view the transactions of the group (called Initial and Response)
- Edit them (by clicking the pencil in top right)
- Fill in some data (label, description, change name)
Exercise scenarios 3:
- 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.
- Create a transaction for all the 'Person' concepts you added in the dataset.
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
Exercise valuesets 1:
- Create a new valueset.
- Click on the + above the tree view on the left-hand side. A new window opens.
- 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:
- Add first value
- Check that the source/bron is SNOMED, click Select to activate it, this will show a popup which the search window for the codesystem.
- Enter search term: bloedgroep
- SNOMED codes may be added one by one to the valueset. Select one from the search results and 'toevoegen aan waardelijst'/'Add to valueset'
- Click button: Close
- Store the new valueset by clicking 'save'
Exercise valuesets 3:
- We will manually edit the valueset we just created and add a code manually
- 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).
- 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:
- Create a reference
- Precondition: repository reference to a bbr project is already present
- Usually it will help to open the repository project in a separate browser window and search the valueset first
- In the project where you want to add the reference: Click on the "chain" icon above the tree view on the left-hand side
- 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:
- 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
Exercise valuesets 6: We will add an 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'.
- Go to Terminology / Terminologiekoppelingen.
- Select from the dataset tree the concept person/gender.
- Add a waardelijstkoppeling/valueset association by clicking on the right of Waardelijstkoppelingen.
- Select the valueset you want to associate the dataset concept with, in this example GeslachtCodelijst.
- 'Statische koppeling aanmaken' to create the association with this fixed version of the valueset.
- 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 this section, click on the Templates menu (in the top menu bar) and choose the Templates menu entry.
For more information: Template editor manual Exercise templates 1:
- Create a template by inheritance. Click on the + above the tree view on the left-hand side. A new window opens.
- Filter on zorginformatiebouwstenen repository and select a template from that project.
- Confirm by 'Selecteren/select'
- This will inherit the template into our own project
Exercise templates 2:
- Edit a template by selecting it and clicking on the pencil on the right of the name of the template to edit it.
- Make a change and save the template
Issues
For this section, click on the Issues menu (in the top menu bar).
For more information: Issue manual. Exercise issues 1:
- Add an issue by clicking on the flag to the right
- Select the correct type (incident, change request, for future consideration, request for information/education)
- Fill in a title.
- Select the desired priority (Lowest, Low, Normal, High, Highest).
- Fill in description
- Assign issue to an author
- Save