New annotation: wps.metadata

[nuest]

Add a new annotation wps.metadata that has two mandatory parameters, href and title. Each annotation is added to the process description as an ows:Metadata element:

# wps.metadata: title = Research paper with method, href = http://my.url/paper.pdf;

results in

<ows:Metadata xlin:title="Research paper with method" xlin:href="http://my.url/paper.pdf"/>

[nuest]

Currently under development in https://github.com/nuest/WPS/tree/wps4r/feature/metadata-annotation

[nuest]

There is an open issue here: URLs that contain a = character break during parsing. Solution probably is encoding the URL in the script, but then it must be decoded during the parsing to be correctly inserted in the XML process description.

[nuest]

Next generation metadata annotation

• use role attributes in a pragmatic way to add semantics to ows:Metadata links
  • Example of "current" way via http://wps1.glues.geo.tu-dresden.de/wps/WebProcessingService?service=WPS&version=1.0.0&request=DescribeProcess&identifier=org.n52.wps.server.r.glues.systemarchetypes

<ows:Metadata xlin:title="R Script" xlin:href="http://wps1.glues.geo.tu-dresden.de:80/wps/r/script/org.n52.wps.server.r.glues.systemarchetypes"/>
<ows:Metadata xlin:title="R Session Info" xlin:href="http://wps1.glues.geo.tu-dresden.de:80/wps/r/sessionInfo"/>
<ows:Metadata xlin:title="GLUES story page 'Global map provides new insights into land use'" xlin:href="http://geoportal-glues.ufz.de/stories/landsystemarchetypes.html"/>
<ows:Metadata xlin:title="Journal paper: Mapping global land system archetypes" xlin:href="http://www.sciencedirect.com/science/article/pii/S0959378013001532"/>
<ows:Metadata xlin:title="Import: advanced-plots.R" xlin:href="http://wps1.glues.geo.tu-dresden.de:80/wps/r/importResource/org.n52.wps.server.r.glues.systemarchetypes/advanced-plots.R"/>

• distinguish between code, additional documentation, runtime environment description, ...
• semantic differences between role and arcrole unknown > use role

Goal:

• need new roles, ideally in (our own?) resolvable semantic description
  • source code repository
  • publication
  • source code
• pragmatic alternative: provide static HTML pages (externally) describing the roles

<ows:Metadata xlin:title="R Script" role="TBD"
<ows:Metadata xlin:title="GLUES story page ..." role="../documentation"
<ows:Metadata xlin:title="Journal paper: ..." role="TBD"
<ows:Metadata xlin:title="Import: advanced-plots.R" > remove, add to ZIP with source code, see #204

Definition of done

• if there are imports, then the source code link provides a link to a ZIP (see Script and resource download as ZIP file #204) of all R files, otherwise the R file directly
• implement role attribute for metadata annotations
• ? add support for metadata for respective inputs and outputs?
• ? discuss: add resources to source code ZIP (instead of using own download endpoint)
• "downloadability" is configurable for each process, i.e. it is part of the wps.des annotation, or a new annotation