]> $Id: Grounding.owl,v 1.34 2004/09/28 06:58:53 martin Exp $ Upper-level OWL ontology for Groundings that employ WSDL. Part of the OWL-S ontology; see http://www.daml.org/services/. This version is intended for use with WSDL 1.1. The OWL-S Coalition plans to produce a future version for use with WSDL 2.0, when it has been finalized (or nearly so). Note that other approaches to grounding may be accommodated within the OWL-S framework. This is the only approach produced to date by the OWL-S Coalition. For notes on version history, see http://www.daml.org/services/owl-s/1.1/status.html. A WsdlGrounding is just a collection of WsdlAtomicProcessGrounding instances, one for each atomic process in the process model. A class that relates elements of a OWL-S atomic process to a WSDL specification. Each instance of WsdlAtomicProcessGrounding must have exactly one value for owlsProcess and exactly one for wsdlOperation, which sets up a one-to-one correspondence between an atomic process and a WSDL operation. In addition, for each message part of the relevant WSDL input message, there must be exactly one value of wsdlInput. For each output of the atomic process, there must be exactly one value of wsdlOutput. These property instances show the correspondences between OWL-S inputs/outputs and WSDL message parts. In addition, single values are recommended (but not required) for wsdlInputMessage and wsdlOutputMessage. Note that the value of wsdlOperation may or may not uniquely identify a particular WSDL port with which to interact. If there are multiple such ports offering the specified operation, an OWL-S enactment engine is free to choose any of these ports. If it is desired to further constrain the choice of ports, a WsdlAtomicProcessGrounding may do so by specifying any number of values for wsdlService and/or wsdlPort. 1 The atomic process to which this grounding applies. A WSDL operation to which the atomic process (referenced by owlsProcess) corresponds. A URI for a WSDL Service that provides the operation to which this atomic process is grounded. A URI for a WSDL Port that provides the operation to which this atomic process is grounded. A URI for the WSDL input message element corresponding to the inputs of the atomic process. There should be one instance of this property for each message part of the WSDL input message. A URI for the WSDL message element corresponding to the outputs of the atomic process. There should be one instance of this property for each output of the atomic process. A URI indicating the version of WSDL being used. A URI indicating a WSDL document to which this grounding refers. This isn't essential; primarily for convenience as documentation. This class provides a unique specification of a WSDL operation. WSDL 1.1, on which this version of the grounding is based, does not have a way to uniquely identify an operation with a single URI. Uniqueness is achieved using a pair (portType, operation). Restricting the cardinality of portType to one 1 Restricting the cardinality of operation to one 1 Superclass for WsdlInputMessageMap and WsdlOutputMessageMap. An input or output property of an atomic process. A URI for a WSDL message part element. XSLT Tranformation to transform OWL-S parameters (inputs and outputs) to and from WSDL messages. This property exists mainly for declaring a cardinality restriction, and should not be instantiated directly. Instantiate xsltTransformationString or xsltTransformationURI. (Ranges are specified with the sub properties.) A string giving an XSLT Tranformation. A URI for an XSLT Tranformation. A class that shows how to derive a WSDL message part from (one or more) inputs of an atomic process. A WsdlInputMessageMap must have 1 wsdlMessagePart, and EITHER 1 owlsParameter or 1 xsltTransformation. (The cardinality restrictions don't capture the disjunction.) If there is a direct correspondence between a particular OWL-S input and the wsdlMessagePart, use owlsParameter to show that. Otherwise, use xsltTransformation to give a transformation from the OWL-S input(s) to the wsdlMessagePart. 1 1 1 A class that shows how to derive an atomic process output from the input message parts of a WSDL operation. A WsdlOutputMessageMap must have 1 owlsParameter, and EITHER 1 wsdlMessagePart or 1 xsltTransformation. (The cardinality restrictions don't capture the disjunction.) If there is a direct correspondence between a particular WSDL message part and the OWL-S output, use wsdlMessagePart to show that. Otherwise, use xsltTransformation to give a transformation from the message parts to the OWL-S output. 1 1 1 Deprecated as of DAML-S 0.9. Deprecated as of DAML-S 0.9; wsdlOutputs should now be used. Deprecated as of DAML-S 0.9; wsdlVersion should now be used. A URI indicating a relevant standards document (other than that for WSDL). Deprecated as of DAML-S 0.9; no longer recommended or supported. Deprecated as of OWL-S 1.0. owlsParameter should be used. Deprecated as of OWL-S 1.0. wsdlInput should be used. A list of WsdlMessageMap instances, one for each message part of the WSDL input message. Deprecated as of OWL-S 1.0. wsdlOutput should be used. A list of WsdlMessageMap instances, one for each output of the atomic process. Deprecated as of version 1.1; no longer needed A list of WsdlOutputMessageMap instances Deprecated as of version 1.1; no longer needed A list of WsdlInputMessageMap instances