协作
共享与协作
按角色共享项目,与他人实时编辑,查看谁在线,离线工作,解决冲突,以及恢复早期版本或已删除的条目。
本页内容
共享项目,让您的团队可以同时处理同一个模型。您决定谁可以打开它,以及每个人可以做什么:所有者、编辑者、评审者或查看者。
每个 Holarch 项目都存放在 Holarch 服务器上。每项更改都保存在那里,并在大约一秒内到达其他人。Holarch 会自动保留每个项目的较早版本。已删除的项目会在回收站中保留 30 天。
概念
- 成员:在项目中拥有某个角色的账户。角色按项目适用:作为一个项目的所有者,并不能获得对另一个项目的访问权限。
- 角色:成员可以做什么。每个项目至少有一个所有者。
- 邀请:一封带有链接的电子邮件,可将某人以某个角色添加到项目中。链接有效期为 7 天。
- 实时编辑:每次编辑都会作为对一个条目的小更改(包含您更改的字段)发送到服务器。服务器将其转发给所有打开该项目的人。两个人更改同一条目的不同字段时,双方的更改都会保留。
- 在线状态:此刻打开该项目的人,以及每个人所在的页面或条目。
- 冲突:同时进行的两项相互冲突的编辑。要么两个人在看到对方的更改之前更改了同一个字段,要么有人编辑了别人已删除的条目。较新的更改生效;另一项保留以供审查。
- 隔离区:因损坏、过大或不安全而被拒绝的更改。它们会被列出,但不会被应用。
- 较早的版本:整个项目的已保存副本。Holarch 在所有者方案的天数内保留自动版本(Free 方案:7 天):在此期间,保留最近 20 次保存以及每天一次保存。恢复之前保存的版本永远不会被移除。请参阅方案和限制。
- 协作者:项目中除一位所有者之外的所有者或编辑者。在 Free 方案上,一个项目包含所有者外加 1 名受邀编辑者(当所有者拥有学术邮箱地址时最多 6 名),在 Individual 上为所有者外加最多 6 名受邀编辑者,在 Team 上编辑者数量不限,每人占用一个 Team 席位;另一位所有者算作编辑者,待处理的所有者和编辑者邀请也计入。评审者和查看者免费且不受限制。在 Individual 项目上,每位编辑者还需要有自己的方案(请参阅Individual 项目上的编辑者)。
- 回收站:已删除的项目在被永久删除之前保留 30 天的地方。
- 组织:诸如班级或团队之类的群体。一个项目可以属于一个组织。此后,组织的设置(例如是否可以使用 AI)将适用于该项目。属于某个组织并不能获得对其项目的访问权限。
角色
| 角色 | 可以执行的操作 |
|---|---|
| 所有者 | 编辑者能做的一切,外加邀请他人、更改角色、移除成员、转让所有权、选择项目的组织以及删除项目。 |
| 编辑者 | 编辑所有内容、恢复较早的版本以及导出。编辑者可以看到成员列表,但不管理共享。 |
| 评审者 | 像查看者一样阅读和导出,外加添加评论、编辑、解决和删除自己的评论,以及审批、拒绝或重新打开需求和文档评审。他们还可以审批或拒绝自己被指定审批的变更请求(变更委员会,或状态变更的审批人)。其他一切均为仅查看,AI 控件处于关闭状态。条目和文档在阅读视图中打开。 |
| 查看者 | 阅读和导出。编辑控件、评论和 AI 控件均处于关闭状态。条目和文档在阅读视图中打开。 |
共享对话框底部的角色图例以简短形式重复这些内容:“编辑、共享、转让和删除项目”、“编辑内容并恢复较早的版本”、“阅读、评论以及审批或拒绝需求;不能编辑”、“阅读和导出;不能更改任何内容”。
如何使用
何时使用及原因
一旦有多人处理系统模型,就共享项目。典型情况:
- 团队分工处理需求、架构和验证工作。
- 评审者在里程碑评审(SRR、PDR、CDR)之前阅读模型。
- 教师跟进一个学生团队。
角色回答的是“谁可以更改基线?”这一问题:
- 将编辑者授予构建模型的人。
- 将评审者授予评论模型和审批需求的人,例如评审委员会、客户或教师。
- 将查看者授予只阅读的利益相关者。
- 将所有者保留给管理访问权限的一两个人。
与团队共享项目
通过电子邮件邀请他人,并为每个人指定一个角色。您必须是所有者。
- 打开项目,然后点击顶栏右侧的共享。
您会看到共享对话框。
- 在邀请成员下,输入此人的电子邮件地址。
- 选择一个角色:所有者、编辑者(默认)、评审者或查看者。
- 点击邀请。
您会看到“已向 [email protected] 发送邀请。”该地址会连同其角色和到期日期出现在待处理的邀请下。
此人会收到一封标题为“您的姓名与您共享了“项目””的电子邮件。没有账户的人通过该链接创建账户。已有账户的人登录后加入。请参阅您的账户。
当他们接受后,会从待处理的邀请移到成员,角色为您选择的角色。
在 Free 方案上,一个项目包含所有者外加 1 名受邀编辑者:除您之外的一名编辑者或其他所有者,包括待处理的所有者或编辑者邀请。拥有学术邮箱地址时,Free 方案允许最多 6 名,Individual 方案也是如此;Team 允许任意数量的编辑者,每人占用一个 Team 席位。在邀请表单下方,您会看到例如“受邀编辑者:1/1(Free 方案)。其他所有者算作编辑者;评审者和查看者免费且不受限制。”当项目已满时,角色菜单只提供评审者和查看者,服务器会拒绝再添加所有者或编辑者,并显示“Free 方案每个项目包含所有者外加 1 名受邀编辑者。Individual 最多包含 6 名,每人需有自己符合条件的方案;Team 数量不限,每人占用一个 Team 席位。请将更多人邀请为免费的评审者或查看者,或在“账户设置 → 方案与账单”中选择付费方案。”将查看者更改为编辑者或所有者,以及在设为所有者并转让…中将您之后的访问权限设为编辑者,都以同样方式计数。已经拥有更多编辑者的项目会保留他们;只有新的所有者和编辑者需要等到项目低于限额。
添加组织的成员
要一次性为整个部门或团队提供访问权限,请添加您所在组织的当前成员。您必须是项目的所有者,并且是每个所选组织的成员。在自托管服务器上,这适用于所有组织;在托管服务上,仅适用于 Team 方案的组织。
- 在共享中的邀请他人下,点击添加组织成员…。
- 勾选一个或多个组织。每个组织都会显示其成员数。
- 选择在项目中的角色:编辑者、评审者(默认)或查看者。
预览会将每个人列出一次:已添加、角色已提升(其原有角色较低)、已是成员或账户已停用;已跳过。
- 点击添加 N 人。
他们会立即成为成员;不会发送邀请。提示消息会在几秒钟内提供撤销。
每个人都作为普通成员添加。之后加入该组织的人不会被添加;离开组织的人则保留其项目角色,直到所有者将其移除。与邀请一样,编辑者计入方案的编辑者数量,在自托管服务器上还计入许可证的编辑者席位。
Individual 项目上的编辑者
当项目所有者使用 Individual 方案时,每位编辑者都需要有自己的方案。以下方案符合条件:
- Individual 方案,包括 1 个月免费试用以及管理员授予该账户的方案;
- Team 方案的一个席位;
- 已验证的学术邮箱地址,例如以 .edu 或 .ac.uk 结尾;
- 活跃班级组织的成员资格。
评审者和查看者不需要方案。Free、Team 和班级项目不受影响。
邀请没有符合条件方案的人担任编辑者或所有者会被拒绝:“姓名需要付费方案才能编辑此项目。请将其邀请为评审者,或者他们可以开始试用或选择方案。”点击消息旁边的邀请为评审者,即可改为以评审者角色发送邀请。将评审者或查看者更改为编辑者也会以同样方式被拒绝。发送到尚无账户的地址的邀请会在此人接受时进行检查:没有方案时,他们以编辑者身份加入,但以评审者身份行事,并会看到“您以评审者身份加入:编辑此项目需要您自己的付费方案。请在“账户设置 → 方案与账单”中开始试用或选择方案。”
当编辑者的方案结束时(订阅或试用结束、Team 席位被移除、学术地址更改或班级结束),他们保留编辑者角色,但以评审者身份行事:他们可以阅读、评论和审批,而每次编辑都会被拒绝,通过 API 和 MCP 也是如此。共享对话框会在其姓名下显示“在其拥有付费方案前为评审者”。一旦他们再次拥有符合条件的方案,就可以重新编辑;项目中无需做任何更改。
共同所有者遵循相同的规则,但项目的第一位所有者(通常是创建它的人)除外。当某位共同所有者自己的方案结束,而该项目通过另一位所有者仍保持 Individual 方案时,他们保留所有者角色,但以评审者身份行事,没有共享等所有者设置,直到他们再次拥有符合条件的方案。
打开共享对话框的其他方式:
- 按 ⌘K / Ctrl+K 并选择共享项目…。
- 点击顶栏开头的项目名称,然后选择共享项目…。
- 在管理项目下,打开项目的行菜单(⋯)并选择共享…。
之后更改访问权限
所有者可以随时更改成员的角色、移除成员或取消邀请。
要更改角色:
- 打开共享。
- 在成员姓名旁边的菜单中选择另一个角色。
- 点击菜单旁边的应用(或在菜单中按 Enter)。Esc 会将菜单恢复原状。
您会看到诸如“Dana 现在是查看者。”的通知。
要移除成员:
- 打开共享。
- 点击成员旁边的 ⋯,然后选择从项目中移除…。
- 点击移除。
该成员会立即失去访问权限。如果他们正打开着该项目,项目会为他们关闭。
要取消尚未被接受的邀请:
- 打开共享。
- 在待处理的邀请下,点击邀请旁边的撤销。
- 点击撤销以确认。
该链接将失效。
要再次发送邀请,例如在其链接已过期时:
- 打开共享。
- 在待处理的邀请下,点击邀请旁边的重新发送。最近 30 天内过期的邀请也会列在那里,并标记为已过期。
您会看到“已重新发送邀请。”此人会再次收到电子邮件,其中包含一个新链接,有效期 7 天,角色不变。之前的链接将失效。每个邀请每 10 分钟可以重新发送一次。在不发送电子邮件的服务器上,Holarch 会改为显示一次新的邀请链接:点击复制链接,然后私下转交。
与整个组织共享
将项目与某个组织(例如一个部门)共享,而不必逐个邀请。该组织中的每个人在作为成员期间都拥有您选择的角色,之后加入的人也一样。离开组织的人会立即失去该访问权限;如果此人正打开着该项目,项目会在其下一次更改时关闭。
在自托管服务器上,您可以与您所属的任何组织共享;站点管理员可以将自己的项目与服务器上的任何组织共享。在托管服务上,项目只能与其自身的组织共享,且仅限 Team 方案:请先在组织下选择组织。
要与组织共享:
- 打开共享。
- 在组织下,选择组织和角色:查看者、评审者或编辑者。组织不能成为所有者。
- 点击共享。
在执行任何操作之前,Holarch 会显示将发生的变化:组织有多少成员;对于自托管服务器上的编辑者,还会显示多少人将获得编辑者访问权限、其中多少人已拥有编辑者席位以及还需要多少席位,例如“这将为 42 人提供编辑者访问权限:其中 30 人已拥有编辑者席位,因此还需要 12 个席位。”当许可证的空闲席位不足时,Holarch 会予以说明且不共享任何内容;请以评审者或查看者身份共享,或添加席位。
- 点击共享确认。
您会看到“已以角色身份与 组织 共享。”该项目会出现在每位成员的项目列表中。
一个人的角色取直接授予的角色与其所在组织的角色中最高的一个。通过组织为查看者、直接授予为编辑者的人就是编辑者。在成员列表中,此类人员显示为“通过 组织”;如果其下方还有直接授予的角色,则显示为“通过 组织;编辑者为直接授予”。
要查看某个组织涵盖哪些人,请点击其旁边的显示人员。要更改其角色,请在其菜单中选择另一个角色,然后点击应用;提升为编辑者时会先显示相同的摘要。要停止共享,请点击其旁边的 ⋯,然后选择停止共享:其成员仅保留直接授予他们的角色。
只有项目的所有者才能更改这些共享。该组织的组织管理员无法更改或移除它们;他们决定谁是组织的成员。
仅通过组织获得访问权限的人无法从项目中单独移除:请停止与该组织共享,或请其组织管理员将此人从组织中移除。要为某位成员提供高于组织角色的权限,请在成员列表中更改其角色;即使此人离开组织,该角色仍归其所有。
来自公司外部的访客(自托管)
在公司自己的 Holarch 服务器上,即使公司通过其目录或单点登录让自己的员工登录,所有者也可以邀请公司外部的人员,例如评审需求的客户。此类人员称为访客。
要邀请访客:
- 打开共享。
- 输入此人的邮箱地址。当地址不在公司邮箱域名内时,表单会显示“来自公司外部的访客”,以及访客可获得的最高角色和其访问权限是否在若干天后结束。高于该角色的角色不会提供。
- 选择评审者或查看者(当服务器允许编辑者访客时,也可选择编辑者),然后点击邀请。
在不发送电子邮件的服务器上,Holarch 会显示一次邀请链接,而不是发送它。点击复制链接并私下转交给此人:任何持有该链接的人都可以使用该邀请。链接 7 天内有效;重新发送会生成新链接。
访客打开链接,使用其姓名和密码创建账户。公司目录或单点登录的要求适用于公司自己的员工,不适用于访客。访客使用邮箱和密码登录,或在服务器提供时使用 Google 或 Microsoft 登录。
访客获得的权限:
- 仅限与其共享的项目。访客不属于任何组织,因此组织共享、部门项目和“添加组织成员”都不会包含他们。
- 没有自己的项目:访客不能创建、导入或拥有项目。
- 作为评审者或查看者时不占用编辑者席位。编辑者访客与其他人一样占用一个编辑者席位。
在共享中,访客及其待处理的邀请都标记为访客。当访客访问在若干天后结束时,成员列表会显示“访问于 日期 结束”。要给访客更多时间,请点击其旁边的 ⋯,然后选择续期访问。时间从当天重新开始计算。时间到期后,访客将无法再打开该项目,并会被从项目中移除。
站点管理员在管理 → 设置 → 访客中设置访客可以执行的操作(请参阅管理)。访客必须能够访问服务器:在封闭的公司网络中,这需要 VPN 访问、访客网络或通过公司网关以 TLS 发布的服务器。如果无法做到,请将需求文档和 DoDAF 视图导出为 Word 或 PDF,并通过电子邮件发送以供评审。
将项目交给其他人
当应由其他人代替您管理项目时,请转让所有权。
- 打开共享。
- 点击新所有者(编辑者或查看者)旁边的 ⋯,然后选择设为所有者并转让…。来自公司外部的访客不能成为所有者。
- 在之后您的访问权限下,选择编辑者、评审者、查看者或无访问权限。
- 点击转让。
您会看到“姓名现在是所有者。”您不再是所有者。
要在不放弃自己所有权的情况下添加第二位所有者,请改为将该成员的角色更改为所有者。
退出项目
- 打开共享。
- 点击您自己姓名旁边的 ⋯,然后选择退出项目…。
- 点击退出。
该项目会从您的列表中消失。所有者可以再次邀请您。
最后一位所有者不能退出。请先让其他人成为所有者,或转让所有权。
共同编辑
所有有访问权限的人都可以同时编辑项目。无需锁定或签出任何内容。
- 打开项目。
当其他人也打开了该项目时,您会在顶部保存状态旁边、实时指示器 ⇄ 之后看到他们的圆形徽章。
- 指向某个徽章。
您会看到此人的卡片:姓名、电子邮件、角色、正在编辑还是查看,以及所在的页面或条目,例如“编辑者 · 编辑 · 当前活跃”和“位于需求”。
- 照常编辑。
您的更改会在大约一秒内到达其他人,他们的更改也会到达您。
- 当出现诸如“Dana 更改了 3 个条目。显示更改”的通知时,点击显示更改。
您会看到此人更改的条目和字段。
在属性面板或条目视图中打开的条目会立即显示他们的更改。如果此时您正在其某个字段中输入,您的文本会保留,面板会显示“Dana 更改了此条目。”点击显示对方的版本可放弃您的文本并查看对方的文本,或离开该字段以保存您的文本。
随时可以点击保存状态旁边的 ⇄,使用他人的更改…、冲突 (n)…和关于协作。
解决冲突
当两项编辑冲突时,Holarch 会保留较新的一项生效,并暂存另一项供您审查。
- 点击顶部徽章旁边的红色徽章,例如1 个冲突。(或者点击 ⇄ 并选择冲突 (1)…。)
每个冲突显示一个条目:用文字说明的条目和字段(例如Connection 类 · 允许的关系)、当前使用的版本和已搁置的版本,各自附有制作者和时间,以及一个推荐的选择。对于允许的关系之类的列表,每一方还会显示只有该版本才有的内容。
- 可选:点击打开查看该条目(如果它仍然存在)。
- 使用以下按钮之一解决该条目。推荐的按钮标有“(推荐)”:
- 保留我的,或带有对方姓名的保留(例如“保留 Dana 的”),会保留该值。Holarch 自己做出的更改(例如整个项目的更新)显示为Holarch(自动更新),并带有保留自动更新。
- 保留两者(适用于允许的关系之类的列表,当双方各自添加了不同内容时)会保留两个版本中的每个条目。
- 编辑…(仅限文本值)可让您在文本框中合并两个版本。保存结果。
- 保持删除(适用于在您编辑时被删除的条目)使其保持删除状态。
- 使用此编辑恢复(同一情况)会恢复该条目并应用该编辑。
该条目随即消失。
恢复较早的版本
回到整个项目的某个自动保存版本。编辑者和所有者可以执行恢复。
- 打开控制与评审 → 基线和版本,然后点击页面标题中的恢复以前的版本…。(或者在管理项目下,在项目的行菜单中选择恢复以前的版本…。)
您会看到版本列表,包含已保存、实体、名称和大小。
- 选择一个版本。
您会看到恢复将带来的更改:先是一份摘要,然后是一个包含更改、实体、字段、当前和恢复后的表格。
- 点击恢复。
您会看到“已恢复于日期和时间保存的版本。撤销(⌘Z / Ctrl+Z)可返回。”恢复之前的状态也会作为一个版本保留。
所有打开该项目的人都会收到恢复后的状态。他们的页面会重新加载该状态并显示通知。
要找到仍包含某个已删除条目的版本:
- 在查找包含以下内容的版本下输入该条目的名称。
- 点击查找。
列表会缩小为包含具有该名称实体的版本,并添加一个包含列。
- 选择最新的匹配版本,然后点击恢复。
全部显示会恢复完整列表。
恢复已删除的条目
要在不恢复整个项目的情况下找回单个条目,请使用项目的回收站。
- 点击导航栏工具中的回收站(位于数据库和图旁边)。
您会看到项目中已删除的条目,最新的在前,并附有每个条目的删除时间、原因、剩余天数和关系数量。
- 点击条目旁边的恢复。
您会看到“已恢复“名称”。”该条目会连同其关系一起恢复。
有关预览、全部恢复和清空回收站,请参阅项目的回收站。
实例:在 SRR 之前评审 CubeSat EO-1 模型
本例使用 CubeSat EO-1 演示项目(管理项目 → 项目文件 ▾ → 新建演示项目)。
- 打开 CubeSat EO-1 并点击共享。
- 将您的系统工程负责人邀请为所有者。
- 将有效载荷工程师邀请为编辑者。
- 将评审委员会主席邀请为评审者。
- 等待有效载荷工程师接受邀请并打开需求。
您会在保存状态旁边看到其徽章。指向它会显示其所在的页面。
- 你们两人同时编辑系统需求规范中同一条需求的文本。
一项更改胜出。另一项连同两个值一起出现在冲突下。
- 打开冲突,选择编辑…,合并两种措辞,然后保存。
评审委员会主席打开项目,看到仅评审横幅:“您可以阅读、评论以及审批或拒绝需求。向所有者申请编辑权限。”他们阅读 RVTM,对两条需求发表评论并审批其余需求,但不能编辑模型或其他人的评论。
评审之后,有效载荷工程师误删了功能 F11。从项目的回收站中恢复它(请参阅恢复已删除的条目)。或者打开恢复以前的版本…,找到包含 F11 的版本,选择最新的一个并点击恢复。
提示和良好做法
- 团队项目至少保留两位所有者,以便在某人不在时仍能管理访问权限。
- 为评审人员指定评审者角色。他们可以评论、审批需求以及导出文档、RVTM 和图,但不能更改模型。
- 在进行大规模重组(例如重新编号、批量导入或恢复版本)之前,请告知团队。恢复或导入会为所有打开该项目的人替换项目。
- 在每次里程碑评审时,在基线和版本中创建基线。自动版本只在所有者方案的天数内保留(Free 方案:7 天);基线会一直保留。请参阅基线和版本。
- 使用实体上的评论进行评审讨论,而不是来回编辑某个字段。请参阅评论和评审。
常见错误
- “我邀请了某人,但对方看不到项目。”对方尚未接受。请查看待处理的邀请。如果链接已在 7 天后过期,请点击其旁边的重新发送。
- “该邀请是发给另一个地址的。”邀请必须由使用受邀电子邮件地址的账户接受。请邀请对方登录所用的地址。
- “所有者无法退出。”最后一位所有者必须先转让所有权或让其他人成为所有者。
- “我的撤销没有撤销队友的更改。”⌘Z / Ctrl+Z 只撤销您自己的更改。
关联方式
- 账户和登录:邀请会创建账户并添加成员。请参阅您的账户。
- 组织:所有者在共享对话框的组织下将项目关联到某个组织。此后适用该组织的 AI 设置。请参阅组织设置和AI。
- 存储:编辑者添加到您项目中的文件计入所有者的存储空间。请参阅存储和限制。
- 基线和评审包:恢复或冲突解决是一次普通编辑,会出现在项目历史记录和关联评审检查中。
共享对话框
对话框的标题是共享,后面跟着带引号的项目名称。完成会关闭它。
| 组成部分 | 谁能看到 | 内容 |
|---|---|---|
| 邀请成员 | 所有者 | 电子邮件字段、角色菜单(所有者、编辑者、评审者、查看者)、邀请。说明:“他们会收到一封电子邮件,其中的链接有效期为 7 天。没有账户的人可以通过该链接创建账户。” |
| 成员 (n) | 所有人 | 每位成员及其姓名首字母、姓名、电子邮件和角色。您排在第一位,并带有“(您)”。所有者可以看到每位成员的角色菜单和 ⋯;其他人看到的角色是一个标签。链接查看每位成员的贡献会打开贡献。 |
| 组织 | 所有人(当项目与组织共享时);可以与组织共享的所有者 | 每个组织及其成员数、显示人员(列出其涵盖的人员及其角色)和其角色(对所有者为菜单,对其他人为标签)。所有者:⋯ → 停止共享,以及用于添加组织的组织菜单、角色菜单和共享。 |
| 待处理的邀请 | 所有者 | 每个未处理的邀请:电子邮件、“由姓名邀请 · 日期到期”、角色、重新发送和撤销;其后是最近 30 天内过期的邀请,标记为已过期。为空时:“没有待处理的邀请。” |
| 组织 | 属于某个组织的所有者,或项目已有组织时 | 一个包含无和您的组织的菜单。其他人看到的是组织名称。 |
| 角色 | 所有人 | 角色图例。 |
编辑者、评审者和查看者会在顶部看到“您在此项目中是编辑者。只有所有者可以邀请他人和更改角色。”
成员菜单(⋯)
| 项 | 显示对象 | 结果 |
|---|---|---|
| 设为所有者并转让… | 所有者,针对编辑者、评审者或查看者 | 打开转让所有权。 |
| 从项目中移除… | 所有者,针对其他成员 | 确认移除成员:“姓名(电子邮件)将失去对此项目的访问权限。” |
| 退出项目… | 您,除非您是最后一位所有者 | 确认退出项目:“您将失去对此项目的访问权限。所有者可以再次邀请您。” |
更改自己的角色
当所有者降低自己的角色时,Holarch 会先询问:更改自己的角色——“您将成为编辑者,并且无法再管理共享。”点击更改我的角色以继续。如果您是最后一位所有者,则无法更改您的角色。
组织
将项目关联到某个组织,使该组织的设置适用于该项目。
- 在组织下选择一个组织以关联项目。您会看到“该项目现在属于组织。”
- 选择无以取消关联。您会看到“该项目不属于任何组织。”
菜单下方的说明为:“组织的设置适用于此项目,例如是否可以使用 AI。组织的成员资格不会授予对此项目的访问权限。”
当组织已关闭 AI 时,对话框会显示“此组织的 AI 已被其管理员关闭。”
仅查看模式
当您的角色为查看者时:
- 顶栏下方的横幅显示仅查看“您可以阅读和导出此项目。向所有者申请编辑权限。”横幅中的显示成员会打开共享对话框。
- 字段显示为纯文本。
- 更改模型的按钮(新建、删除、重命名、导入、应用、恢复等)处于关闭状态。指向其中一个会显示“仅查看:向所有者申请编辑权限”。
- ✦ AI 控件处于关闭状态:“仅查看:AI 工具需要编辑权限”。
- 导出、打开、搜索、筛选、缩放、演示和帮助控件仍可正常使用。
- 任何更改内容的尝试,包括将文件拖放到页面上,都会显示“仅查看:请向所有者申请编辑权限。”
阅读视图
评审者和查看者会先在阅读视图中打开条目和文档,该视图专为阅读和决策而非建模的人设计:
- 条目以其类、编号和名称作为标题,显示评审栏(需求的审批、拒绝…和重新打开)、描述、基本信息(有值的属性,以及负责人和截止日期)、追溯(每个关系显示为一个链接)、图(它出现在其中的图)和讨论。
- SysML v2 元素的阅读方式相同:其文档说明、需求状态和 Holarch 属性、关系、显示它的视图和图,以及讨论。文本编辑器、工具栏和选项板会被隐藏。
- 文档显示时不带编辑工具栏、+ 新建和快速添加。查找、评论和交付 ▾(导出)保留。处于评审中的文档会在标题下方显示其评审栏,带有审批和拒绝…。
评论和审批的方式与下文的仅评审模式相同。点击顶栏中的显示所有工具可查看完整布局(仍为仅查看或仅评审);阅读视图会返回。Holarch 会在此浏览器中保留该选择。
仅评审模式
当您的角色为评审者时,页面的行为与仅查看模式相同,但有以下不同:
- 横幅显示仅评审“您可以阅读、评论以及审批或拒绝需求。向所有者申请编辑权限。”
- 属性面板、条目视图、文档评论(在属性面板中)、可追溯性矩阵、演示和层级工具中的评论框仍可使用:添加评论,以及编辑(✎)、解决(✓)、重新打开(↺)和删除(×)您自己写的评论。
- 对于其他人的评论,编辑、解决和删除处于关闭状态。指向其中一个会显示“评审者只能更改自己的评论”。解决其他人的评论是编辑者的工作。
- 需求的审批框保留审批、拒绝…和重新打开。每一项都会记录您的账户名称和时间。
- 撤销处于关闭状态。请改为重新打开需求或删除评论。
- 其他编辑控件处于关闭状态。指向其中一个会显示“仅评审:向所有者申请编辑权限”。
当您是某个 Individual 项目的编辑者但没有自己的付费方案时,横幅显示仅评审“编辑此项目需要您自己的付费方案。您仍然可以评论和审批。请开始试用或选择方案。”并带有选择方案…。如果您的方案在项目打开期间结束,下一次编辑会被拒绝,并显示“编辑此项目需要您自己的付费方案。您仍然可以评论和审批。请在“账户设置 → 方案与账单”中开始试用或选择方案。”,页面随即切换为仅评审。请参阅Individual 项目上的编辑者。
当项目因方案结束后超出其所有者 Free 方案的限制而变为只读时,横幅显示只读及原因,例如“此项目为只读:它的条目数超过了其所有者的 Free 方案所包含的数量。您仍然可以评论和审批。所有者可以删除条目或选择方案。”请参阅超出 Free 限制的项目。
当所有者在项目打开期间更改您的角色时,页面会立即随之变化:“您的角色已更改为查看者:此项目现在仅供查看。”、“您的角色已更改为评审者:您可以评论和审批需求,但不能编辑。”或“您的角色已更改为编辑者。”
实时编辑和在线状态
实时区域位于已打开项目顶部的保存状态旁边。
| 元素 | 含义 |
|---|---|
| ⇄ | 实时连接。指向它:“实时:更改会发送到服务器,并立即同步给此项目中的所有人。”连接断开时它会变暗:“离线:更改保存在此设备上,连接恢复后发送。”点击它可打开下面的菜单。 |
| 圆形徽章 | 每位打开该项目的其他人一个:其姓名首字母显示在其专属颜色上。最多显示四个(窄窗口中显示两个);您自己的其他标签页和设备不会显示徽章。 |
| +n | 前四位之外的人。点击它可查看项目中所有人的列表。 |
| 红色徽章 | “n 个冲突”或“n 项已隔离”。点击它可打开冲突。 |
指向徽章、用 Tab 移到徽章上或轻点徽章,即可查看此人的卡片:
- 姓名和电子邮件地址(这些成员在共享下也能看到彼此的电子邮件)。
- 角色:所有者、编辑者、评审者或查看者。
- 编辑(他们在最近 2 分钟内更改过内容)或查看,然后是当前活跃,或者例如空闲 5 分钟(其页面上已有这么长时间没有使用鼠标或键盘)。
- 他们所在的页面、条目或图,例如“位于实体:Pump”。如果在多个标签页中打开了该项目,则每个标签页都会列出。
点击徽章可使其卡片保持打开;点击其他位置或按 Esc 可将其关闭。卡片只显示每个打开的页面当前报告的内容;不会记录任何相关信息。
点击 ⇄ 打开菜单:
- 他人的更改…:自您打开项目以来每个人更改的条目和字段,按人分组。为空时:“自打开此项目以来,没有他人的更改。”
- 冲突 (n)…:冲突对话框。
- 关于协作:帮助主题。
与他人协作时的撤销
⌘Z / Ctrl+Z 和 ⇧⌘Z / Ctrl+Shift+Z 只撤销和重做您自己的更改。如果有人在您之后更改了某个字段,该字段保留他们的值。
保存、离线和重新连接
顶栏中的保存状态显示您的更改的状态:
| 状态 | 含义 |
|---|---|
| 已保存和时间 | 所有内容都已在服务器上。指向它可查看上次保存的时间。 |
| 正在保存… | 更改正在发送中。在进行大型更改(例如导入数千个条目)之后,窗口底部的进度条会显示“正在将更改保存到服务器…”以及已发送的更改数,例如“40,000/275,138”。几秒钟后,它会加上以分钟为单位的剩余时间,例如“剩余约 3 分钟”,这是根据服务器接收更改的速度估算的;不到 5 秒时显示“剩余不到 5 秒”。如果连接断开,它会显示“正在等待连接…”,并在连接恢复后继续。您可以继续工作;当所有内容都已在服务器上时,它会关闭。标签页处于后台时也会发送更改。请保持此页面打开,直到保存完成;如果关闭它,其余部分会在您下次在此浏览器中打开该项目时发送。在此之前,离开或重新加载页面会要求确认。 |
| 离线 – 更改保留在此设备上 | 连接已断开。您可以继续工作:更改保存在此浏览器中,并在连接恢复后发送。点击状态可立即重新连接。 |
| 未保存 — 正在重试 / 未保存 | 服务器没有响应或拒绝了保存。点击状态可立即重试。此浏览器中会保留一份副本。 |
| 未保存 — 已在服务器上更改 | 在此处打开项目之后,有人以替换其状态的方式保存了该项目(例如从另一个窗口)。 |
当项目在您打开之后在服务器上被替换时,Holarch 会询问项目已在服务器上更改:
注意:“在此处打开“项目”之后,它已在服务器上被更改(由另一位成员,或在另一个窗口或标签页中)。现在保存将替换这些更改。您未保留的那个版本会保存在“恢复以前的版本”下。”
选择其一:
- 加载服务器上的版本
- 保留此版本
当所有者恢复或导入整个项目时,或者当页面离线时间过长(在其他人继续编辑期间超过约 15 分钟)时,已打开的页面也会重新加载项目。您会看到“已从服务器重新加载项目:项目在服务器上已被替换(恢复或导入),或此页面离线时间过长。”尚未发送的更改会在重新加载后发送。
项目打开期间失去访问权限
当您被移除,或所有者将项目移到回收站时,项目会关闭,您将返回管理项目:
- “您已无法访问此项目。”或“此项目已被所有者移到回收站。”
- 如果有更改尚未发送,通知中还会加上“n 项更改未保存。”以及下载副本,后者会将项目保存为
.json文件。
会话已结束
当您的会话结束时(请参阅您的账户),会出现登录屏幕,并显示“您的会话已结束。请重新登录以继续;未保存的更改保留在此浏览器中。”登录后,这些更改会被发送。
冲突和隔离区
冲突对话框将每个冲突列为一张卡片。要逐一处理,请参阅解决冲突。没有冲突时,它显示“没有冲突。与他人冲突的编辑会显示在此处供审查。”
列表上方的说明为:“两项更改在任何一方看到另一方的更改之前到达了同一位置。Holarch 保留较新的一项继续使用,并将另一项搁置在这里,因此不会丢失任何内容。请选择要保留哪一项。保留已搁置的版本或两者都保留,都是一次普通编辑,可以撤销。”
| 控件 | 结果 |
|---|---|
| 保留我的 / 带有对方姓名的保留 | 将该值作为一次普通的、可撤销的编辑保留。 |
| 保留两者 | 适用于类的允许关系之类的列表:保留两个版本中的每个条目,作为一次可撤销的编辑。 |
| 编辑… | 仅限文本值。打开带有两个值的编辑值;您保存的文本即成为该值。 |
| 保持删除 | 适用于在编辑时被删除的条目:它保持删除状态。 |
| 使用此编辑恢复 | 恢复已删除的条目并应用该编辑。如果它已不在项目的回收站中:“无法恢复该条目:它已不在项目的回收站中。” |
| 打开 | 打开该条目。 |
对时间戳和图布局的编辑会被静默合并(最后一次更改胜出),不会列出。对某个架构列表的两项更改中,如果一个版本已包含另一个版本的每个条目(例如在添加的允许关系之上执行添加新的内置项),则会合并而不产生冲突。
当有更改被拒绝时,冲突下方会出现隔离区 (n)。其说明为:“因损坏、过大或不安全而被拒绝的更改:此页面未应用的来自服务器的更改,以及服务器未接受的您的更改。”
- 表格显示时间、文件、原因和内容开头。
- 清除列表会将其清空。
- 当服务器拒绝您的更改时,通知会显示“服务器拒绝了 n 项更改(原因)。它们列在“冲突 → 隔离区”下。”
较早的版本
Holarch 会在您编辑时(大约每分钟一次)、恢复之前以及删除项目之前自动保存项目的一个版本。
- 保留:自动版本在所有者方案的天数内保留(Free 方案:7 天;请参阅方案和限制)。在此期间,保留最新的 20 个版本以及每天的最新版本。版本列表会说明该规则,例如“Free 方案:自动版本保留 7 天。”
- 永不移除:恢复之前保存的版本,以及基线。
- 谁可以:每位成员都可以列出版本;编辑者和所有者可以恢复版本。
- 恢复会为所有人替换项目,一次撤销即可全部撤回。恢复之前的状态会先保存为一个版本。
- 消息:“此项目没有早期版本。”、“请先选择版本。”、“没有已保存的版本包含具有该名称的实体。”、“m 个版本中有 n 个包含“term”。”、“恢复失败:原因”。
如需在里程碑处创建有名称的永久快照,请使用控制与评审 → 基线和版本中的基线。请参阅基线和版本。
删除和回收站
已删除的条目
您在项目中删除的条目会进入项目的回收站:导航栏工具中的回收站。每个条目在那里保留 30 天,然后自动移除。已删除的条目永远不会在其项目之外显示。
- 恢复会恢复一个条目及其关系。
- 全部恢复会恢复所有条目。
- 清空回收站会在确认后永久删除其中的每个条目。
有关显示的原因、预览以及已删除条目的子项会如何处理,请参阅项目的回收站。
已删除的条目也会保留在较早的版本中。
已删除的项目
只有所有者可以删除项目:管理项目 → ⋯ → 删除此项目…。确认提示为“为所有成员删除“项目”?它会在服务器的回收站中保留 30 天,然后被永久删除。”所有打开该项目的人都会立即失去它(见上文)。
所有者可以从管理项目中项目列表下方的回收站区域找回已删除的项目(在项目之外使用 ⌘K / Ctrl+K → 回收站,或 #/trash,会在那里以展开状态打开它)。否则该区域只有一行,即带有已删除项目数量的回收站 (N);点击它即可显示这些项目。每行显示项目、删除时间、剩余天数及其条目数。恢复会将其连同成员、版本和附件一起恢复到项目列表,提示消息为“已恢复“项目”。”管理项目的回收站区域只存放项目;已删除的条目保留在项目的回收站中。
- 恢复的项目计入您方案的活跃项目数。达到限额时,恢复会被拒绝并显示限额消息:请先将另一个项目移到回收站。
- 编辑者、评审者和查看者在那里看不到该项目。请所有者恢复它。
- 管理员(因滥用或违法内容)移到回收站的项目不会列出。如需申请找回,请使用“联系我们…”(相关电子邮件中会注明该项目)。
30 天后,项目、其版本和成员将被永久删除。
快捷键
| 按键 | Action |
|---|---|
| ⌘K / Ctrl+K,然后选择共享项目… | 打开共享对话框。 |
| ⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z | 撤销/重做您自己的更改。 |
消息
| 留言 | 含义和解决方法 |
|---|---|
| “请输入有效的电子邮件地址,例如 [email protected]。” | 邀请地址不是电子邮件地址。 |
| “此人已是该项目的成员。” | 请改为更改其角色。 |
| “项目至少需要一位所有者。请先让其他人成为所有者。” | 您试图降低最后一位所有者的角色。 |
| “项目至少需要一位所有者。请先转让所有权。” | 您试图以最后一位所有者的身份移除或退出。 |
| “只有此项目的所有者才能执行此操作。” | 请联系所有者。 |
| “您对此项目只有查看权限。” | 服务器拒绝了查看者的编辑。 |
| “您对此项目只有评审权限:您可以评论和审批需求。” | 服务器拒绝了评审者的编辑。 |
| “您只能更改自己的评论。” | 评审者试图编辑、解决或删除他人的评论。 |
| “未找到邀请。” | 该邀请已被接受、拒绝、撤销或已过期。 |
| “未找到成员。” | 该成员在此期间已退出或被移除。 |
| “尝试次数过多。请稍后再试。” | 您发送的邀请过多(每小时 30 个)。请稍候,然后重试。 |
| “此人通过 组织 获得访问权限,此项目已与该组织共享。…” | 此人仅通过组织加入项目。请停止与该组织共享,或请其组织管理员将其从组织中移除。 |
| “此人通过 组织 拥有角色访问权限,…” | 您试图将某人的角色降低到其组织所授予的角色以下。请改为更改组织的角色。 |
| “您通过 组织 获得访问权限,此项目已与该组织共享。…” | 您不能退出由您的组织授予访问权限的项目。请退出该组织,或请所有者停止与其共享。 |
| “以编辑者身份与 组织 共享还需要 n 个编辑者席位,…” | 自托管:许可证的空闲编辑者席位不足。请以评审者或查看者身份共享,或使用续期的许可证文件添加席位。 |
| “在托管服务上,项目只能与其自身的组织共享,且仅限 Team 方案。…” | 托管:请先在组织下选择项目所属的组织;该组织需要 Team 方案。 |
| “已移除 姓名。” / “已撤销邀请。” / “您已退出项目。” / “已以角色身份与 组织 共享。” / “已停止与 组织 共享。” | 确认消息。 |
限制
- 邀请链接有效期为 7 天。再次邀请同一地址会替换之前的邀请。
- 每人每小时可以发送 30 个项目邀请。
- 接受邀请永远不会降低已有的角色。被邀请为评审者或编辑者的查看者会获得该角色。被邀请为评审者或查看者的编辑者仍为编辑者。
- 较早的版本:最新 20 个外加每天一个,保留所有者方案的天数(Free 方案:7 天)。
- 回收站:30 天。
- 您无法打开的项目看起来与不存在的项目相同。
- 组织在项目中的角色为查看者、评审者或编辑者,绝不会是所有者。在自托管服务器上,编辑者共享会为每位尚未持有编辑者席位的成员占用一个编辑者席位。