集合 Collection

集合是一组项目。 这可以是 SQL 中的 1-1 数据表、一组其他集合或只读视图。 尽管名称不太专业，但它们具有与数据表相同的功能和功能。

概览

集合是数据表。 通常，您在 内容模块 中访问集合中的项目。

系统集合

系统集合存储为您的项目提供动力所需的数据和配置详细信息。

由于系统集合存储了为您的 Directus 项目提供支持的信息。 您不能重新配置系统集合或其任何默认字段，因为任何重新配置都会破坏您的项目。 但是，您_可以_ 在系统集合上创建和配置新字段。 这使您可以根据需要安全地自定义数据模型。

系统集合不会显示在内容模块中。 下表将介绍每个系统集合负责的逻辑和功能，以及在哪里可以找到相关的应用程序和 API 文档。

系统集合PurposeAPPAPI
Activity跟踪和存储 Directus 中的所有事件，对所有事情进行全面负责。Activity LogActivity
Collections存储每个集合的数据表和配置详细信息。CollectionsCollections
Dashboards存储仪表板配置详细信息和所有相关链接的面板。InsightsN/A
Fields存储每个字段的配置详细信息。FieldsFields
Files这会存储资产存储中的文件位置以及与该文件关联的任何数据。File LibraryFiles
Flows存储 Flows 所需的基本逻辑，从而启用事件触发的任务自动化。FlowsFlows
Folders存储提供虚拟文件资产管理的文件夹所需的信息。FoldersFolders
Migrations我们的安装/升级过程使用它来跟踪特定版本的迁移脚本何时运行。It has no relevant app functionality.N/A
Notifications存储有关应用内通知的详细信息。Module Bar and SidebarNotifications
Operations存储操作所需的信息，这些信息是 Flows 的一部分。OperationsOperations
Panels这存储有关各个分析面板的信息，这些信息显示在 Dashboards 上。InsightsN/A
Permissions这存储为角色配置的访问权限。Users, Roles & PermissionsPermissions
Presets这存储了预设和书签的详细信息。Presents & BookmarksPresets
Relations这存储有关集合之间关系的信息。RelationshipsRelations
Revisions修订是对项目所做的更改/编辑。 Directus 会跟踪所做的编辑，因此您可以随意恢复到以前的状态。Revert an ItemRevisions
Roles存储有关创建的每个角色的信息。Users, Roles, and PermissionsRoles
Sessions出于系统目的存储有关每个用户会话的信息。N/AN/A
Settings存储在 Settings > Project Settings 中进行的所有配置。Project Settingssettings
Shares存储有关数据共享的所有信息。Data Sharing
Users存储有关平台内每个用户的信息。User DirectoryUsers
Webhooks存储有关已配置 webhook 的所有信息。WebhooksWebhooks

创建一个集合

要创建集合，请执行以下步骤。

  1. 导航到设置>数据模型，点击页眉中的add，会打开一个抽屉。
  2. 输入唯一的集合名称。这不能在以后修改，但可以翻译。这用作数据表键、API 集合键和默认集合名称。
  3. 可选：根据需要进行任何其他配置。
    • Singleton - 切换集合是否为 Singleton。
    • 主键字段 - 设置主键字段的名称，默认为 id。
    • Type - 设置用于此集合的 ID 类型。
  4. 点击arrow_forward确认。
  5. 根据需要启用并重命名其他可选系统字段：
    • 状态 - 存储项目状态。
    • Sort - 添加一个允许对项目进行拖放排序的字段。
    • 创建时间 — 记录项目的创建日期。
    • 创建者 - 记录创建此项目的用户。
    • 更新时间 — 记录项目上次更新的日期。
    • 更新者 - 存储最后一个编辑文件的用户。
  6. 点击check确认并创建集合。

不可变键
创建集合后，无法修改步骤 2 中的集合名称。 但是，您可以覆盖它的样子与 集合命名翻译 一起显示。

复合键
Directus 目前不支持复合键。 如果您的项目使用复合键，您将需要制作一个 数据模型的调整。

SQL视图
Directus 目前不支持通过 SQL 视图创建虚拟表。

数据库表
请记住，集合只是一个数据库表。 因此，您可以直接在数据库中导入或创建表 它会自动出现在您的 Directus 项目中。 第一次管理该表时，directus_collections 记录将使用默认值创建。

切换集合可见性

要在内容模块中切换是否默认隐藏集合，请执行以下步骤。

  1. 导航至设置 > 数据模型。
  2. 点击more_vert 打开集合的上下文菜单。
  3. 选择查看内容或隐藏集合以根据需要调整可见性。

假设用户具有访问权限，仍然可以查看隐藏的集合。 他们必须右键单击导航栏并选择 visibility Show Hidden Collections。

创建文件夹

文件夹允许您对集合的显示方式进行子嵌套和分组。 此功能只是更改集合在 Settings > Data Model 和 Content Module 下的显示方式。 它对数据模型没有影响。 要创建文件夹，请按照下列步骤操作。

  1. 导航至设置 > 数据模型。
  2. 点击页眉中的create_new_folder。
  3. 设置一个文件夹键，它也将用作文件夹的名称。
  4. 可选：根据需要设置文件夹图标、颜色、注释和翻译。
  5. 点击 Save 创建您的文件夹。

切换文件夹显示

要切换文件夹显示，请按照以下步骤操作。

  1. 导航至设置 > 数据模型。
  2. 单击所需集合上的 文件夹 以切换以下显示：
    • 开始打开
    • 开始折叠
    • 始终打开

