1. 升版文档
升版文档。
请求方式:POST
请求地址:/bosdocumentservice/{appKey}/documents/upgrade/{key}
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | access_token |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
appKey | string | xb05cd3a35614caa85c0f8f86c58fcc1 | 是 | 应用Key |
key | string | doc-01 | 是 | 文档document key |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
transactionCode | string | 3MD2XzN70VkcvbXllg7x7V | 否 | 业务事务编码 |
Body:
application/json:
from-data
{
"file": "具体文件",
"revision": "1", //新的文档版本
"gmodelType": "" //模型类型
}
1.2. 参数说明:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
revision | string | 1.0 | 是 | 新的文档版本号 |
gmodelType | string | ifc/imodel/revit | 是 | 模型类型 |
文件 | file | 无 | 是 | 物理文件 |
1.3. 正确返回:
Http Status Code:200
{
"code": "SUCCESS",
"message": "请求处理成功",
"data": "http://bosgw.bimwinner.com/bosdocumentservice/h5e4ff8257dc4e86a8042097f67d2718/documents/xxxx"
}
1.4. 状态码:
状态码 | code | message | data | 原因 |
---|---|---|---|---|
200 | ENTITY_NOTFOUND | Key为{key}的{bosclass}实体对象不存在 | NULL | 无法找到旧文档 |
200 | ENTITY_WRITEPERMISSION_REQUIRED | 缺少实体对象{bosclass/key}的写权限 | NULL | 当前用户如果无该文档的写权限时 |
200 | OBJECT_FIELD_DATATYPE_WRONG | XXX属性数据类型错误 | NULL | 当字段数据类型错误时 |
200 | ENTITY_NAME_INVALID | 实体对象name属性值无效 | NULL | 当文件name包含※时 |
1.5. 注意事项:
1、 gpriority为空表示普通文档,不为空表示模型文档。
2、 创建新文档,除了revision和key外,其他的文档属性默认复制旧文档的属性。
3、 修改旧文档的状态。
4、 先上传文件,然后创建文档与文件的关系。
5、创建文档与目标文件夹的关联。
6、更新文档所属所有上层文件夹的size属性。
7、当sliceKey不为空时,取sliceKey对应缓存数据,判断文件是否已合并,已合并的取fileKey,未合并的校验文件块是否已经上传完成,上传完成则合并。