码头

Dock 是桌面最左侧边缘那一列窄窄的图标。每个图标会打开你当前所在应用的一个模块，比如 ERPNext 中的 Selling 或 Stock。应用的标志位于顶部，你的个人头像位于底部。

每个应用都有自己的 Dock。当你打开 Frappe HR 时，Dock 会切换为 Frappe HR 的模块，而且调整一个应用的 Dock 不会改变另一个应用的 Dock。

本页介绍如何使用 Dock、选择它的显示方式、为自己或整个站点调整它，以及应用如何自带它的 Dock。关于 Dock 如何与桌面的其他部分配合，请参阅 Desk 导航。

开始之前

  • 任何人都可以调整自己的 Dock。 其他人看不到这些更改。
  • 为所有人调整需要 Workspace Manager 角色。 System Manager 不会自动获得这个角色。请参阅用户和权限。
  • Dock 只显示你能打开的内容。 如果你没有权限打开某个模块中的任何内容，那么无论怎么调整，该模块都不会显示。

使用 Dock

  1. 将鼠标指向某个图标，即可看到该模块的名称。
  2. 选择它。该模块会打开其侧边栏中的第一个条目，同时 Sidebar 会切换到该模块。

  • 顶部的应用标志 会返回桌面。
  • 底部的个人头像 会打开用户菜单：Settings、Manage Dock、Reload 和 Logout，如果你开启了 My Space，还会显示它。

Dock 不会显示在 My Space 中，因为你的私人工作区不属于任何单个应用。

选择固定或浮动 Dock

默认情况下，Dock 是 Pinned（固定）的：它始终位于 Sidebar 旁边。将它设为 Floating（浮动）可以获得更多空间：Dock 会隐藏起来，当你将鼠标一直移到窗口最左侧边缘时，它会滑入显示。

  1. 选择你的个人头像，然后选择 Settings。
  2. 选择 Appearance，然后滚动到 Dock。
  3. 选择 Pinned 或 Floating。它会立即生效。

浮动 Dock（已高亮）会在你的鼠标到达左边缘时滑入并覆盖在 Sidebar 上。

使用浮动 Dock 时，你的个人头像会移动到 Sidebar 的底部，以便用户菜单仍然触手可及。这是个人设置；其他人的 Dock 不会改变。

调整 Dock

打开 Manage Dock

  1. 打开你想调整其 Dock 的应用中的任意模块。
  2. 选择你的个人头像，然后选择 Manage Dock。

Manage ERPNext Dock 窗口会打开，其中 Entries 下是各个模块，还有结果的 Preview。Workspace Manager 会在右上角看到一个开关：For everyone（对他们来说是默认值）或 Just for me。没有该角色时就没有这个开关，所有更改都只对你生效。

重新排序或隐藏模块

  • 重新排序。 通过拖动手柄来拖动某一行。列表顶部就是 Dock 的顶部。
  • 将模块从 Dock 中移除。 选择眼睛图标。该行会变灰，并从预览中消失。再次选择眼睛图标可将其放回。

将模块从 Dock 中移除并不会取消任何人的访问权限：它的记录仍然可以从链接、搜索和其他模块中打开。标记为 app ships this off 的行是应用默认隐藏的模块；眼睛图标仍然会显示它。

添加模块、工作区或网站

  1. 选择列表上方的 Add。
  2. 在 What it opens 下，选择 Module（打开该模块及其侧边栏）、Workspace（打开一个工作区，位于其模块的侧边栏中）或 Web address（打开桌面外部的网站）。
  3. 选择模块或工作区，或者粘贴地址。
  4. 选择一个 Icon，并输入一个 Title，也就是有人指向该图标时显示的名称。
  5. 选择 Add，然后将新行拖到你想要的位置。

保存或撤销

选择 Save。系统会显示一条消息，确认你是为自己保存（Dock updated）还是为所有人保存（Dock updated for everyone）。

  • Reset 会清除你正在编辑的调整，并移除你添加到其中的快捷方式。Dock 会回退到所有人看到的内容（在 Just for me 下）或应用自带的内容（在 For everyone 下）。选择 Save 以应用它。
  • Reset for everyone 适用于 Workspace Manager。它会移除该站点的调整 以及每个用户自己对该应用 Dock 的调整，因此所有人都会回到应用自带的状态。它会要求你确认，立即生效，且无法撤销。

