创建和编辑表单
表单页面的概述
在Viedoc Designer表单页面,您可创建,编辑和管理表单。
在表单页面,您可完成以下操作(如图:)
1. 从头开始创建表单,请参见创建表单。
2. 通过使用共享表单模板创建表单,请参见使用共享表单模板创建表单。
3. 将一张表单添加至共享模板,请参见创建共享模版。
4. 筛选和搜索表单。
5. 按编辑日期,创建日期或名称对表单进行排序。默认为按编辑日期。
6. 显示/隐藏表单/字段ID。
7. 打印带注释的CRF(带有ID)或空白CRF(不带ID)。
8. 编辑,复制或删除一张表单。
表单
关于表单的布局和内容
表单由一个或几个包含一个或多个字段的组组成。
表单中的白框定义组(字段组)。一个字段组可以有一个标题。
黄色框突出显示一个字段。将鼠标悬停在字段上时,将显示黄色框。
您可以调整字段组的设置和单个字段的设置。
- 要访问字段组设置,请在构成字段组的白色框内字段外部区域单击。
- 要访问字段设置,请单击字段的区域(黄色框)。
分步指南: 创建新表单
要创建新表单,请按照以下步骤操作。
1 |
在Viedoc Designer中的研究设计中,在表单字段中单击显示。 表单页面打开。 |
2 | 点击创建新表单。 创建一个新表单,然后Form Settings弹出窗口打开。 |
3 |
在Form Settings弹出窗口中,在一般栏,输入/编辑:
提示! 您可以输入格式设定,以定义如何在Viedoc Clinic中显示表单。在之后的阶段很容易做到这点只要建立了表单并填充了字段和字段组。想要查询更多的信息,请参见表单的格式设定。 |
4 |
在高级一栏,选择:
提示!您可在之后编辑这些设置! |
5 |
在可见栏,请选择:
若您选择了已选角色,选择哪些角色应该能够查看表单并编辑数据。 注意!只有用户的角色拥有编辑研究开始访视的权限时,该用户才能添加新受试者卡以及创建Viedoc Me账号。 请注意! 提醒不遵守角色可见性条件。表单中某些角色隐藏的字段可能会在提醒消息中可见。想要查询更多的信息, 请见提醒。 |
6 | 点击保存以保存。 |
您也可通过共享表单模板创建表单,请见共享表单模板。
表单的格式设定
格式设定是表单标识符,用于定义启动表单时将如何在Viedoc Clinic的以下位置中显示表单:
1.受试者详情页面上访视视图中的表单列表(请参见下图)。
2.以视图/编辑模式显示表单时的表单名称(请参见下图)。
3.添加受试者表单。
4.签名控制台(请参见下图)。
5.数据审核控制台。
6.表单历史记录PDF的标题(请参见下图)。
7. Viedoc版本4.39及更高版本的PDF导出。
设定格式的字段您可输入变量或者和自由文本(完整内容请见在Viedoc中使用JavaScript)。对于可重复表单,您可使用 FormRepeatKey
以便在格式中区分表单的重复次数。在下图的例子中,可重复表单的设定格式为Instance nr {FormRepeatKey}, {DATE}。
当日期变量在设定格式中,日期的格式将按照Viedoc Admin中研究设置中的设置进行设置,请参见研究常规设置。
关于更多可重复表单的信息,请参见试验流程。有关使用设定格式的更全面示例,请参见使用可重复表单。
在启动表单之前,如果设定格式保留为空,则使用表单名称在Viedoc Clinic的这些位置显示表单。
注意!如果使用了较长的设定格式,则会增加PDF中标题的大小。如果PDF标头包含三行以上的文本,它将与PDF的内容(即表单的屏幕截图)重叠。
提示!如果为表单激活了选项允许表单在复制前一个访视数据后激活,则可以在摘要设定格式中包含一个或多个表单序列号,以便更轻松地在Viedoc Clinic中识别表单从中复制数据的实例。有关更多详细信息,请参阅允许表单在复制前一个访视数据后激活 。
自动更新功能
在Form settings 弹出窗口的“高级”选项卡上,可以启用选项自动更新功能 (误差值一旦更改,功能就会被触发)。
如果选中此选项,则当表单包含具有依赖于其他表单项的功能的字段时,该表单将自动更新。如果更改了一个或多个依赖字段的值(在Viedoc Clinic,Viedoc Me中或通过API),该函数将重新执行,并且该表单将自动更新,如下所示:
- 该字段将使用重新执行该功能所产生的新值进行更新
- 可见性条件已验证
- 数据检查已通过验证
- 表单状态已更新
请注意! 仅当表单中的某些字段使用依赖于其他表单中的字段的功能(所谓的跨表单字段)时,自动更新功能选项才有用。如果表单中没有跨表单字段,则不应启用自动更新功能选项,因为这会不必要地降低系统性能。
如果启用了自动更新功能选项的表单处于锁定状态,则仍然可以通过重新执行功能来对其进行更新。值更改时,将保存该表单,并且审核和签名将被破坏,但是该表单仍处于锁定状态。
一个启用了自动更新功能的例子
让我们考虑一个表单(Form A),其中包含一个跨表单项(Calculated_Item),该项使用依赖于另一种表单(Form B)中两个字段的函数(F): Input_Item_1 和Input_Item_2 。表单A启用了自动更新功能选项。保存表单B(在Viedoc Clinic,Viedoc Me或通过API)后,将重新执行函数F。结果,如果Calculated_Item的值已更改,则通过以下方式更新表单A:
- 将Calculated_Item的值更新为新值
- 重新验证可见性条件
- 重新验证数据检查
- 更新表单状态(例如缺少字段)
自动更新功能如何影响表单稽查轨迹和修订版?
当由于依赖关系更改而自动更新表单时,由关联数值改变引起自动更新为稽查轨迹中显示的更改原因。
在研究设计的修订版本中启用自动更新功能选项并且未启用可隐藏表单选项时,该表单将被标记为已更改,并且功能将在升级期间执行。
可隐藏的表单
如果为表单启用了选项自动更新功能,则可以将该表单设置为可隐藏的表单。在Viedoc Clinic,Viedoc Me中或通过API发起访视时,隐藏表格会自动启动,但不可见。
隐藏的表单(或在隐藏表单中的数据):
- 未包含在任何状态/统计/参数计数中,
- 不包含在PDF存档中,
- 没有签名
- 重置相应访视时自动重置,
- 包括在导出中。
在研究设计的修订版中禁用可隐藏的表单选项时,该表单将自动升级并显示出来。
在研究设计的新修订版启用可隐藏表单的选项时,在应用修订版后,现有(可见)表格需要进行手动升级或批量批准。在研究者确认之后,该表格将被隐藏。
允许表单在复制前一个访视数据后激活
开启选项允许表单在复制前一个访视数据后激活后,可以将表单中的数据从一个访视中的表单复制到另一个访视中相同表单的另一实例。
激活此选项后,必须选择是始终可复制表格,还是仅在满足某些条件(在简单/高级条件下)时才可复制:
- 总是
- 对简单条件满足为真。从下拉菜单中,选择基于条件的字段,选择是或不是,然后选择代码列表以指定条件。
- 高级条件满足为真。 输入JavaScript语言填写条件。
请注意!
- 即使在不同的访视中,也无法将一个可复制表单的多个实例添加到一个访视中。一旦激活了允许表单在复制前一个访视数据后激活选项,该表单就只能添加到每个访视一次。但是,可以将可复制的表格设置为可重复表单,请参阅试验流程中的可重复表单。
- 根据允许表单在复制前一个访视数据后激活设置,而不考虑研究流程中访视/活动上可能设置的可见性条件。 换句话说,可复制表格不遵循在活动或访视级别上设置的可见性条件。 因此,如果您在设置可见性条件的活动/访视中包括可复制表单,则由于未满足可见性条件而未显示活动,即使Viedoc Clinic也显示可复制表单的重影形式。 为确保可复制表单的重影表单仅在某些条件下显示,请指定允许表单在复制前一个访视数据后激活的标准来启动表单。
表单序列号可供您更容易地了解到受试者层面表单序列,尤其是对于从前一访视复制过来数据的新表单。
- FormRepeatKey - 在同一活动中用来计数可重复表单的复制次数。只在4.39及以后版本才可导出。
- SubjectFormSeqNo – 在受试者层面的表单序列号,从“1”开始然后每当该受试者有添加一张新的该表单则数字增加一次。只在4.51.及以后版本才可导出。
- OriginSubjectFormSeqNo – 对于可复制表单,受试者层面的原表单序列号。对于非复制表单,该数值等于
SubjectFormSeqNo
。在4.51.及以后版本才可导出。 - SourceSubjectFormSeqNo – 对于可复制表单,该数值等于源表单被复制次数,与其源复制表单的
SubjectFormSeqNo
数值相等。对于非可复制表单,该空为空。在4.51.及以后版本才可导出。
以下的例子阐述了这些序列号的产生方式。该表同时设置了在Visit 1, Visit 2 and Visit 3表单即可重复。
我们在Viedoc Clinic中做了如下操作:
1 | 开启Visit 1 并填入三个可重复表单,如下为三个表单的序列号: |
2 | 开启Visit 2在1该访视您可看到三个可复制的模板表单来源于Visit 1: |
3 | 在Visit 2中复制一个来源于Visit 1的表单,您将会会看到以下的序列号: |
4 | 开启Visit 3后可选择复制来源于Visit 1和Visit 2 中的已填入表单: |
5 |
在Visit 3中复制Visit 2中的表单,您将能看到以下序列号: |
这些序列号用于让您区分一个特定的表单,举例来说: {SubjectFormSeqNo}, {OriginFormSeqNo}, {SourceFormSeqNo}。
在以上的例子中,您可查看到以下的一些序列号:
Form Repeat Key {FormRepeatKey}, SubjectFormSeqNo {SubjectFormSeqNo}, OriginFormSeqNo {OriginFormSeqNo}, SourceFormSeqNo {SourceFormSeqNo}
请注意!
- 只有FormRepeatKey是可以用来作为表单序列号当您需要做数据导出的映射的,也是我们在JavaScript中使用的 (比如 EventID.FormID$ActivityID[FormRepeatKey].ItemID)。
- 当您重置表单后,序列号依旧被重置前的表单使用,再填入数据的表单会有新的序列号。
在Excel的导出中,这些序列号可帮助您查看那些表单是复制之前访视数据的表单,而哪些是被复制表单:
在Source Subject form sequence number 这一列中,只有复制之前访视数据的表单才会有数值。拿最后两列作为例子,这两行的数据来源于与有相同Subject form sequence number 数值的表单,图中已标绿。而第一次被复制的表单会和该表单有相同的Origin Subject form sequence number, 我们这个例子的数值为“3”。
预览表单
要查看和测试表单,请单击预览表单。 必须先保存对表单的所有更改,然后才能在预览模式下查看它们。
表单的预览将打开,显示在Viedoc Clinic中的外观。 您可以通过填写一些值来测试字段以及可能的功能,数据检查,依存关系和可见性设置(取决于同一表单中的字段)。 请注意,以下设置无法在预览模式下进行测试:
- 可见性设置取决于其他表单或访视的字段。
- 角色可见性设置。
- 允许通过某些角色进行编辑的设置。
如果将表单翻译成其他语言,则还可以在预览模式下查看表单的翻译版本。
要退出预览模式,请单击关闭按钮。
字段
字段类型
字段类型的概述
表单可以包含不同类型的字段。
下表列出了所有可用的字段并提供了描述。
字段类型 | 用于 |
---|---|
单行文本 | 自由文本,即字符串类型数据。 |
数字 | 数字数据。 |
日期 | 年,月和日。 |
日期和时间 | 年,月,日,小时和分钟。 |
时间 | 小时和分钟。 这与其他日期项目在结构上有所不同,因为它不包括年,月,日或秒。 |
段落文本 | 较长的文本。 |
复选框 | 选择题允许一个以上的答案。 Clinic用户可以从列表中选择一个,多个或每个选项,如果没有选择,质疑将触发。 |
单选按钮 | 多选题仅允许一个答案。 |
下拉框 | 选择题仅允许一个答案,选项显示在下拉列表中,允许选择单个选项。 |
视觉模拟量表(VAS) |
使用滑块(在ViedocMe中) 和数字字段(在Viedoc Clinic中)显示刻度,以监控疼痛或症状的强度,请见视觉模拟量表。 |
段落分节 | 页面上的分割线。 |
组 | 将字段组添加到表单。 |
静态文字 | 在表单上显示文本(信息)。 |
文件上传 | 将文件上传到表单,通常是图像或是PDF文件,请见文件上传。 |
绘图板 | 显示一个绘图区(在ViedocMe中)和一个文件上传项(在Viedoc Clinic中),用于收集症状/签名的绘图,见下面的绘图板。 |
范围 | 输入数字范围,请见范围字段。范围值作为数字项输入(请参见上文)。 |
表单链接 |
为不同的表单之间添加链接,请参见下方表单链接项 |
对于有代码列表的字段类型(复选框、单选按钮和下拉框),请注意代码列表值在导出以下格式时,将不包含前导零:
- CSV
- Excel
- Audit log (每个值占一行,包括历史记录)
- ODM
例如,代码列表值为001将会在导出中显示为1。
视觉模拟量表
VAS量表(视觉模拟量表)可用于测量跨连续值范围的特征,例如受试者的疼痛程度或某些症状的强度。 默认情况下,小数位数从0到100。
根据使用的VAS标尺的形式,标尺的功能如下:
- 当用于Viedoc Clinic的表单时,VAS刻度将显示为数字字段,可在其中填写0到100之间的数字。
- 当在Viedoc Me中用于问卷调查时,VAS刻度看起来像是带有滑块的刻度,请参见图像。 通过单击刻度或移动滑块,对象可以指示疼痛或症状的严重程度。 单击重置按钮将删除滑块并清除数值。 当用户单击量表时,滑块将重新出现。 提交Viedoc Me调查表后,将禁用滑块,并将重置按钮替换为锁。
提示!如果要确保VAS刻度显示在10厘米处,建议使用iPad Mini填写Viedoc Me问卷。
文件上传
文件上传字段允许Clinic用户将文件上载到表单。 允许的最大文件大小为:
- Viedoc Clinic的表单是2GB。
- Viedoc Me的表单是512MB。
保存表单后,文件上传信息将在稽查轨迹中可查看。 当导出到Excel,CSV,PDF或ODM时,上载的文件包含在导出输出中。 包括以下信息:文件名,文件大小(以字节为单位),文件哈希(MD5)。
不支持上传受密码保护的zip文件,因为Viedoc无法扫描这些文件中的病毒。 也不允许上传可执行文件。 不支持的文件类型的完整列表可以在Viedoc Clinic User Guide中录入/编辑数据的黑名单文件类型中找到。
绘图板
绘图板项允许Viedoc Me用户制作图纸并提交给Clinic。绘图被保存为文件,可以在Clinic中下载,同文件上传项一样。
在设计绘图板时,有三个背景选项可用:
- 空:显示一个完全空的绘图区,用户可以自由绘图。
- 人体轮廓图:显示一个正面和背面视角的人体轮廓图,用户可以在上面作标记。
- 签名:显示一个空行,用户可以在上面签名。
范围字段
范围字段允许临床用户定义和填写一系列值。 一个示例是实验室形式的特定实验室测量的正常范围。
当使用参考数据功能时,范围字段应允许最大的小数位数(6位)。
在Viedoc Clinic中填写表单时,临床用户可以通过选择以下选项之一来定义值的范围:
- “-“ - 介于两者之间
- “<” - 小于
- “≤” - 小于或者等于
- “>” - 大于
- “≥” - 大于或者等于
- “=” - 等于
更多信息,请查看在Viedoc中使用JavaScript。
表单链接项
表单链接项允许Clinic用户在不同访视和包含相关/依赖数据的表单之间添加链接。例如,在编辑既往和伴随药物表单时,用户可以链接到多个已添加的病史访视。
注意! 受试者发起的访视(Viedoc Me)不支持表单链接项。
要创建和配置表单链接项:
1 | 将表单链接项添加到研究设计中的任何一个表单(参见下方的在表单中添加字段)。 |
2 |
点击链接项,打开表单链接项。 |
3 |
在设置中,有四个不同的标签,一般、可见、验证和导出。关于标签的更多信息,参加下方的配置一个字段。 |
4 |
在‘来源’下: 1. 单击选择一个选项打开下拉菜单并选择要显示的表单。在本例中为病史。 注意! 您可以在‘来源’字段菜单中搜索,也可以在下拉列表中滚动。 2. 选择访视。在此示例中,在普通访视中选择病史访视。 注意! 根据您的研究设计,在试验流程中,您可以选择将表单链接到添加了特定表单的所有访视(在本例中是病史)或单个访视。 在下面的图像中,您可以看到‘来源’中的病史表单和普通访视中的病史访视都已添加。在此示例中,Clinic用户可以链接到普通访视中的病史表单类型的所有实例。 |
5 |
在‘格式’下,添加可用表单链接要显示的项。例如,病史的术语、序列号以及开始日期、是否持续和结束日期。这定义了表单将如何在Viedoc Clinic中显示。 提示! 点击问号了解有关摘要格式的信息。 更多信息,请参见表单的总结格式。 |
6 |
单击保存 注意! 如果您为修订研究设计而更新访视、来源或格式属性,将导致链接项所涉及的所有表格触发问题,需要研究者批准。 |
表单链接验证
有表单链接验证错误的设计不能被发布。如果验证失败,设计将不会被发布,并显示一个错误信息。
格式字符串必须引用源表单的有效项ID,以便显示格式能够被填入并显示在Viedoc Clinic。
如果源表单之间存在循环引用,例如,表单链接的源表单是包含表单链接的表单,则会显示一条错误信息,指出存在问题的表单。
在表单中添加字段
在表单中添加字段:
- 单击表单窗口左窗格中的标准元素(字段)之一,或
- 将元素(字段)拖放到现有字段组中。
如果单击标准元素之一,该项目将出现在所选组中。 如果未选择任何组,则该项目将出现在表单上的新组中。
您可以通过拖放项目在组内或组之间移动字段。
更改表单后,单击保存。
您还可以使用组织共享模板创建字段组,请见共享字段组模板。
配置一个字段
您可以在字段设置弹出窗口中配置字段。 单击字段周围的黄色框以打开字段设置弹出窗口。
字段设置弹出窗口有五个不同的选项卡:
选项卡 | 调整设置 |
---|---|
一般(1) |
设置字段的外观。 |
可见(2) |
设置字段的可见性条件。 注意!如果您对字段的某些临床角色设置为“隐藏”,则这些角色将看不到PDF表格。 即使在新修订版中将隐藏项目从表单中删除后,这些角色仍然看不到PDF。 这是因为表单PDF包含表单修订版中曾经存在的所有项目的完整审核跟踪,甚至包括隐藏于某些角色的项目。 因此,不会对任何这些角色显示PDF表单。 重要!不要将字段可见性设置用于盲态数据。 盲态数据应以单独的表单(例如随机表单)收集。 |
验证(3) | 设置字段的ID,并添加验证字段的逻辑核查。 |
功能 (4) | 设置用于计算字段的函数,或设置默认值。 |
导出 (5) | 设置输出栏ID(OID)和输出栏标签。 如果您希望该项目在导出中具有不同于Viedoc中使用的ID的其他ID或标签,这将很有用。 另请参阅在线学习输出和验证。 |
在以下各节中,将更详细地描述在这五个选项卡中可以进行的设置。
您可以更改输入的任何文本的布局。 单击abc(6)打开一个菜单,您可以在其中控制字体样式(常规,粗体,斜体,下划线,上标或下标),字体颜色(黑色,灰色,红色,绿色)和字体大小(小,正常值,大,超大)。 标记文本,然后单击相应的图标。
提示! 如果将显示栏ID开关(7)设置为ON,则表单及其所有项目的字段ID将以蓝色文本显示。
字段设置 - 一般
在一般选项卡上,您可以调整字段的外观。
您可以调整以下设置(见图):
1. 栏标签:描述字段的标签。 导出数据时,字段标签将用作项目标签,除非在导出选项卡上定义了输出栏ID或输出栏标签。
2. 标签位置:标签相对于输入字段的位置。 推荐的默认位置是“置顶”(标签上方)。
3. 小数点:仅对于数字字段,允许的小数位数。
4. 度量单位: 字段的度量单位。 测量单位将显示在输入字段下方。
5. 宽度:
- 单元:外部元素框(整个项目)的长度(以像素为单位)。
- 标签:字段标签的长度(以像素为单位)。
- 输入栏:输入字段的长度(以像素为单位)。
6. 用户说明:自由文本,例如该字段的更详细说明。 在此处输入文本时,字段标签旁边将显示i(信息)图标。 用鼠标悬停在此图标上将显示文本。
复选框字段的一般设置
对于复选框,可以在选项中输入选择标签的文本。 如果选择标签的文本较长,则在Viedoc Clinic中显示表单时,文本将被截断。 您可以通过激活允许换行符来避免截断。 激活此复选框后,复选框标签将遵循字段的宽度,并且文本将在下一行继续。
对于在2019年2月Viedoc版本4.48之后开始的研究,默认情况下激活允许换行符,对于在2019年2月Viedoc版本4.48之前开始的研究默认情况下处于禁用状态。
视觉模拟量表的一般设置
您可以调整VAS标尺的以下设置:
- 量表最小值标签:输入以VAS标尺的最小值显示的标签。
- 量表最大值标签:输入以VAS标尺的最大值显示的标签。
- 显示效果:选择刻度的方向:水平或垂直。
- 颜色:选择应以全彩色还是灰阶显示比例尺。
- 显示数字反馈:在标尺下方显示一个数字,指示滑块的位置。
- 显示数字评估量表:显示数字刻度。
- 显示竖线评估量表:在刻度上显示刻度线。
- 最大/最小值标签 置顶或者置底显示(垂直)*:在刻度的底部和顶部显示最小值和最大值。 此选项仅适用于垂直方向。
- 以上标签使用数字标尺(垂直)*:配置将标签显示在数字反馈上方。 仅当选中了显示数字反馈选项时和垂直方向时,该选项才显示。
* 在将VAS用于EQ5D问卷时,应使用这些设置。
文件上传字段的一般设置
对于文件上传,您可以选择是否要显示缩略图。
在一般选项卡上,从显示缩略图下拉列表中选择以下选项之一:
- 左侧:缩略图将显示在文件上传字段的左侧。
- 下方:缩略图将显示在文件上传字段下方。
- 无:没有缩略图显示。
请注意!
- 缩略图仅支持jpeg,gif和png文件。 如果选择显示其他文件类型的缩略图,则仅显示文件扩展名。
- 缩略图的使用将增加存储的数据量。 可以在Viedoc Admin中的研究概述页面和研究页面上的Viedoc Admin中查看到。
字段设置 - 可见
在可见选项卡上,您可以调整字段的可见条件。
您可以设置以下条件(见图):
1. 哪些角色可以查看该字段? 选择显示或隐藏所有,然后选择:
- 所有角色,向所有角色显示或向所有角色隐藏。
- 已选角色,用于向/从选定角色显示或隐藏字段。 选择应向其显示或隐藏该字段的角色。
2. 什么时候显示该字段? 选择显示或隐藏,然后选择何时显示或隐藏该字段:
- 总是
- 基于一个简单的条件:仅依赖同一表单上的一个字段,请参见下文。
- 基于高级条件:对其他表单或访视的依赖,请参见下文。
请注意!
- 在执行功能时,仅当设置为总是隐藏的字段存在于非隐藏字段组中,该数据才会被填充。 如果组中的所有字段组都设置为隐藏或字段组本身设置为隐藏,则该字段组将变为隐藏状态。
- 设置为总是隐藏的项目将包含在数据导出和稽查轨迹中。 因此,如果要保留数据,或者如果其他字段依赖于此功能,则在修订版中可将其设定为总是隐藏而不是删除。
3. 谁可以编辑字段? 选择启用编辑功能:
- 所有角色,以便任何可以查看该字段的角色也可以编辑该字段。
- 已选角色,以便只有选定的角色才能编辑字段。 选择将能够编辑字段的角色。
简单可见条件
要基于仅依赖于同一表单中的字段的简单条件显示或隐藏这个字段,请按照以下步骤操作。
1 | 选择对简单条件满足为真。 |
2 | 选择可见性条件所基于的字段。 |
3 | 为使条件为真,选择此项应等于(是)还是不等于(不是)某个值。 |
4 | 输入可见性条件应基于的值。 |
高级条件满足为真
要基于高级条件显示或隐藏字段,该条件允许多个依赖性,请按照以下步骤操作。
1 | 选择高级条件满足为真。 |
2 | 使用JavaScript定义条件。 有关JavaScript的更多信息,请参阅eLearning课程在Viedoc中使用JavaScript。 |
注意! 不要设置对所有角色隐藏所有! 如果某个字段对所有角色均隐藏,则保存表单后将清除该字段中存储的数据。 如果希望将值存储在对所有用户都应隐藏的字段中,请选择总是隐藏所有,并始终按照图像中的nr 2下的说明进行操作。
字段设置 - 验证
在验证选项卡上,您可以设置字段的ID并添加数据检查以验证输入到输入字段中的数据。
您可以设置以下条件(见图):
1. 您可以更改字段ID。字段ID是用于在数据库和导出输出中标识字段的ID。在JavaScript表达式中引用该字段时,也可以使用它。
导出数据时,字段ID将用作字段标签,除非在导出选项卡上定义了输出栏ID或输出栏标签,请见字段设置-导出。
注意!字段ID不应在正式环境中从一个研究设计版本更改为下一个研究设计版本。如果更改字段的ID,则数据检查,角色可见性条件和其他基于字段ID识别字段的功能将停止工作。如果在研究进入生产环境后需更改ID,请在导出选项卡下更改其输出栏ID。
如果选中了必填项,则字段为空保存表单时触发系统检查。将显示一条警告消息,指出必须填写该字段。
2. 您可以输入系统检查和/或数据检查。
系统检查是系统预先定义的检查。例如,系统检查可用于“日期”,“日期和时间”项,在这种情况下,它们会阻止将来输入将来日期。要激活此系统检查,请选中日期不得晚于复选框,然后选择访视日期或当前数据录入日期。
数据检查是用户可以定义的检查。要定义数据检查,请执行以下步骤:
1 | 点击“+”图标。 |
2 | 在限制表示若满足为真字段中,输入希望在不触发质疑或错误消息的情况下接受在输入字段中输入的数据的条件。使用JavaScript定义条件。有关JavaScript的更多信息,请查看在Viedoc中使用JavaScript。 |
3 | 在若为假,则触发Query/错误信息字段中,输入当输入的数据不满足步骤1中定义的条件时应显示的错误消息。 |
4 | 默认情况下,即使输入了触发查询或错误消息的数据,也可以保存该表单。如果要禁用表单保存,请清除Allow form save的复选框。 |
您可以为同一字段输入多个数据检查。
要删除数据检查,请单击 “-” 图标。
日期以及日期和时间字段的验证设置
对于日期和日期和时间字段,有一个系统逻辑核查,防止临床用户在 Viedoc Clinic填写表单时输入未来日期。要设置此设置,请在系统逻辑核查的字段中激活日期不得晚于复选框,然后选择:
- 访视日期
- 当前数据录入日期
单行文本和段落文本字段的验证设置
对于单行文本和段落文本字段,有一个系统检查,设置字段的在Viedoc Clinic中的最小长度和/或最大长度(字符数):
请注意,最小/最大长度设置与字段的必填项设置无关,即即使未选中必填项字段,也可以使用。如果要定义在 Viedoc Clinic中输入的非必填字段,这非常有用。但是,如果在非必填字段中输入了某些内容,您希望确保它至少包含 2 个字符,或者最多 10 个字符长。
文件上传字段的验证设置
在验证选项卡上,可以输入数据检查以验证输入字段中输入的数据。可用于文件上载项的属性包括:
ItemID.FileName
- 上传文件的名称ItemID.FileSize
- 上传文件的大小(以字节为单位)ItemID.FileHash
- 上传文件的MD5哈希
更多信息请查看在Viedoc中使用JavaScript。
范围字段的验证设置
在验证选项卡上,可以输入数据检查以验证输入字段中输入的数据。可用于范围项的属性包括:
RangeObject.Lower
- 范围的下限(数字)RangeObject.LowerFormat
- 用于范围下限的小数点位数(数字)RangeObject.Upper
- 范围的上限(数字)RangeObject.UpperFormat
- 用于范围上限的小数点位数(数字)RangeObject.Comparator
- 用于定义范围(字符串)的比较器。可用的比较器包括:InclusiveInBetween
- 定义一个范围,即上限和下限。LessThan
LessThanOrEqualTo
GreaterThan
GreaterThanOrEqualTo
EqualTo
注意!在函数中使用比较器时,请在引号之间写入它:"LessThan"。它是区分大小写的,因此键入它完全按照此处所述。
RangeObject.StringValue
- 相应范围字段(字符串)的字符串表示形式。
可用于与范围项结合使用的函数,包括可用于获取 RangeObject 的函数,请查看在Viedoc中使用JavaScript。
字段设置 - 功能
在功能选项卡上,可以设置用于计算字段的功能,或设置初始值,该初始值将在输入字段中显示为初始值。
有以下两种选项:
1. 功能。 如果定义功能,则该字段对于临床用户将变为只读。 例如,BMI(如图所示)将根据用户输入的身高(BMHGHT)和体重(BMWGHT)自动计算。 该值将显示在BMI字段中,并且用户无法对其进行编辑。
要设置功能,请选择功能。 在功能逻辑 (JavaScript)字段中,使用JavaScript输入功能。 有关可以使用的表达式的更多信息,请单击 ? 图标。 将打开一个弹出窗口,显示有关如何引用其他表单字段,特定访视或活动,上下文变量和复选框的信息。
2. 默认值。 第一次打开表单并显示该字段时,初始值将显示在该字段中,但是该值对于临床用户仍然可以编辑。
要设置初始值,请选择初始值。 在初始值或JavaScript表示字段中,输入要设置为初始值的值,或输入JavaScript表达式。
有关JavaScript的更多信息,请参见在Viedoc中使用JavaScript。
请注意!功能和默认值无法在ViedocMe的表单中使用。
字段设置 - 导出
在导出选项卡上,可以设置输出栏ID(OID,1)和输出栏标签(2)。 另请参阅输出和验证。
如果您希望该字段在导出中具有不同于Viedoc中使用的ID和标签的其他ID或标签,则输入输出栏ID和输出栏标签很有用。 更改输出栏ID将使系统中的变量正确无误,因此研究设计中的所有内容仍可在计算上正常运行,但是导出时将显示您希望它具有的ID(请参见下图)。
在导出中更改输出栏ID也可能很有用。在一些系统中,比如SAS,无法处理一些特殊字符比如 < 或者 >,这种时候可以将输出栏标签更改为“小于”,并且可以将标签导入到SAS中而不会出现问题。
复制和删除字段
要复制字段,请单击该字段,然后单击字段设置弹出窗口中的复制栏字段(图像中为 1)。
要删除字段,请单击该字段,然后在字段设置弹出窗口(图像中为 2)中单击删除栏字段。
复制字段时,复制的内容包含为原始字段配置的所有数据检查。 系统将自动按照以下格式为重复项目创建项目ID:ItemID_Copy1,请参见图像。
模板
共享表单模板
除了从头开始创建新表单之外,还可以使用共享模板来创建表单。
使用共享表单模版创建表单
要使用共享模板创建表单,请单击共享模板(图像中的 1)旁边的箭头图标以打开共享模板。 您现在可以编辑并保存表单。 对表单的任何更改都不会影响共享模板。
创建共享模板
通过拖放表单至此,创建新模板,可以从设计中使用的表单之一创建共享模板(图片中的 4)。
该表单将出现在共享模板列表中,并且可以如前所述使用或编辑。 将表单添加到共享模板时,将保留在表单中进行的所有项目设置。
共享模板可用于组织内的所有研究以及组织内有权访问Designer的所有用户。
编辑共享模板
您可以通过单击共享模板(图像中的 2)旁边的编辑(笔)图标来编辑共享模板。共享模板将打开,您可以编辑模板。 这不会影响用作模板基础的原始表单,或基于表单模板创建的任何其他表单实例。
删除共享模板
您可以通过单击共享模板(图像中的 3)旁边的删除(X)图标来删除全局模板。 将会出现一个弹出窗口。 单击删除确认删除共享模板,或单击撤销取消。
共享数据组模板
您还可以使用共享数据组模板创建字段组。 数据组模板在表单页面上可用。
共享数据组模板可用于组织内的所有研究以及组织内有权访问Designer的所有用户。
要将共享数据组模板添加到表单,请单击共享模板(1)旁边的箭头图标。 您现在可以编辑数据组。 对数据组的任何更改都不会影响共享数据组模板。
要删除共享数据组模板,请单击共享模板旁边的删除(X)图标(2)。 将会出现一个弹出窗口。 单击删除确认删除共享模板,或单击撤销取消。
要创建共享数据组模板,请将数据组拖拽至此,创建新模板!(3)。
The pen icon between the arrow and the cross is for renaming the group template. But this did not work at the time of writing this eLearning. Add later once the function is added to Viedoc:
To rename a global item group template, click the pen icon (2) and.
表单示例
本节提供了两个符合CDASH标准格式的示例。
生命体征表单
下图提供了在Viedoc Designer中创建的生命体征表单的示例。
此表单中的数据组设置和字段设置如下:
- 可见条件(可见选项卡)的设置:
- 顶部的两个数据组在带有字段标签30 minutes pre-dose和30 minutes post-dose;
使它们仅在访视2期间(活动PRE30或活动POST 30)可见:
⇒ 高级条件满足为真ActivityDefId == "V2_PRE30"
orActivityDefId == "V2_POST30"
- 字段Date of measurement,两行绿色的字体(Clinically significant findings should be recorded in the Medical History/Adverse Events log)和两个表单底部的包括生命体征结果的数据组
使它们仅在Were vital signs collect? 的回答是Yes 时可见:
⇒ 对简单条件满足为真 VSPERF 是Yes。 - 字段Reason not collected;
使其仅在Were vital signs collect? 是No 时可见
⇒ 对简单条件满足为真 VSPERF是No 。
- 顶部的两个数据组在带有字段标签30 minutes pre-dose和30 minutes post-dose;
- 系统逻辑核查(验证选项卡)的设置:
- 字段Date of measurement,
⇒ 日期不得晚于 当前数据录入日期。
- 字段Date of measurement,
- 数据检查(验证选项卡)的设置:
- 字段Diastolic blood pressure;
确保在此处输入的值低于在Systolic blood pressure字段中输入的值:
⇒ 在限制表示若满足为真中输入:
//L1_VS
if ( ORRES_SYSBP != null && ORRES_DIABP != null && ORRES_DIABP >= ORRES_SYSBP )
return false;
else return true;
⇒ 若为假,则触发Query/错误信息: Diastolic blood pressure is not less than the Systolic blood pressure. Please verify.
- 字段Diastolic blood pressure;
- 功能(功能选项卡)的设置:
- 字段 Body mass index;
根据在此表单的同一实例中输入的体重和在访视E01_SCR 中使用的在此表单实例中输入的身高来计算体重指数:
- 字段 Body mass index;
⇒ function getValue(){
if (StudyEventDefId == "E01_SCR" && ORRES_WEIGHT != null && ORRES_HEIGHT != null)
{
return (ORRES_WEIGHT / ((ORRES_HEIGHT * 0.01) * (ORRES_HEIGHT * 0.01)));
}
else if (StudyEventDefId != "E01_SCR" && ORRES_WEIGHT != null && E01_SCR.VS.ORRES_HEIGHT != null)
{
return (ORRES_WEIGHT / ((E01_SCR.VS.ORRES_HEIGHT * 0.01) * (E01_SCR.VS.ORRES_HEIGHT * 0.01)));
}
else return null;
}
- 初始值(功能选项卡)的设置:
- 字段 Were vital signs collected?;
因此,当临床用户在Viedoc Clinic中打开表单时,默认情况下会填写Yes。
⇒ function getValue(){
return 1;
} - 字段 Date of measurement;
因此,当临床用户在Viedoc Clinic中打开表单时,默认情况下会填写访视日期。
⇒ function getValue(){
return EventDate;
}
- 字段 Were vital signs collected?;
- 导出(导出选项卡)的设置:
- 字段 Height, Weight, Body mass index, Heart rate, Pulse rate, Respiratory rate, Body temperature, Systolic blood pressure 和 Diastolic blood pressure, 带有字段和单位的描述,例如,Temp(C)以原始单位表示。 这些输出字段标签显示在导出中。
病史表单
下图提供了在Viedoc Designer中创建的病史表单的示例。
此表单中的数据组设置和字段设置如下:
- 可见条件(可见选项卡)的设置:
- 字段 End date;
使其仅在 Ongoing? 是 No 时可见。
⇒ 对简单条件满足为真 MHONGO 是 No。
- 字段 End date;
- 系统逻辑核查(验证选项卡)的设置:
- 字段 Start date,⇒ 日期不得晚于 当前数据录入日期。
- 字段 End date, ⇒ 日期不得晚于 当前数据录入日期。
- 功能(功能选项卡)的设置:
- 字段 Sequence number;
获取当前病史表单实例的序列号:
⇒ function getValue(){
return StudyEventRepeatKey;
}
- 字段 Sequence number;
保留字
在命名访视,表单,字段,功能和变量时,需要避免使用许多保留字。否则,可能会发生意外行为甚至错误。 对ID和标签中的最大字符数也有限制。有关更多信息,请参见保留字。