Android应用通过REST API在Lotus Notes工作流中创建文档的实现咨询

很高兴看到你前两步的功能都顺利跑通了！针对第三步在IBM Lotus Notes的掩码层级下的工作流中创建文档的需求，结合REST API和JSON技术，我整理了几个落地性很强的实现思路：

1. 先明确Notes工作流的REST API端点规则 #

首先得确认你的Lotus Notes环境已经启用了REST服务（比如Domino REST API，或者传统的Domino Access Services(DAS)）。要在掩码层级下创建工作流文档，关键是找到对应API的路径逻辑：

• 如果工作流文档是掩码文档的子文档，端点通常会包含掩码文档的UNID，比如：/api/data/collections/unid/<掩码文档UNID>/<工作流表单名>
• 也可能基于数据库视图设计，路径类似：/api/data/collections/name/<掩码视图名>/<工作流视图名>
• 你需要先通过Domino Designer或Notes客户端，找到工作流文档对应的表单名称，以及它和掩码文档的关联字段（比如掩码文档的UNID会被存为工作流文档的ParentUNID字段）。

2. 构造符合Notes表单要求的JSON请求体 #

Notes的REST API对请求体的格式有严格要求，必须匹配目标工作流表单的字段定义：

• 必须包含Form字段，值为工作流文档对应的表单名称（比如"Form": "WorkflowTask"）
• 必须包含关联掩码的字段（比如"ParentUNID": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"，值就是你之前操作的掩码文档的UNID）
• 加上工作流文档本身的业务字段（比如任务标题、状态、创建时间等）

举个请求体示例：

{
  "Form": "WorkflowTask",
  "ParentUNID": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "TaskTitle": "新的审批任务",
  "TaskStatus": "待处理",
  "CreateTime": "2024-05-20T14:30:00Z"
}

注意：如果表单里有必填字段，必须在JSON中完整提供，否则API会返回400错误。

3. 处理请求的认证与权限控制 #

和你前两步的逻辑一致，Android端需要携带有效的认证信息：

• 如果是Basic Auth，把用户名和密码做Base64编码后，放在请求头的Authorization字段里：Authorization: Basic <base64编码的用户名:密码>
• 如果是JWT令牌，就把令牌放在Authorization: Bearer <token>里
• 确保你的认证账号拥有创建工作流文档的权限，同时能访问掩码文档所在的数据库和工作流表单。

4. Android端调用REST API执行创建操作 #

用HTTP POST请求发送到对应的端点即可，这里给一个用OkHttp实现的代码示例：

OkHttpClient client = new OkHttpClient();
MediaType JSON_TYPE = MediaType.get("application/json; charset=utf-8");

// 构造请求体字符串
String workflowJson = "{\"Form\":\"WorkflowTask\",\"ParentUNID\":\"a1b2c3d4...\",\"TaskTitle\":\"新审批任务\"}";
RequestBody requestBody = RequestBody.create(workflowJson, JSON_TYPE);

// 构建POST请求
Request request = new Request.Builder()
    .url("https://your-notes-server/api/data/collections/unid/<掩码UNID>/WorkflowTask")
    .post(requestBody)
    .addHeader("Authorization", "Basic dXNlcjE6cGFzc3dvcmQ=") // 替换为你的Base64认证串
    .build();

// 执行请求并处理响应
try (Response response = client.newCall(request).execute()) {
    if (response.isSuccessful()) {
        String responseContent = response.body().string();
        // 解析响应，获取新建工作流文档的UNID等信息
        Log.d("NotesAPI", "工作流文档创建成功：" + responseContent);
    } else {
        Log.e("NotesAPI", "创建失败，响应码：" + response.code() + "，错误信息：" + response.body().string());
    }
} catch (IOException e) {
    e.printStackTrace();
}

5. 验证与错误处理 #

• 创建完成后，建议调用Notes的REST API查询该工作流文档，确认它确实关联到了目标掩码文档下（比如通过视图查询ParentUNID等于掩码UNID的文档）
• 针对常见错误做处理：认证失败（401）、权限不足（403）、必填字段缺失（400）、服务器内部错误（500），在Android端给出友好提示或日志记录。

6. 可选：用Notes代理封装复杂逻辑 #

如果工作流有复杂的业务规则（比如自动触发审批流程、更新掩码状态等），可以在Notes数据库中编写LotusScript或Java代理：

• 代理接收Android端发送的JSON参数，内部完成工作流文档的创建、关联掩码、触发业务逻辑的操作
• Android端通过调用代理的REST端点来执行：/api/data/agents/<代理名称>，用POST方法发送JSON参数即可。

内容的提问来源于stack exchange，提问作者khouloud