SuperAPI AI 工具集

fcode-ui-triggers

数据与分析

查看项目

更新于 10-16 08:37

技能介绍

用途:把 Factorial 市场应用的流程暴露为产品界面里的按钮。Factorial 页面声明 location,已安装应用的流程可认领该 location,界面为每个认领流程渲染一个按钮;点击后运行流程或打开其表单。

配置:在 processes/<slug>/metadata.json 的 factorial.uiTrigger 子块声明,再执行 fcode push。字段含 enabled、locationId(启用时必填)、label(纯文本或 fcode.i18n 令牌)、icon;awaitResult 位于 factorial 顶层,默认 true(同步),false 为即发即弃。存在旧版顶层 uiTrigger 块仍可往返兼容,新代码应写 factorial。

限制与注意事项:仅已安装市场应用才有按钮,触发需经 dev→prod→release 部署流程;location id 须由拥有该页面的 Factorial 团队提供,未知 id 会被静默忽略;location 决定契约(转发参数、结果键、是否 single)。抛出未捕获错误时用户只看到通用提示,应返回 { errors: [...] }。变更最长约五分钟生效。单次同步预算约 50 秒。

表单触发:启用 factorial.form.enabled 后按钮在 Factorial 内以对话框打开表单,走 Factorial 后端提交并注入 company_id、triggered_from_location、access_id。文件字段用 x-fcode-file 声明,文件直传存储,上传文件 48 小时后删除。图标仅支持 Bell、Calendar、Chart、Document、Download、ExternalLink、Globe、Graph、Link、Play、Refresh、Send、Settings、Sparkles、Star、Upload。