工单模块OpenAPI开发必读

工单模块功能介绍

工单模块基本功能介绍

工单OpenAPI使用指南

基本概念

此处罗列OpenAPI中工单的各类概念

• 工单(workorder): 可以通过获取工单列表获取其基本信息，尤其是其唯一标识工单号order_no，凭借order_no调用获取工单详情获取其详细信息
• 工单流程/模板(workorder_template/template)，通过获取工单模板列表来获取全部工单模板
• 工单自定义组件(component): 对应创建工单模板的时候添加的选项/文本框等，目前工单OpenAPI暂时不支持文件上传，每个工单模板对应一套自定义组件，可以通过获取工单模板详情来获取一个工单模板的自定义组件配置详情。
• 工单自定义组件记录(component_records)，对应创建工单时需要填写自定义组件规定的信息/选项，其内容将会保存在工单自定义组件记录中，可以通过获取工单详情来获取自定义组件中所填写的数值记录。

示例1：创建并修改工单

• 获取工单模板列表，以查找新工单要套用的工单模板
• 找到指定模板对应的id(template_id)后，凭借模板id获取工单模板详情以获取工单模板的详细数据（自定义组件，必填情况等）
• 以工单模板的数据为参考规范，来新建工单，新建工单后会返回工单的order_no
• 根据order_no来获取工单详情。
• 如果你想要修改工单数据，你需要根据工单的order_no，并参考获取工单模板详~~~~情中的来修改工单。

示例2：更改工单状态

• 选择想要更改状态的工单号order_no并获取工单详情以获取工单当前状态，再获取工单流内处理人来选择工单下一阶段的处理人
• 调用流转工单以将工单交给其他人处理
• 调用评论工单以添加工单评论
• 关闭工单