宜搭问题排查与常见问题 FAQ

可能原因 宜搭未安装到企业、可见范围不含当前用户、浏览器拦截 Cookie、或自建版域名/CorpId 配置不一致。 排查步骤

1. 钉钉管理后台 → 应用管理 → 确认「宜搭」已启用，可见范围包含测试账号所在部门
2. 换 Chrome/Edge 无痕窗口；关闭「阻止第三方 Cookie」后重试
3. 优先在钉钉客户端内打开工作台宜搭，排除浏览器插件干扰
4. 自建部署：核对宜搭后台「集成配置」中 CorpId、回调域名与钉钉开放平台一致

仍失败时 记录浏览器 Network 中 login 请求返回码，附带 CorpId 提交宜搭工单。

宜搭权限独立于钉钉通讯录：需在宜搭「组织管理 → 成员管理」中邀请或同步成员，并分配应用访问权限。仅加入钉钉部门不等于自动获得宜搭应用权限。

宜搭成员状态需手动禁用或等待通讯录同步任务执行（通常 T+1）。管理员应在「成员管理」中及时禁用账号，并回收应用管理员、开发者等高权限角色。

宜搭以服务端数据为准，客户端偶发缓存延迟。处理方式：下拉刷新列表；审批类操作优先在发起端完成；避免同时在 PC 与手机编辑同一条记录。

按优先级排查（约 5 分钟可定位 80% 案例）

1. 数据权限：数据管理 → 权限设置 → 确认当前角色为「全部数据」或包含提交人；若仅「本人数据」，管理员账号看不到他人提交
2. 列表筛选：点击「重置筛选」；检查是否默认筛选了「流程状态=审批中」导致已结束单被隐藏
3. 流程占用：绑定流程的表单，新记录在「我发起的」「待我处理」中，未必出现在普通数据视图
4. 自动化误删：智能助手Pro → 运行日志，筛选提交时间点前后是否有「删除数据」动作
5. 多版本表单：确认查看的是与提交时相同的表单版本（发布变更后旧实例仍挂旧版）

验证 用提交人本人账号登录查看；若本人可见而管理员不可见，根因在数据权限组。

必填、格式、唯一性、自定义校验公式均会拦截提交。移动端错误提示较小，建议在 PC 端复现；检查子表单内是否有隐藏必填行；校验公式中引用空值时需用 IF 兜底。

单文件大小受版本限制（免费版通常 ≤ 50MB，企业版可更高）；检查网络与钉钉/企业防火墙是否拦截上传域名；图片字段与附件字段限制不同；批量上传建议分批，单次不超过 20 个文件。

导入前准备 从数据管理导出官方模板，勿手改列顺序；成员/部门字段填 userid / 部门编码，非显示姓名。 失败处理

1. 下载「错误报告」定位行号与字段；常见：日期非 YYYY-MM-DD、单选值不在选项列表、必填为空
2. 单次 ≤ 5000 行；超大文件按月份拆分导入
3. 导入不触发智能助手Pro——若需补跑，用定时任务或手动批量更新触发字段
4. 导入后核对行数：数据管理总行数 − 导入前行数 ≈ 成功条数

主表汇总子表需使用 SUM 等聚合函数，引用路径应为「子表单.金额」而非主表字段。子表行数上限约 200 行（以当前版本文档为准），超出会导致保存失败或截断。

使用 UTF-8 打开；关联表单字段导出为 ID 时需用 VLOOKUP 二次匹配；导出大量数据建议用「数据管理 → 导出」而非视图复制，超限时联系管理员分批导出。

聚合表按设定频率刷新，非实时；修改源表单后需等待下一次同步或手动触发刷新。检查聚合条件、分组字段类型是否一致；关联字段变更后需重新保存聚合表配置。

五分钟检查表

1. 规则状态是否为「已发布」（草稿不执行）
2. 触发事件与实际操作是否一致：手动改字段不触发「仅新增」规则
3. 条件里字段路径是否因改版变更（如子表字段重命名）
4. 运行日志 → 查看「跳过 / 失败」及原因文案
5. 批量导入、OpenAPI 写入：确认版本是否支持触发，必要时改定时同步

高频误配 在「修改时触发」中更新了会被条件再次命中的字段，导致循环或意外跳过——用状态机字段控制只执行一次。

避免「修改时触发」监听会被自身更新再次触发的字段；增加条件判断（如状态字段仅变更一次）；使用「仅当字段从 A 变为 B」类条件；关键写操作建议加唯一性约束或幂等校验。

检查上游数据源连通性与字段映射；单任务数据量过大时拆分为多个节点或缩小时间窗口；查看任务运行详情中的失败行；输出目标表字段类型需与加工结果匹配。

单表数据量超过 10 万行后查询明显变慢；为常用筛选字段建索引；列表默认不加载大文本/附件字段；历史数据归档到「归档表」或导出冷存储；复杂关联改用聚合表预计算。

单图表数据点建议 < 1 万；多图表引用同一数据源时可合并查询；避免实时拉取全量明细，改用聚合表或数据工厂预处理；高峰时段避开大批量导入与定时任务叠加。

各版本配额见订购页面；清理未使用应用与草稿自动化；合并相似智能助手Pro；升级套餐或联系宜搭商务扩容。算数科技渠道客户可协助评估版本与采购优化。

1. 门户设计器 → 检查菜单项是否绑定正确页面，且状态为「已发布」
2. 菜单「可见角色」是否包含当前用户所属角色
3. 子应用从主应用拆出后，门户链接可能仍指向旧路径，需更新菜单 URL
4. 移动端与 PC 端可配置不同导航，分别预览钉钉内 H5 与浏览器

数据源表单权限不足会导致组件无数据；检查页面筛选条件是否过严（如默认「本月」但无本月数据）；仪表盘组件引用的聚合表是否已刷新；设计态有数据而运行态无数据时，多为发布未同步。

表单设计 → 移动端布局单独调整，勿仅依赖 PC 自动适配；避免一行过多列；固定底栏按钮与钉钉原生栏重叠时，增加底部留白；在真机钉钉内测试，浏览器模拟不完全可靠。

打印模板需单独配置字段映射；子表打印检查「展开行」设置；图片/附件字段打印受权限与文件大小影响；流程未结束时部分字段可能尚未赋值，在「审批完成」节点后再触发打印更稳。