先找到你要做的事
第一次配置，从业务页开始；遇到问题，直接查现象
配置专家的作用，是把手机上的操作接到本厂已有的 ERP 规则。实施员需要说清楚：谁做、货在哪里、数据写哪里、码怎么认。
确认本次维护对象
在运维工具顶部选择正确的 API 和账套，用该 API 的 ADMIN 登录，再进入“配置专家”。实施员可使用此页；日常运维管理员不负责这里的专业配置。
做到这一步应看到：顶部维护目标、当前账号、左侧选中功能都与本次任务一致。
先准备一笔说得清的业务
例如：哪位工人、在哪个部门、处理哪一批货、数量是多少、保存后希望在哪个 ERP 页面查到。带一张真实业务单据或现有 ERP 配置记录来核对。
做到这一步应看到：能回答数据的实际含义；不需要先猜数据环境的名字。
每次配置完一个职责页就保存
通常按基础绑定 → 使用范围 → 字段设置 → 扫码规则 → 标签输出 → 体检与启用推进。不适用的页会隐藏；下文和四篇业务指南会说明哪些页需要做。
做到这一步应看到：当前页不再显示未保存修改，重新读取后仍是刚保存的配置。
四篇业务专项
按正在实施的业务，走完一条完整路线
四篇都包括：业务来龙去脉、前置资料、逐页配置、图解示例、故障处理和现场验收。
先懂来龙去脉
手机点一下“保存”，背后要接通什么？
- 收集这笔业务
手机录入，流程给路线，扫码规则带回货品等信息。
- 按配置填 ERP 列
字段映射确定落点；数据环境执行默认值、计算式。
- 检查并正式保存
ERP 检查器按时机执行，保存到配置指定的正式表。
- 读回同一笔结果
手机回显单号和数量；生产作业再用正式 WorkID 打标签。
使用范围负责入口权限。任一步失败，都要查看具体失败位置；“字段都填过了”不能证明已保存，更不能证明业务已经完成。
看懂一个小例子：输入 40 件，为什么还会报“缺数量”？
手机的“数量”有值，只证明工人填了 40。还要在“手机写入”中把数量接到真实 ERP 数量列，并保存映射。若误接到重量列，或者建议还没接受和保存，正式数量列依然可能为空。
处理顺序：看手机数量 → 看已保存目标列 → 看默认值/计算式是否重算 → 看 ERP 正式记录 → 看读回列。不要为了消红字给数量填固定值 40。
一个问题，找对配置位置
这些名字分别管什么？
工作流程：货怎么走
决定允许的部门和路线，也是功能授权的单位。来货只用接收部门，出货和作业只用交货部门，生产交接用完整路线。
去哪里找：基础绑定；旧 ERP 的工作流程及明细。
数据环境：数据怎么存
可以把它理解为 ERP 的“存单说明书”：有哪些表列、表头如何关联明细、怎样编号、怎样补值、保存前后检查什么。
去哪里找：基础绑定；旧 ERP 数据环境配置。
字段映射：把值填对格子
说明手机字段、流程值、扫码结果等分别落到哪个 ERP 列，以及保存后从哪里读回来。名称相似只能帮助找候选。
去哪里找：字段设置的四个子页。
PDA：扫到的码怎么解释
先识别码类别，再查正式数据，再决定带回什么。只认出了码的外形，还不等于已经找到货。
去哪里找：扫码规则；旧 ERP 的 PDA 配置。
使用范围：谁可以做
选择账号、手机角色、登录工位或所有启用账号。一个工作流程的授权可能影响共用它的其他移动功能。
去哪里找：使用范围；用户与密码。
标签输出：把记录交给下游
生产作业的标签用正式码值识别同一笔记录；模板决定纸上内容，下游自己的 PDA 决定怎样认它。
去哪里找：标签输出、标签设计器、下游扫码规则。
配置专家 · 基础绑定
先选流程与数据环境，再做字段
工作流程和数据环境要分别从当前账套选择。名字相似不代表它们可以互相推导；最终以真实业务路线和表列为准。
- 1左侧选中的是本次要配置的移动功能
- 2工作流程：按当前账套真实候选选择
- 3数据环境与本功能专有选项
- 4保存基础绑定；其他页仍须分别保存
- 1
选功能，不先造流程
来货、出货使用左侧固定功能；生产交接点“交接”新增，生产作业点“作业”新增。按真实环节命名，避免几条功能都叫“测试”。本指南只讨论这四类业务。
- 2
选流程并核对实际路线
下拉可输入名称或编号中的一段，再点选真实候选。看“所选工作流程的实际路线”；只检查本功能会用的维度。多个合法候选由使用者明确选择，不能默认拿第一条代替。
- 3
选数据环境，补本功能专有项
核对环境中的真实目标表和字段。生产交接还要选交接方向；生产作业还要选记录方式及数量名称等。具体填法见各业务专项。
- 4
保存后再读字段
点“保存：基础绑定”，再到字段设置点“重新读取四页字段结构”。换数据环境后，旧字段草稿不能直接套到新环境。
完成结果：基础绑定重读一致，字段列表来自刚保存的数据环境。
四类业务的关键区别
部门的含义不能混用
| 业务 | 取哪个流程字段 | 这笔业务的结果 |
|---|---|---|
| 来货 | 接收部门 → 单头存货部门 | 建立来货单头和明细；批号按数据环境生成。 |
| 出货 | 交货部门 | 装车后生成送货单；结存变化由旧 ERP 正式单据及触发器处理。 |
| 生产交接 | 交货部门 → 性质 → 处理对策 → 接收部门 | 保存一次真实交接；收货部门来自选中的路线。 |
| 生产作业 | 交货部门 | 这既是作业归属，也是批号正结存范围；记录工作量，不移动库存。 |
配置专家 · 使用范围
授权给实际使用的人，并用他的账号验证
给谁用与数据写哪里是两件事。所有获权账号共用本功能映射，不需要按人重复配置字段。
- 1授权范围：账号、手机角色、登录工位或所有启用账号
- 2点选真实对象后添加授权
- 3核对已授权范围和启用状态
- 4保存当前工作流程的使用范围
- 1
先保存流程，再选授权范围
选择“指定账号”“指定角色”“指定登录工位”或“所有启用账号”。角色指手机角色；登录工位不等于库存部门。
- 2
添加对象并保存
从当前账套真实候选点选，点“添加授权”，核对列表，再点“保存：使用范围”。添加到列表还是草稿，不代表已经授权成功。
- 3
留意共用流程与同时编辑
权限按工作流程共用。两项功能绑定同一流程时，授权影响两者。同一流程尽量由一人维护；若保存提示冲突，先保留草稿，重新读取并核对，确认后放弃旧草稿再修改。提示缺读取快照时须更新工具；旧版不能假定已有防覆盖保护。
- 4
用现场账号测试
待功能启用后，用目标账号重新进入 APP，核对是否能看到并操作；另用未授权账号确认不能使用。ADMIN 能进入不能证明工人也有权。
完成结果：有权者可用，未授权者被拒绝；账号停用、工位或角色变化也已核对。
配置专家 · 字段设置
先讲清这是什么值，再选它要去的列
字段映射像给一张表填格子：左边是手机里的业务含义，右边是当前数据环境的真实 ERP 列。数量、重量、件数和合格数量不能因名字相似就互换。
- 1重新读取四页字段结构：读取，不保存
- 2手机写入、ERP 补值、允许修改、保存后读回
- 3建议只是候选；右侧正式目标才是要保存的配置
- 4按钮上的页名表示本次保存范围
- 1
读结构，看清表与列
先保存基础绑定，再读四页字段结构。检查目标属于单头、明细还是单条记录。来货和出货的单头/明细关系由 ERP 的 Relations 定义，不能凭哪张表排在前面判断。
- 2
逐行确认，不批量照抄建议
先看业务含义、单位、类型和保存时机，再点选 ERP 目标。建议正确时可“接受已选建议”，但接受后仍是草稿。物理列名与界面标题可能不同，要核对实际列。
- 3
四个子页分别保存
当前子页保存后再处理下一页。“重新读取”不会保存，“下一步”也不能代替保存。取消“只看待处理”可检查已配项目，空白列表有时只是都被筛掉了。
- 4
从真实结果倒查
用一笔数量、重量容易区分的业务验证。看 ERP 实际值，再看手机读回；两边不同，先定位是哪一方向错了。
完成结果：录入、正式记录与读回一致；必填项来源明确，选填项按业务明确处理。
四页各做什么
写入正确，还要确认能改、能读回
| 字段子页 | 你需要决定什么 | 典型例子与验证 |
|---|---|---|
| 手机写入 | 工人录入/选择的值存到哪个 ERP 列；不用的选填字段可明确不写入。 | 手机数量 40，应到数量列而非重量列。必需字段不能选“暂不写入”。 |
| ERP 补值 | 手机没填的 ERP 列由谁提供值。 | 部门取流程，业务时间取已配置来源，单号/作业码按数据环境生成。 |
| 允许修改 | 修正已有记录时，哪些列更新、用什么新值。 | 新增能写数量，不代表修正时也已允许写；原记录标识不能随修正变成另一笔。 |
| 保存后读回 | ERP 保存结果怎么回到手机；引用选择后，返回列如何带回手机字段。 | “ERP 保存结果”读已存记录；“引用选择后带回”读所选候选，它们不是同一次读取。 |
把术语翻成操作
六种来源，应该选哪一种？
先确定“这个值是谁决定的”。下表英文用于识别排障文件或配置提示；实际操作仍从界面候选选择。
手机录入 · MobileField
工人在手机填写或确认的业务值，如数量、批号、作业人编号。生产作业的这三个字段必须明确映射。
流程字段 · WorkflowField
已选路线里的部门、性质等。来货存货部门取 ToCenterCode（接收部门），不能拿固定仓库替代。
扫码带回 · ScanField
当前 PDA 规则查到并明确输出的值。要先有规则和输出，再选真实来源；不能只写一个想象中的输出名。
当前上下文 · SessionField
系统提供的当前用户、时间等候选。操作账号与实际作业人可能不同，不能因为方便就让登录人代替作业人。
明确固定值 · Static
实施员确认这项业务恒定的值。要符合列类型与业务要求；不能用 0、空字符串或随手写的部门掩盖缺配置。
ERP 生成 · DataEnvironment
使用该列真正配置的默认值、计算式、自动编号等。仅仅选择这个来源不会凭空生成规则，仍要核对 ERP 列配置。
重点详解 · 下拉、过滤与带出
能看到候选、能选中、能带值，是三件事
在字段行点“来源/带出…”。这个窗口能帮你看清旧 ERP 的来源配置；它不是一张万能的新映射表。
- 找到来源
从哪个真实数据环境、逻辑表读取候选。
- 按本笔条件筛选
例如客户、部门、正结存；参数必须有明确绑定。
- 选择真实记录
编号和名称列各有出处；输入只用于筛选。
- 带回需要的列
将返回的客户、货品、规格等明确对应到手机字段。
手工选择与扫码是不同入口。把下拉配好，不等于 PDA 已经配好；两条路最终都要遵守同一业务范围。
第①类：简单列映射的候选来源（IDSource）
用于说明简单引用从哪里取候选。窗口只能点选当前账套真实来源；“保存第①类来源”只改这一项，不会顺便改 DataSelect 或 PDA。
做到这一步应看到：候选来源、编号列、名称列可以追溯；编号旁不再因缺名称配置显示“未配置名称列”。
第②类：DataSelect，带条件的选择与带出
核对来源、过滤条件 SqlWhere、参数映射 ParamsMapping、回检条件 CheckBack，以及选中后带回列。多个定义时通过 UseMappingName 显式指定；“保存第②类 DataSelect”只保存选用哪条定义，不编辑其 SQL/条件/输出。
做到这一步应看到：当前选择明确，条件中的每个参数都有来源；换客户或部门后，候选范围会正确变化。
第③类：PDA，扫码时的查询与带出
回“扫码规则”查看本功能绑定的 PDA 表单。修改简单来源或 DataSelect 都不会修复 PDA 正则、查询和输出映射。
做到这一步应看到：同一批货用手选和扫码进入时，客户、部门、批号等结果一致。
带回列还要接到手机字段
回字段设置 → 保存后读回 → 引用选择后带回，确认所需 ERP 返回列。扫码的输出则在“扫码后带入手机字段”中配置，不能混存。
做到这一步应看到：选货之后应带回的名称、规格等确实显示；保存再打开仍能读回同一记录。
字段问题速查
这些小问题，先这样查
接受了建议，为什么仍说没配置？
- 先分清
- 接受建议只写入当前草稿；维护候选词典只改变建议。
- 这样处理
- 看右侧正式目标，保存当前字段子页，再重新读取。若是 PDA 输出，保存的是“扫码后带入手机字段”。
- 改后确认
- 正式目标、保存成功反馈、重读后的目标三者一致。
列表没有任何字段，是不是坏了？
- 先分清
- 可能启用了“只看待处理”，也可能还没保存绑定、没有可写列，或读取失败。
- 这样处理
- 先取消筛选；再看状态提示。未加载时先保存基础绑定并读结构；报读取错误时处理连接/权限/对象错误，不将它当成无需处理。
- 改后确认
- 能看到明确的完整字段清单，或有依据的“无需处理”说明。
想写的列不在候选里
- 先分清
- 候选受数据环境、可写字段、物理列类型限制；计算列、只读列和数据库自动生成列不能当普通输入列。
- 这样处理
- 核对所选环境、SelectInfos、UpdateFields 和物理列。需要 ERP 生成的值应配置生成及读回；不要改成相似列绕过。
- 改后确认
- 目标列真实存在且可用于该方向，提交值落到业务要求的列。
编号正确，但只显示“未配置名称列”
- 先分清
- 编号列说明存什么，名称列说明给人看什么；二者各有配置。
- 这样处理
- 回对应 ERP 引用来源补名称列，再读来源。不要根据编号猜人名、部门名或货名。
- 改后确认
- 多个候选均显示各自真实名称，选择后仍保存原编号。
同名列很多、两个字段选中了同一列
- 先分清
- 单头、明细、引用表可能有同名列；目标重复也可能是映射冲突。
- 这样处理
- 按数据环境 → 逻辑表/记录范围 → 物理列逐级确认，并核对含义和单位。保留一个明确来源，纠正错误目标，不让建议替你决定。
- 改后确认
- 没有重复目标或歧义提示，新增和修正都写对表列。
数值变了、精度丢失或提示类型不符
- 先分清
- 可能列选错、单位不同，也可能数据环境计算式主动改值。
- 这样处理
- 分别比对手机输入、映射值、列类型/长度/小数位、计算式、ERP 最终值及读回值。先定位在哪一步变化，再改该步骤。
- 改后确认
- 用整数、小数、边界值各验证一笔；单位明确，不靠改显示名称代替换算。
配置专家 · 扫码规则
先保存 PDA 表单，再保存它带入手机的字段
来货没有这一页。出货、生产交接、生产作业各自显式选择 PDA 表单；工作流程不会替你选。页面上有两个独立的保存范围。
- 1为当前功能选择并保存真实 PDA 表单
- 2旧 ERP 码类、识别式、动作和查询，只读查看
- 3PDA 实际输出 → 正式带入手机字段
- 4映射区域自己的保存按钮，区别于底部 PDA 表单保存
- 1
确定现场到底扫什么
列出批号码、人员码、挂具码、作业标签等实际入口，每种准备一个脱敏样例。PDA 表单有名字但规则为空，不能算配置完成。
- 2
保存 PDA 表单绑定
先选当前账套真实 PDA 表单，点底部“保存：扫码规则 / PDA 表单”，再读取该表单规则。不要把换表单和旧表单输出映射同时作为一批草稿保存。
- 3
逐行接手机字段
看“实际输出”，选择“正式带入手机字段”。例如工号输出应指向实际作业人字段，批号输出应指向批号。接受建议后，点区域内“保存：扫码后带入手机字段”。
- 4
拿同一码走完整条链
分别手输和扫码，核对识别类别、查询结果、带值、候选范围和重复处理。识别成功不代表提交成功，还要完成业务保存。
完成结果：每个启用码类都有明确用途和带回结果；错误码能说明失败在哪一步。
扫码排障的固定顺序
沿识别、查询、带回、处理逐步排查
- 识别码类别
Regex 看外形；多条命中要消除歧义。
- 查到正式对象
SQLSELECT 与参数确定查谁；@BarCode 是本次原码。
- 带回手机
ERP 的 MAPPINGCOLUMNS 输出，再接手机字段映射。
- 按规则处理
FINDTYPE 等定义重复/查找行为；随后仍按业务范围和检查器提交。
配置中的 SELECTARGS 决定查询参数来源。@BarCode 只是原码，不天然等于批号、工号或作业号；查哪种对象由该规则明确决定。
配置专家 · 标签输出
生产作业必须配置 WorkID 标签，码要能被下游识别
标签输出页只在生产作业出现。WorkID 是本次作业的正式标识；不能拿交接 RID、批号或随手拼的码代替。这里负责绑定，版式去标签设计器。
- 1生产作业必需的 WorkID 标签输出
- 2由数据环境在新增时生成的正式码值列
- 3符合当前功能上下文的蓝牙标签模板
- 4保存标签绑定后，再做体检
- 1
先把正式码值生成与读回配好
码值来自 ERP 数据环境的自动编号、默认值或计算式等真实规则。字段叫 WorkID 不代表就会生成；候选空时回字段设置和 ERP 生成规则查。
- 2
从当前功能打开标签设计器
选择匹配本功能数据环境、PDA 上下文的模板。模板应含正式码值，并表达客户、部门、货/批次、数量；示例文字不能代替正式变量。
- 3
先配好真正的下游消费者
启用生产作业前，至少一个已启用的生产交接或出货功能要有可识别该码的真实 PDA 规则。两者可以同时识别，不要求只选一个，也不强制先入成品仓。
- 4
试打、扫回、补打
无线蓝牙打印的设备、纸张和份数在手机端核对；模板细节见标签设计专项。打印失败先查正式作业是否已保存，再对原记录补打，避免多记工作量。
完成结果：纸上内容与正式记录一致，下游能查到同一作业；补打不会新建作业记录。
ERP 检查器与表达式
分清“规则不允许”和“规则执行不了”
按动作执行
检查时机决定它在什么时候生效
| 当前动作 | 执行哪些检查 | 实施员怎样处理 |
|---|---|---|
| 新增 / 修正提交 | Checking + Updated | 读具体检查名称和提示，判断客户、数量、库存、状态等是否违反本账套规则。 |
| 删除 / 作废 | RowDeleting | 按正式状态和检查结果处理；新增通过不能证明允许删除。 |
| 桌面编辑事件 | RowChanging / ColumnChanging / Updating 不按提交事件执行 | 不要把移动端没触发桌面控件事件当作有权跳过保存检查。 |
规则确实拒绝了业务
例如提示库存不足、客户不允许交易或已保存记录不可删。先核对输入、状态和实际业务。只有业务规则本身需要改变时，才由负责该规则的人修改 ERP 配置。
做到这一步应看到：允许的业务能通过，不允许的业务仍按要求被拦下。
表达式或 Enabled 算不出来
记录数据环境、表、检查名称、原始错误和操作动作。配置确有拼写、对象或参数问题则修配置；ERP 能执行而移动端不支持的语义，应反馈产品支持，不能靠关检查器掩盖。
做到这一步应看到：能明确指出问题属于配置缺失还是执行能力缺口，不把失败当成通过。
检查没有启用，或没有配置检查
Enabled 表达式明确为 false 时才按规则跳过。可读且完整的配置中确实没有检查器，不等于读取失败；不能因为数量为零就随意补造一条检查。
做到这一步应看到：本次使用的是当前账套真实规则，失败信息没有被空列表遮住。
配置专家 · 体检与启用
修完阻断，保存启用，再做业务验收
体检看的是已经保存的配置。它能判断配置是否完整，不能替代一笔真实输入下的 ERP 表达式执行、实体打印和现场验收。
- 1当前功能的阻断数量
- 2具体问题、影响，以及跳到责任页的入口
- 3重新体检只读已保存配置
- 4核对草稿与启用条件，勾选后仍要保存本页
- 1
先保存各页草稿
看体检页“未保存草稿”列表；逐页保存或明确放弃。修改了字段却未保存，上方仍显示旧问题是正常的。
- 2
逐条处理阻断
读问题、影响和“去某页处理”。提示只说明风险，不阻止继续；阻断才必须修复。只有状态没有原因时，导出排障材料反馈，不能自行猜字段。
- 3
重新体检并保存启用
阻断清零后，勾选“启用当前移动功能”，点“保存：体检与启用”。已经启用又出现阻断时，可以取消勾选并保存停用，修完再启用。
- 4
换实际账号验业务
让目标账号重新进入功能，用测试业务逐步核对手机、ERP 正式记录及下游结果。
完成结果：功能已启用且真实业务可完成，失败路径也能准确解释。
以界面实际文字为准
状态和草稿不是一回事
| 界面状态 | 它表示什么 | 下一步 |
|---|---|---|
| 未配置 | 还没有完整的正式配置。 | 从基础绑定开始。 |
| 不完整 | 有配置，但体检有明确缺口。 | 点查看阻断，按责任页补齐。 |
| 可启用 | 已配置、当前无阻断，但尚未启用。 | 到体检与启用勾选并保存。 |
| 已停用 | 当前功能停用；仍需核对是否有阻断。 | 修复后再体检、启用。 |
| 已启用 | 服务端已开放配置；仍受用户权限和每笔业务检查约束。 | 做现场验收。排障响应中的 Ready 对应已启用，不能解释成“尚未启用”。 |
| 有未保存修改 | 这是当前页编辑状态，尚未成为运行配置。 | 保存该页；不能只刷新或直接离开。 |
交给现场前
每个功能至少验完这些，再说能用
按对应业务专项选取可回滚的测试单据。记录时间、账套/API、移动功能、流程号、数据环境、账号及真实业务键；不要记录密码和密钥。
- 1. 身份与入口
目标账号可进入，未授权账号不可用；ERP 执行身份符合现场安排。
- 2. 范围与候选
换客户、部门后范围变化正确；范围外候选、失效对象和多候选均处理明确。
- 3. 新增、读回与修正
正式表、主键、批号、数量、时间一致；修正影响同一记录；检查器按规则执行。
- 4. 扫码及重复处理
需扫码的功能覆盖每种码类、手输、错码及重扫，结果能追溯到 PDA 配置。
- 5. 标签与下游
生产作业验真实标签、下游扫码和原记录补打；未连接实体打印机时明确记为待验。
- 6. 清理与交接
测试记录按正式作废/移除流程处理并复核状态；保留必要证据，留下未通过项及负责人。
现场故障速查
先选现象，再按顺序排查
点开问题看“先分清 → 这样处理 → 改后确认”。也可用浏览器查找关键词。每次只改一个已经定位的原因，再重复原操作。
入口与候选
找不到配置专家，或页面没有权限
- 先分清
- 配置专家在运维工具中，供实施员使用；当前可能是普通 Ops/运维会话，或切换 API 后旧会话已清空。
- 这样处理
- 核对顶部 API，使用当前 Factory API 的 ADMIN 登录。平台网站账号不是这里的登录账号。
- 改后确认
- 维护目标和登录身份正确；不需要给普通工人开放配置专家。
工人 APP 看不到已经配置的功能
- 先分清
- “已保存”“可启用”“已启用”不同，还受流程授权、账号状态和授权有效性影响。
- 这样处理
- 依次看体检、启用是否已保存、使用范围是否含该账号/角色/工位、账号是否启用、APP 是否连接同一 API。重新进入功能验证。
- 改后确认
- 工人账号能进入；未授权账号仍被拒绝。不要只用 ADMIN 验。
流程、数据环境或 PDA 下拉没有想要的项
- 先分清
- 可能筛选词没清、候选未刷新、对象未配置，也可能是读取失败。
- 这样处理
- 清空筛选词，点对应刷新。根据提示区分空态和读取错误。确认真实缺项才回 ERP 补配置；手输名称只用于筛选，不能创建候选。
- 改后确认
- 真实对象出现在候选中，点选保存后重读一致。
路线显示“已排除”，或有编号却找不到部门
- 先分清
- 流程明细可能引用失效部门、性质、对策，或正式来源缺项。
- 这样处理
- 按被排除的路线序号和字段，核对 ERP 流程明细/来源。来货缺接收部门时，可用基础绑定的“查看接收部门…”处理真实缺项，不随意替换有效路线。
- 改后确认
- 刷新后显示预期有效路线；多条合法路线没有被误删。
有些功能看不到扫码页或标签页
- 先分清
- 页面按功能类型显示。
- 这样处理
- 来货无扫码页；出货、交接、作业有扫码页；标签输出只在生产作业出现。选错动态类型时，应按真实业务建立正确功能。
- 改后确认
- 类型与实际业务一致，不为补齐页签硬配无关能力。
保存与刷新
保存按钮灰色，或点下一步后发现没保存
- 先分清
- 当前页可能没有修改，或尚不满足保存条件。“下一步”负责导航，不是自动保存。
- 这样处理
- 看底部当前页名和草稿提示；有修改却不能保存时读具体提示。需要先保存基础绑定的，按顺序处理。
- 改后确认
- 出现保存成功反馈，草稿清除，重读一致。保存后按钮变灰可能正是已无修改。
换流程/数据环境时提示还有草稿
- 先分清
- 权限草稿属于旧流程，字段草稿属于旧环境，不能直接套到新对象。
- 这样处理
- 先逐页保存要保留的旧配置，或明确放弃草稿，再改基础绑定。换环境后重新读取四页结构并核对映射。
- 改后确认
- 旧草稿没有写入新对象，当前体检针对新绑定。
改了很多项，体检仍是原来的红字
- 先分清
- 可能只接受了建议、只改草稿、保存了另一子页，或剩余问题属于不同职责。
- 这样处理
- 看体检页未保存草稿清单，逐项保存，再重新体检。扫码表单和扫码输出分开保存。
- 改后确认
- 已修正的问题消失，剩余每一条都有具体对象和原因。
保存报“版本变化/冲突”
- 先分清
- 其他操作更新了绑定/映射版本，或修改了本工作流程共用的使用范围。
- 这样处理
- 保留草稿与错误，重新读取并比较正式配置。使用范围冲突时，核对最新授权后明确放弃旧草稿再修改；不要反复点保存或强行覆盖。
- 改后确认
- 保存基于最新配置，未覆盖其他人刚保存的内容。
保存超时，或提示“已保存，但刷新失败”
- 先分清
- 请求/刷新失败不等于服务器没有保存。
- 这样处理
- 先重读同一功能的已保存值。已保存就只修刷新问题；确认没保存再处理原错误并重试。
- 改后确认
- 以服务器重读确认成败，不用按钮颜色判断。
运行与数据
批号下拉为空、手选可以但扫码不行
- 先分清
- 手工候选和 PDA 是两条配置路径；生产作业还要求本部门正结存。
- 这样处理
- 先查批号确属当前客户/部门且有库存，再分别查两条入口的条件与参数。详见来源/带出及生产作业专项。
- 改后确认
- 范围内批号两种入口一致，范围外批号两边都不能混入。
扫码有反应，却没有货品、数量或人员
- 先分清
- 可能只匹配正则、查询零条/多条，或 ERP 输出尚未接手机字段。
- 这样处理
- 按识别式 → SQL 与参数 → 查询结果 → MAPPINGCOLUMNS → 手机输出映射逐段看。正确码也要用在正确功能。
- 改后确认
- 业务对象、客户、部门、数量都正确，错码不能借默认值继续。
功能已启用，提交仍被检查器拒绝
- 先分清
- 体检只验证配置；真实业务仍受库存、客户、状态、执行身份和表达式检查约束。
- 这样处理
- 读检查名称及原始原因，按检查器分流处理。ERP 能执行而移动端执行不了，要交产品支持核查。
- 改后确认
- 合法业务通过，违反规则的业务仍被拒绝。
提示成功，但 ERP 查不到或手机回显空白
- 先分清
- 可能查错账套/表/日期/状态，或写入和读回映射不一致。
- 这样处理
- 按响应中的正式业务键查当前目标表，再核对 ERP 页面过滤条件。记录存在而手机空白，查读回；没有记录则保留请求时间与错误，反馈执行链问题。
- 改后确认
- 手机、正式记录、ERP 查询对应同一业务键。不要先再提交一笔。
标签下游扫不到，或打印失败想再记一笔
- 先分清
- 下游 PDA、码值或范围可能不匹配；打印失败与保存失败是两件事。
- 这样处理
- 先查原 WorkID 是否已保存；已保存就对原记录补打。下游用自己的 PDA 核对原码、查询对象、输出和部门范围。
- 改后确认
- 工作量没有重复，补打仍指向原 WorkID，下游可识别。
复制另一账套配置后全是缺项
- 先分清
- 来源账套的流程、环境、列和模板不一定存在于目标账套。参考配置不是通用标准。
- 这样处理
- 逐项确认目标账套真实候选。共同产品能力缺口反馈产品；账套差异用明确配置解决。复用材料不包含密码、API Key 或机器身份。
- 改后确认
- 在目标账套独立重读、体检、完成业务，不能只验来源账套。
向支持反馈，给这些信息就容易定位
在哪：工具/API 版本、账套/API、功能名称与标识、当前责任页；流程号、数据环境、目标表列或 PDA 表单。
做了什么：准确时间、账号类型、操作步骤、预期与实际结果、完整错误；提交过业务时附业务键，扫码问题附脱敏原码及命中类别。
已经查到什么：是否仅某账号/部门失败、能否重现、是否已保存、重读是否一致。字段问题可用“导出排障文件（不改配置）”；分享前核对其中客户信息和内部地址。
不要附：登录密码、SQL 密码、API Key、令牌或完整连接字符串。
成套复用 · 配置方案
配好一套后，怎样带到另一个账套？
配置方案把已保存的移动功能和映射带过去，省去重复录入；目标账套的流程、数据环境和扫码规则仍要逐项确认。先明确源和目标，再做迁移。
- 源端导出
保存好配置，勾选要带走的功能，导出方案文件。
- 目标选择
逐功能确认流程、数据环境、PDA；相同编号也要看业务含义。
- 审阅导入
读差异、确认替换范围；整套保存为停用草稿，自动留备份。
- 修正体检
补齐目标引用、扫码、标签、使用范围；各项问题处理完再启用。
- 业务验收
用真实业务样例核对单据、结存或工作量，验证扫码和打印。
导入成功只说明这套配置已保存。体检、启用和业务验收是后续独立步骤，不能互相替代。
在来源实例保存，再导出
从配置专家顶部打开“配置方案”，填写“来源账套 + 实施参考用途”，勾选来货、出货、交接或作业条目，点“导出勾选功能…”。导出只读取已保存配置，编辑器里尚未保存的修改不会带走。
做到这一步应看到：拿到 .uprun-scheme.json 文件；文件名称、所选功能和来源用途明确。
在目标实例打开并选择真实候选
点“打开方案文件”，再点“选择目标并预检”。流程、数据环境、PDA 可输入筛选，但必须选真实候选。来货附属建档还要确认自己的环境。每个功能都确认业务含义后继续。
做到这一步应看到：每个目标都有明确选择；“按原编号预检”可先看差异，但不能代替目标确认。
按预检结果准备目标配置
“编号存在”只说明找得到，“有差异”要核对两边含义，“缺依赖”先补真实配置，“未核查”要继续审阅和体检。流程编号相同，也可能在两家分别表示不同部门；表列名称相同也不保证默认值、检查器一致。
做到这一步应看到：保存预检清单；明确哪些配置沿用，哪些要在目标重新设置。
迁移边界
哪些会带过去，哪些必须留在目标确认？
| 内容 | 方案如何处理 | 实施员接下来做什么 |
|---|---|---|
| 功能与字段 | 携带显式双绑、当前映射、引用及扫码带入、作业计量选项、产码位置、来货附属建档。 | 核对目标表列、来源类型、必填覆盖和引用来源。旧历史版本、未保存草稿不迁移。 |
| ERP 流程 / 环境 / PDA | 携带依赖编号与摘要，不复制 ERP SQL、检查器、关系定义、实体表或基础资料。 | 先在目标准备真实依赖。目标表列不同不能靠换流程编号解决，也不能随意改 JSON 绕过检查。 |
| 标签设计 | 携带所选模板设计；同编号不同内容拒绝覆盖，新模板保持停用。 | 冲突时在标签设计器使用独立编号，再从来源重新导出。客户、环境、图片和字体均须目标验收。 |
| 账号 / 权限 / 身份 | 不携带账号授权、密码、API Key、连接信息、服务器指纹或启用状态。 | 目标使用范围保持原值；按目标真实用户和工作流程配置，再体检启用。 |
先审阅影响，再保存
已有入口会被替换并停用，必须逐项看清
以下为工具离屏演示图，数量与业务名称仅作示意。点击“审阅后导入…”会再次读取目标并校验；此时仍未写入。
- 1已有功能逐项确认替换；当前启用项会停用
- 2核对新增、替换及目标依赖影响
- 3路线差异、缺失字段与标签依赖不能略过
- 4确认整套保存为停用草稿后才能导入
- 1
先定替换范围
同功能编号已存在时会替换该入口配置，不是新增副本。核对清单里的启用状态、差异和影响，逐项勾选确认；不希望替换的功能，应回来源重新导出所需子集。
- 2
区分阻断和草稿待办
目标列不存在、路线无效、字段来源不合法等会拒绝导入。原规则允许的不完整停用草稿可以保存，但校验说明会列出缺口，之后必须在配置专家修正。
- 3
导入并核实结果
确认整套停用后点“导入停用草稿”。配置、导入前后快照和历史在同一事务内保存；保存中途失败会整套撤销，不留下半套。
完成结果：看到明确导入结果；历史中有对应记录，功能均处于停用状态。
- 4
结果不确定时先核实
超时或断网不等于导入失败。保持当前审阅，点“核实本次结果”；需要重试时沿用本次操作编号。重新打开窗口后先查导入历史，不要立即再导入一遍。
备份与恢复
导入不合适，怎样恢复？
历史显示最近 50 次导入，可保存导入前备份、查看状态、回滚所选导入。图为演示数据；操作对象始终是当前目标账套。
- 1核对方案、时间、操作人和当前状态
- 2保存的是导入前备份，不是迁移方案
- 3选中记录后回滚，恢复前会重新检查
- 1
先保留追溯证据
打开“导入历史与备份…”，刷新记录，选中正确导入并保存备份。备份用于本账套追溯，不能作为跨账套方案文件导入；不要改扩展名强行打开。
- 2
理解恢复范围
回滚将原有配置恢复为停用草稿，移除本次新增入口；本次新建且未被其他功能引用的标签也会移除。不回退业务单据，也不恢复原启用状态。
- 3
遇到“导入后已修改”先停
配置、启用状态或共享标签在导入后有变化时，整套回滚会拒绝，避免覆盖后续工作。先导出当前配置留档，再逐项核对；不要强改数据库或删除历史来绕过保护。
完成结果：成功回滚的记录显示已回滚；恢复的旧入口仍需体检、确认使用范围并重新启用。
导入专项排障
看到这些提示，该去哪里处理？
| 现象 | 真因 | 处理与复验 |
|---|---|---|
| 编号存在，仍无可用路线 | 路线引用的部门等不在目标 ERP 参照来源中；原始记录可能存在，但已被排除。 | 按提示的路线序号、字段和失效编号，检查 ERP 工作流程与相应引用来源。不要重复建路线或借其他部门冒充。 |
| 缺来货存货部门 | 来货流程未配置接收部门，不能借交货部门补上。 | 在目标 ERP 确认真实来货存货部门并配置，再重新预检。 |
| 没有可写列 / 字段不存在 | 目标数据环境未包含来源映射的表列，或该列未列入可写字段。 | 核对目标实体表和数据环境；修正来源方案映射或准备目标真实环境，重新导出并审阅。 |
| 审阅后配置发生变化 | 其他编辑或 ERP 依赖已变化，原审阅依据过期。 | 重新校验并审阅，重新确认替换范围；不能把旧摘要复制进新请求。 |
| 导入成功，仍不能启用 | 导入只保存停用草稿；必填、引用、扫码、标签、权限仍有缺项。 | 回配置专家按体检列出的责任页逐项修正。体检通过后再启用，并完成四业务对应的现场验收。 |
| 备份打不开为方案 | 导入前快照与可迁移方案是两种文件格式。 | 跨账套用“导出勾选功能…”生成方案；恢复本次导入用当前账套导入历史中的回滚。 |
迁移结束前
这四件事做完，才算交付到目标账套
先选一个功能完成闭环，再按同样标准验收其余功能；不同业务的验收重点见四篇专项。
- 1. 读回核对
重新打开配置专家，核对选中的流程、环境、映射、PDA、计量和标签；需要时从目标再次导出对照。
- 2. 权限与体检
给目标真实人员配置使用范围，修正全部阻断项；导入不会自动授予权限。
- 3. 实际业务
来货核对存货部门；出货核对扣减部门；交接核对接收部门结存；作业核对工作量和 WorkID 标签，确认不写结存。
- 4. 可追溯
保留来源方案、预检清单、导入记录、目标修正说明及验收结果；备份与方案分开命名存放。