DATASET parameters pass only the data, because the static ProDataSet's schema is known at WSDL generation. In the WSDL, OpenEdge Web services map a DATASET definition to a <complexType> consisting of a <sequence> of elements that represent the ProDataSet's temp-tables. Each temp-table element includes a <complexType> describing the temp-table's fields. The definition also includes elements describing the data relations and indexes.

For all SOAP formats, client interfaces typically represent dataset parameters as follows:

  • For every dataset, each temp-table is represented by an object.
  • Every dataset parameter is represented as arrays of the constituent temp-table objects.
  • For an ABL client, the WSDL Analyzer transforms the WSDL definition of a ProDataSet parameter into a matching ProDataSet.

By default, a ProDataSet parameter includes only the current data. You must specify in ProxyGen the ProDataSet parameters for which you want to include before-image data. If the ProDataSet parameter includes before-image data, the before-image data is serialized in a proprietary OpenEdge datasetChanges document.

The following snippet shows the general format for DATASET parameters in SOAP messages:

DATASET parameters—general SOAP format

<PDSname>
      <Buffer1Name> <!--- TEMP-TABLE-1 row instance 1 --> </Buffer1Name>
      <Buffer1Name>    <!--- TEMP-TABLE-1 row instance 2 --> </Buffer1Name>    
        ...    
        <Buffer2Name>   <!--- TEMP-TABLE-2 row instance 1 --> </Buffer2Name>
       <Buffer2Name>   <!--- TEMP-TABLE-2 row instance 2 --> </Buffer2Name>    
        ...
</PDSname>