跳转至

Core concepts（核心概念）

Checkpoint

A checkpoint is a justification prompt a user sees when attempting a sensitive interaction (as described in What is a checkpoint?). Checkpoint configurations define these prompts and declare under which conditions and to which users they will be shown. When a user submits a checkpoint, a checkpoint record is created.

Checkpoint configurations

A checkpoint configuration defines the prompt and requested justification type which determines how the checkpoint prompt looks and functions from the user perspective. Configurations also define the conditions where a checkpoint should be shown to users. The Configure checkpoints page describes these options and conditions in depth and provides a walkthrough of how to create a new configuration.

Checkpoint records

When a user submits a checkpoint, a checkpoint record is automatically created. Each checkpoint record can be reviewed and contains several pieces of information:

  • The user who created the record.
  • The timestamp of when a record was Created.
  • The Checkpoint Type of the record.
  • The Checkpoint Language, which includes the Checkpoint Title, Checkpoint Prompt, and Checkpoint Description. These values are inherited from the checkpoint configuration but are static; they always reflect the text shown to a user in the checkpoint and will not be updated if the underlying checkpoint configuration is edited or deleted.
  • The Justification a user provided.
  • Checkpointed Items for the interaction: For checkpoint types that describe an interaction involving a resource or other entity in the platform, references to those resources or entities will be saved in the record. For example, if you attempt to export a resource and submit a checkpoint generated from a configuration of type Compass export, then the record will contain a checkpointed item reference to this resource. Likewise, if you submit a checkpoint generated from a configuration of type Submit action, then the record will contain a checkpointed item reference to the Action type (including related metadata, like the Action type's Ontology and that Ontology's version at time of submission).
  • A Checkpoint RID uniquely identifying each record.
  • The Checkpoint Configuration RID uniquely identifying the checkpoint configuration the checkpoint was generated from.

中文翻译

核心概念

检查点(Checkpoint)

检查点(Checkpoint) 是用户在尝试进行敏感交互时看到的理由提示（详见什么是检查点？）。检查点配置(Checkpoint configurations)定义了这些提示，并声明了在何种条件下向哪些用户显示这些提示。当用户提交检查点时，会创建一个检查点记录(Checkpoint records)。

检查点配置(Checkpoint configurations)

检查点配置(Checkpoint configuration) 定义了提示内容和请求的理由类型，这决定了检查点提示从用户角度来看的外观和功能。配置还定义了应向用户显示检查点的条件。配置检查点页面深入描述了这些选项和条件，并提供了如何创建新配置的逐步指南。

检查点记录(Checkpoint records)

当用户提交检查点时，会自动创建一条检查点记录(Checkpoint record)。每条检查点记录都可以进行审查，并包含以下信息：

  • 创建记录的用户。
  • 记录创建的时间戳。
  • 记录的检查点类型(Checkpoint Type)。
  • 检查点语言(Checkpoint Language)，包括检查点标题(Checkpoint Title)、检查点提示(Checkpoint Prompt)和检查点描述(Checkpoint Description)。这些值继承自检查点配置，但属于静态内容；它们始终反映检查点中向用户显示的文本，即使底层检查点配置被编辑或删除也不会更新。
  • 用户提供的理由(Justification)。
  • 交互的检查点项目(Checkpointed Items)：对于描述涉及平台中资源或其他实体交互的检查点类型，这些资源或实体的引用将保存在记录中。例如，如果您尝试导出资源并提交由Compass导出(Compass export)类型配置生成的检查点，则记录将包含指向该资源的检查点项目引用。同样，如果您提交由提交操作(Submit action)类型配置生成的检查点，则记录将包含指向操作类型(Action type)的检查点项目引用（包括相关元数据，如操作类型的本体论(Ontology)以及提交时该本体论的版本）。
  • 唯一标识每条记录的检查点RID(Checkpoint RID)。
  • 唯一标识生成检查点的检查点配置的检查点配置RID(Checkpoint Configuration RID)。