排序和嵌套集合

要在 Settings > Data Model 和 Content Module 中对集合进行排序和嵌套，请执行以下步骤。

  1. 导航至设置 > 数据模型。
  2. 单击并拖动 drag_handle 以根据需要放置集合。 要嵌套集合，请在预期的父文件夹或集合的下方和右侧拖动。

配置一个集合

要配置集合，请执行以下步骤。

  1. 导航到 Settings > Data Model 并单击所需的集合。 集合的配置页面将打开。
  2. 根据需要进行配置。 配置选项分为六类。
  3. 点击check确认。

字段和布局

此部分允许您创建和配置字段，以及配置字段在项目详细信息页面上的显示方式。 要了解更多信息，请参阅 字段 上的文档。

集合设置

这些控件允许您修改集合在内容模块中的显示方式。

  • 集合名称 - 显示集合的名称，不能修改。但是，您可以使用集合命名翻译覆盖显示的名称，显示在此列表的下方。
  • 消息 - 设置一个有用的注释来解释集合的目的。
  • 图标 - 设置引用此集合时在整个应用程序中使用的图标。
  • 颜色 — 设置图标的颜色，显示在导航栏及其页眉中。
  • 显示模板 - 为集合创建一个 显示模板。
  • 隐藏 - 切换集合是否应该在其他应用程序模块中全局隐藏，即使对于管理员用户也是如此。您不能像其他角色一样通过权限为管理员隐藏集合，因此这可以方便地整理内容模块。
  • 单集 - 切换以绕过 集合页面 并将用户带到 项目详细信息页面。
  • 集合命名翻译 - 跨多种语言翻译集合名称。当在项目设置或用户详情页面中更改默认语言时，如果存在相关翻译，将在整个应用程序中使用。

集合命名翻译
默认情况下，Directus 使用 标题格式化 将集合键显示为人类可读的名称，但您也可以使用翻译显式重命名更多技术表键。

什么是单集？
仅包含一个项目的集合。 例如，网站的 About Us 页面。

存档

选择一个字段来处理归档项目。 这为集合中的项目提供了 软删除 功能。 归档项目仍将存在于集合和数据库中，但会在 Data Studio 中进行过滤。 要配置存档字段，请根据需要设置以下四个输入字段。

  • 存档字段 - 从下拉菜单中选择存档字段。
  • 存档应用过滤器 - 切换应用用户是否可以过滤存档项目。
  • 存档值 — 当项目被 存档 时分配给字段的值。
  • 未存档的值 — 当项目 未存档 时分配给字段的值。

自动设置
当您 创建集合 时，您可以选择创建可选的状态字段。 如果您选择包含此字段，则会自动为您配置集合的存档设置。

存档字段值
除了上面定义的存档和未存档值之外，存档字段还可以包含任意数量的附加值。

通过 API 进行归档项目管理
归档项目默认隐藏在应用程序中，但除非明确过滤掉，否则它们仍会通过 API 正常返回。 这使您可以在使用 API 时灵活地管理归档项目。

排序字段

排序功能使用户能够在数据洞察中手动排序项目。这通常显示在 Content Module > Collection Page 上。它还可以用于对 交汇点集合 中的项目进行排序。需要使用“INTEGER”数据类型配置的标准字段。如视频所示，不能用作排序字段的字段将在排序字段下拉列表中显示为灰色且不可选择。

排序字段 - 选择一个字段来自定义排序和排序项目。单击 取消选择 以禁用。

要配置排序字段，请执行以下步骤。

  1. 创建字段 具有INTEGER数据类型。
  2. 从 设置 > 数据模型 > 集合 > 排序 下的下拉列表中选择一个字段。
  3. 点击check确认。

配置排序字段后，您可能想了解如何 手动排序项目。

自动设置
当您 创建集合 时，您可以选择创建 Sort 字段。 如果您选择包含此字段，则会自动为您配置集合的排序设置。

界面排序
要在关系接口(例如 M2M、O2M 或 M2A)中配置手动排序，请按上述方式进行配置，但还要在字段配置抽屉的关系部分中设置 Sort Field。

配置为隐藏
您还可以将此字段设置为隐藏，这样它就不会显示在“项目详细信息”页面中。

问责制

默认情况下，您的 Directus 项目会跟踪集合的所有 活动 和 修订。 但是，您可以覆盖它并选择要跟踪的数据。

  • 活动和修订跟踪 - 支持以下选项：
    • 跟踪活动和修订
    • 仅跟踪活动
    • 不要跟踪任何东西

问责制与遥测
问责制是您项目中_谁做了什么_的日志。 它是供您的团队自己使用的。 这与在 环境变量 下配置的 telemetry 不同。

重复

项目详细信息页面上的另存为副本选项提供了一种有效复制当前项目的方法。 由于项目中可能存在唯一的或相关的数据，因此准确控制要复制的内容非常重要。 复制允许您配置在项目上使用另存为副本时将复制哪些父和关系字段值。

  • 项目重复字段 - 检查字段以在复制项目时复制值。

删除一个集合

要删除集合，请按照以下步骤操作。

  1. 导航至设置 > 数据模型 > 集合名称。
  2. 点击页眉中的delete。
  3. 单击对话框中的 Delete 确认此决定。

危险
这个动作是永久的和不可逆转的。 请谨慎行事。