配置参考值范围

  • Published by Viedoc System 2023-06-12
  • Print

本课描述了如何在Viedoc Designer中配置参考值范围。

简介

About reference data

Viedoc offers support for adding reference data that will be automatically populated to specific forms. When reference data are configured for your study, it is not necessary to fill in reference values for each subject in each form separately.

It is possible to configure different sets of reference data that will be populated to the form based on:

  • factors that can affect the reference data, such as age or gender
  • reference data source, such as a lab
  • site
  • date

Terminology

Term Definition
Reference data source

An institute that provides reference data, for example a lab.
Reference data scope A mapping of the items that should be automatically populated with reference values, and the factors that they should depend on. One or more reference data scopes can be configured in Viedoc Designer > Global Settings, as set(s) of variables and factors (see definitions below).
Factor A parameter that affects the reference data, for example a subject’s sex. Factors may affect the normal range for a test result.
Variable A specific measurement to be carried out.
Date factor The date the sample was collected or the measurement carried out. This field determines on which date the reference data to be populated are based, for example when the event date is not the same as the collection or measurement date.
Target type An item of a certain type of information that a reference data source can provide for a specific variable (such as range, unit, low/high values, etc.). Any number of target types can be defined by the user.

Workflow

Reference data are configured in Viedoc Designer, Viedoc Admin and Viedoc Clinic. The schematic below depicts what different steps need to be taken, and which roles have permission to perform these steps.

http://help.viedoc.net/l/5cf069/en/

This is a single-sourced file that should have the following content:

Introduction to reference data, description of the workflow.

若您需要更多信息，请查看：

若您想要了解更多怎样使用参考值，请见：

也可参考视频教程：

参考值使用范围

关于参考值使用范围

参考值范围是应自动填充参考值的项目的映射，以及影响这些数据的因素的列表。一种参考数据范围的数据将填充为一种特定的实验室数据形式。 参考数据范围是在Viedoc Designer中的通用设计版本设置下配置的。

参考值范围链接到参考值源，并定义了以下内容：

  • 参考数据源执行哪些测量，
  • 哪些参数（因素）可能会影响结果，
  • 这些参数使用的范围/单位是多少？

参考值范围页面简介

在参考值范围页面上，您可以：

1. 添加一个新范围，请参考添加一个新参考值范围。

2. 删除一个已存在范围，请参考删除一个参考值范围。

3. 编辑已存在范围，请参考编辑一个参考值范围。在打开参考值范围页面，您可以在其中配置以下内容：

4. 范围名称。范围名称显示在Viedoc Admin中，该范围可以链接到参考数据源。它也显示在Viedoc Clinic中，可以在其中输入参考数据值。范围名称是必填字段。
提示！使用范围名称，该名称包含要执行的测量的（简短）描述。 这将使在Viedoc Admin和Viedoc Clinic中更容易确定范围。

5.影响参考数据的因素（请见因素）。

6.将要测量的变量以及将自动使用参考数据填充的变量（请见变量）。

因素

什么是因素？

因素是可能影响测试结果正常范围的参数，例如受试者的性别或年龄。此处定义的因素将在Viedoc Clinic中的参考值编辑器中可用。

在参考值范围页面上配置因素在参考值范围页面上，您可

1. 添加一个新的因素。

2. 删除一个因素。

3. 编辑一个因素。

每个因素的定义如下：

  • # - 序号。序号是自动分配的。您可以通过单击数字旁边的箭头来更改因素在列表中的位置。 这些因素将在Viedoc Clinic中的参考值编辑器中按此顺序显示。
  • 因素标签 - 因素的名称。该标签将显示在Viedoc Clinic的参考数据编辑器中。
    请注意！ 如果在Viedoc Clinic的参考数据编辑器中输入数据后更改因素标签，则输入的数据将丢失，因为因素名称不再匹配。 因素标签区分大小写。
  • 因素表述 - 特定表字段的因素的参考路径。您可以通过以下方式编辑此字段：
    • 手动键入字段的表达式
    • 单击 “...”，然后从因素表述对话框中选择字段。
      接受以下字段类型：下拉菜单，单选按钮和数字。可供选择的字段是有效设计版本的所有字段，以及具有现有表单或访视数据的先前设计版本的字段。
  • 因素选项 - 显示属于所选表单字段的选项。这些选项将自动填充。如果没有为所选表单字段预定义选项，则该字段将显示TBD。

定义因素时，必须填写以上所有字段。

变量

什么是变量？

变量是要执行的特定测量。此处定义的变量将在Viedoc Clinic中的参考数据编辑器中可用。

在参考值范围页面上配置变量

