Difference between revisions of "Issue subsystem general description"

From Developer Documents
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
    1. org.simantics.issues.ontology (SVN)
  • Issue user interface model
    1. org.simantics.issues.ui.ontology (SVN)
  • Headless issue code
    1. org.simantics.issues (SVN)
    2. org.simantics.issues.common (SVN)
  • Issue user interface code
    1. 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