[Oslc-Automation] Changes to spreadsheet

[Nick Edgar]

Hi all,

I've made a few updates to the spreadsheet linked at 
http://open-services.net/bin/view/Main/ResourceDefinitions
These include:

- shortened parent property names (to reduce verbosity, and because the 
child properties used the short form, e.g. results, contributions)
automationPlan -> plan
automationResult -> result

- added sub-types to AutomationContribution; the hierarchy is now:
AutomationContribution
  FileContribution
    ArtifactContribution
    LogContribution
  LinkContribution

- FileContribution has properties for file name, size, content URL and 
media type (inherited by subtypes)

- LinkContribution has a url property

If anyone can suggest more general purpose properties I could use for 
these, since they're all pretty generic, I'd appreciate it.

For representing contributions of different types, my expectation is that 
the representation (whether using XML/RDF or other) will use the most 
specific OSLC-defined type as the 'main' type (i.e. element name in 
XML/RDF), with extra rdf:type and other properties as needed.
e.g. an RTC Build log contribution would be something like:
<oslc_auto:LogContribution rdf:about="
https://localhost:9443/jazz/oslc/automation/results/_KSuKABi1Ed6Z54AoyQsJ9A/contributions/_XhG24Bi1Ed6Z54AoyQsJ9A
">

  <!-- general AutomationContribution properties  -->
  <oslc_auto:result rdf:resource="
https://localhost:9443/jazz/oslc/automation/results/_KSuKABi1Ed6Z54AoyQsJ9A
"/>
  <dc:title>Full Build Log</dc:title>

  <!-- LogContribution properties -->
  <oslc_auto:fileName>build.log</oslc_auto:fileName>
  <oslc_auto:fileSize>12345</oslc_auto:fileName>
  <oslc_auto:mediaType>text/plain</oslc_auto:mediaType>
  <oslc_auto:fileContent>
https://localhost:9443/jazz/resource/virtual/build/result/_KSuKABi1Ed6Z54AoyQsJ9A/contributions/_XhG24Bi1Ed6Z54AoyQsJ9A/build.log
</oslc_auto:fileContent>

  <!-- RTC Build properties -->
  <rdf:type>rtc_build:BuildResultContribution</rdf:type>
 
<rtc_build:contributionType>com.ibm.team.build.common.model.IBuildResultContribution.log</rtc_build:contributionType>

</oslc_auto:LogContribution>

I'm also wondering if we can nail down the namespace URL and prefix.  Our 
prototype in RTC Build currently uses:
prefix: oslc_auto  (contrary to oslc-auto in the spreadsheet)
namespace: http://open-services.net/xmlns/automation/1.0/ 

Other specs seem to use a dash instead of a separate segment, e.g. 
oslc-core-2.0.  And should we add 'oslc-'? 
e.g. http://open-services.net/xmlns/oslc-automation-1.0/ 

Thoughts?

Regards,
Nick Edgar
RTC Build component lead

“To jazz, or not to jazz, there is no question!” - Louis Armstrong

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://open-services.net/pipermail/oslc-automation_open-services.net/attachments/20100521/38287cca/attachment-0003.html>