3.1.4.1.4.3 ColumnMappingType

  • Article

ColumnMappingType is used to determine the format of the data returned to the client. If ColumnMappingType is set to the value of "element", the data MUST be formatted so that each column of data is returned as a child element to the row element. For example:

 <Widgets_Row>
   <Title>Widget C</Title>
   <Count>23</Count>
   <Stock>1</Stock>
   <ID>3</ID>
 </Widgets_Row>

When the ColumnMappingType is set to the value of "attribute", the data MUST be formatted so that each column of data is returned as an attribute of the row element. For example:

 <Widgets_Row Title="Widget A" Count="50" Stock="0" ID="1" />

When ColumnMappingType is set to "attribute" the result data MUST NOT contain any data annotations that are used to comment return data. The "attribute" for ColumnMappingType setting is designed to increase performance when a client is requesting only row data from a data source. For example:

 <s:simpleType name="ColumnMappingType">
   <s:restriction base="s:string">
     <s:enumeration value="element"/>
     <s:enumeration value="attribute"/>
   </s:restriction>
 </s:simpleType>

The following table defines possible values for ColumnMappingType.

Value

Meaning

element

The server MUST send result XML using elements to store column data.

attribute

The server MUST send result XML using attributes on to store column data.