Skip to end of metadata
Go to start of metadata

Basic use cases

Insert a link to a statement

While writing an annotation (forum post, comment) user wants to insert a link to a statement about particular painting. For example, they may want to insert a link to the date of creation of a painting.

First, user needs to search for a particular painting and select it from the result set.

User browses painting's data and selects a statement. A link to the statement is inserted in the RTF editor. The link has a meaningful name. 

Navigate to a link to statement

When reading an annotation (forum post, comment) user clicks on a link to a statement. This navigates them to:

- If statement is in data layer (original, approved) the painting's data form is shown and it is positioned on the relevant field (i.e. year of production)

- If statement is in annotation layer only - TBD

Design

Data vs Annotation layer

When creating a link, user chooses from data layer. That is, approved or original data/statements. After link is created though, data layer can change. Certain statements can be disapproved or replaced. When this happens, they will exist in annotation layer only.

In order for the created link to be still valid, we need not link to data layer but to annotation layer.

All statements in data layer have representation in annotation layer but not vice versa:

  1. Annotations are precreated for everything in the data layer after migration
  2. Before certain statements get into data layer they should be created as annotations (proposed) and later approved
  3. Annotation are never deleted, statements in data layer are.

URIs

Links to annotations are based on their URIs. The URIs themselves cannot be used for navigation so we need to navigate to some link that would interpret the annotation URI and would navigate to the relevant painting and data field.

We can create a rest service (http://.../redirectToAnnotation) and we can have URLs like /redirectToAnnotation?uri=rso:2926/part/1/a/1 in the annotation content.

When redirectToAnnotation is accessed it will load annotation by URI, fetch painting (annotation's main URI), get its Nuxeo UID and navigate to details page passing subject, predicate and old/new object as parameters.

DMS-RDF integration

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Jan 27, 2012

    If $ANNOTATION_IDENT=1636|rso:2926/part/1/a/1 (or something else)

    is identification of data layer statement or annotation in annotation layer.

    I think it's possible last sequnce from the sequence diagram starting with "Navigate to annotation link by URI" to be deleted. Link in tinyMCE 1636 to be represented as http://$LINK_TO_SUMMARY_VIEW?$ANNOTATION_IDENT .In that way statement/annotation that will be expanded is passed as url parameter and Load annotation by uri request to owlym db will be unnecessary.

  2. Jan 30, 2012

    1636|rso:2926/part/1/a/1:

    • 1636 is link title
    • rso:2926/part/1/a/1 is URI of annotation. If we use Nuxeo UIDs in the URI it will be something like nuxeo:998374-747678-7347475

    LINK_TO_SUMMARY_VIEW: Not an option as summary view only shows data layer and annotation may not be there anymore.