NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Use Case Number
The author-assigned number to refer to each specific use case. The format of this number is <SemCon Ops Initiative><analyst's initiatls><requirement number>.< <use case number>, for example Init1dbw1.1, Init1dbw1.2, Init2dbw2.1, 2.2, etc.

Init1dbw10.u1.0- Load value Meaning

Brief Description

a model is being loaded into caDSR containing enumerations for an attribute in the model.  The Uml loader needs to create a new value domain in caDSR, or reuse a Value Domain, with the correct Permissible Value Set associated with it.  

Actor(s) for this particular use case

UML Loader

Pre-condition
The state of the system before the user interacts with it

UML Model serialized in XMI containing a local value domain Class stereotyped as Local Value Domain, with enumerations - concepts the UML Attribute is mapped on only 1 concept.  The Concept exists in caDSR

Post condition
The state of the system after the user interacts with it

a new value domain is created or an existing value domain is reused

Steps to take
The step-by-step description of how users will interact with the system to achieve a specific business goal or function

1. Using the UML attribute mapped Primary concept code, code  search caDSR for matching VM Concept = PreferredName
2. traverse the caDSR concept associated items for existing Value Meaning
3. a Value Meaning object administered item based on the concept code is found in caDSR
4. the loader reuses . Using Matching Concept, get Concept.ComponentConceptCollection

3. getDerivationRule for the conceptCollection with Primary Flag = "Yes"

4. getValueMeaning associated with the derivationRule.
5. get the valueMeaning's conceptDerivationrule and check to see if the ValueMeaning has any qualifiers (getcomponentConceptCollection)

6. If component concepts are found where DisplayOrder is greater than 0,  then loader can reuse the existing value meaning in caDSR as the semantic basis for the PV ( UML attribute ) in the model
5. the PV = "Short", the VM name = EVS Preferred Name, VM definition = EVS preferred defnition.  7. the loader continues this for each UML Attribute in the Local Value Domain class where there is only 1 concept associated with the attribute 

Alternate Flow
Things which would prevent the normal flow of the use case

- No matching Value Meaning based on the concept code is found - Create New Value Meaning - See Init1dbw10.u1.1 
- No concept is associated with the Value Meaning (uml attribute) in the model.  Create Value Meaning without Concept code. See use case Init1dbw10.u1.2 for details. 
- Matching VM is found based on the concept code, but the name of the VM is not the same as the name of the PV in the model.  Do nothing.  The PV in the model is an arbitrary token for storing a representation of the concept in a database Reuse the VM.  The concept name and the PV name do not have to match.
- More than one concept is associated with the UML Attribute.
- More than one VM is found that is based on the concept code. See Init1dbw10.u1.3

Priority
The priority of implementing the use case: High, Medium or Low

High

Associated Links
The brief user stories, each describing the user interacts with the system for the one function only of the use case. There would potentially be a number of user stories that make up the use case.

Related GForge Tracker in Semantic Integration Tools Project

Fit criterion/Acceptance Criterion 
How would actor describe the acceptable usage scenarios for the software or service that meets the actor's requirement?


1. There are 2 concepts in EVS and caDSR, both have concept name "Short".
C25249:Short
C73939:Short
User has a model 1 with one LVD, one of the PV has name "Short", mapped to C25249:Short.
UML Loader should create new Local Value domian (LVD)
If no Value Meaning exists mapped to C25249, a new VM is created. The new VM long name is the EVS preferred Name, its definition is the EVS preferred definition.  The VM is associated with the PV "Short" in the new Value Domain.


2. Create model 2 with one LVD, one of the PV has name "Short", mapped to C73939:Short.
UML loader shoudl create a new LVD if not LVD exists with one PV mapped Value = "Short" mapped to concept C73939.
If no Value Meaning exists mapped to C73939, new VM should be created and used in the new local value domain.  The VM name = EVS preferred name, concept =C73939, definition = EVS preferrred Definition.

...