作者： Next

如果你从自己的用户账号中移除了系统管理员角色，或者移除了所有角色，你就会失去对用户、角色以及所有需要系统管理员权限的页面的访问权。大多数情况下，你可以自己恢复访问权限，不需要提交工单。

为什么会发生这种情况

Frappe 会在每个页面上检查你的角色。像用户列表、角色和角色权限管理器这样的页面，只有拥有系统管理员角色的用户才能看到。如果你编辑自己的用户记录并取消勾选系统管理员，或者取消勾选所有角色，那么你接下来打开的页面就是你已经无法看到的页面了。Frappe 不会在你保存一个会把自己锁在外面的更改之前提醒你。

例如，Bluepeak Technologies 的 Ayesha Khan 打开了自己的用户记录，想清理掉一些不再需要的角色，结果把系统管理员也一起取消勾选了。

roles-tab-uncheck-system-manager.png

在 dev16.localhost 上实时截取：Ayesha Khan 的用户表单的角色与权限选项卡，角色列表底部的系统管理员复选框已被清除，表单显示“未保存”。已端到端验证：取消勾选此框并保存会重现锁定问题，该账号的用户列表从 16 行降到 0 行。

她保存后，设置工作区从她的侧边栏消失了。如果她直接打开用户列表，列表加载出来没有任何行。如果她打开一个需要系统管理员权限的页面，比如角色权限管理器，她会看到：

错误

Not permitted to view Role Permission Manager

Administrator 用户是唯一的例外：无论“拥有角色”表中显示什么角色，Frappe 始终授予它所有权限。下面的每个选项都直接或间接地利用这一点来恢复你的访问权限。

自己修复

使用下面第一个适用于你的选项。

另一个用户仍然拥有系统管理员角色

请该用户执行以下操作：

1. 前往用户列表并打开你的用户记录。
2. 打开角色与权限选项卡。
3. 勾选系统管理员。
4. 点击保存。

注销后重新登录以应用更改。

从 bench 控制台重新添加角色

终端

bench --site yoursite.com console

在 In [1]: 提示符下，运行：

Python

user = frappe.get_doc("User", "your-email@example.com")
user.add_roles("System Manager")

从站点注销并重新登录。

如果你不想动自己的用户记录，也可以改为从命令行创建一个临时的第二个系统管理员用户，然后用它通过界面修复你的主账号：

终端

bench --site yoursite.com add-system-manager temp-admin@example.com \
  --first-name Temp --password "a-strong-password"

通过 SSH 进入 bench 组

SSH 访问需要先创建一个私有的 bench 组并添加你的 SSH 密钥。参见 SSH 访问。一旦你能通过 SSH 登录，运行与选项 2 中相同的 bench --site yoursite.com console 命令和 user.add_roles("System Manager")，然后从你的站点注销并重新登录。

使用数据库访问

前往站点仪表盘 → 操作 → 访问站点数据库，如果你之前没用过，点击启用访问。使用显示的凭据通过 MariaDB 命令行客户端连接，然后运行：

SQL

INSERT INTO `tabHas Role`
  (name, creation, modified, modified_by, owner, docstatus,
   idx, parent, parentfield, parenttype, role)
VALUES
  (UUID(), NOW(), NOW(), 'Administrator', 'Administrator', 0,
   1, 'your-email@example.com', 'roles', 'User', 'System Manager');

通过这种方式所做的更改会跳过 Frappe 的正常保存步骤，因此对已经打开的会话不会生效。从你的站点注销并重新登录，角色才会生效。（已验证：直接在数据库中添加的角色只有在重新登录后才会出现——在那之前，正在运行的会话会一直保留旧的角色列表。）

重置 Administrator 密码

这在自托管环境中有效，或者在 Frappe Cloud 上，只要你像选项 2 或 3 那样拥有控制台或 SSH 访问权限也有效：

终端

bench --site yoursite.com set-admin-password "a-strong-new-password"

使用用户名 Administrator 和你刚设置的密码登录。Administrator 始终拥有完全访问权限，所以你现在可以打开自己的用户记录，并通过正常的角色与权限选项卡重新勾选系统管理员。

user-list-access-restored.png

在 dev16.localhost 上实时截取：Ayesha Khan 账号的系统管理员角色恢复后、她重新登录时的用户列表——列表再次显示全部 16 个用户（锁定期间为 0），右上角的+ 添加按钮也回来了。

