AmResourceModelElementV1 < Main

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.
TWiki>
Main Web>AmHome>AMRestApiV1>AmResourceModelElementV1 (20 Jul 2010, JimConallen) (raw view)
---+ Architecture Management - AM Resource Format

1.0 SPECIFICATION

%TOC%
---++ Introduction

The general approach taken by the Architecture Management team follows the Change Management team's lead by not attempting to re-define model storage formats or even model or other architecture management resource notations, but rather extract out a least common denominator, that could be managed by an AM server, and still be useful to the overall goal of architecture management in a collaborative ALM environment. This does not prevent knowledgeable clients from getting and making use of internal resource content.

The AM resource properties are not limited to the ones defined in this specification. It is recommended to contribute resource properties in their own unique namespace. Service providers MUST NOT reuse or re-define properties or terms defined in this specification.

This resource format is XML. Extensions MUST NOT invalidate the document structure.

This specification makes use of RDF principles and concepts. While the resource format is strictly speaking not RDF nor RDF/XML it does use RDF terms and concepts.
---++ Namespaces

XML namespace abbreviations used in this specification:

   * =rdf= - [[http://www.w3.org/TR/rdf-syntax-grammar/][RDF XML]] namespace - http://www.w3.org/1999/02/22-rdf-syntax-ns#
   * =dcterms= - The [[http://dublincore.org/documents/dcmi-terms/][Dublin Core Metadata Terms]] namespace - http://purl.org/dc/terms/
   * =foaf= - [[http://xmlns.com/foaf/spec/][Friend of a Friend]] namespace - http://xmlns.com/foaf/0.1/
---++ Representation

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

The resource MUST be an XML document with the root element =&lt;rdf:RDF&gt;=.

The resource MUST include at least one =&lt;rdf:Description&gt;= and the =rdf:about= attribute MUST specify the absolute URI of the architecture resource.

The following table describes the RDF properties whose meaning is defined by this specification:

| *Prefixed Name*  | *Occurs*  | *Read-Only* | *Value Type* | *Representation* | *Range* | *Description* |
| dcterms:title  | exactly-one | No  | String  | n/a  | any  | The title (label) string. This is often a short displayable label for resource. |
| dcterms:identifier  | exactly-one | No  | String  | n/a  | any  | A unique identifier for a resource. Typically read-only and assigned by the service provider when a resource is created. Not typically intended for end-user display.  |
| dcterms:description | zero-or-one | No  | String  | n/a  | any  | The description string. |
| rdf:type  | one-or-many | No  | Resource  | Reference  | n/a  | The domain relative type, such as: use case, interface, process model, etc. The type is specified as a rdf:resource attribute and expected to be a URI. |
| dcterms:source  | zero-or-one | Yes  | Resource  | Reference  | n/a  | A URL reference that a client can perform a GET on that will return a document in a supported format that contains a representation of this resource. |
| dcterms:creator  | zero-or-many | Yes  | Resource  | either  | foaf:Person | The user who originally created this resource. It MAY include an rdf:resource attribute with the creator's URI. It MAY contain a further elaboration of the user using the Friend of a Friend Person. |
| dcterms:created  | zero-or-one | Yes  | Date Time  | n/a  | ISO8601  | The date and time that this resource was originally created. |
| dcterms:contributor | zero-or-many | Yes  | Resource  | either  | foaf:Person | The user who made the most recent modifications to this resource. It MAY include an rdf:resource attribute with the creator's URI. It MAY contain a further elaboration of the user using the Friend of a Friend Person. |
| dcterms:modified  | zero-or-one  | Yes  | Date Time  | n/a  | ISO8601  | The last modified date time of the resource. |

Service provides MAY support write. If the service provider does not support write or updating of AM resourcs through this API, then an appropriate status code is returned.

The creator and modified properties can be specified with a =foaf:Person= element. Clients that want to parse and use creator / modified properties SHOULD be prepared to parse any valid =foaf:Person= construct.

In general, service providers SHOULD be consistent in their use of =foaf:Person= elements. Only the elements returned in this resource can be expected to be referenceable in simple queries. This means that if a service provider returns the following properties for creator:
<blockquote><verbatim><dcterms:creator>
   <foaf:Person>
      <foaf:name>Dan Designer</foaf:name>
      <foaf:mbox rdf:resource="mailto:dan@acme.com" />
   </foaf:Person>
</dcterms:creator></verbatim></blockquote>

the following simple query MAY not work:
<blockquote><verbatim>http://example.com/resources?oslc.where=dcterms:creator{foaf:givenName="Dan" and foaf:familyName="Designer"}</verbatim></blockquote>

only the properties returned in this resource can be referenced in a simple query where clause, and there SHOULD be no expectation that the service provider
---+++ Additional Properties

Service providers MAY provide additional information or properties within the resource. These MUST be valid XML constructs.

Properties MAY be any valid XML element, and MAY have child elements.

Service providers MAY reject any modification or creation of properties for any reason, including but not limited to user permission and resource integrity.

[[AMManagingLinks][Resource links]], or references to other resources SHOULD appear as additional properties, and SHOULD include the =rdf:resource= attribute to specify the target (or object) of the relationship. Properties MAY be associated with the resource link itself, and if present will appear in a separate =rdf:Description= whos =rdf:about= attribute specifies the =rdf:ID= attribute of the link. (See guidance on managing links)
---++ Examples
---+++ Example 1. Only Required properties returned

In this example on the required properties are returned.
<blockquote><verbatim><?xml version="1.0" encoding="UTF-8"?>
<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="https://acme.com/resources/res1">
      <dcterms:title>ServiceInterface</dc:title>
      <dcterms:identifier>res1</dc:identifier>
      <rdf:type rdf:resource="http://www.eclipse.org/uml2/3.0.0/UML/Interface" />
    </rdf:Description> 

</rdf:RDF>
</verbatim></blockquote>

---+++ Example 2. All optional properties returned

In this example all optional properties are returned. Creator and modifier values are specified with the FOAF vocabulary and include a URI.

Additional properties are specified, two of which reference an external URI.
<blockquote><verbatim><?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF 
   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
   xmlns:dcterms="http://purl.org/dc/terms/"
   xmlns:foaf="http://xmlns.com/foaf/0.1/" 
   xmlns:acme="http://acme.com/">

    <rdf:Description rdf:about="https://acme.com/resources/res1">
      <dcterms:title>ServiceInterface</dcterms:title>
      <dcterms:identifier>res1</dcterms:identifier>
      <dcterms:description>This may come from the model element's documentation properties.</dcterms:description>
      <rdf:type rdf:resource="http://www.eclipse.org/uml2/3.0.0/UML/Interface" />
      <dcterms:source rdf:resource="https://acme.com/resources/source/res1"/>
   
      <dcterms:created rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2009-10-20T19:49:47-04:00</dcterms:created>
      <dcterms:creator>
        <foaf:Person>
           <foaf:name>Dan Designer</foaf:name>
           <foaf:mbox rdf:resource="mailto:dan@acme.com" />
           <foaf:img rdf:resource="https://acme.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>
         <foaf:Person>
            <foaf:name>Ana Analyst</foaf:name>
            <foaf:mbox rdf:resource="mailto:ana@acme.com" />
            <foaf:img rdf:resource="https://acme.com/users/photo/ana" />
         </foaf:Person>
      </dcterms:contributor>

      <!-- Other properties not defined by the OSLC specification.  These include 
           relationships to other resources (links) -->

      <acme:accountCode>CUST123</acme:accountCode>

      <acme:elaborates rdf:resource="https://req.acme.com/reqs/req1"/>

      <dcterms:license rdf:ID="id1" rdf:resource="http://open-services.net/html/Terms.html"/>

    </rdf:Description>

    <rdf:Description rdf:about="#id1">
         <acme:status>reviewed</acme:status>
         <dcterms:description>This resource is subject to the terms in this document.</dcterms:description>
    </rdf:Description>

</rdf:RDF> 
</verbatim></blockquote>

---+++ Example 3. All Simple optional properties returned

In this example all optional properties are returned. Creator and modifier values are specified as simple strings.
<blockquote><verbatim><?xml version="1.0" encoding="UTF-8"?>
<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="https://acme.com/resources/res1">

       <dcterms:title>ServiceInterface Diagram</dcterms:title>
       <dcterms:identifier>res1</dcterms:identifier>
       <dcterms:description>This may come from the model element's documentation properties.</dcterms:description>

       <rdf:type rdf:resource="http://www.eclipse.org/uml2/3.0.0/UML/SequenceDiagram" />
       <dcterms:source rdf:resource="https://acme.com/resources/source/res1"/>
   
       <dcterms:created rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2009-10-20T19:49:47-04:00</dcterms:created>
       <dcterms:creator>Dan Developer</dc:creator>
   
       <dcterms:modified rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2009-11-03T08:53:00-04:00</dcterms:modified>
       <dcterms:contributor>Ana Analyst</dc:contributor>

       <acme:accountCode>CUST123</acme:accountCode>

    </rdf:Description>

</rdf:RDF> 
</verbatim></blockquote>

---+++ 

Back to [[AMResourceDefinitionsV1][Architecture Management Resource Definitions]]
Attachments
Topic attachments
I	Attachment	Action	Size	Date	Who	Comment
gif	Resource_Diagram.gif	manage	14.6 K	09 Dec 2009 - 23:55	JimAmsden
tiff	Resource_Diagram.tiff	manage	49.0 K	09 Dec 2009 - 23:51	JimAmsden
png	Screen_shot_2009-11-05_at_9.17.24_AM.png	manage	31.4 K	05 Nov 2009 - 14:25	JimAmsden	Diagram for Resource
Topic revision: r37 - 20 Jul 2010 - 17:29:56 - JimConallen
Main
Webs
Main
Sandbox
TWiki
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