:在参考值范围页面上，您可

1. 添加新的变量。

2. 删除一个变量。

3-6. 编辑一个变量。

每个变量的定义如下：

  • # - 序号。序号是自动分配的。您可以通过单击数字旁边的箭头来更改因素在列表中的位置。 这些因素将在Viedoc Clinic中的参考值编辑器中按此顺序显示。
  • 表单 (3) - 包含您要填充参考值的字段的表单（例如，实验室表单）。您可以从下拉列表中选择表单。可以从下拉列表中选择研究中使用的所有表单。
  • 名字 (4) - 变量的名称。 该名称将显示在Viedoc Clinic的参考数据编辑器中。您可以通过以下方式编辑此字段：
    • 输入变量名称。
    • 点击 "..." 并在变量类型中选择。在变量类型对话框中，可以在静态和动态之间进行选择。更多信息请参阅变量类型。
      请注意！如果在Viedoc Clinic的参考值编辑器中输入了数据后更改了变量的名称，则输入的数据将丢失，因为变量名不再匹配。变量名称区分大小写。
  • 日期因素 (5) - 测量的日期，默认情况下设置为EventDate。 例如，在访视日期与测量日期不同的情况下，此字段确定要填充参考值的日期。 您可以通过以下方式编辑此字段：
    • 输入表达。
    • 单击“ ...”，然后从日期因素表达对话框中选择一个字段。
  • 目标类型 (6) - 参考数据源可以提供的信息类型，例如单位或范围。此字段确定将使用参考值自动填充所选表单中的哪些字段。您可以定义无限数量的目标类型。可接受以下项目类型：字符串，数字，范围，下拉列表和单选按钮。 可供选择的字段是有效设计版本的所有字段，以及具有现有表单或访视数据的先前设计版本的字段。 类型名称是将在Viedoc Clinic中的参考值编辑器中显示的标签。此处定义目标类型的顺序是它们在Viedoc Clinic中的参考值编辑器中显示的顺序。

定义变量时，必须填写以上所有内容。

注意！一个表单项只能映射到一个范围。 如果表单项映射到多个范围，则会显示以下错误消息：字段只允许在一个范围中出现。

注意！ 变量不能映射到包含函数的表单项。如果将变量映射到包含功能的字段，则将显示以下错误消息：无法关联已包含功能的项。

变量类型

有两种类型的变量：

  • 静态 - 当目标字段（要填充参考数据的字段）具有单一且固定的用途时使用，即，当这些项目由静态文本描述时。
  • 动态 - 当目标字段取决于另一个字段中选择的字段时，即当字段由包含下拉列表或单选按钮的另一个字段描述时，使用。 描述字段的每个代码列表值在Viedoc Clinic中的参考值编辑器中显示为单独的变量，并且对于每个代码列表项目，必须输入单独的一组参考值。

下图给出了静态变量的示例。

下图给出了动态变量的示例。如果字段由单选按钮或下拉列表组成，并因此具有代码列表，则从代码列表字段中获取Viedoc Clinic中参考值编辑器中显示的变量名称。 对于每个代码列表项，必须在参考值编辑器中输入一组单独的参考值。 然后，当中心用户在Viedoc Clinic中填写表单时，他/她从单选按钮或下拉列表中进行的选择将确定将哪些参考值填充到表单中。

分步指南

Viedoc Designer中的流程

为了在您的研究中设置参考数据，您必须在Viedoc Designer中执行以下步骤：

  1. 创建一个包含要自动填充参考数据值的字段的表单。请参阅创建和编辑表单。
    注意！参考值项应设置为允许最大小数位（6位）。关于创建表单的更多信息，请见eLearning 创建和编辑表单。
  2. 创建参考数据范围。请参阅创建一个参考值范围。
  3. 创建一个或多个可以编辑和/或发布参考值的临床角色。请参阅创建一个可以编辑和/或发布参考值的临床角色。

提示！ 创建表单时，请将用作因素的字段设置为必填项。 如果在Viedoc Clinic中某个因素字段保留为空，则不会自动填充任何参考值。 将用作因素的字段设置为必填项，可避免将它们留空。在下面的示例中，人口统计学表单的年龄是实验室表单的变量血红蛋白参考数据的一个因素。为了确保可以填充参考值，需要提供受试者的年龄。 因此，人口统计学表中的年龄项设置为必填项。

创建参考值范围

要创建参考数据范围，请按照以下步骤操作。

1 在Viedoc Designer中，打开通用设计版本设置页面。 在参考值范围字段中，单击编辑。
2 点击添加。
参考数据源页面打开。
3 输入范围的名称。范围名称将在Viedoc Admin（可将范围链接到参考数据源）和Viedoc Clinic（可在其中输入参考数据值）中显示。
4

