Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Template vocabulary"

(Example)
Line 3: Line 3:
 
Vocabulary to describe a Template Context. Contains information necessary to dynamically instantiate regular contexts. Part of the [[Persona Data Model 2.0]].  
 
Vocabulary to describe a Template Context. Contains information necessary to dynamically instantiate regular contexts. Part of the [[Persona Data Model 2.0]].  
  
=== Files ===
+
== Files ==
 
* Most recently [http://www.eclipse.org/higgins/ontologies/2010/6/template published]
 
* Most recently [http://www.eclipse.org/higgins/ontologies/2010/6/template published]
 
* SVN source: [https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2/org.eclipse.higgins.ontology/template.owl template.owl]
 
* SVN source: [https://dev.eclipse.org/svnroot/technology/org.eclipse.higgins/trunk/H2/org.eclipse.higgins.ontology/template.owl template.owl]

Revision as of 18:11, 26 September 2011

{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}
Higgins logo 76Wx100H.jpg

Vocabulary to describe a Template Context. Contains information necessary to dynamically instantiate regular contexts. Part of the Persona Data Model 2.0.

Files

UML Overview

Template 2.0.112B.png

Overview

TemplateContexts are used to instantiate both regular contexts and connector context pairs mentioned here: Persona Data Model 2.0. The AppTemplate subclass of TemplateContext (itself a subclass of ctxt:Context) is used to describe the former, and the ConnectorTemplate subclass of TemplateContext, the latter. TemplateContexts have an optional policy attribute whose value is an an instance of DataPolicy.

AppTemplate

An AppTemplate is a template for an app. An app is a PDS add-on. Apps run within a PDS-provided runtime environment. Apps have read (and potentially write) access to a specific set of attributes within the PDS. An AppTemplate is a TemplateContext subclass with a ContextPrototype instance that describes a context to be used to support an app.

  • subClassOf TemplateContext
  • 1..1 app App

App

Abstract class. A prototype of a context instance that holds app-specific data (e.g. Person entity) if any. Subclasses reference active content (aka code).

  • subclass of ContextPrototype
  • 1..1 description--human friendly text that describes this app/view/context
  • 0..1 viewRoot (inherited) - value is a structure created using the View-builder vocabulary that describes how to dynamically construct a UI to view and/or edit the attributes of this context.
  • 0..1 settingsViewRoot (inherited) - value is a structure created using the View-builder vocabulary that describes how to dynamically construct a UI to view and/or edit administrative settings related to the JavaScript app (if present)

The instantiated context of an AppTemplate TemplateContext is a place where the JavaScript of the app can persist new attributes if needed. Apps use an API that may update the values of attributes in other contexts.

ConnectionTemplate

A TemplateContext containing two ContextPrototypes instances that describe each connector context in a relationship:

The Definer ContextPrototype instance has the following attributes:

  • 0..1 viewRoot - value is a structure created using the View-builder vocabulary that describes how to dynamically construct a UI to view and/or edit the attributes of this context.
  • 0..1 settingsViewRoot - value is a structure created using the View-builder vocabulary that describes how to dynamically construct a UI to view and/or edit administrative settings related to the JavaScript app (if present)

The Participant ContextPrototype instance has the following attributes:

  • 0..1 templateRole - value is a default Role to assign to the new p:Person instance in the newly instantiated context

in the relationship for which the participant is authoritative and may optionally decide to provide

  • 0..1 viewRoot - value is a structure created using the View-builder vocabulary that describes how to dynamically construct a UI to view and/or edit the attributes of this context.
  • 0..1 settingsViewRoot - value is a structure created using the View-builder vocabulary that describes how to dynamically construct a UI to view and/or edit administrative settings related to the JavaScript app (if present)

Example

Below is an example of a ConnectionTemplate. See (nytimes-template-context.n3 for details):

Here is the ConnectionTemplate (Note: the image value is truncated):

 <http://www.eclipse.org/higgins/ontologies/examples/nytimes-template-context>
     rdf:type template:ConnectionTemplate , owl:Ontology ;
     template:definer :Definer_1 ;
     template:participant
             :WebsiteFacade_1 ;
     template:policy :DataPolicy_1 ;
     template:proxyClass proxy:WebLogin ;
     proxy:connectionType
             "business"^^xsd:string ;
     proxy:image "329849238457234523453454"^^xsd:base64Binary ;
     proxy:imageType "JPG"^^xsd:string ;
     owl:imports <http://www.eclipse.org/higgins/ontologies/2010/6/fp> , 
     <http://www.eclipse.org/higgins/ontologies/2010/6/template> ;
     skos:prefLabel "NYTimes ConnectionTemplate"^^xsd:string .

Here is the DataPolicy:

 :DataPolicy_1
     rdf:type template:DataPolicy ;
     template:desires fpa:fashionAndStyle , fpa:worldLocalities ;
     template:provides <http://nytimes.com/schema/accountNumber> ;
     template:requires fp:email , fp:givenName , fp:familyName .


Here is the definer WebsiteFacade:Participant (Note: the actual code of the JavaScript has been omitted). See App-data vocabulary for a complete example of a WebsiteFacade object:

 :WebsiteFacade_1
     a       app-data:WebsiteFacade ;
     app-data:script :Login_1 ;
     app-data:siteName "nytimes.com"^^xsd:string .

Here is its Login CDEScript:

 :Login_1
     a       app-data:Login ;
     app-data:data "<JSON script goes here>"^^xsd:string ;
     app-data:version "1.0"^^xsd:string ;
     skos:prefLabel "Script to auto-login to the New York Times website."^^xsd:string .

Classes

App

Abstract class. A prototype of a context instance that holds app-specific data (e.g. Person entity) if any. Subclasses reference active content (aka code).

  • subClassOf ContextPrototype
  • 1..1 appURI
  • 1..1 description

AppTemplate

An AppTemplate is a template for an app. An app is a PDS add-on. Apps run within a PDS-provided runtime environment. Apps have read (and potentially write) access to a specific set of attributes within the PDS. An AppTemplate is a TemplateContext subclass with a ContextPrototype instance that describes a context to be used to support an app.

  • 1..1 app

Attribute

An attribute. Optionally from a specified authority/issuer.

  • 1..1 attribute
  • 0..N authority

ConnectorTemplate

A TemplateContext containing two ContextPrototypes instances that describe each connector context in a relationship

  • 1..1 definer
  • 1..1 participant

ContextPrototype

Abstract class. A prototype of an Context instance including, potentially, active code to be executed. The attributes of the prototype are copied into a Context instance.

  • 0..1 viewRoot

DataPolicy

Attribute data related policy statements that govern the relationship between the external party (e.g. definer or app operator) and the user/PDS.

  • 0..1 dataContract
  • 0..N desires
  • 0..N requires
  • 0..N provides

Definer

A prototype of a context that is one side of a connector context pair. The Definer side is a context managed by the same party that created the TemplateContext--the party that defines the overall parameters of the connector relationship. In a person-to-business connector. Definer would typically be the business as it is the business that defines the relationship including the set of attributes that will go back and forth.

  • subClassOf: Connector

HBXApp

An App that consists of an app-data:Overlay that is loaded by the HBX and executed in the foreground--i.e. as an overlay to the current page.

  • subClassOf App
  • 1..1 overlay

Participant

A prototype of a context that is one side of a connector context pair. The Participant side is a context managed by the other party--not the party that created the TemplateContext that defines the overall parameters of the connector relationship. In a person-to-business connector. Participant would be the person (the PDS owner/user)

  • subClassOf: Connector
  • 0..1 overlayCode

PortalApp

A kind of App that loads HTML/JS from appURI and displays it within the portal. The appURI may be within the PDS operator's domain or external to it.

  • subClassOf App
  • 1..1 appURI

TemplateContext

A TemplateContext is an abstract class for a context whose attributes act analogous to a "class" for regular context "instances".

  • subclassOf ctxt:Context (see Context vocabulary)
  • ..1 proxy:image
  • ..1 proxy:imageType
  • 1..1 proxy:description
  • ..1 proxyClass

Attributes

app

AppContext ContextPrototype

  • domain: AppTemplate
  • value: App

appURI

App UI page

  • domain: App
  • value: xsd:anyURI

authority

Authority (issuer) from which this attribute must be supplied. If not present then self-asserted is acceptable.

  • domain: Attribute
  • value: xsd:anyURI

attribute

Value is an attribute defined by persona.owl or fp.owl.

  • domain: Attribute
  • value: rdf:Property

dataContract

Contract governing app/user or definer/user data policy. Governs retention, data deletion, resale, etc.

  • domain: DataPolicy
  • value: xsd:anyURI

definer

Definer context within a pair of Participant/Definer connector contexts.

  • domain: ConnectionTemplate
  • value: Definer

description

Human readable description.

  • domain: TeplateContext
  • values: xsd:string

desires

Definer or app desires but doesn't require this attribute from the user. In the case of a ConnectionTemplate the definer reads the value of this attribute from the participant context. In the case of an AppTemplate the app requests the attribute via an API.

  • domain: DataPolicy
  • range: Attribute

overlay

JavaScript code that provides web augmentation/overlay to the user's current webpage in the browser.

  • domain: Participant or HBXApp
  • value: app-data:Overlay

participant

Participant context within a pair of Participant/Definer connector contexts.

  • domain: ConnectionTemplate
  • value: Participant

provides

Attribute provided by the definer. Attribute is stored in the definer context and is readable by the participant party. Value is an attribute defined by persona.owl or fp.owl.

  • domain: Definer
  • value: Attribute

proxyClass

Subclass of proxy:Proxy to instantiate in the root context.

  • domain: TemplateContext
  • value: owl:Class

requires

Either (i) the Definer requires this attribute from the participant. The value would be stored in the participant context and readable by the definer or (ii) an App requires this attribute from some context in the the PDS.

  • domain: Definer or App
  • value: Attribute

role

Default role played by new Person entity instances in contexts instantiated from this Participant prototype

  • domain: Participant
  • value: persona:Role

settingsViewRoot

Root of a tree of ViewNodes that describe the UI for the settings control panel for this context.

  • domain: ContextPrototype
  • value: view-builder:ViewNode

role

Default role played by new Person entity instances in contexts instantiated from this Participant prototype

  • domain: Participant
  • value: persona:Role

viewRoot

Root of a tree of ViewNodes that describe the UI for this context.

  • domain: ContextPrototype
  • value: view-builder:ViewNode

Links

Back to the top