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