如下设置因素：

  • 点击添加。
  • 在因素标签栏，输入因素的名称。
  • 在因素表述中：
    • 手动键入字段的表达式
    • 单击“...”，然后从因素表述对话框中选择字段。
      接受以下字段类型：下拉菜单，单选按钮和数字。可供选择的字段是有效设计版本的所有字段，以及具有现有表单或访视数据的先前设计版本的字段。

因素选项会显示属于所选表单字段的选项。这些选项将自动填充。如果没有为所选表单字段预定义选项，则该字段将显示TBD。

您可以添加任意多个因素。 您可以通过单击垃圾箱图标删除因素。

更多信息请点击因素。
5

Set the variable(s) as follows:

  • 点击添加新变量。
  • 在表单栏，输入您要填充参考值的字段的表单。
  • 在名字栏：
    • 输入变量名称，或
    • 点击“...”并在变量类型中选择。在变量类型对话框中，可以在静态和动态之间进行选择。更多信息请参阅变量类型。
      • 静态用于由数字字段或文本字段组成的变量。
      • 动态用于由单选按钮或下拉列表组成的变量。
        如果选择了动态，请从下拉列表中选择表单和字段。 表达式显示在表达式字段中。 单击添加以添加表达式。
      • 注意！对于静态变量，您始终必须输入名称。
  • 在日期因素栏：
    • 输入表单，或
    • 单击“ ...”，然后从日期因素表达对话框中选择一个字段。
    • 表达式显示在表达式字段中。单击添加以添加表达式。
  • 在目标类型栏：
    • 点击目标类型右侧的箭头，然后选择添加新类型，
    • 在类型名称字段中输入目标类型的名称，
    • 单击空白字段，然后从下拉列表中选择应使用参考数据值自动填充的字段。您也可以直接输入表达式，或输入字段名称以过滤字段列表。

您可以根据需要添加任意数量的变量和目标类型。您可以通过单击垃圾箱图标来删除变量。您可以通过单击目标类型名称右侧的箭头并选择移除类型来删除目标类型。 通过单击目标类型名称右侧的箭头，然后选择左移或右移，可以将目标类型向左或向右移动。

更多信息请查看变量。
6

点击保存。

新创建的参考数据范围显示在参考数据范围列表中。

注意！为了使新创建的参考值作用生效，您需要发布通用设计版本设置。

将参考值范围链接到Viedoc Admin中的参考值源后（请查看Viedoc Admin中的管理参考值源），可以在Viedoc Clinic中为该源-范围组合输入参考值。参考值应在Viedoc Clinic中发布，以使其可自动填充到受试者表单中（请参考Viedoc Clinic中的使用参考值）。如果在Viedoc Clinic中发布参考值后更改参考值范围并在Viedoc Designer中发布，则以下消息将出现在Viedoc Clinic中。

参考日期来源-范围组合需要更新并再次在Viedoc Clinic中发布，以使参考值可用于自动填充到受试者表单中。

创建一个可以编辑和/或发布参考值临床角色

为了在您的研究中使用参考数据，您需要创建一个或多个具有以下权限的临床角色：

  • 查看参考值 - 允许用户在Viedoc诊所中以只读模式查看现有参考数值。 启用此选项时，以下两个选项变为可用：
  • 编辑参考值 - 允许用户编辑和保存参考数据。
  • 发布参考值 - 允许用户发布参考值，以便这些值可用于在Viedoc Clinic中供受试者表单使用。

注意！您需要至少具有一个具有编辑参考值权限的临床角色，以及一个具有发布参考数据权限的临床角色。此角色不必相同。

在Viedoc Designer中，研究设计的角色部分中配置了每个临床角色的权限。 有关如何配置临床角色的更多详细说明请查看配置角色。

编辑参考值范围

要编辑参考数据范围，请在Viedoc Designer中打开通用设计版本设置页面。 在参考值范围字段中，单击编辑以打开参考值范围页面。 单击编辑以打开您要编辑的参考值范围并进行所需的更改。

请查看因素，变量和创建参考值范围以获取更多信息。

即使已发布的通用设计版本并且该范围已链接到参考值源，也可以随时编辑参考值范围。 为了使更改生效，您必须再次发布通用设计版本。

删除参考值范围

注意！您只能在参考值范围在通用设计版本设置发布之前将其删除。

要删除参考值范围，请在Viedoc Designer中打开通用设计版本设置页面。 在参考值范围字段中，单击删除。 打开确认对话框。 单击删除继续删除范围，或单击取消返回而不删除范围。