Data Model and Editing.zh_CN

🌐 English · Deutsch · Español · Français

数据模型与编辑

Gramps Connect 使用与 Gramps 本身相同的对象模型。共有十种记录类型，每种都有自己的列表视图、自己的可搜索搜索框（默认为纯文本，或通过一个复选框切换为 GOQL），以及自己在 gramps-web-api 上的 REST 端点：

类型	列表视图	查询端点
成员（Person）	成员	/api/people/query/
家庭（Family）	家庭	/api/families/query/
事件（Event）	活动	/api/events/query/
地点（Place）	地点	/api/places/query/
文库（Repository）	文库	/api/repositories/query/
来源（Source）	来源	/api/sources/query/
引用（Citation）	引用	/api/citations/query/
媒体（Media）	媒体	/api/media/query/
摘录（Note）	摘录	/api/notes/query/
标签（Tag）	标签	/api/tags/query/

由于一棵家谱可以在 Gramps 桌面版、gramps-web 和 Gramps Connect 之间自由迁移（见概览），这些正是 Gramps XML 和 GEDCOM 本来就承载的记录类型和字段——Gramps Connect 没有增加或删除任何一个。

浏览

从列表中选择一条记录，与它相关的一切——事件、家庭、照片、摘录、来源——都会出现在旁边。点击其中任何一项，它自己的详情会在下方打开，而列表和您最初的选择都留在原处，无论您深入多少层（见概览）。

编辑

点击任意记录的编辑按钮，会打开它的完整编辑表单，用于修改该记录自身的详情（姓名、日期、描述）或它与其他记录的关联——例如，一个孩子与其父母之间究竟是什么关系。

对于较小的日常修改，“+”和“−”按钮是一种快捷方式：无需打开完整表单，即可附加一个已有的引用、照片或成员，或移除一个已关联的项。它们只改变记录与什么相关联，而不改变记录自身的详情。每个部分的“+”就在其标题旁边（将鼠标悬停在上面可以看到它会添加什么，例如“添加孩子”），因此大部分部分为空的记录仍能保持紧凑。标签也显示在其标题所在的行上，紧挨着它们自己的“+”。

目前完全可编辑的内容

成员和家庭记录最为完整，只有一个值得注意的例外：LDS（后期圣徒）教仪完全是只读的——不能编辑、添加或解除关联。

部分可编辑的内容（按类型）

• 地点——现在可以通过 Wikidata 查询来填写地点的上级/所属层级（按名称搜索，确认匹配项后，就会创建或关联城市/县/州/国家这一链条，每一级都有自己的坐标）；但仍然无法脱离 Wikidata 手动添加、移除或重新排列上级地点。每一级的“类别”字段也会根据 Wikidata 推测，依据的是一张覆盖大多数国家约 2700 种行政区划和聚落类别的表（而不只是美国式的城市/县/州/国家）；无法识别的类别仍会在确认界面上把“类别”留空，让您手动填写。查询创建的每一级都会得到一个包含其已确认上级的描述性标题（例如“Marion County, Indiana, United States”），而不只是它自己的名称——其底层的名称字段仍然只是名称本身，这样以后的查询仍能把它识别为同一个地点。一个全新地点的编辑器会预先询问是手动添加还是从 Wikidata 添加，而不是把查询作为又一个字段与手动字段并列显示；重新编辑一个已保存的地点时，查询则保留为一个普通的补充信息按钮。同一个查询还可以选择从 Wikidata 获取轮廓（确认界面上的一个复选框，默认勾选）——对每个新创建的层级以及正在添加的地点本身都是如此——这样地图上显示的是它的实际边界，而不只是其坐标处的一个图钉；轮廓的附加方式与手绘的地图形状相同，因此之后可以像其他附件一样在“媒体”视图中编辑或移除，并按地点类型和 Wikidata ID 着色，使不同地点不会都使用相同的默认填充色。层级中已有/复用的级别不会被补上轮廓。地点自己的（主）名称现在可以带有日期和语言，使用与事件和引用相同的日期编辑器——地图叠加层功能的按日期可见性读取的就是它（见概览）。仍然缺少：备用名称（添加/编辑/移除——地点的 alt_names 列表以只读方式显示，但没有编辑器；每个条目都是带有自己日期/语言的名称，例如用于记录旧名称及其使用的年代）、历史位置，以及代码。
• 摘录——缺少：文本格式/链接（摘录只能是纯文本），以及格式标志（流式/已格式化）。
• 媒体——描述、日期和隐私可以通过“编辑”按钮修改；文件本身、其类型和校验和仍由服务器根据上传内容生成。属性、引用、摘录和标签已经可以通过与其他所有记录类型相同的相关记录部分进行编辑。照片点击后就会以全尺寸打开；文件为 PDF、视频、音频片段、SVG 或类文本格式（HTML、JSON、纯文本、CSV、GEDCOM、KML/XML 等）的媒体（或输出）条目，旁边则会出现一个“查看”按钮，在浏览器中打开同一文件，而不必下载。HTML 预览在沙箱中渲染（不运行脚本），这样生成报告的排版可以显示出来，而其中的任何内容都不会被执行（不过它以相对路径链接的任何资源都无法加载，因为只有这一个文件可用，而不是一个包含其同级文件的文件夹）。

合并重复记录

除标签外的所有记录类型都可以合并：选中两条同类型的记录（在列表中按 ctrl/cmd+点击），然后选择“合并”。选择保留哪一条——保留它自己的定义性字段（姓名、标题、日期等，视类型而定），丢弃另一条的；而摘录、引用、媒体和属性这类列表形式的内容会从两者合并。对未保留记录的其他所有引用，都会在删除它之前改为指向保留的那条。家庭是唯一一种被合并的两条记录可能在某位父/母上不一致的类型；出现这种情况时，会按角色（父亲/母亲）询问您保留哪一方。标签在 Gramps 本身中没有合并途径，因此合并两个标签改为在客户端处理——所有带有被丢弃标签的内容都会改为打上保留的标签，然后删除被丢弃的标签。

查看编辑历史

每条记录在其“地图/年谱/图表”链接旁都有一个“历史”按钮。它会打开该记录自身变更的日志——每次修改是谁做的、何时做的，以及是添加、更新还是删除——按时间从新到旧，一次显示一页。点击任意条目即可看到究竟改了什么：逐字段的修改前后对比，而不只是“有东西改了”这一事实。这是对实时同步（见架构）的事后补充，后者只在编辑到达时显示它们；两者读取的是同一个 gramps-web-api 事务日志。

目前还没有撤销功能——还原一项修改意味着手动把记录改回去。进展见路线图与已知限制。

跨类型的缺口

• GrampsType 字段大多是自由文本。 家庭的关系类型，以及属性/网址自身的 type，有一个真正的下拉框，可根据 Gramps 已知的取值列表自动补全。其他 GrampsType 字段在功能上可以作为纯文本编辑，只是还没有这种自动补全或校验。
• 并发编辑会被拦截，而不是合并。 如果在您打开编辑表单后，记录在服务器上被修改了——别人改的，或者您自己的另一个标签页——保存会被拒绝并报错，而不是悄悄覆盖对方的修改。目前仍然无法查看改了什么或合并两次编辑；您只能重新打开并重做自己的修改。

这些缺口在积极开发中的进展见路线图与已知限制。