侧边栏

侧边栏是停靠区旁边较宽的那一列。它列出了你当前所在模块中的所有内容：工作区、你在这里使用的文档列表、报表和仪表盘。每个模块都有一个侧边栏，当你切换到另一个模块时，侧边栏也会随之变化。

本页介绍如何使用侧边栏、如何为你自己或整个站点自定义它、工作区如何显示在其中，以及应用如何提供它的侧边栏。关于侧边栏与桌面其余部分的关系，请参阅桌面导航。

开始之前

  • 任何人都可以自定义自己的侧边栏。 其他人看不到这些更改。
  • 为所有人更改侧边栏需要工作区管理员角色。 系统管理员不会自动获得此角色。请参阅用户和权限。
  • 侧边栏从不授予访问权限。 你无权打开的条目会被略去，隐藏某个条目也不会剥夺任何人的权限。

使用侧边栏

选择一个条目，即可在屏幕的主要区域打开它。

  • 分区。 带有箭头的条目（例如报表）是一个分区。选择它可以显示或隐藏其中的条目。
  • 搜索和通知。 顶部的这些条目会打开搜索栏和你的通知。要隐藏搜索，请在设置 > 偏好设置下关闭显示搜索栏。
  • 标题菜单。 选择侧边栏顶部的模块名称，会打开一个菜单，其中包含所有应用（返回桌面）、编辑侧边栏和帮助。

模块总是打开其侧边栏中的第一个条目。没有单独的“主页”设置：如果你想让销售模块打开销售订单而不是它的工作区，请把销售订单移到顶部。

自定义侧边栏

你的更改如何与其他人的更改叠加

侧边栏由三个层构建，每一层都叠加在前一层之上：

  1. 应用自带的内容。 ERPNext、Frappe HR 和其他应用都为其每个模块自带一个侧边栏。如果某个模块没有任何应用自带侧边栏，系统会根据其包含的内容生成一个。
  2. 为所有人。 工作区管理员所做的更改，站点上的每个用户都能看到。
  3. 仅为我。 你自己的更改，只有你能看到。

每一层只更改它提到的内容。如果你的工作区管理员为所有人隐藏了POS，而你把销售发票移到了自己的顶部，你会同时看到这两项更改。当应用更新添加新条目时，它仍会出现在你的侧边栏上，即使你之前重新排列过。

打开侧边栏编辑器

  1. 转到你想更改的模块，例如库存。
  2. 选择侧边栏顶部的模块名称，然后选择编辑侧边栏。

会打开管理库存侧边栏窗口。你的条目在左侧的条目下。预览在右侧显示侧边栏的外观。在你选择保存之前，什么都不会改变。

如果你是工作区管理员，右上角有一个开关，显示你正在为谁进行排列：为所有人（工作区管理员的默认选项）或仅为我。没有该角色就没有开关，所有更改都只为你自己。

重新排列和隐藏条目

每一行左侧有一个手柄，右侧有一个铅笔图标和一个眼睛图标。

  • 重新排序。 通过手柄拖动某一行。你拖到顶部的任何内容都会成为该模块的落地页。
  • 移入分区。 将某一行拖到分区标题（例如报表）下方。它会缩进显示，表明它属于该分区。将它拖回左侧即可将其移出。
  • 隐藏。 选择眼睛图标。该行会变灰并从预览中消失，但会在列表中保留其位置，以便你可以用眼睛图标将其恢复。

重命名条目或更改其图标

  1. 选择该行上的铅笔图标。
  2. 在重命名条目中，输入新的标签，并可选地选择一个图标。将图标留空可保留当前图标。
  3. 选择完成。

重命名只会改变条目的显示方式。它仍然打开相同的列表、报表或页面，如果应用之后更改了该链接的指向，你重命名后的条目也会随之更新。

添加条目或分区

  1. 选择列表上方的添加。
  2. 在类型下，选择链接以添加要打开的内容，或选择分区以添加标题。
  3. 对于链接，在链接到下选择它打开的内容：文档类型（文档列表）、页面、报表、工作区、仪表盘或URL。
  4. 选择该项目。标签会自动填充；如果你愿意，可以更改它。
  5. 可选地选择一个图标，然后选择添加。

新条目会添加到列表底部。要构建一个分组，请先添加分区，再添加其条目：每个条目都会落在你刚添加的分区下。选择分区上的铅笔图标以打开编辑分区，你可以在其中重命名分区，并开启可折叠、默认折叠或显示箭头。添加已在侧边栏但被隐藏的内容，只会让它重新显示。

保存或撤销

