This wiki is locked. Future workgroup activity and specification development must take place at our new wiki. For more information, see this blog post about the new governance model and this post about changes to the website.

Architecture Management - Link Type Format

1.0 SPECIFICATION DRAFT

Introduction

A link type represents type of link that is or can be used when defining links from AM resources. The type has an ID (expressed as a URI), whose universally accepted semantics may be defined elsewhere. This resource represents the definition as it is used by this service provider. It is meant to make it easy for clients to get a list of known or registered link types with human readable definitions that can be used in client user interfaces.

Namespaces

XML namespace abbreviations used in this specification:

Representation

The media type used for this RDF/XML representation SHOULD be application/rdf+xml.

The resource MUST be an XML document with the root element <rdf:RDF>.

The resource MUST include at least one <rdf:Description> and the rdf:about attribute MUST specify the absolute URI of the link type.

The following properties are defined as XML child elements for link type resources:

Prefixed Name Occurs Read-Only Value Type Representation Range Description
dcterms:title exactly one No String n/a n/a The short label for the link type.
dcterms:description at most one No String n/a n/a A description of the link type. Expected to be used in user interfaces to help explain the semantics of the link type.
dcterms:creator at most one Yes XMLLiteral either foaf:Person The user who added the link type to the service provider as a supported link type. The value of this element MAY be free form text, or MAY be a FOAF Person element. If the user has a URI it SHOULD be represented as a rdf:resource attribute of this element.
dcterms:created at most one Yes Date Time ISO8601 n/a When the link type was added to the service provider. Can be expressed as free form text, or in a standard form. When in a form that can be automated, the rdf:datatype attribute with a public date time URI SHOULD be present to assist the client in parsing the value (i.e. http://www.w3.org/2001/XMLSchema#dateTime).
dcterms:contributor at most one Yes XMLLiteral either foaf:Person The user last modified the link type description or label. The value of this element MAY be free form text, or MAY a FOAF Person element. If the user has a URI it SHOULD be represented as a rdf:resource attribute of this element.
dcterms:modified at most one Yes Date Time ISO8601 n/a When the link type was last modified. MAY be expressed as free form text, or in a standard form. When in a form that can be automated, the rdf:datatype property with a public date time URI SHOULD be present to assist the client in parsing the value (i.e. http://www.w3.org/2001/XMLSchema#dateTime).

Examples

Example 1. All optional elements included, FOAF identities

<rdf:RDF 
   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
   xmlns:dcterms="http://purl.org/dc/terms/">

  <rdf:Description rdf:about="http://example.com/linktype/depends">

    <dcterms:title>Depends</dcterms:title>

    <dcterms:description>
       The source end of this link depends on the target end.
    </dcterms:description> 

    <dcterms:created rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">
       2009-10-20T19:49:47-04:00
    </dcterms:created>

    <dcterms:creator rdf:resource="https://example.com/users/dan">
       <foaf:Person>
          <foaf:name>Dan Designer</foaf:name>
          <foaf:mbox rdf:resource="mailto:dan@example.com" />
          <foaf:img rdf:resource="https://example.com/users/photo/dan" />
       </foaf:Person>
    </dcterms:creator>

    <dcterms:modified rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">
       2009-11-03T08:53:00-04:00
    </dcterms:modified>

    <dcterms:contributor rdf:resource="https://example.com/users/ana">
       <foaf:Person>
         <foaf:name>Ana Analyst</foaf:name>
         <foaf:mbox rdf:resource="mailto:ana@example.com" />
         <foaf:img rdf:resource="https://example.com/users/photo/ana" />
       </foaf:Person>
    </dcterms:contributor>

  </rdf:Description>

</rdf:RDF> 

Example 2. Only Required Return Elements

In this example the link type is externally defined (leveraging the Dublin Core term license), and specified in the rdf:about attribute.

<rdf:RDF 
   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
   xmlns:dcterms="http://purl.org/dc/terms/">

  <rdf:Description rdf:about="http://purl.org/dc/terms/license">
    <dcterms:title>Distribution License</dcterms:title>
  </rdf:Description>

</rdf:RDF> 

Example 3. All simple user identities

<rdf:RDF
   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
   xmlns:dcterms="http://purl.org/dc/terms/">

  <rdf:Description rdf:about="http://example.com/linktype/depends">

   <dcterms:title>Depends</dcterms:title>
   <dcterms:description>
      The source end of this link depends on the target end.
   </dcterms:description>

   <dcterms:created rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">
      2009-10-20T19:49:47-04:00
   </dcterms:created>
   <dcterms:creator>Dan Developer</dcterms:create>

</rdf:RDF> 

Back to Architecture Management Resource Definitions

Topic revision: r11 - 29 Jun 2010 - 20:08:29 - JimConallen
 
This site is powered by the TWiki collaboration platform Copyright � by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use
Ideas, requests, problems regarding this site? Send feedback