租户管理员手册

给企业管理员 · 操作员请看 PDA 使用说明

一、登录控制台

浏览器打开 https://pda.etimefun.com/console/,输入企业代码、管理员账号密码(开通时平台方提供)。忘记管理员密码请联系平台方重置。

二、看板(日常第一眼)

每个场景的状态、最近 webhook(简道云推数据过来)、最近拉取(系统去简道云拉数据)。时间变红说明对接可能断了——去场景页「体检」。

三、场景管理

场景=一类扫码业务,两种类型:开单计数(按单据扫)/ 直接计数(自由扫)。新建走四步向导:基本信息 → 选表 → 字段映射(标准模板可一键套用)→ 体检确认,完成后按提示到简道云配置数据推送。

按钮作用何时用
体检自查对接是否健康任何"数据不对"先点它
拉取手动拉一次简道云数据单据/档案没及时出现
暂停/恢复停用该场景业务停用
重建清缓存全量重拉数据错乱的大招,慎用

四、设备管理

PDA 首次登录自动登记(受授权上限约束)。操作:改名(起易认名)、挂失(丢失即挂,找回再恢复)、禁用重置凭证(PDA 报"凭证冲突"时用,重置后设备重新登录自动领取)。

凭证三态:未发 / 在册 / 冲突(疑似设备被克隆或重装,核实后重置)。

五、成员管理

六、告警

设置:企业微信建一个纯内部成员的群(含外部联系人的群没有机器人入口),群设置 → 群机器人 → 添加自定义消息推送,Webhook 地址填入设置页并「发送测试消息」。

告警页自动监测:写回死信、同步停滞、映射损坏、额度将满、授权临期、设备凭证冲突。可手动「关闭」,多数在问题消除后自动解决。

七、死信(写回失败的记录)

扫码写回简道云失败重试多次后进死信页。看「失败原因」排查(常见:简道云字段被改动 → 场景页重新映射+体检),修复后重推批量重推

八、常见问题速查

现象排查顺序
PDA 说"无可用场景"成员管理 → 可用场景是否分配
PDA 扫码弹红幅(档案外)场景页「拉取」→ 仍不行「体检」
PDA 看不到新单据看板查推送时间 → 「拉取」→ 简道云推送日志
PDA 登录报凭证冲突设备页核实后「重置凭证」
授权过期/设备达上限联系平台方调整授权
扫码数据没进简道云死信页看失败原因 → 修复后重推
解决不了联系平台方,附上:场景名、大致时间、PDA 提示截图。