You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@taverna.apache.org by bu...@apache.org on 2015/03/10 18:39:27 UTC
svn commit: r943216 - in /websites/staging/taverna/trunk: cgi-bin/ content/
content/documentation/scufl2/bundle.html
Author: buildbot
Date: Tue Mar 10 17:39:27 2015
New Revision: 943216
Log:
Staging update by buildbot for taverna
Added:
websites/staging/taverna/trunk/content/documentation/scufl2/bundle.html
Modified:
websites/staging/taverna/trunk/cgi-bin/ (props changed)
websites/staging/taverna/trunk/content/ (props changed)
Propchange: websites/staging/taverna/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Mar 10 17:39:27 2015
@@ -1 +1 @@
-1665490
+1665631
Propchange: websites/staging/taverna/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Mar 10 17:39:27 2015
@@ -1 +1 @@
-1665490
+1665631
Added: websites/staging/taverna/trunk/content/documentation/scufl2/bundle.html
==============================================================================
--- websites/staging/taverna/trunk/content/documentation/scufl2/bundle.html (added)
+++ websites/staging/taverna/trunk/content/documentation/scufl2/bundle.html Tue Mar 10 17:39:27 2015
@@ -0,0 +1,492 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <title>Apache Taverna - Scufl2-WorkflowBundle</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="/img/taverna-logo-145x134.png" />
+
+ <link rel="shortcut icon" href="/favicon.ico">
+ <link rel="icon" type="image/png" sizes="145x134" href="/img/taverna-logo-145x134.png">
+ <link rel="apple-touch-icon" sizes="145x134" href="/img/taverna-logo-145x134.png">
+
+ <link rel="stylesheet" href="/lib/bootstrap/css/bootstrap.min.css">
+ <link rel="stylesheet" href="/lib/bootstrap/css/bootstrap-theme.min.css">
+ <link rel="stylesheet" href="/css/sticky-footer-navbar.css">
+ <link rel="stylesheet" href="/css/taverna.css">
+ <link rel="stylesheet" href="/css/pygments.css">
+
+
+
+
+ <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at . http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->
+
+ <!-- JSON-LD markup for Google Structured Data -->
+
+ <!-- generic JSON-LD for this page -->
+ <script type="application/ld+json">
+ {
+ "@context" : "http://schema.org",
+ "@type" : ["CreativeWork"],
+ "@id": "",
+ "name" : "Scufl2-WorkflowBundle",
+ "publisher" : {
+ "@type" : "Organization",
+ "url" : "http://www.apache.org/",
+ "name" : "The Apache Software Foundation (ASF)"
+ },
+ "license": {
+ "@type": "CreativeWork",
+ "@id": "http://www.apache.org/licenses/LICENSE-2.0",
+ "url": "http://www.apache.org/licenses/LICENSE-2.0",
+ "name": "Apache License, Version 2.0"
+ }
+ }
+</script>
+
+ </head>
+
+
+ <body>
+
+ <!-- Static navbar -->
+ <nav class="navbar navbar-default" role="navigation">
+ <div class="container">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/"><img src="/img/taverna-logo-145x134.png" alt="">Apache Taverna</a>
+
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <ul class="nav navbar-nav">
+ <li class="dropdown">
+ <a href="/introduction" data-toggle="dropdown" role="button" aria-expanded="false">Introduction<span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="/introduction/taverna-features">Taverna features</a></li>
+ <li><a href="/introduction/why-use-workflows">Why use workflows?</a></li>
+ <li><a href="/introduction/what-is-in-silico-experimentation">What is âin silicoâ experimentation?</a></li>
+ <li><a href="/introduction/what-is-a-workflow-management-system">What is a Workflow Management System?</a></li>
+ <li><a href="/introduction/how-can-taverna-help-me">How can Taverna help me?</a></li>
+ <li><a href="/introduction/services-in-taverna">Services in Taverna</a></li>
+ <li><a href="/introduction/related-projects">Related projects</a></li>
+ <li><a href="/introduction/chemistry-web-services">Chemistry-web-services</a></li>
+ <li><a href="/introduction/taverna-in-use">Taverna in use</a></li>
+ <li><a href="/introduction/works-with">Works with...</a></li>
+ <li><a href="/introduction/roadmap">Raod Map</a></li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="/documentation" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Documentation<span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="/documentation/glossary">Glossary</a></li>
+ <li><a href="/documentation/quick-start-guide">Quick start guide</a></li>
+ <li><a href="/documentation/components">Components</a></li>
+ <li><a href="/documentation/interaction">Interactions</a></li>
+ <li><a href="/documentation/tutorials">Tutorials</a></li>
+ <li><a href="/documentation/videos">Videos</a></li>
+ <li><a href="/documentation/example-workflows">Example workflows</a></li>
+ <li><a href="/documentation/service-sets">Service sets</a></li>
+ <li><a href="/documentation/provenance">Provenance management</a></li>
+ <li><a href="/documentation/command-line">command-line</a></li>
+ <li><a href="/documentation/server">Taverna Server</a></li>
+ <li><a href="/documentation/taverna-player">Taverna Player</a></li>
+ <li><a href="/documentation/plugins">Plugins</a></li>
+ <li><a href="/documentation/training-and-workshops">Training and workshops</a></li>
+ <li><a href="/documentation/web-service-developers">Web service developers</a></li>
+ <li><a href="/documentation/#tools">Tools and Services</a></li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="/download" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Download<span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="/download">Which Taverna to use</a></li>
+ <li><a href="/download/workbench">TavernaWorkbench</a></li>
+ <li><a href="/download/language">Taverna's SCUFL2 Language</a></li>
+ <li><a href="/download/command-line-tool">Taverna Command Line</a></li>
+ <li><a href="/download/server">Taverna Server</a></li>
+ <li><a href="/documentation/plugins">Plugins</a></li>
+ <li><a href="/download/code">Source Code</a></li>
+ <li><a href="/download/maven">Maven Repository</a></li>
+ <li><a href="/download/system-requirements">System Requirements</a></li>
+ <li><a href="/download/pre-apache">Taverna 2.x (Pre-Apache)</a></li>
+ </ul>
+ </li>
+ <li class="dropdown">
+ <a href="/community" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Community<span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="/community/lists">Mailing Lists</a></li>
+ <li><a href="/community/irc">IRC chat</a></li>
+ <li><a href="/community#contribute">Contribute</a></li>
+ <li><a href="/community#reportbugs">Report a Bug</a></li>
+ <li><a href="/community/edit">Edit website</a></li>
+ </ul>
+ </li>
+ </ul>
+
+ <form >
+
+
+ <!--<input type="submit" id="submit" value="Search">-->
+ </form>
+
+ <form class="navbar-form navbar-right" role="search"
+ name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="taverna.incubator.apache.org" name="sitesearch" type="hidden"/>
+ <div class="form-group input-group">
+ <input type="text" name="q" id="query" placeholder="Search" class="form-control">
+ <span class="input-group-btn">
+ <button type="submit" class="btn btn-default">Search</button>
+ </span>
+ </div>
+ </form>
+
+ <ul class="nav navbar-nav navbar-right">
+ <li class="dropdown">
+ <a href="http://www.apache.org/" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">ASF<span class="caret"></span></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="http://www.apache.org/">Apache Software Foundation</a></li>
+ <li><a href="http://www.apache.org/foundation/how-it-works.html">How it works</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+ <li><a href="http://incubator.apache.org/projects/taverna.html">Taverna Incubation Status</a></li>
+ </ul>
+ </li>
+ </ul>
+ </div><!--/.nav-collapse -->
+ </div><!--/.container-->
+ </nav>
+
+
+ <div id="page" class="container">
+ <h1>Scufl2-WorkflowBundle</h1>
+ <div class="alert alert-info" role="alert"><p><span class="glyphicon glyphicon-info-sign" aria-hidden="true"></span>
+
+Taverna is transitioning to the Apache Incubator.
+This webpage reflects material not yet released under Apache Incubator.
+Instead it shows <a class="alert-link" href="http://www.taverna.org.uk/">taverna2</a> material that is expected to become part of the Apache Incubator project in the future.
+</div>
+
+
+ <div id="content"><p>The entry point of the Taverna Workflow Bundle.</p>
+<p>Defines the <em>workflows</em> and <em>profiles</em> of a
+ <a href="/documentation/scufl2/taverna_bundle">Taverna Workflow Bundle</a>.
+The <em>main workflow</em> is also normally defined, which would be the top-level workflow to execute.
+The profiles defines how these workflows can be realised and <em>executed</em> on different environments,
+ one of which can be suggested as the <em>main profile</em>.</p>
+<h2 id="bundle-path-and-root-files">Bundle path and root files</h2>
+<p>The <strong>workflow bundle document</strong> in RDF/XML format <strong>should</strong> be in in <code>/workflowBundle.rdf</code> within the bundle archive.</p>
+<p>If the archive is a <a href="/documentation/scufl2/taverna_bundle">workflow bundle</a>,
+ i.e. <code>/mimetype</code> is <code>application/vnd.taverna.scufl2.workflow-bundle</code>,
+ then the <code>META-INF/container.xml</code> can define <strong>root files</strong> at alternative paths and media types.
+This specification requires that one of those formats is <code>application/rdf+xml</code> according to this specification. </p>
+<p>Example <code>META-INF/container.xml</code>: (may be outdated)</p>
+<div class="codehilite"><pre><span class="cp"><?xml version=&quot;1.0&quot;?></span>
+<span class="nt"><container</span> <span class="na">version=</span><span class="s">"1.0"</span>
+ <span class="na">xmlns=</span><span class="s">";urn:oasis:names:tc:opendocument:xmlns:container"</span><span class="nt">></span>
+ <span class="nt"><rootfiles></span>
+ <span class="nt"><rootfile</span> <span class="na">full-path=</span><span class="s">"workflowBundle.ttl"</span>
+ <span class="na">media-type=</span><span class="s">"text/turtle"</span> <span class="nt">/></span>
+ <span class="nt"><rootfile</span> <span class="na">full-path=</span><span class="s">"workflowBundle.rdf"</span>
+ <span class="na">media-type=</span><span class="s">"application/rdf+xml"</span> <span class="nt">/></span>
+ <span class="nt"></rootfiles></span>
+<span class="nt"></container></span>
+</pre></div>
+
+
+<p>This defines the RDF/XML root file to be <code>/workflowBundle.rdf</code> -
+ with <code>workflowBundle.ttl</code> being an alternate representation the resource in Turtle format.</p>
+<p>SCUFL2-compliant workflow bundle writers:</p>
+<ul>
+<li><strong>Must</strong> set the bundle <strong>mimetype</strong> to <code>application/vnd.taverna.scufl2.workflow-bundle</code></li>
+<li><strong>Must</strong> add a workflow bundle document in <code>application/rdf+xml</code> format</li>
+<li><strong>Should</strong> store the workflow bundle document in <code>/workflowBundle.rdf</code></li>
+<li><strong>Must not</strong> contain a resource <code>/workflowBundle.rdf</code> which is not the workflow bundle document</li>
+<li>If the <code>application/rdf+xml</code> representation is not in <code>/workflowBundle.rdf</code>,
+ the writer <strong>must</strong> include <code>META-INF/container.xml</code> with the required <code><rootfile></code> entries.</li>
+<li><code>META-INF/container.xml</code>, if present, <strong>must</strong> contain one and only one <code>rootfile</code> with the media-type
+ <code>application/rdf+xml</code>.
+ rootfiles of other media-types <strong>may</strong> be included, but their formats and restrictions are not defined by this specification.</li>
+<li><strong>May</strong> Add additional representation of the workflow bundle document (and other documents).
+ Alternates of the workflow bundle document <strong>should</strong> be included in the <code>META-INF/container.xml</code>,
+ but only if they can be considered to fully specify the workflow bundle as in the RDF/XML format.
+ (So for instance a <code>text/html</code> or <code>image/png</code> representation would not normally be considered a
+ <strong>rootfile</strong> if it does not include all the structural information from the RDF/XML representation as specified here)</li>
+</ul>
+<p>It is possible to include a workflow bundle document within a different kind of archive or bundle,
+ for instance in a data bundle.
+In this case the bundle is not considered an <code>application/vnd.taverna.scufl2.workflow-bundle</code> -
+ but producers of such archives:</p>
+<ul>
+<li><strong>Should</strong> store the workflow bundle document in <code>/workflowBundle.rdf</code>,
+ unless the workflow bundle is not to be considered to have a 'main' or 'prominent' role within the archive.
+ (For instance if the archive is a collection of workflow bundles).</li>
+<li><strong>Should</strong> have a <code>mimetype</code> and <code>META-INF/container.xml</code> resource which declares the archive's main entry point,
+ like the data bundle document.
+ The mime type <strong>must not</strong> be <code>application/vnd.taverna.scufl2.workflow-bundle</code> and
+ the root files <strong>should not</strong> be the workflow bundle document.</li></li>
+<li><strong>Should</strong> link to the workflow bundle document from a resource within the archive which (ultimately)
+ is linked to from one of the <code>rootfile</code> documents.
+ Such documents <strong>should</strong> be in RDF/XML format.</li>
+<li><strong>Should</strong> declare the media type of the RDF/XML workflow bundle document as <code>application/rdf+xml</code>
+ in its <code>META-INF/manifest.xml</code></li>
+</ul>
+<p>SCUFL2 compliant workflow bundle readers:</p>
+<ul>
+<li><strong>Should</strong> assume that <code>/workflowBundle.rdf</code> - if present -
+ is the root workflow bundle in the <code>application/rdf+xml</code> format specified here.</li>
+<li><strong>Should</strong> assume that if the archive's <code>mimetype</code> is <code>application/vnd.taverna.scufl2.workflow-bundle</code>,
+ then the <code>rootfile</code> in <code>META-INF/container.xml</code> with the media type {{application/rdf+xml})
+ is the root workflow bundle document.</li>
+<li><strong>May</strong> assume that any alternate formats listed as a <code>rootfile</code> in a <code>application/vnd.taverna.scufl2.workflow-bundle</code>
+ archive would fully cover the specification of the RDF/XML representation, and read such formats instead.</li>
+<li><strong>May</strong> assume that any <code>application/rdf+xml</code> document with a <code>xsi:type="WorkflowBundleDocument"</code>
+ can be parsed according to the Scufl2 XML schema</li>
+</ul>
+<h2 id="identifiers">Identifiers</h2>
+<p>Workflow bundles and their resources <strong>must</strong> be declared with relative identifiers within the archive.
+In a <code>application/vnd.taverna.scufl2.workflow-bundle</code> archive,
+ the workflow bundle <strong>must</strong> be identified as the root of the archive.
+If the Workflow Bundle document is in <code>workflowBundle.rdf</code> within the archive, the workflow identifier is <code>./</code>.<br />
+This <strong>should</strong> be achieved by setting <code>xml:base="./"</code> and <code>rdf:about=""</code>.</p>
+<p>This means that one can mint a URI to refer to resources within the bundle archive, including the workflow bundle,
+ workflows and representations.
+If <code>http://example.com/myWfBundle.scufl2</code> returns a <a href="/documentation/scufl2/taverna_bundle">Scufl2 workflow bundle</a>
+ archive of the content type <code>application/vnd.taverna.scufl2.workflow-bundle</code>,<br />
+ then (assuming default structure of the archive):</p>
+<ul>
+<li><code>http://example.com/myWfBundle.scufl2</code> identifies for the Workflow Bundle representation (the archive)</li>
+<li><code>http://example.com/myWfBundle.scufl2/</code> identifies the Workflow Bundle (as described here)</li>
+<li><code>http://example.com/myWfBundle.scufl2/workflowBundle.rdf</code> identifies the Workflow Bundle representation in RDF/XML</li>
+<li><code>http://example.com/myWfBundle.scufl2/workflow/HelloWorld/</code> identifies the "HelloWorld"
+ <a href="/documentation/scufl2/workflow">workflow</a> within the bundle</li>
+<li><code>http://example.com/myWfBundle.scufl2/workflow/HelloWorld.rdf</code> identifies the "HelloWorld" workflow representation in RDF/XML</li>
+<li><code>http://example.com/myWfBundle.scufl2/workflow/HelloWorld/processor/Hello/</code> identifies the "Hello"
+ processor within the "HelloWorld" workflow.</li>
+</ul>
+<h3 id="embedded-workflow-bundles">Embedded workflow bundles</h3>
+<p>If the archive is another type of bundle which includes the workflow bundle
+ (but is not primarily playing the role as the format for this workflow bundle),
+ the local workflow identifier <strong>should</strong> be unique within the archive.
+This is easiest achieved by using the same folder technique as for the workflow representations:</p>
+<ul>
+<li><code>workflowBundle1.rdf</code> can define <code>workflowBundle1/</code></li>
+<li><code>exampleWorkflowBundles/hello.rdf</code> defines <code>exampleWorkflowBundles/hello/</code></li>
+</ul>
+<p>Such embedded workflow bundles <strong>should</strong> include their constituent representations
+ (such as <code>workflow/HelloWorld.rdf</code>) within that folder,
+ for instance <code>exampleWorkflowBundles/hello/workflow/HelloWorld.rdf</code> to define
+ <code>exampleWorkflowBundles/hello/workflow/HelloWorld/</code> - but could also be shared among bundles,
+ for instance both <code>workflowBundle1.rdf</code> and <code>workflowBundle2.rdf</code> might refer to <code>workflow/Shared.rdf</code>.</p>
+<h3 id="global-workflow-bundle-identifiers">Global workflow bundle identifiers</h3>
+<p>Workflow bundles <strong>should</strong> declare a <strong>sameBaseAs</strong> reference to a globally unique non-informational URI.</p>
+<p>Anyone can generate such a URI using the form <code>http://ns.taverna.org.uk/2010/workflowBundle/UUID/</code> -
+ for instance <code>http://ns.taverna.org.uk/2010/workflowBundle/28f7c554-4f35-401f-b34b-516e9a0ef731/</code> -
+ including the trailing slash.</p>
+<p>The semantics of <strong>sameBaseAs</strong> is a kind of recursive version of <strong>owl:sameAs</strong> -
+ so also resources which URI start with the same will be included.</p>
+<p>So if:</p>
+<div class="codehilite"><pre><span class="p">@</span><span class="n">prefix</span> <span class="p">:</span> <span class="o"><</span><span class="p">;</span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">ns</span><span class="p">.</span><span class="n">taverna</span><span class="p">.</span><span class="n">org</span><span class="p">.</span><span class="n">uk</span><span class="o">/</span>2010<span class="o">/</span><span class="n">scufl2</span><span class="o">></span> <span class="p">.</span>
+<span class="p">@</span><span class="n">prefix</span> <span class="n">rdfs</span><span class="p">:</span> <span class="o"><</span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="p">.</span><span class="n">w3</span><span class="p">.</span><span class="n">org</span><span class="o">/</span>2000<span class="o">/</span>01<span class="o">/</span><span class="n">rdf</span><span class="o">-</span><span class="n">schema</span><span class="o">></span> <span class="p">.</span>
+
+<span class="o"><./></span> <span class="n">a</span> <span class="p">:</span><span class="n">WorkflowBundle</span><span class="p">;</span>
+ <span class="p">:</span><span class="n">name</span> "<span class="n">HelloWorld</span>"<span class="p">;</span>
+ <span class="p">:</span><span class="n">sameBaseAs</span> <span class="o"><</span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">ns</span><span class="p">.</span><span class="n">taverna</span><span class="p">.</span><span class="n">org</span><span class="p">.</span><span class="n">uk</span><span class="o">/</span>2010<span class="o">/</span><span class="n">workflowBundle</span><span class="o">/</span>28<span class="n">f7c554</span><span class="o">-</span>4<span class="n">f35</span><span class="o">-</span>401<span class="n">f</span><span class="o">-</span><span class="n">b34b</span><span class="o">-</span>516<span class="n">e9a0ef731</span><span class="o">/></span><span class="p">;</span>
+ <span class="p">:</span><span class="n">mainWorkflow</span> <span class="o"><</span><span class="n">workflow</span><span class="o">/</span><span class="n">HelloWorld</span><span class="o">/></span><span class="p">;</span>
+ <span class="p">:</span><span class="n">workflow</span> <span class="o"><</span><span class="n">workflow</span><span class="o">/</span><span class="n">HelloWorld</span><span class="o">/></span><span class="p">;</span>
+
+<span class="o"><</span><span class="n">workflow</span><span class="o">/</span><span class="n">HelloWorld</span><span class="o">/></span> <span class="n">a</span> <span class="p">:</span><span class="n">Workflow</span><span class="p">;</span>
+ <span class="n">rdfs</span><span class="p">:</span><span class="n">seeAlso</span> <span class="o"><</span><span class="n">workflow</span><span class="o">/</span><span class="n">HelloWorld</span><span class="p">.</span><span class="n">ttl</span><span class="o">></span> <span class="p">.</span>
+</pre></div>
+
+
+<p>then also:</p>
+<p><code><./></code>= <code><http://ns.taverna.org.uk/2010/workflowBundle/28f7c554-4f35-401f-b34b-516e9a0ef731/></code> <br />
+<code><workflow/HelloWorld/></code> = <code><http://ns.taverna.org.uk/2010/workflowBundle/28f7c554-4f35-401f-b34b-516e9a0ef731/workflow/HelloWorld/></code> <br />
+<code><workflow/HelloWorld.rdf></code> = <code><http://ns.taverna.org.uk/2010/workflowBundle/28f7c554-4f35-401f-b34b-516e9a0ef731/workflow/HelloWorld.rdf></code></p>
+<p>This allows anyone to make a statement about any resource within the workflow bundle,
+ even if the URL of the workflow bundle representation itself might change,
+ be it on a local USB disk, DropBox folder, myExperiment, etc.</p>
+<h4 id="updating-the-uuid">Updating the UUID</h4>
+<p>It is up to the software editing or creating the workflow to assign a new UUID as soon as
+ any change has been done to any workflow, profile or workflow bundle,
+ as this is the globally unique identifier for this workflow archive,
+ and also the base URI for all the other resources in the archive.</p>
+<blockquote>
+<p><img alt="" src="/img/warning.png" /><strong>Not implemented by API</strong> Scufl2 API do not yet</p>
+<p>automatically update the workflow bundle identifier.
+<a href="http://www.mygrid.org.uk/dev/issues/browse/SCUFL2-41">SCUFL2-41</a></p>
+<p>To update the URI, use <code>workflowBundle.setSameBaseAs(WorkflowBundle.generateIdentifier())</code>.</p>
+</blockquote>
+<h2 id="example-representation-in-rdfxml">Example representation in RDF/XML</h2>
+<p>(may be outdated)</p>
+<div class="codehilite"><pre><span class="cp"><?xml version="1.0"?></span>
+<span class="nt"><rdf:RDF</span> <span class="na">xmlns=</span><span class="s">"http://ns.taverna.org.uk/2010/scufl2#"</span>
+ <span class="na">xmlns:rdf=</span><span class="s">"http://www.w3.org/1999/02/22-rdf-syntax-ns#"</span> <span class="na">xmlns:rdfs=</span><span class="s">"http://www.w3.org/2000/01/rdf-schema#"</span>
+ <span class="na">xmlns:xsi=</span><span class="s">"http://www.w3.org/2001/XMLSchema-instance"</span>
+ <span class="na">xsi:schemaLocation=</span><span class="s">"http://ns.taverna.org.uk/2010/scufl2# http://ns.taverna.org.uk/2010/scufl2/scufl2.xsd http://www.w3.org/1999/02/22-rdf-syntax-ns# http://ns.taverna.org.uk/2010/scufl2/rdf.xsd"</span>
+ <span class="na">xsi:type=</span><span class="s">"WorkflowBundleDocument"</span> <span class="na">xml:base=</span><span class="s">"./"</span><span class="nt">></span>
+ <span class="nt"><WorkflowBundle</span> <span class="na">rdf:about=</span><span class="s">""</span><span class="nt">></span>
+ <span class="nt"><name></span>HelloWorld<span class="nt"></name></span>
+ <span class="nt"><sameBaseAs</span>
+ <span class="na">rdf:resource=</span><span class="s">"http://ns.taverna.org.uk/2010/workflowBundle/28f7c554-4f35-401f-b34b-516e9a0ef731/"</span> <span class="nt">/></span>
+ <span class="nt"><mainWorkflow</span> <span class="na">rdf:resource=</span><span class="s">"workflow/HelloWorld/"</span> <span class="nt">/></span>
+ <span class="nt"><workflow></span>
+ <span class="nt"><Workflow</span> <span class="na">rdf:about=</span><span class="s">"workflow/HelloWorld/"</span><span class="nt">></span>
+ <span class="nt"><rdfs:seeAlso</span> <span class="na">rdf:resource=</span><span class="s">"workflow/HelloWorld.rdf"</span> <span class="nt">/></span>
+ <span class="nt"></Workflow></span>
+ <span class="nt"></workflow></span>
+ <span class="c"><!--</span>
+<span class="c"> <workflow></span>
+<span class="c"> <Workflow rdf:about="workflow/SomeNestedWorkflow/"></span>
+<span class="c"> <rdfs:seeAlso rdf:resource="workflow/SomeNestedWorkflow.rdf" /></span>
+<span class="c"> </Workflow></span>
+<span class="c"> </workflow></span>
+<span class="c"> --></span>
+ <span class="nt"><mainProfile</span> <span class="na">rdf:resource=</span><span class="s">"profile/tavernaWorkbench/"</span> <span class="nt">/></span>
+ <span class="nt"><profile></span>
+ <span class="nt"><Profile</span> <span class="na">rdf:about=</span><span class="s">"profile/tavernaServer/"</span><span class="nt">></span>
+ <span class="nt"><rdfs:seeAlso</span> <span class="na">rdf:resource=</span><span class="s">"profile/tavernaServer.rdf"</span> <span class="nt">/></span>
+ <span class="nt"></Profile></span>
+ <span class="nt"></profile></span>
+ <span class="nt"><profile></span>
+ <span class="nt"><Profile</span> <span class="na">rdf:about=</span><span class="s">"profile/tavernaWorkbench/"</span><span class="nt">></span>
+ <span class="nt"><rdfs:seeAlso</span> <span class="na">rdf:resource=</span><span class="s">"profile/tavernaWorkbench.rdf"</span> <span class="nt">/></span>
+ <span class="nt"></Profile></span>
+ <span class="nt"></profile></span>
+ <span class="nt"><rdfs:seeAlso</span> <span class="na">rdf:resource=</span><span class="s">"annotation/workflowBundle.rdf"</span> <span class="nt">/></span>
+ <span class="nt"></WorkflowBundle></span>
+<span class="nt"></rdf:RDF></span>
+</pre></div>
+
+
+<p>This example defines the workflow bundle "HelloWorld".
+It contains one workflow <code>workflow/HelloWorld</code>, which is also the <strong>main workflow</strong>.
+Any additional workflows are typically nested (and nested-nested, etc) workflows bound as activities in processors).
+Two execution profiles are provided, and <code>profile/tavernaWorkbench</code> is dedicated as the <strong>main profile</strong>.</p>
+<h2 id="properties">Properties</h2>
+<ul>
+<li><strong>name</strong> (required) gives the human readable title for this workflow archive.
+ This is a subproperty of <code>dc:title</code>.</li>
+<li><strong>sameBaseAs</strong> (optional) gives a unique URI which is <strong>owl:sameAs</strong> with this workflow bundle and its children.</li>
+<li><strong>workflow</strong> (required) All <a href="/documentation/scufl2/workflow">workflows</a> included in this bundle.
+ Each workflow must have an <strong>rdfs:seeAlso</strong> link to the bundle resource that defines the workflow,
+ typically <code>workflow/workflowName.rdf</code> corresponding to the non-information resource <code>workflow/workflowName/</code>.</li>
+<li><strong>mainWorkflow</strong> (optional) The reference to the top-level <a href="/documentation/scufl2/workflow">workflow</a> of this bundle.
+ It is valid to have a workflow bundle without a main workflow,
+ for instance if the bundled workflows are unconnected "workflow fragments".
+ If there is a <strong>mainProfile</strong> the workflow bundle must also have a <strong>mainWorkflow</strong>.
+ The main workflow must always be listed under <strong>workflow</strong>.</li>
+<li><strong>profile</strong> (optional) <a href="/wiki/display/developer/Scufl2-Profile">profiles</a> specifying how to <strong>execute</strong> the bundled workflows. In particular the profile provides a set of configured activities bound to the processors for a particular run environment. If no profiles are specified this is an abstract workflow bundle.</li></li>
+<li><strong>mainProfile</strong> (optional) the suggested <strong>main profile</strong>. Execution platforms unable to choose between the provided profiles can select this profile as a default. It is valid to have a workflow bundle without a main profile (even if it has other profiles), but any main profile must be listed under <strong>profile</strong>.</li></li>
+<li><strong>rdfs:seeAlso</strong> (optional) link to annotations about the workflow bundle and its content. Traditionally found in <code>annotation/workflowBundle.rdf</code>, which should contain further links to annotations from different sources, for instance <code>annotation/myExperiment.rdf</code> for annotations included from myExperiment.</li></li>
+</ul>
+<h2 id="bundle-links">Bundle links</h2>
+<p>The workflow bundle document is the starting point for finding all workflow bundle resources within the archive.
+Each of the workflows and profiles must therefore have a <strong>rdfs:seeAlso</strong> link to the bundle resource that defines it.</p>
+<p>If alternate formats other than the required RDF/XML format is included in the bundle,
+ these formats can therefore link to resources in other formats, for instance in an additional <code>workflowBundle.ttl</code>
+ (<a href="http://www.w3.org/TeamSubmission/turtle/">Turtle format</a>):</p>
+<div class="codehilite"><pre><span class="p">@</span><span class="n">prefix</span> <span class="p">:</span> <span class="o"><</span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">ns</span><span class="p">.</span><span class="n">taverna</span><span class="p">.</span><span class="n">org</span><span class="p">.</span><span class="n">uk</span><span class="o">/</span>2010<span class="o">/</span><span class="n">scufl2</span>#<span class="o">></span> <span class="p">.</span>
+<span class="p">@</span><span class="n">prefix</span> <span class="n">rdfs</span><span class="p">:</span> <span class="o"><</span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="p">.</span><span class="n">w3</span><span class="p">.</span><span class="n">org</span><span class="o">/</span>2000<span class="o">/</span>01<span class="o">/</span><span class="n">rdf</span><span class="o">-</span><span class="n">schema</span>#<span class="o">></span> <span class="p">.</span>
+
+<span class="o"><./></span> <span class="n">a</span> <span class="p">:</span><span class="n">WorkflowBundle</span><span class="p">;</span>
+ <span class="p">:</span><span class="n">mainProfile</span> <span class="o"><</span><span class="n">profile</span><span class="o">/</span><span class="n">tavernaWorkbench</span><span class="o">/></span><span class="p">;</span>
+ <span class="p">:</span><span class="n">mainWorkflow</span> <span class="o"><</span><span class="n">workflow</span><span class="o">/</span><span class="n">HelloWorld</span><span class="o">/></span><span class="p">;</span>
+ <span class="p">:</span><span class="n">name</span> "<span class="n">HelloWorld</span>"<span class="p">;</span>
+ <span class="p">:</span><span class="n">profile</span> <span class="o"><</span><span class="n">profile</span><span class="o">/</span><span class="n">tavernaServer</span><span class="o">/></span><span class="p">,</span>
+ <span class="o"><</span><span class="n">profile</span><span class="o">/</span><span class="n">tavernaWorkbench</span><span class="o">/></span><span class="p">;</span>
+ <span class="p">:</span><span class="n">sameBaseAs</span> <span class="o"><</span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">ns</span><span class="p">.</span><span class="n">taverna</span><span class="p">.</span><span class="n">org</span><span class="p">.</span><span class="n">uk</span><span class="o">/</span>2010<span class="o">/</span><span class="n">workflowBundle</span><span class="o">/</span>28<span class="n">f7c554</span><span class="o">-</span>4<span class="n">f35</span><span class="o">-</span>401<span class="n">f</span><span class="o">-</span><span class="n">b34b</span><span class="o">-</span>516<span class="n">e9a0ef731</span><span class="o">/></span><span class="p">;</span>
+ <span class="p">:</span><span class="n">workflow</span> <span class="o"><</span><span class="n">workflow</span><span class="o">/</span><span class="n">HelloWorld</span><span class="o">/></span><span class="p">;</span>
+ <span class="n">rdfs</span><span class="p">:</span><span class="n">seeAlso</span> <span class="o"><</span><span class="n">annotation</span><span class="o">/</span><span class="n">workflowBundle</span><span class="p">.</span><span class="n">ttl</span><span class="o">></span> <span class="p">.</span>
+
+<span class="o"><</span><span class="n">profile</span><span class="o">/</span><span class="n">tavernaServer</span><span class="o">/></span> <span class="n">a</span> <span class="p">:</span><span class="n">Profile</span><span class="p">;</span>
+ <span class="n">rdfs</span><span class="p">:</span><span class="n">seeAlso</span> <span class="o"><</span><span class="n">profile</span><span class="o">/</span><span class="n">tavernaServer</span><span class="p">.</span><span class="n">ttl</span><span class="o">></span> <span class="p">.</span>
+
+<span class="o"><</span><span class="n">profile</span><span class="o">/</span><span class="n">tavernaWorkbench</span><span class="o">/></span> <span class="n">a</span> <span class="p">:</span><span class="n">Profile</span><span class="p">;</span>
+ <span class="n">rdfs</span><span class="p">:</span><span class="n">seeAlso</span> <span class="o"><</span><span class="n">profile</span><span class="o">/</span><span class="n">tavernaWorkbench</span><span class="p">.</span><span class="n">ttl</span><span class="o">></span> <span class="p">.</span>
+
+<span class="o"><</span><span class="n">workflow</span><span class="o">/</span><span class="n">HelloWorld</span><span class="o">/></span> <span class="n">a</span> <span class="p">:</span><span class="n">Workflow</span><span class="p">;</span>
+ <span class="n">rdfs</span><span class="p">:</span><span class="n">seeAlso</span> <span class="o"><</span><span class="n">workflow</span><span class="o">/</span><span class="n">HelloWorld</span><span class="p">.</span><span class="n">ttl</span><span class="o">></span> <span class="p">.</span>
+</pre></div>
+
+
+<h2 id="parsingwriting">Parsing/writing</h2>
+<p>SCUFL2 compliant writers, when producing the workflow bundle document:</p>
+<ul>
+<li><strong>Should</strong> write the workflow bundle RDF/XML document according to the SCUFL2 XML schema,
+ use the default namespace <code>xmlns="http://ns.taverna.org.uk/2010/scufl2#"</code> and declare the
+ <code>xsi:type="WorkflowBundleDocument"</code></li>
+<li><strong>Must</strong> ensure the workflow bundle RDF/XML document is valid <a href="http://www.w3.org/TR/REC-rdf-syntax/">RDF/XML</a>
+ and includes the properties deemed required by this specification.
+ Conforming to the XML schema should ensure this.</li>
+<li><strong>Should</strong> set the <code>xml:base</code> property to<code>"./</code></li>
+<li><strong>Should</strong> set <strong>rdf:about</strong> to <code>""</code> (or <code>"./"' if</code>xml:base` is not set))</li>
+<li><strong>Should</strong> declare a <strong>mainWorkflow</strong> and <strong>mainProfile</strong></li>
+<li><strong>Must</strong>ensure that any <strong>workflow</strong>/<strong>profile</strong> has a relative <strong>rdfs:seeAlso</strong> link to a bundle resource in
+ <code>application/rdf+xml</code> which defines <br />
+ that <a href="/documentation/scufl2/workflow">workflow</a> / <a href="/documentation/scufl2/profile">profile</a>.</li>
+</ul>
+<p>SCUFL2 compliant readers, when parsing a workflow bundle document:</p>
+<p><strong>May</strong> assume that a declared workflow/profile is defined in the referenced representation.
+ For instance, if:</p>
+<div class="codehilite"><pre><span class="nt"><workflow></span>
+ <span class="nt"><Workflow</span> <span class="na">rdf:about=</span><span class="s">"workflow/SomeNestedWorkflow/"</span><span class="nt">></span>
+ <span class="nt"><rdfs:seeAlso</span> <span class="na">rdf:resource=</span><span class="s">"workflow/SomeNestedWorkflow.rdf"</span> <span class="nt">/></span>
+ <span class="nt"></Workflow></span>
+<span class="nt"></workflow></span>
+</pre></div>
+
+
+<p>then <code>workflow/SomeNestedWorkflow.rdf</code>> <strong>must</strong> contain a <a href="/documentation/scufl2/workflow">workflow definition</a>
+ for <code>workflow/SomeNestedWorkflow/</code>. <br />
+<strong>May</strong> parse the <code>/workflowBundle.rdf</code> as RDF/XML <br />
+<strong>May</strong> parse the {/workflowBundle.rdf}} according to the XML schema if the <code>xsi:type="WorkflowBundleDocument"</code>
+ is set on the <code>rdf:RDF</code> element.</p></div>
+
+ </div>
+
+ <footer class="footer">
+ <div class="container">
+ <p id="copyright" class="text-muted">
+ Copyright © 2014-2015 The Apache Software Foundation, Licensed under the
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ Apache and the Apache feather logo are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </footer>
+
+
+
+ <script src="/lib/jquery/jquery-1.11.1.min.js"></script>
+<script src="/lib/bootstrap/js/bootstrap.min.js"></script>
+
+<script>
+ jQuery(function($) {
+ if($(window).width()>769){
+ $('.navbar .dropdown').hover(function() {
+ $(this).find('.dropdown-menu').first().stop(true, true).delay(250).slideDown();
+
+ }, function() {
+ $(this).find('.dropdown-menu').first().stop(true, true).delay(100).slideUp();
+
+ });
+
+ $('.navbar .dropdown > a').click(function(){
+ location.href = this.href;
+ });
+
+ }
+ });
+</script>
+
+
+ </body>
+</html>
\ No newline at end of file