| 1 | <html xmlns:xi="http://www.w3.org/2001/XInclude"> |
|---|
| 2 | <head> |
|---|
| 3 | <title>CLARIN Web Services: core CMD model for Web Service descriptions</title> |
|---|
| 4 | <link rel="shortcut icon" href="http://www.clarin.eu/sites/all/themes/clarin/images/clarin-icon16.ico" /> |
|---|
| 5 | <link rel="icon" href="$site$interface/JSXAPPS/ISOcat/images/favicon.gif" type="image/gif" /> |
|---|
| 6 | <link href="$site$clarin/ws/cmd-core/style.css" rel="stylesheet" type="text/css" /> |
|---|
| 7 | <link href="$site$clarin/ws/cmd-core/xmlverbatim.css" rel="stylesheet" type="text/css" /> |
|---|
| 8 | <script type="text/javascript" src="$site$interface/addins/jquery/js/jquery-1.6.4.js"> |
|---|
| 9 | <!-- |
|---|
| 10 | keep the script alive in IE//--> |
|---|
| 11 | </script> |
|---|
| 12 | <link href="$site$interface/addins/jquery/js/plugins/treeTable-2.3.0/src/stylesheets/jquery.treeTable.css" rel="stylesheet" type="text/css" /> |
|---|
| 13 | <script type="text/javascript" src="$site$interface/addins/jquery/js/plugins/treeTable-2.3.0/src/javascripts/jquery.treeTable.js"> |
|---|
| 14 | <!-- |
|---|
| 15 | keep the script alive in IE//--> |
|---|
| 16 | </script> |
|---|
| 17 | <script type="text/javascript"> |
|---|
| 18 | \$(document).ready(function() { |
|---|
| 19 | \$("#core-profile").treeTable(); |
|---|
| 20 | }); |
|---|
| 21 | </script> |
|---|
| 22 | </head> |
|---|
| 23 | <body> |
|---|
| 24 | <table class="main"> |
|---|
| 25 | <tr> |
|---|
| 26 | <td class="left"> |
|---|
| 27 | <a href="http://www.clarin.eu/"><img src="http://catalog.clarin.eu/trac-clarin-logo.jpg" width="125px" border="0" /></a> |
|---|
| 28 | <div class="note" style="text-align:center;font-style:italic;">Web Services</div> |
|---|
| 29 | </td> |
|---|
| 30 | <td class="right"> |
|---|
| 31 | <div class="title">Core CMD model for Web Service descriptions</div> |
|---|
| 32 | </td> |
|---|
| 33 | </tr> |
|---|
| 34 | <tr> |
|---|
| 35 | <td class="left"> |
|---|
| 36 | <ol class="menu"> |
|---|
| 37 | <li> |
|---|
| 38 | <a href="#intro">introduction</a> |
|---|
| 39 | </li> |
|---|
| 40 | <li> |
|---|
| 41 | <a href="#model">model</a> |
|---|
| 42 | </li> |
|---|
| 43 | <li> |
|---|
| 44 | <a href="#profile">profile</a> |
|---|
| 45 | </li> |
|---|
| 46 | <li> |
|---|
| 47 | <a href="#usage">usage</a> |
|---|
| 48 | </li> |
|---|
| 49 | <li> |
|---|
| 50 | <a href="#validation">validation</a> |
|---|
| 51 | </li> |
|---|
| 52 | <li> |
|---|
| 53 | <a href="#example">example</a> |
|---|
| 54 | </li> |
|---|
| 55 | <li> |
|---|
| 56 | <a href="#faq">FAQ</a> |
|---|
| 57 | </li> |
|---|
| 58 | <li> |
|---|
| 59 | <a href="#pubs">publications</a> |
|---|
| 60 | </li> |
|---|
| 61 | <li> |
|---|
| 62 | <a href="#contact">contact</a> |
|---|
| 63 | </li> |
|---|
| 64 | <li> |
|---|
| 65 | <a href="#ack">acknowledgements</a> |
|---|
| 66 | </li> |
|---|
| 67 | <li> |
|---|
| 68 | <a href="#log">change log</a> |
|---|
| 69 | </li> |
|---|
| 70 | </ol> |
|---|
| 71 | </td> |
|---|
| 72 | <td valign="top" style="padding:10;"> |
|---|
| 73 | <a name="intro"></a> |
|---|
| 74 | <div class="subtitle">Introduction</div> |
|---|
| 75 | <p> Within the CLARIN infrastructure a growing number of web services is becoming available. To answer linguistic research questions advanced workflows of these services will be created. Various national CLARIN initiatives are using or building workflow engines to specify and execute these workflows. In general these workflow engines execute web services based on metadata stored in an engine specific repository. This core CMD model for CLARIN web service descriptions is based on the overlap between the metadata schemes of these repositories. </p> |
|---|
| 76 | <fieldset style="border: 1px dashed red;margin-bottom:1em;"> |
|---|
| 77 | <legend style="font-weight:bold;">Preview</legend> |
|---|
| 78 | <p> This is not yet the final version of this page. The following actions still need to be done: </p> |
|---|
| 79 | <ul> |
|---|
| 80 | <li>in ISOcat: <ol> |
|---|
| 81 | <li>complete the new data category specifications and make them public</li> |
|---|
| 82 | </ol> |
|---|
| 83 | </li> |
|---|
| 84 | </ul> |
|---|
| 85 | </fieldset> |
|---|
| 86 | <a name="model"></a> |
|---|
| 87 | <div class="subtitle">UML model</div> |
|---|
| 88 | <p> |
|---|
| 89 | <img src="model/WS-Core-Components.png" style="padding:1em;" /> |
|---|
| 90 | <br /> |
|---|
| 91 | <span> ( View the UML model as <a href="model/WS-Core-Components.svg">SVG</a>, <a href="model/WS-Core-Components.emf">EMF</a>, <a href="model/WS-Core-Components.jpg">JPEG</a>, <a href="model/WS-Core-Components.png">PNG</a> or <a href="model/WS-Core-Components.pdf">PDF</a> ) </span> |
|---|
| 92 | </p> |
|---|
| 93 | <a name="profile"></a> |
|---|
| 94 | <div class="subtitle">CMD profile</div> |
|---|
| 95 | <p> Based on this UML model a CMD profile has been created. However, notice as CMD doesn't support object oriented features like abstract classes and inheritance this profile isn't a one-to-one transformation. </p> |
|---|
| 96 | <xi:include href="profile.xml"></xi:include> |
|---|
| 97 | <p> ( View the CMD profile in the <a href="$registry$?item=$profile$&space=$space$" target="other">registry</a> or download the profile as <a href="$registry$/rest/registry/profiles/$profile$/xml">XML</a> or <a href="$registry$/rest/registry/profiles/$profile$/xsd">XSD</a> ) </p> |
|---|
| 98 | <p>Notes:</p> |
|---|
| 99 | <ol> |
|---|
| 100 | <li>In an instance of the UML model Parameter and ParameterGroup instances would me able to mix in the Input, Output and Parameters lists, but in the CMD model ParameterGroup instances have to precede Parameter instances</li> |
|---|
| 101 | <li>In the CMD model ServiceDescriptionLocation is a component instead of an element to enable the use of a CMD ResourceProxy to point to the WSDL or WADL file <fieldset style="border: 1px dashed #02027C;margin:1em;"> |
|---|
| 102 | <legend>Example use of CMD ResourceProxy</legend> |
|---|
| 103 | <div class="xmlverb-default" style="margin:1em;"> <<span class="xmlverb-element-name">CMD</span><span class="xmlverb-ns-name"> xmlns</span>="<span class="xmlverb-ns-uri">http://www.clarin.eu/cmd/</span>" ... <span class="xmlverb-attr-name">CMDVersion</span>="<span class="xmlverb-attr-content">1.1</span>"><span class="xmlverb-text"><br />     </span><<span class="xmlverb-element-name">Header</span> /><span class="xmlverb-text"><br />     </span><<span class="xmlverb-element-name">Resources</span>><span class="xmlverb-text"><br />         </span><<span class="xmlverb-element-name">ResourceProxyList</span>><span class="xmlverb-text"><br />             </span><<span class="xmlverb-element-name">ResourceProxy</span> |
|---|
| 104 | <span class="xmlverb-attr-name">id</span>="<span class="xmlverb-attr-content">r1</span>"><span class="xmlverb-text"><br />                 </span><!--<span class="xmlverb-comment">the WSDL MIME type is application/wsdl+xml</span>--><span class="xmlverb-text"><br />                 </span><<span class="xmlverb-element-name">ResourceType</span> |
|---|
| 105 | <span class="xmlverb-attr-name">mimetype</span>="<span class="xmlverb-attr-content">application/vnd.sun.wadl+xml</span>"><span class="xmlverb-text">Resource</span></<span class="xmlverb-element-name">ResourceType</span>><span class="xmlverb-text"><br />                 </span><<span class="xmlverb-element-name">ResourceRef</span>><span class="xmlverb-text">uri:myServiceDescription</span></<span class="xmlverb-element-name">ResourceRef</span>><span class="xmlverb-text"><br />             </span></<span class="xmlverb-element-name">ResourceProxy</span>><span class="xmlverb-text"><br />         </span></<span class="xmlverb-element-name">ResourceProxyList</span>><span class="xmlverb-text"><br /> |
|---|
| 106 |         </span><<span class="xmlverb-element-name">JournalFileProxyList</span> /><span class="xmlverb-text"><br />         </span><<span class="xmlverb-element-name">ResourceRelationList</span> /><span class="xmlverb-text"><br />     </span></<span class="xmlverb-element-name">Resources</span>><span class="xmlverb-text"><br />     </span><<span class="xmlverb-element-name">Components</span>><span class="xmlverb-text"><br />         </span><<span class="xmlverb-element-name">myProfile</span>><span class="xmlverb-text"><br />             </span><<span class="xmlverb-element-name">Service</span> |
|---|
| 107 | <span class="xmlverb-attr-name">CoreVersion</span>="<span class="xmlverb-attr-content">1.0</span>"><span class="xmlverb-text"><br />                 </span><<span class="xmlverb-element-name">Name</span>><span class="xmlverb-text">myService</span></<span class="xmlverb-element-name">Name</span>><span class="xmlverb-text"><br />                 </span><<span class="xmlverb-element-name">ServiceDescriptionLocation</span> |
|---|
| 108 | <span class="xmlverb-attr-name">ref</span>="<span class="xmlverb-attr-content">r1</span>" /><span class="xmlverb-text"><br />                 </span><<span class="xmlverb-element-name">Operations</span>><span class="xmlverb-text"><br />                     ...<br />                 </span></<span class="xmlverb-element-name">Operations</span>><span class="xmlverb-text"><br />             </span></<span class="xmlverb-element-name">Service</span>><span class="xmlverb-text"><br />         </span></<span class="xmlverb-element-name">myProfile</span>><span |
|---|
| 109 | class="xmlverb-text"><br />     </span></<span class="xmlverb-element-name">Components</span>><span class="xmlverb-text"><br /> |
|---|
| 110 | </span></<span class="xmlverb-element-name">CMD</span>><br /> |
|---|
| 111 | </div> |
|---|
| 112 | </fieldset> |
|---|
| 113 | </li> |
|---|
| 114 | </ol> |
|---|
| 115 | <a name="usage"></a> |
|---|
| 116 | <div class="subtitle">Usage</div> |
|---|
| 117 | <p> A web service repository shouldn't directly offer its services in instances of the core model. Instead a repository specific profile should be created. This repository specific profile can extend the core model, e.g., it can add additional CMD elements and components. This can be done by editing copies of the components of the core model. The current versions of the core components are in the <i>$group$</i> group in the $space$ space in the <a href="$registry$">ComponentRegistry</a>. </p> |
|---|
| 118 | <p> The following public CMD profiles are valid extensions to the core model and are or will be used by CLARIN web service registries, workflow and/or chaining engines: <dl> |
|---|
| 119 | <dt><a href="$registry$?item=clarin.eu:cr1:p_1311927752306">ToolService</a> - CLARIN-NL Tool/Service descr - version 1.0</dt> |
|---|
| 120 | <dd>CMD profile in use within CLARIN-NL/VL and to be used within the TTNWW project.</dd> |
|---|
| 121 | <dt><a href="$registry$item=clarin.eu:cr1:p_1360230992146">ToolService</a> - CLARIN-NL Tool/Service descr - DANS - version 1.0</dt> |
|---|
| 122 | <dd><a href="http://dans.knaw.nl/">DANS</a> version of the CLARIN-NL/VL <a href="$registry$?item=clarin.eu:cr1:p_1311927752306">ToolService</a> profile, which allows an optional instance of the <a href="$registry$?item=clarin.eu:cr1:c_1353678848731">DANS-DC-metadata</a> component.</dd> |
|---|
| 123 | <dt><a href="$registry$?item=clarin.eu:cr1:p_1320657629644">WebLichtWebService</a> - NaLiDa</dt> |
|---|
| 124 | <dd>From version 2.0 on CLARIN-D's <a href="http://weblicht.sfs.uni-tuebingen.de/weblichtwiki/index.php/Main_Page">WebLicht</a> supports the CMD core model for CLARIN Web Services. A dedicated <a href="http://weblicht.sfs.uni-tuebingen.de/weblichtwiki/index.php/Editing_Webservice_CMDI_Metadata">online editor</a> has been created and is available to CLARIN-D developers (look in the archive or ask on the CLARIN-D developers mailinglist if you don't know the credentials).</dd> |
|---|
| 125 | </dl> |
|---|
| 126 | </p> |
|---|
| 127 | <a name="validation"></a> |
|---|
| 128 | <p>Notes:</p> |
|---|
| 129 | <ol> |
|---|
| 130 | <li>Notice that the profile name can be different from the core profile, e.g., <i>ToolService</i>, as the associated element name will be skipped during <a href="#validation">validation</a>.</li> |
|---|
| 131 | </ol> |
|---|
| 132 | <div class="subtitle">Validation</div> |
|---|
| 133 | <p> |
|---|
| 134 | <p> When an instance of the repository specific profile is stripped of all the extensions it should still be a valid instance of the core model. This validation can be done by uploading the instance using the form below. </p> |
|---|
| 135 | <form action="$site$clarin/ws/cmd-core/validate" method="post" enctype="multipart/form-data" target="clarin-ws-cmd-core-validate"> |
|---|
| 136 | <fieldset> |
|---|
| 137 | <legend>Validate a CMD instance</legend> |
|---|
| 138 | <p> |
|---|
| 139 | <label for="instance">Instance: </label> |
|---|
| 140 | <input id="instance" name="doc" type="file" size="40" /> |
|---|
| 141 | </p> |
|---|
| 142 | <p> |
|---|
| 143 | <input type="submit" value="Validate" /> |
|---|
| 144 | </p> |
|---|
| 145 | </fieldset> |
|---|
| 146 | </form> |
|---|
| 147 | </p> |
|---|
| 148 | <a name="example"></a> |
|---|
| 149 | <div class="subtitle">Example</div> |
|---|
| 150 | <p> This example shows how the CLARIN-NL repository specific <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:p_1311927752306">ToolService</a> profile has been created. This profile mainly adds the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1311927752300">TechnicalMetadata</a> component to the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1299509410079">Parameter</a> component of the core model.</p> |
|---|
| 151 | <ol> |
|---|
| 152 | <li>Add the TechnicalMetadata component to the core Parameter component: <ol> |
|---|
| 153 | <li>Open the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1299509410079">core Parameter</a> component in the editor</li> |
|---|
| 154 | <li>Change the group name of the component, so you can find the edited component back <ul> |
|---|
| 155 | <li>Do <b>not</b> change the component name, as that will change the element names and make the instances invalid!</li> |
|---|
| 156 | </ul> |
|---|
| 157 | </li> |
|---|
| 158 | <li>Add the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1311927752300">TechnicalMetadata</a> component</li> |
|---|
| 159 | <li>Save the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629628">edited Parameter</a> component in your own workspace (see </li> |
|---|
| 160 | </ol> |
|---|
| 161 | </li> |
|---|
| 162 | <li>Recusively update each component that refers to an updated component: <ol> |
|---|
| 163 | <li>Update the ParameterGroup component: <ol> |
|---|
| 164 | <li>Open the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1302702320471">core ParameterGroup</a> component in the editor</li> |
|---|
| 165 | <li>Change the group name of the component, so you can find the edited component back <ul> |
|---|
| 166 | <li>Do <b>not</b> change the component name, as that will change the element names and make the instanced invalid!</li> |
|---|
| 167 | </ul> |
|---|
| 168 | </li> |
|---|
| 169 | <li>Replace the Parameter component by the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629628">edited Parameter</a> component from your own workspace <ul> |
|---|
| 170 | <li>Recreate the cardinality constraints so they stay <b>valid</b> in the core model, i.e., you can have a lower maximum cardinality but not a lower minimum cardinality!</li> |
|---|
| 171 | </ul> |
|---|
| 172 | </li> |
|---|
| 173 | <li>Save the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629629">edited ParameterGroup</a> component in your own workspace</li> |
|---|
| 174 | </ol> |
|---|
| 175 | </li> |
|---|
| 176 | <li>Update the Operation component: <ol> |
|---|
| 177 | <li>Open the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1299509410080">core Operation</a> component in the editor</li> |
|---|
| 178 | <li>Change the group name of the component, so you can find the edited component back <ul> |
|---|
| 179 | <li>Do <b>not</b> change the component name, as that will change the element names and make the instanced invalid!</li> |
|---|
| 180 | </ul> |
|---|
| 181 | </li> |
|---|
| 182 | <li>Replace the Parameter and ParameterGroup components by the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629628">edited Parameter</a> and <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629629">ParameterGroup</a> components from your own workspace <ul> |
|---|
| 183 | <li>Recreate the cardinality constraints so they stay <b>valid</b> in the core model, i.e., you can have a lower maximum cardinality but not a lower minimum cardinality!</li> |
|---|
| 184 | </ul> |
|---|
| 185 | </li> |
|---|
| 186 | <li>Save the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629630">edited Operation</a> component in your own workspace</li> |
|---|
| 187 | </ol> |
|---|
| 188 | </li> |
|---|
| 189 | <li>Update the Service component: <ol> |
|---|
| 190 | <li>Open the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1299509410081">core Service</a> component in the editor</li> |
|---|
| 191 | <li>Change the group name of the component, so you can find the edited component back <ul> |
|---|
| 192 | <li>Do <b>not</b> change the component name, as that will change the element names and make the instanced invalid!</li> |
|---|
| 193 | </ul> |
|---|
| 194 | </li> |
|---|
| 195 | <li>Replace the Operation component by the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629630">edited Operation</a> components from your own workspace <ul> |
|---|
| 196 | <li>Recreate the cardinality constraints so they stay <b>valid</b> in the core model, i.e., you can have a lower maximum cardinality but not a lower minimum cardinality!</li> |
|---|
| 197 | </ul> |
|---|
| 198 | </li> |
|---|
| 199 | <li>Save the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629631">edited Service</a> component in your own workspace</li> |
|---|
| 200 | </ol> |
|---|
| 201 | </li> |
|---|
| 202 | </ol> |
|---|
| 203 | </li> |
|---|
| 204 | <li>Create <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:p_1311927752306">your own profile</a> which uses the <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:c_1320657629631">Service</a> component from your own workspace</li> |
|---|
| 205 | <li>Check if an instance of your profile is also a valid instance of the core model: <ol> |
|---|
| 206 | <li>Create a valid instance based on the schema of your own profile</li> |
|---|
| 207 | <li>Validate the instance also against the core model using <a href="#validation">the form above</a></li> |
|---|
| 208 | </ol> |
|---|
| 209 | </li> |
|---|
| 210 | </ol> |
|---|
| 211 | <p>The results of the CLARIN-NL <a href="http://adelheid.ruhosting.nl/">Adelheid</a> project has been described using this ToolService profile and is thus also a valid instantiation of the core model:</p> |
|---|
| 212 | <ol> |
|---|
| 213 | <li>CMDI metadata file: <a href="http://catalog.clarin.eu/metadata/cmdi/Adelheid.cmdi">http://catalog.clarin.eu/metadata/cmdi/Adelheid.cmdi</a></li> |
|---|
| 214 | <li>referenced WADL files: <ol> |
|---|
| 215 | <li>adelheid/main: <a href="http://lux17.mpi.nl/adelheidws/wadl/main.wadl">http://lux17.mpi.nl/adelheidws/wadl/main.wadl</a></li> |
|---|
| 216 | <li>adelheid/lexicon: <a href="http://lux17.mpi.nl/adelheidws/wadl/lexicon.wadl">http://lux17.mpi.nl/adelheidws/wadl/lexicon.wadl</a></li> |
|---|
| 217 | <li>adelheid/lexicon: <a href="http://lux17.mpi.nl/adelheidws/wadl/tokenizer.wadl">http://lux17.mpi.nl/adelheidws/wadl/tokenizer.wadl</a></li> |
|---|
| 218 | </ol> |
|---|
| 219 | </li> |
|---|
| 220 | </ol> |
|---|
| 221 | <p>Notes:</p> |
|---|
| 222 | <ol> |
|---|
| 223 | <li>The links in the example above are based on version 1.0.1 of the core model and version 1.0.0 of the ToolService profile.</li> |
|---|
| 224 | </ol> |
|---|
| 225 | <a name="faq"></a> |
|---|
| 226 | <div class="subtitle">Frequently Asked Questions</div> |
|---|
| 227 | <p> |
|---|
| 228 | <dl> |
|---|
| 229 | <dt><i>Why do we need a technical service description, e.g., a WADL or WSDL file, next to the CMD metadata to fully document a web service?</i></dt> |
|---|
| 230 | <dd> |
|---|
| 231 | <p>The CMD metadata for web services focusses on the semantic description of a service, i.e., what goes in and what comes out, but it doesn't specifiy how to technically invoke the web service. Should you pass, for example, on the parameters on in the query string and use the GET HTTP verb to invoke the service and receive the result? Or should one do a multi-part POST? Or should one wrap the input in a SOAP envelope and POST it to the web service? One could extend the core model to make this explicit, but there are already many of these proposals, e.g., WSDL and WADL, which can be reused. To invoke aribtrary web services a workflow or chaining engine needs to know this. For a more in-depth discussion see the <a href="./pubs/CMD-WS-core-model-preprint.pdf">Metadata2012 paper</a> on the core model.</p> |
|---|
| 232 | </dd> |
|---|
| 233 | <dt><i>The core model doesn't prescribe a technical service description language or Interface Definition Language (IDL), why not?</i></dt> |
|---|
| 234 | <dd> |
|---|
| 235 | <p>For SOAP web services there is a standard, i.e., WSDL (2), but for REST-based web services there isn't. Sun submitted WADL some years ago, but it never made it to a recommendation. So currently there are several competing proposals: |
|---|
| 236 | <ul> |
|---|
| 237 | <li><a href="http://www.w3.org/TR/wsdl20/">WSDL 2</a> also supports <a href="http://www.w3.org/TR/wsdl20-primer/#more-bindings-http">HTTP bindings</a></li> |
|---|
| 238 | <li><a href="http://www.w3.org/Submission/wadl/">WADL</a> (W3C submission)</li> |
|---|
| 239 | <li><a href="http://tools.ietf.org/html/draft-nottingham-json-home-00">Home Documents for HTTP APIs</a> (IETF draft)</li> |
|---|
| 240 | <li><a href="http://restdesc.org/">RESTdesc</a></li> |
|---|
| 241 | <li>... (please <a href="#contact">contact</a> me to add other alternatives)</li> |
|---|
| 242 | </ul> |
|---|
| 243 | </p> |
|---|
| 244 | </dd> |
|---|
| 245 | </dl> |
|---|
| 246 | </p> |
|---|
| 247 | <a name="pubs"></a> |
|---|
| 248 | <div class="subtitle">Publications</div> |
|---|
| 249 | <p> |
|---|
| 250 | <ol> |
|---|
| 251 | <li>M. Windhouwer, D. Broeder, D. van Uytvanck. <a href="http://www.lrec-conf.org/proceedings/lrec2012/workshops/11.LREC2012%20Metadata%20Proceedings.pdf#page=48&pagemode=none">A CMD Core Model for CLARIN Web Services</a>. |
|---|
| 252 | In the <i>Proceedings of the <a href="http://workshops.elda.org/metadata2012/">Metadata2012 Workshop</a> on |
|---|
| 253 | Describing Language Resources with Metadata: Towards Flexibility and Interoperability in the Documentation of Language Resources</i>. |
|---|
| 254 | At <a href="http://www.lrec-conf.org/lrec2012/">LREC 2012</a>, Istanbul, Turkey, May 22, 2012. |
|---|
| 255 | (<a href="http://www.slideshare.net/mwindhouwer/a-cmd-core-model-for-clarin-web-services">SlideShare</a>) |
|---|
| 256 | </li> |
|---|
| 257 | </ol> |
|---|
| 258 | </p> |
|---|
| 259 | <a name="contact"></a> |
|---|
| 260 | <div class="subtitle">Contact</div> |
|---|
| 261 | <p>For any additional information feel free to contact:</p> |
|---|
| 262 | <p> |
|---|
| 263 | <img src="$site$famfamfam/silk/icons/email.png" align="baseline" /> <a href="mailto:Menzo.Windhouwer@mpi.nl">Menzo Windhouwer</a> (MPI for Psycholinguistics) </p> |
|---|
| 264 | <a name="ack"></a> |
|---|
| 265 | <div class="subtitle">Acknowledgements</div> |
|---|
| 266 | <p>This core CMD model is based on information provided by and feedback from:</p> |
|---|
| 267 | <ul> |
|---|
| 268 | <li>Marc Kemps-Snijders (Meertens Institute)</li> |
|---|
| 269 | <li>Marta Villegas (Universitat Pompeu Fabra)</li> |
|---|
| 270 | <li>Thomas Zastrow (University of Tübingen)</li> |
|---|
| 271 | </ul> |
|---|
| 272 | <a name="log"></a> |
|---|
| 273 | <div class="subtitle">Change log</div> |
|---|
| 274 | <p>[2011-12-19] <a href="$registry$?item=$profile$&space=$space$">CLARIN core WS descr - version 1.0.1</a></p> |
|---|
| 275 | <ol> |
|---|
| 276 | <li>Inplace update of the component to allow multilingual descriptions</li> |
|---|
| 277 | </ol> |
|---|
| 278 | <p>[2011-11-16] CLARIN core WS descr - version 1.0</p> |
|---|
| 279 | <ol> |
|---|
| 280 | <li>The CoreVersion attribute on the Service component now indicates the version (currently 1.0) of the core model that is instantiated</li> |
|---|
| 281 | <li>Location attribute has been renamed to ServiceDescriptionLocation to indicate that it should point to a WSDL or WADL description of the service(s)</li> |
|---|
| 282 | <li>ServiceDescriptionLocation is realised as a CMD component to enable the use of a CMD resource proxy for the URI of the WSDL or WADL document</li> |
|---|
| 283 | <li>Recipe attribute has been removed as the ServiceDescriptionLocation now points to a machine readable recipe, i.e., a WSDL or WADL file, to invoke a service</li> |
|---|
| 284 | <li>Name attribute of the AbstractParameter class should point to a parameter described in the WSDL or WADL file if the Parameter(Group) has a direct correspondent</li> |
|---|
| 285 | <li>Name attribute of the Operation class should point to a service described in the WSDL or WADL file</li> |
|---|
| 286 | <li>SemanticType attribute has been added to the AsbtractParameter class to fine tune output/input parameter matching</li> |
|---|
| 287 | <li>DataCategory attribute has moved to the AbstractParameter class to allow references to container data categories from ParameterGroup</li> |
|---|
| 288 | </ol> |
|---|
| 289 | <p>[2011-08-08] <a href="http://catalog.clarin.eu/ds/ComponentRegistry?item=clarin.eu:cr1:p_1311927752332">CLARIN core WS descr (tentative)</a> |
|---|
| 290 | </p> |
|---|
| 291 | <ol> |
|---|
| 292 | <li>Tentative release of the profile and components</li> |
|---|
| 293 | </ol> |
|---|
| 294 | </td> |
|---|
| 295 | </tr> |
|---|
| 296 | </table> |
|---|
| 297 | </body> |
|---|
| 298 | </html> |
|---|
