Data service operations are written to invoke queries. Therefore, defining operations is the 4th step in the process of creating a data service. Follow the steps given below.
- Log in to the management console and select Create under Data Service menu. Following the instructions given here.
- Click Next to add a data source. Follow the instructions in Step 2: Adding Datasources.
- Click Next to add a query to the data source. Follow the instructions in Step 3: Writing Data Service Queries.
- Click Next to add an operation to invoke the queries.
- The Add Operation page appears. Provide a name for the operation and select the query to execute when the operation is invoked. For example,
Also, see enable streaming.
You can get a SOAP response instead of an HTTP 202 when invoking an IN-ONLY operation by setting the returnRequestStatus
attribute to true
in a dataservice operation. For example,
<operation name="operation1" returnRequestStatus="true"> <call-query href="QRY_INSERT_DM"> <with-param name="dm1" query-param="dm1"/> <with-param name="dm2" query-param="dm3"/> </call-query>
Handling Faulty Requests
A structured SOAP fault message will be returned for an incorrect invocation of the data service. For example, if you use an invalid value to invoke a data service that validates the length of the parameters, a SOAP fault with VALIDATION_ERROR code will be returned. A SOAP fault message is constructed as given in the following XML schema structure.
<xs:element name="DataServiceFault"> <xs:complexType> <xs:sequence> <xs:element name="current_params" type="xs:string"/> <xs:element name="current_request_name" type="xs:string"/> <xs:element name="nested_exception" type="xs:string"/> <xs:element name="source_data_service"> <xs:complexType> <xs:sequence> <xs:element name="location" type="xs:string"/> <xs:element name="default_namespace" type="xs:string"/> <xs:element name="description" type="xs:string"/> <xs:element name="data_service_name" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ds_code" type="xs:string"/> </xs:sequence> </xs:complexType> </xs:element>