Difference between revisions of "Issue subsystem general description"
Jump to navigation
Jump to search
Line 1: | Line 1: | ||
− | |||
The Simantics issue subsystem is defined in various plugins including | The Simantics issue subsystem is defined in various plugins including | ||
Line 17: | Line 16: | ||
severity in the following way | severity in the following way | ||
− | * Fatal issues describe severe errors which for example prevent simulation | + | * '''Fatal''' issues describe severe errors which for example prevent simulation |
− | * Error issues describe clear errors, which require user attention | + | * '''Error''' issues describe clear errors, which require user attention |
− | * Warning issues are indications that something may be wrong | + | * '''Warning''' issues are indications that something may be wrong |
− | * Note issues are reminders about important things | + | * '''Note''' issues are reminders about important things |
− | * Info issues are pieces of information linked to objects | + | * '''Info''' issues are pieces of information linked to objects |
Issues are somewhat related to events. The main difference between | Issues are somewhat related to events. The main difference between |
Revision as of 14:46, 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 describe severe errors which for example prevent simulation
- Error issues describe clear errors, which require user attention
- Warning issues are indications that something may be wrong
- Note issues are reminders about important things
- Info issues are pieces of information linked to objects
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
Issues are identified by the following data
- A type resource
- A main context resource
- A list of secondary context resources
§ All issues are required to be part of a model (by ConsistsOf). § All issues are managed by an issue source
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
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