Subgraph operations

From Developer Documents
Revision as of 15:37, 12 November 2013 by Tuukka Lehtonen (talk | contribs)
Jump to navigation Jump to search

This page discusses three common operations that handle some subgraph of the whole Simantics database. They all have very similar issues:

  • Export/import
    • What is exported?
    • How the references from the exported part to the unexported part are handled?
  • Copy/paste
    • What is copied?
    • How the references from the copied part to the uncopied part are handled?
  • Removal
    • What is removed?
    • How the references between the removed and the unremoved resources are handled?

Moreover in many cases copy/paste should behave similarly to export/import and immediate removal of an imported object should usually restore the database to the state before import.

Baseline behavior

First, it should be made clear, that in some cases there are more than one reasonable behaviour for the operations. For example, consider an applications where graphical and semantic objects are separated and the same semantic object can be represented by multiple graphical objects. When the user removes a graphical object, it is possible to remove also the corresponding semantic object, but it is also sensible to remove only the graphical object. Sometimes the desired behaviour can be asked from the user.

This means that the "correct" behaviour of each operation cannot be based purely on the shape of the data but it should be customizable in each case separately. However, the customization cannot be based solely on the type of the resource selected when the operation is requested. For example, a removal of a library has a very simple behavior: its children should also be removed. However the children of the library may each require different removal customization.

In order to collect all requirements for the customizable export/import, copy/paste and removal operations, we first define the baseline behaviour for the operations. The idea is that we can then collect all current cases where the operations should behave differently from the baseline and this helps for choosing the right customization hooks.

Every operation targets some resource C. In some cases there can be more than one target, but definitions should be easily generalizable for that case.

A resource is external to C if there is a PartOf-path leading from the resource to the root library such that the path does not include C. In other words, the set of resources external to C are the resources that are reachable by ConsistsOf from root library without going through C.

A resource is in the context of C if it reachable from C by statements without going through any external resources.

Extent.png

Now, we can define baseline behaviors:

  • Export writes all resources in the context of C as internal resources to the transferable graph, together with all their statements excluding a PartOf-statements from C. Resources external to C are referred by URI. C is marked the root of TG.
  • Import creates all internal resources in TG file as new resources and adds all the statements in TG. The references to external resources are resolved by URI and if the resource does not exist a dummy resource is created. The root of the TG is attached by ConsistsOf to the target of the import operation.
  • Copy/paste behaves just like export/import.
  • Removal removes all the resource in the context of C.

Exceptions to baseline behavior

Export/import

Copy/paste

Removal

  • Component types (and other types)
    • If the type has instances the operation must be cancelled or all the instances must be removed
  • Connection points, properties (and other relations)
    • If the relation is used somewhere the operation must be cancelled or the corresponding statement must be removed.
  • Components
    • If component is created by mapping from a diagram the corresponding diagram elements should also be removed