如果这些都不适用于你

如果你的站点在共享的 Frappe Cloud bench 上，你没有数据库访问权限、没有其他系统管理员用户，也没有保存的 Administrator 密码，请在 support.frappe.io 上提交工单。支持人员会要求你从 Frappe Cloud 仪表盘（侧边菜单中的访问请求）批准一个站点访问请求，然后他们才能恢复你的角色。

如何预防

• 在每个站点上保留第二个拥有系统管理员角色的用户，作为常备的备用管理员。如果你把一个账号锁在外面，你可以在不到一分钟内从另一个账号修复它。
• 在从您自己的用户中移除角色之前，请检查它是否是最后一个系统管理员账户。
• 创建站点时，请将管理员密码保存在安全的地方。即使其他所有系统管理员账户都不在了，它也是您的备用方案。

相关

• 用户和权限
• 权限类型
• SSH 访问
• 数据库访问

你可以移除用户不需要的 DocType 链接，比如 Buying 中的 Material Request。你可以在设置里完成这个操作，不需要修改任何代码。

开始之前

• 你需要 Workspace Manager 角色才能为所有用户修改工作区或侧边栏。System Manager 角色不包含这个权限。请在 User → Roles 下添加它。
• 以下步骤适用于 Frappe v16。

链接显示在哪里

一个 DocType 链接可以在模块中的两个地方显示：

• 左侧边栏。 它是一个独立的记录，名为 Workspace Sidebar。每个模块都有一个，比如 Buying。
• 工作区上的卡片。 这是模块的主页面，比如 Reports & Masters 下的 Buying 卡片。

每个地方都有自己的链接列表。如果你从一个地方移除了链接，它还会保留在另一个地方。要彻底移除它，需要按照两组步骤都操作一遍。

移除链接只是把它隐藏起来，并不会删除 DocType、它的记录或用户权限。用户仍然可以通过搜索栏或 URL 打开列表。如果要阻止用户打开它，请参阅“仅对部分用户隐藏”。

从工作区卡片中移除链接

观看操作步骤：

1. 打开模块，比如 Buying。
2. 在右上角点击 ···，然后点击 Edit。工作区会进入编辑模式。
3. 指向包含该链接的卡片，比如 Buying。点击卡片上的铅笔图标。Edit Links 对话框会打开。
4. 在 Card Links 下，点击该链接所在行的铅笔图标，比如 Material Request。Editing Row 对话框会打开。
5. 点击 Delete。该行会从 Card Links 中移除。
6. 用保存按钮关闭 Edit Links 对话框。
7. 在右上角点击 Save。

卡片上不再显示该链接。

相关内容

• Workspace
• Users and permissions

负值或异常高的估值率几乎总是由某一笔错误的库存交易引起的，而不是估值方法本身的 bug。请在库存分类账中找到那笔交易，修正它，然后运行重新计算库存估值，这样之后的所有分录都会被重新计算。

你可能遇到了以下症状之一：

• 库存余额显示余额价值为负，而数量却是正数。
• 某个物料的估值率突然跳到正常成本的 10 倍或 1000 倍。
• 交货单或销售发票上的销货成本高得离谱，或者是负数。
• 物料清单或库存分录为某个原材料取到了一个意外的费率。

常见原因

估值率等于余额价值除以余额数量。所以当一笔价值以错误的费率入账，而剩余数量又很少时，费率就会被推得偏离很远。

找到费率出错的那笔分录

库存分类账报表按顺序列出该物料的每一次移动，因此你可以看到费率出问题的确切凭证。

1. 转到库存 > 报表 > 库存分类账。
2. 设置公司、物料和仓库。将起始日期设置得足够早，以覆盖费率看起来正常的最后时间。
3. 从上到下阅读以下列：

• 入库费率 —— 每笔收货的费率。查找 0，或远高于正常成本的费率。
• 余额数量 —— 查找任何降到零以下的行。
• 平均费率（余额库存） —— 每笔分录之后的估值率。找到第一次跳变或变为负数的行。
• 余额价值 —— 这应该接近余额数量 x 平均费率。数量为正而价值为负就标志着问题所在。

4. 打开第一个错误行上凭证号对应的凭证，以及它前面的那笔收货。其中之一就是你的源头分录。

