大量操作

大量操作 API 设计用来在单一请求中对表单中的多笔数据运行相同的操作。

有两种指定要更新纪录的方法：

• 使用 where筛选

https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/massOperation/<大量操作类型>?api&where=<字段 ID>,<过滤操作元>,<值>

• 在查询字段中使用 recordId，例如 recordId=1&recordId=2

https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/massOperation/<大量操作类型>?api&recordId=<数据 ID>

请求格式

• 大量操作 API 是异步操作。
• 根据您的 Ragic 数据库帐号 URL，需要将 API URL 中的 www 修改为 na3、ap5 或 eu2。

HTTP 方法 - POST
URL - https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/massOperation/<大量操作类型>?api
首部
Authorization: Basic 

主体
{
// 描述要运行操作的 JSON 数据
}

==========

响应
{
"taskId": <识别任务的 UUID>
}

大量加锁

HTTP 方法 - POST
URL - https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/massOperation/massLock?api

{
    "action": 
}

==========

响应
{
    "taskId": "6dbc796a-07d5-475b-b578-d254eb30f7d2"
}

批次签核

HTTP 方法 - POST
URL - https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/massOperation/massApproval?api

{
    "action": , 
    "comment": <响应> // 可选
}

==========

响应
{
    "taskId": "6dbc796a-07d5-475b-b578-d254eb30f7d2"
}

批次运行动作单击钮

HTTP 方法 - POST
URL - https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/massOperation/massActionButton?api
{
"buttonId": <单击钮 ID>
}

==========

响应
{
"taskId": "6dbc796a-07d5-475b-b578-d254eb30f7d2"
}

获取表单中可用的动作单击钮列表

HTTP 方法 - GET
URL - https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/metadata/actionButton?api&category=massOperation

==========

响应
{
    "actionButtons": [
        {
            "id": <单击钮 ID 1>,
            "name": <单击钮名称 1>
        },
        .....
        ,{
            "id": <单击钮 ID 2>,
            "name": <单击钮名称 2>
        }
    ]
}

大量修改

大量修改 API 许可一次更新多笔数据的字段值。

大量修改

HTTP 方法 - POST
URL - https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/massOperation/massUpdate?api

{
    "action": [
        {
            "field": <字段 ID>,
            "value": <新字段值>
        }
    ]
}

==========

响应
{
    "taskId": "6dbc796a-07d5-475b-b578-d254eb30f7d2"
}

查找与替换

查找与替换 API 许可一次替换多笔数据的值。

查找与替换

HTTP 方法 - POST
URL - https://www.ragic.com/<帐号>/<页签路径参数>/<表单路径参数>/massOperation/massSearchReplace?api

{
    "action": [
        {
            "field": <字段 ID>,
            "valueReplaced": <要替换的值>,
            "valueNew": <替换后的值>, 
        }
    ]
}

==========

响应
{
    "taskId": "6dbc796a-07d5-475b-b578-d254eb30f7d2"
}

工作项目跟踪

大量操作是异步的。操作的工作项目 ID 可用于监控其进度。

HTTP 方法 - GET
URL - https://www.ragic.com/<帐号>?api&taskId=<工作项目 ID>

==========

响应
{
    "id": <工作项目 ID>,
    "ap": <帐号>,
    "taskName": <工作项目名称>,
    "status": <状态>
}