条目批量更新

Update multiple rows 条目批量更新

DataTablesUpdateMultipleRows允许通过HTTP POST接口更新多个条目. 可通过一条指令根据指定每行的唯一标识条目（主键）来更新多个行 值.

请求数据格式

ApiRequest子元素:

参数 类型 描述
ApiKey string 你的API KEY,需要认证,必填.
TableName string 数据表格名称,必填.
Data complex 包含条目数据的参数.

Data子元素:

参数 类型 描述
Row complex 行元素集合. 必填.
Row子元素:
参数 类型 描述
PrimaryKeyColumns complex 列元素集合. 包含唯一标识（主键）相关行. 对应SQL ‘WHERE’指令. 必填.
Columns complex 列元素集合. 只包含需要更新的列及相应的值. 对应SQL ‘SET’指令. 必填.
Column子元素:
参数 类型 描述
Column string 列名称. 必填.
Value string 值. 必填.

示例:

请求:
POST https://api.esv2.com/v2/Api/DataTablesUpdateMultipleRows/ HTTP/1.1

<ApiRequest xmlns:xs=”http://www.w3.org/2001/XMLSchema” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<ApiKey>test_api_key1</ApiKey>
<TableName>Table1</TableName>
<Data>
 <Row>
  <PrimaryKeyColumns>
   <Column>
    <Name>Column1</Name>
    <Value>Value1</Value>
   </Column>
  </PrimaryKeyColumns>
  <Columns>
   <Column>
    <Name>Column2</Name>
    <Value>2</Value>
   </Column>
   <Column>
    <Name>Column3</Name>
    <Value>2013-01-01 01:00:00 PM</Value>
   </Column>
   <Column>
    <Name>Column4</Name>
    <Value>4.66</Value>
   </Column>
   <Column>
    <Name>Column5</Name>
    <Value>True</Value>
   </Column>
  </Columns>
 </Row>
 <Row>
  <PrimaryKeyColumns>
   <Column>
    <Name>Column1</Name>
    <Value>Value2</Value>
   </Column>
   <Column>
    <Name>Column2</Name>
    <Value>3</Value>
   </Column>
  </PrimaryKeyColumns>
  <Columns>
   <Column>
    <Name>Column1</Name>
    <Value>Value5</Value>
   </Column>
   <Column>
    <Name>Column2</Name>
    <Value>5</Value>
   </Column>
   <Column>
    <Name>Column5</Name>
    <Value>True</Value>
   </Column>
  </Columns>
 </Row>
</Data>
</ApiRequest>
OK应答 
HTTP/1.1 204 No Content
Cache-Control: private
Server: Microsoft-IIS/7.5
X-AspNetMvc-Version: 1.0
X-AspNet-Version: 2.0.50727
X-Powered-By: ASP.NET
Date: Wed, 28 Oct 2009 15:35:17 GMT
Content-Length: 0
错误应答:
HTTP/1.1 400 Bad Request
<ApiResponse xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<ErrorMessage>
<Code>400</Code>
<Messages>
<Message for=”Row 1″>Row with specified criteria already exists.</Message>
<Message for=”Row 2″>Request does not contain required columns.</Message>
<Message for=”Row 3″>No row matching specified criteria was found.</Message>
<Message for=”Row 4″>Validation error, field type:Number value:test</Message>
</Messages>
</ErrorMessage>
</ApiResponse>