Difference between revisions of "Issue subsystem general description"
Jump to navigation
Jump to search
(→Basics) |
|||
| Line 14: | Line 14: | ||
An issue describes a condition in a model. Issues are categorized by | An issue describes a condition in a model. Issues are categorized by | ||
| − | severity in the following way | + | '''severity''' in the following way |
| − | * '''Fatal''' issues | + | * '''Fatal''' issues indicate situations which should not occur in normal operation |
| − | * '''Error''' issues | + | * '''Error''' issues indicate a severe issue which blocks calculation |
| − | * '''Warning''' issues | + | * '''Warning''' issues point out a possible error |
| − | * ''' | + | * '''Info''' issues are good to know information |
| − | * ''' | + | * '''Note''' issues are markers for documentation purposes |
| − | Issues are somewhat related to events. The main difference between | + | Issues are somewhat related to events. The main difference between issues and events is that while events happen at a particular time, issues are conditions with a lifecycle. The different issue states are |
| − | issues and events | ||
| − | is that while events happen at a particular time, issues are | ||
| − | conditions with a lifecycle. | ||
| − | The different issue states are | ||
| − | * Active, which means that the condition is true | + | * '''Active''', which means that the condition is true |
| − | * Resolved, which means that the condition is no longer true | + | * '''Resolved''', which means that the condition is no longer true |
| − | + | Further issues can be categorized as | |
| + | |||
| + | * '''User''' issues, which indicates that the user has manually created the condition | ||
| + | * '''Hidden''' issues, which can be used as a hint for user interfaces. | ||
| − | + | The following also applies for issues | |
| − | |||
| − | |||
| − | + | * Issues are directly linked to a model with L0.ConsistsOf and named with UUIDs. | |
| − | |||
| − | + | Issues are identified by the following data | |
| − | * | + | * A type resource (L0.InstanceOf) |
| − | + | * A list of context resources (ISSUE.Issue.HasContexts), where the first resource is a '''main context''' | |
| − | |||
All issues declare the following properties needed to e.g. display the | All issues declare the following properties needed to e.g. display the | ||
| Line 53: | Line 48: | ||
* Path, which us a textual representetion of the location of the main | * Path, which us a textual representetion of the location of the main | ||
context resource | context resource | ||
| + | |||
| + | Typically these are computational properties and e.g. the Description is asserted in the issue type and computed from context resources. | ||
| + | |||
| + | The lifecycle of computational issues is determined by '''issue sources'''. Issue sources are divided into the following categories | ||
| + | |||
| + | * Batch issue sources, which can compute on demand a set of issues | ||
| + | from given context | ||
| + | * Continuous issue sources, which can track the set of issues from given context | ||
Revision as of 14:59, 11 March 2012
The Simantics issue subsystem is defined in various plugins including
- Issue model
- org.simantics.issues.ontology (SVN)
- Issue user interface model
- org.simantics.issues.ui.ontology (SVN)
- Headless issue code
- Issue user interface code
- org.simantics.issues.ui (SVN)
Basics
An issue describes a condition in a model. Issues are categorized by severity in the following way
- Fatal issues indicate situations which should not occur in normal operation
- Error issues indicate a severe issue which blocks calculation
- Warning issues point out a possible error
- Info issues are good to know information
- Note issues are markers for documentation purposes
Issues are somewhat related to events. The main difference between issues and events is that while events happen at a particular time, issues are conditions with a lifecycle. The different issue states are
- Active, which means that the condition is true
- Resolved, which means that the condition is no longer true
Further issues can be categorized as
- User issues, which indicates that the user has manually created the condition
- Hidden issues, which can be used as a hint for user interfaces.
The following also applies for issues
- Issues are directly linked to a model with L0.ConsistsOf and named with UUIDs.
Issues are identified by the following data
- A type resource (L0.InstanceOf)
- A list of context resources (ISSUE.Issue.HasContexts), where the first resource is a main context
All issues declare the following properties needed to e.g. display the issue in the Issue View.
- Description, which is a one-line text about the issue
- Resource, which is a textual representation of the main context resource
- Path, which us a textual representetion of the location of the main
context resource
Typically these are computational properties and e.g. the Description is asserted in the issue type and computed from context resources.
The lifecycle of computational issues is determined by issue sources. Issue sources are divided into the following categories
- Batch issue sources, which can compute on demand a set of issues
from given context
- Continuous issue sources, which can track the set of issues from given context