一次检查一个仓库。每个仓库都有自己的估值率，所以一个仓库的问题可能看起来像是转移到另一个仓库时的突然跳变。

要一次性找到所有受影响的物料，请使用库存分类账不变量检查和错误库存价值报表报表。同时检查重新计算库存估值列表中状态为失败的记录。

修正源头分录，然后重新计算

先修正源头分录。仅重新计算只会再次运行同样的错误数字。

1. 修正源头分录

2. 运行库存重新估值

取消或修改倒填日期的分录通常会自动生成一次重新过账。如果没有生成，或者之前的重新过账失败了，就手动创建一次。

1. 转到库存重新估值 > 新建。
2. 设置基于：

• 物料和仓库 — 输入物料编码、仓库，以及源分录的过账日期和过账时间（或稍早一点的时间）。
• 交易 — 输入源分录的凭证类型和凭证编号。

3. 保存并提交。重新过账会在后台运行。其状态会从排队中变为进行中，再到已完成。
4. 如果状态为失败，请查看错误日志字段。它通常会指出一行你仍需修复的负库存记录。修复后点击重新开始。
5. 再次运行库存台账，确认平均费率（结存库存）现在已恢复正常。

重新过账还会更新总账，因此库存和账目价值会再次匹配。可以在库存重新过账设置中将重新过账限制在特定时间段；如果没有任何反应，请检查那里的时间段设置。

为什么物料清单或销售发票的费率可能与库存台账不同

物料清单和销售发票中的费率是在不同的时间、或从不同的地方获取的，与库存台账不同。出现差异并不总是错误。

如果物料清单显示原材料成本有误，请先修正原材料的估值（见上文）。然后打开物料清单并点击更新成本。

预防措施

一旦关闭负库存并且每笔入库都带有真实费率，大多数这类问题就会消失。

• 保持负库存禁用。在库存设置中，不要勾选允许负库存。这样用户就无法在收货之前发出库存。
• 为每笔入库设置估值费率。除非物料确实是免费的（例如免费样品），否则不要勾选允许零估值费率。在物料主数据中为期初库存和免费物料设置估值费率。
• 在新计量单位首次采购之前，检查物料主数据上的计量单位换算系数。
• 限制倒填日期的分录。使用库存设置中的允许创建/编辑倒填日期交易的角色，这样只有少数用户才能过账这类分录。
• 关注重新过账队列。每周检查库存重新估值列表中的失败记录。在更多分录堆积之前逐一修复。

还需要帮助？

如果重新过账完成后费率仍然错误，请在 support.frappe.io 上提交工单。请附上：

• 物料编码和仓库
• 覆盖费率出错期间的库存台账导出文件
• 库存重新估值记录的名称，以及失败时的错误日志

大多数打印都会经过浏览器的打印对话框。还有两种方式可以跳过它：

• 网络打印通过打印服务器（CUPS）将 PDF 直接发送到网络上的打印机。
• 原始打印通过用户电脑上的 QZ Tray 向热敏打印机和标签打印机发送 ESC/POS 命令。

适用于 Frappe v16 及更高版本。

网络打印

开始之前

• 一个 Frappe 服务器可以访问的 CUPS 打印服务器。
• Frappe 服务器上的 pycups Python 包和 CUPS 系统库。使用系统的包管理器安装该库，然后在 bench 目录下运行 bench pip install pycups。

设置步骤

1. 在打印设置中，开启启用打印服务器。
2. 打开网络打印机设置列表，添加一台打印机，填写服务器的服务器 IP、端口和打印机名称。
3. 在打印页面上，打开⋯ > 选择网络打印机并选择它。

现在点击打印会按照你选择的格式和样式将文档发送到该打印机。

原始打印

开始之前

• 在每台需要打印的电脑上安装 QZ Tray。
• 一个勾选了自定义格式和原始打印的打印格式，并在原始命令中填写打印机命令。你可以在命令中使用 Jinja。

设置步骤

1. 在打印设置中，开启启用原始打印。
2. 在打印页面上，选择原始格式。
3. 打开⋯ > 原始打印设置，将该格式映射到 QZ Tray 找到的打印机。
4. 点击打印。

原始格式的打印页面不会显示预览。

相关主题

• 打印设置
• 打印文档

ERPNext 提供标准的会计科目表，这些科目表根据国家或地区预先配置好，让用户可以快速上手使用。

‎

以下是可用的各地区会计科目表：