icas-connector

Showing 25 of 78 from the live probe.

• Get Form Schema

  获取表单字段结构 + 原生填写网址。用于让 AI 了解某个模板有哪些字段、各字段类型/必填/选项，以便引导用户填写。返回 fill_url（如 {domain}/f/{token}），用户或浏览器技能打开该网址由系统原生提交。

• List Form Submissions

  列出提交数据（按当前令牌的数据范围隔离：公司级/部门级/个人级 或 协管员角色）。可按 template_id 过滤、按 status 过滤。status: 0待处理/1已审/2归档/3作废。

• Get Form Submission

  获取单条提交数据详情（含 form_data 内容）。

• Get Form Fill Url

  返回指定模板的原生填写网址（{domain}/f/{token}）。用于把它交给用户或浏览器技能去实际填报，不经由任何 API 写路径。

• Set Form Status

  设置单条提交数据的状态(status)。约束（与系统一致）：仅当该记录未绑定审批工作流(workflow_id=0)时允许；已归档(2)/作废(3)终态不可再改；审批中或已审的记录不可改。status: 0待处理/1已审/2归档/3作废。

• Set Form Progress

  设置单条提交数据的进度标签(formstatus)。formstatus 为 fa_formstatus 表主键 id（按 模板+租户 隔离），0 表示清除进度。若该标签触发"按进度启动审批"且表单已绑工作流，会自动建审批。审批中或已审的记录不可改。

• Submit Form Approval

  为一条提交数据【发起审批】。仅当该模板的审批触发时机设为"协管员+管理员可提交"(TRIGGER_BOTH)时允许；同时受模板写权限(数据范围/协管员角色)约束。走与后台一致的 ApprovalService::submitApproval 链路。

• Recall Form Approval

  【撤回】一条处于审批中的提交数据的审批（仅审批中可撤回）。约束与 submit_form_approval 一致：仅 TRIGGER_BOTH 模式、且具备写权限。走 ApprovalService::withdrawApprovalByUser，与后台行为一致。

• List Form Templates

  获取表单模板列表（管理员与协管员均可用）。可见范围由调用令牌的身份自动决定：管理员 PAT 遵循后台「数据权限」配置（fa_formconfig.data_scope：0 公司级看租户全部 / 1 部门级看同部门 / 2 个人级仅自己，超管等同公司级）；协管员（会员）PAT 仅返回其在表单协作员（fa_form_collaborator）中被授权的表单。每条记录附带 my_role（admin / assignable / viewer_editor / viewer）与 can_edit，前端可据此渲染操作入口。返回还包含 identity 字段标明本次调用的身份。

• Create Form Template

  创建表单模板 + 可选初始字段（写入草稿版本，需再调 publish_form_template 生效）。fields 为字段数组，每项含 field_name/field_label/field_type 等。常规与智能字段类型均可通过 API 创建；智能字段(ocr/regulations 等)若缺必要配置会返回 need_config 提示选择并回填，而非拒绝。卡码验证字段(activationcode)同样受「一个表单只能有一个 + 仅与辅助类型字段共存」约束。创建成功后会自动生成四个默认进度标签（待处理/处理中/已完成/已关闭），与后台新建模板行为一致。

• Update Form Template

  更新模板元信息并重写草稿版本字段（fields 为完整字段数组，会清空草稿现有字段后重建）。需再调 publish_form_template 生效。受 data_scope 数据范围分级约束。

• Publish Form Template

  将当前草稿版本发布为线上版本，使模板/字段变更对外生效。

• Add Form Field

  向模板【增加一个常规字段】（写入草稿版本，涉及版本变化），需再调 publish_form_template 生效。常规字段类型可自由创建；智能表单字段(ocr/激活码/追溯码/条例/人员选择)缺必要配置时接口返回 need_config（含所需配置项键名），由调用方选择并回填，而非拒绝。注意：卡码验证字段(activationcode)额外受限——一个表单只能有一个，且只能与辅助类型字段(分隔线/提示语)共存，否则返回 HTTP 422。

• Delete Form Field

  从模板【删除一个字段】（写入草稿版本，涉及版本变化）。需再调 publish_form_template 生效。删除不区分字段类型。

• Save Form Basic Info

  编辑表单基础信息（按需传参，未传项保持不变）。可改标题/描述/显示样式/访问类型/状态/开放时间，以及提交控制类配置。注意信息查询开关的键名为 submit_query_enabled。

• Save Form Brand

  编辑表单品牌风格（brand_config）。仅更新传入的键，未传的保持原值。

• List Form Progress Labels

  读取表单的进度标签列表。

• Save Form Progress Labels

  保存表单进度标签（整体覆盖：传入集合即为最终集合）。最多 50 个；名称不可重复且不超过 100 字符；颜色需为 #RRGGBB 格式。已有标签需带 id，不带 id 视为新增。

• Save Form Reminder

  新增或更新表单提醒规则：传 id 为更新，不传为新建。name 必填；trigger_event 仅可取 on_submit/on_approve/on_reject。

• List Form Reminders

  读取表单的提醒规则列表。

• Delete Form Reminder

  删除表单提醒规则。

• List Form Collaborators

  列出「表单级协作员」（fa_form_collaborator，即被授权协作某个具体表单的人）。与 collaborator_list（租户会员 fa_user）是不同概念。

• Save Form Collaborators

  批量设置「表单级协作员」：为指定表单授予/更新一批成员的协作角色。成员必须是本租户会员（可先用 collaborator_list 获取用户 ID）。

• Delete Form Collaborator

  移除某个「表单级协作员」。

• Save Form Data Interface

  保存表单的数据接口绑定（API 推送 / Webhook 配置 ID 列表）。