当应用添加新模块时

保存布局后，你的停靠栏会完全保持你离开时的样子。应用更新或新安装的应用添加的模块不会自动出现。它会在你的条目之后列在管理停靠栏中，眼睛图标被划掉；选择眼睛图标并保存即可添加。

这样可以防止你排列好的停靠栏在你不知情的情况下发生变化。侧边栏则相反：来自应用的新条目总是会出现在那里。

面向开发者：发布应用的停靠栏

应用的停靠栏是应用附带的一个文档。只有它列出的模块和快捷方式才能出现在停靠栏上，所以请列出你希望用户能访问的每一个模块。

  1. 在开发站点上开启开发者模式（在其 site_config.json 中设置 developer_mode: 1）。
  2. 打开你应用的一个模块，然后点击管理停靠栏。
  3. 在开关中，选择随应用发布。此选项仅在开发者模式下出现。
  4. 排列停靠栏。在此处隐藏某一行会将其默认关闭发布（眼睛图标的提示为默认关闭发布）；站点和用户仍然可以显示它。
  5. 选择保存。消息已导出到应用表示确认。

你应用的停靠栏会写入 <app>/dock/<app>/<app>.json</app></app></app>。提交它，bench migrate 会在每个站点上导入它。在应用层级上，编辑器还会告诉你有多少你应用的模块完全没有被列出，以免有任何模块被意外遗漏。

如果你的应用还没有附带停靠栏，请在面向所有人上排列它，然后选择窗口底部的导出到应用。该排列会被复制到你应用中的一个新停靠栏中，而站点自身的排列保持不变。

关于从桌面打开你应用的图标，请参阅面向开发者：将你的应用放到桌面上。

配套应用

有些应用是作为另一个应用的补充而非独立存在的；例如一个地区合规应用可能会向 ERPNext 添加几个模块。这类应用可以通过在其自带的停靠栏中将挂载到设置为主应用，从而将其条目放到主应用的停靠栏上。这样它就没有自己的停靠栏或桌面图标，其工作区会在主应用的停靠栏内打开。

挂载仅在以下条件满足时生效：主应用已安装、主应用附带停靠栏、且配套应用附带自己的条目。否则配套应用的行为与任何其他应用相同。只有应用自带的停靠栏才能设置挂载到；站点和用户无法将应用移动到另一个应用的停靠栏上。

故障排除

我的停靠栏中缺少某个模块。 你可能没有权限打开其中的任何内容，它可能被你的用户记录中的屏蔽模块所屏蔽，或者它可能被隐藏了。打开管理停靠栏，找到它并查看被划掉的眼睛图标。

新应用的模块不在停靠栏上。 打开管理停靠栏，在列表末尾找到它们，眼睛图标被划掉，选择眼睛图标并保存。或者使用重置恢复到应用附带的状态。

我的排列被替换了。 某位工作区管理员使用了为所有人重置。

停靠栏消失了。 它可能被设置为浮动：将指针移到左边缘，或者在设置 > 外观下切换为固定。停靠栏在“我的空间”中也不会显示。

用户菜单中缺少管理停靠栏。 你当前所在的页面不属于任何应用，例如“我的空间”。请先打开某个应用的模块。

某个模块始终不出现，即使在管理停靠栏中也没有。 应用附带的停靠栏没有列出它。需要开发者将其添加到应用的停靠栏中。

常见问题

我可以在停靠栏上重命名模块吗？
不可以。停靠栏显示每个模块自己的名称。你添加的快捷方式可以使用你自己的标题。

我可以把另一个应用的模块放到这个停靠栏上吗？
不可以。你可以改为添加一个工作区或网址快捷方式。

从停靠栏移除模块会将其从搜索中删除吗？
不会。其文档和报表仍然可以通过搜索找到，也仍然可以从链接打开。

  • 桌面导航
  • 侧边栏
  • 桌面
  • 迁移到新导航
  • 工作区