URI
<myData_uri>/upload[.<format>]
支持的方法
父资源
介绍
fileUpload 资源用于上传由数据项 id 指定的数据文件。
支持的方法:
- POST:上传由数据项 id 指定的数据文件,数据项 id 的获取请参见:myDatas 资源的 POST 请求。
支持的表述格式:RJSON、JSON、HTML、XML。
资源层次

HTTP 请求方法
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiportal 是服务器名。
http://supermapiportal:8190/iportal/web/mycontent/datas/{id}/upload.rjson
POST 请求
上传由数据项 id 指定的数据文件,请求体为文本数据流。
请求参数
发送请求时,需要在请求体中传递如下参数:
| 字段 | 类型 | 说明 |
| xIndex | int | 【可选参数】上传 Excel 和 CSV 数据时,X 坐标对应列的索引。 |
| yIndex | int | 【可选参数】上传 Excel 和 CSV 数据时,Y 坐标对应列的索引。 |
| fieldTypes | String[] | 【可选参数】上传的 Excel 数据中各个字段的类型。 |
| separator | String | 【可选参数】上传 CSV 数据时,CSV 文件的分隔符。 |
响应结构
对 fileUpload 资源执行 POST 请求,上传由数据项 id 指定的数据文件。返回的资源表述结构如下:
| 字段 | 类型 | 说明 |
| childID | String | 子资源的 id,即数据项 id。 |
| childContent | Object | 子资源的内容。 |
| childUrl | String | 子资源的 URI。 |
| customResult | Object | 自定义结果。 |
| isAsynchronizedReturn | boolean | 结果是否是异步返回。对于该资源 isAsynchronizedReturn 的值总为 false。 |
响应示例
对 fileUpload 资源:http://localhost:8190/iportal/web/mycontent/datas/1/upload.rjson 执行 POST 请求,返回 rjson 格式的响应结果为:
{
"childContent": null,
"childID": "1",
"childUrl": null,
"customResult": null,
"isAsynchronizedReturn": false
}
请参见