选择保存。系统会显示一条消息，确认你是为自己保存（侧边栏已更新）还是为所有人保存（侧边栏已为所有人更新）。

  • 列表上方的重置会在你确认后移除你正在编辑的布局。在仅为我下，你会回到所有人看到的状态。在为所有人下，站点会回到应用自带的状态，但用户会保留自己的更改。
  • 底部的重置为标准适用于工作区管理员。它会移除此模块侧边栏的站点更改以及每个用户自己的更改，因此所有人都会回到应用自带的状态。它会要求你确认，且无法撤销。

侧边栏中的工作区

工作区是一个包含快捷方式、卡片、图表、数字卡片和快速列表的页面。每个工作区都属于一个模块，并作为该模块侧边栏中的一个条目出现，通常位于顶部，名为主页。

  • 新工作区会出现在你创建它时所选模块的侧边栏中。
  • 你的私有工作区只会出现在你自己的侧边栏中，而我的空间会将它们汇集到你自己的一个侧边栏中。
  • 要将工作区移动到另一个模块的侧边栏，请在管理工作区中更改其模块。
  • 要重新排序或隐藏工作区条目，请像处理其他条目一样使用编辑侧边栏。

创建工作区、编辑和共享工作区，以及我的空间，均在工作区页面中介绍。

面向开发者：发布应用的侧边栏

你在开发站点上使用同一个编辑器安排侧边栏，然后将其保存到应用中。

  1. 在开发站点上开启开发者模式（在其 site_config.json 中设置 developer_mode: 1）。
  2. 打开模块，然后选择编辑侧边栏。
  3. 在切换项中，选择为你的应用。此选项仅在开发者模式下出现。
  4. 安排侧边栏，然后选择保存。消息侧边栏已保存到其应用会确认此操作。

每个侧边栏都会写入 <app>/<module>/sidebar/<name>/<name>.json</name></name></module></app>。将其与你的应用一起提交，bench migrate 会在每个安装或更新该应用的站点上导入它。

  • 你没有为其发布侧边栏的模块仍会获得一个侧边栏，该侧边栏由其工作区、文档类型、报表、页面和仪表板生成。编辑器会从该生成的侧边栏开始。
  • 你在应用层隐藏的条目会以隐藏状态发布。站点和用户仍然可以显示它。
  • 在为你的应用上选择重置会停止发布该侧边栏：它会删除记录和文件，模块会回到生成的侧边栏。
  • 侧边栏以其标题命名，标题会成为页面地址的一部分（/desk/selling/customer）。标题不能包含 /、?、#、% 或 \，也不能是另一个模块的侧边栏名称。

站点和用户将他们的更改保存在不同的层中，因此你的更新永远不会覆盖它们，你之后添加的条目仍会到达重新排列过侧边栏的用户。

仅存放代码的模块

如果某个模块的存在是为了存放代码，而人们在另一个拆分中导航，请在 hooks.py 中的 code_only_modules 下列出它，并列出接管其导航的模块：

code_only_modules = {
    "My Core": ["Orders", "Settings"],
}

仅代码模块会保持在 Dock 之外，但会保留其所有文档类型、报表和页面。当 desk 决定其某个实体在哪个侧边栏中打开时，它会改为在列出的模块中查找。顺序很重要：列出的第一个模块在平局时胜出，而它们都未列出的实体会在用户能看到的第一个模块中打开。

旧侧边栏文件

应用过去在 <app>/workspace_sidebar/</app> 中发布侧边栏。这些文件不再被读取，bench migrate 会列出仍包含它们的应用。使用 convert-sidebar-fixtures 转换它们；请参阅面向应用开发者。

故障排除

我期望的条目缺失了。 你可能没有打开它的权限。如果你有权限，它可能被隐藏了：打开编辑侧边栏，并查找眼睛图标被划掉的条目。

模块打开到了错误的页面。 模块会打开其第一个条目。将你想要的条目拖到顶部并保存。

我的更改消失了。 工作区管理员可能使用了重置为标准，这会移除每个人自己的更改。

重命名后的条目恢复为旧名称。 如果该条目被更改为指向其他地方，它会被视为新条目。请再次重命名。

缺少“为所有人”或“为你的应用”选项。 为所有人需要工作区管理员角色；为你的应用需要开发者模式。

某个模块的侧边栏看起来是生成的，而不是精心整理的。 其应用没有为它发布侧边栏，或者仍发布旧格式。

常见问题

在我自定义侧边栏后，会错过应用之后添加的条目吗？
不会。它们仍会出现在你安排的条目之后。

我可以隐藏整个模块吗？

不是从侧边栏。在管理 Dock 中将其从 Dock 移除，或请管理员在您的用户记录上屏蔽该模块（屏蔽模块）。

一个工作区可以出现在两个侧边栏中吗？
一个工作区只属于一个模块。要从另一个模块访问它，请使用编辑侧边栏添加指向它的链接，或将其放到 Dock 上。

  • 桌面导航
  • Dock
  • 桌面
  • 迁移到新导航
  • 工作区