输出和验证
简介
输出和验证部分总结了在Viedoc Designer中执行的一些字段设置,并提供了更好的概述和更轻松的方法来更新这些设置。
可以查看和编辑以下内容:
逻辑检查
编辑检查表显示每个表单中研究中定义的所有数据检查和系统检查。 逻辑检查将验证输入到表单中的数据是否在True Expression下指定的特定范围内。 配置表单和字段时,可以在Viedoc Designer中定义逻辑检查。 有关在表单中配置编辑检查的详细信息,请参见创建和编辑表单。
现有的逻辑检查按表单分组,并且为每个配置的逻辑检查提供以下信息:
1. 序号。每张表单均以1开头。 将鼠标悬停在表格中的序号上会显示OID。 逻辑核查的ID具有以下结构:RC_FieldItemOID_Version-number_Revision-number_Counter,并定义它属于表单中的哪个字段,以及输入逻辑检查的设计版本和修订版本。 将逻辑检查导出到Excel时,OID列在下Range Check OID列中。
2. 逻辑检查所属变量的ID。
3. 逻辑检查所属变量的标签。
4. 真实表述 - 逻辑检查的表述。请参考在Viedoc中使用JavaScript。
5. 质疑信息 - 将在Viedoc Clinic中为中心用户显示的消息。
6. 允许表格保存 - 是/否,取决于是否要保存表单。 如果设置为“是”,并且表单中保存了导致触发编辑检查的数据,则将在Viedoc Clinic中的相应字段上进行查询。
7. 展开/收起 - 用于展开/收起表单中的编辑检查。
系统检查是只读的。 它们显示在列表中,但无法编辑或删除。
通过单击导出到Excel,可以将所有定义的逻辑检查导出到Excel。
通过单击笔图标并编辑相应的字段,可以编辑现有的逻辑检查:
该表中明确指出了逻辑检查定义(真表达式)中的任何错误:
格式
格式页面使您能够准备更多代码列表字段正在使用的通用格式,即,允许您为具有相同选项的所有字段设置一种格式名称。
Viedoc中的代码列表项是具有输入数据时可以填写的可能值的代码列表的字段。有以下几种:
- 单选按钮
- 复选框
- 下拉框
例如,当许多单选按钮字段具有相同的代码列表值和文本(例如,是/否)时,默认情况下,为每个字段分配一个格式名称,但是在这里您可以设置所有这些项目使用的通用格式。
这在导出SAS时特别有用,因为在使用报表和表中的字段时需要指定格式名称。
在设置格式之前
例如,如果我们定义了以下表单,其中四个单选按钮项具有相同的选择(是/否)。
在格式部分中,每个字段都有相同的代码列表显示文本(是/否)和代码列表值(0/1)。
在ODM导出中的有代码列表的字段
在上面的示例中为字段应用通用格式名称之前,这些项目将在ODM导出中的表示,如下所示,每个字段都使用CodeListRef
而显示为不同的代码列表:
每个CodeList
包括CodedValue
并显示文本:
在CSV/Excel导出中的有代码列表的字段
输入数据并将其导出为CSV时,将创建两个其他文件。 当导出为Excel时,将创建另外两个工作表。 这些是:
- Items - 在导出范围内包括有关所有可用字段的信息(包括元数据信息,例如SubjectId,EventId等),不包括静态文本字段和分节符。
- CodeLists - 包括有关具有代码列表的字段的信息,即单选按钮,下拉框和复选框。
在我们的示例中,在设置格式之前,字段表如下所示:
带有代码列表的项目在代码的后面附加有ID为“ CD”的另一行。 在这种情况下,我们只有单选按钮,但是如果包含复选框和/或下拉框,则代码中还会有带有“ CD”的其他行。
每个代码的默认格式名称(即在应用任何格式之前)为CL_ItemIDF。在我们的示例中,在设置格式之前,CodeLists表如下所示:
每个引用的格式名称都包含有关每个代码值的信息。 在这种情况下,只有“是”为“ 1”,“否”为“ 0”。
因为我们在IE表单中有四个单独的单选按钮,所以我们有四个独特的格式,每个格式都有两个不同的值。
SAS指令文件
在选中包括相关的SAS指令选项的情况下进行CSV导出时,将所有表单保存在单独的文件中,并且“ _CodeLists”和“ _Items”具有上面简要介绍的内容。(请参阅导出SAS)
此外,还包括SAS文件CSV2SAS和_RunMe。
_RunMe文件非常小,这是用于将数据导入SAS的文件,即此脚本已在SAS中打开并运行。 其工作是找到要导入文件的路径,并使用在CSV2SAS中的 doWork
功能(宏):
CSV2SAS脚本中与格式相关的基本部分位于第306行,其中代码列表文件的内容传递到CreateSasFormats
宏,该宏接收内容并创建格式。
之后,读取Items文件中的Items元数据,并将格式应用于SAS中的适用字段。
在SAS中,以上示例将为IE表单创建四种格式:
设置格式名称
要在研究设计设置>输出和验证>格式下的Viedoc Designer中设置格式名称,请在四个名称之一的格式名称栏中键入格式名称。 该字段将出现在上方的表格中,带有格式名称的字段,如下图所示。
定义格式名称后,所有具有完全相同设置(代码列表名称和值)的字段都将被标记,您可以通过单击链接为这些名称提供相同的格式名称,如图所示。
由于此方法主要用于SAS,因此Viedoc会检查格式名称是否符合SAS要求,如下所示:
- 必须唯一
- 不可超过8个字符
- 第一个字符必须以英文字母(A-Z,a-z)或下划线开头
- 不可有空格
- 除下划线外,不能包含任何特殊字符
- 它必须以英文字母(A-Z,a-z)结尾
如果不满足以上任何条件,将显示错误消息:
单击导出到Excel可以将所有格式导出到Excel。
注意!代码列表值在导出以下格式时,将不包含前导零:
- CSV
- Excel
- Audit log (每个值占一行,包括历史记录)
- ODM
例如,代码列表值为001将会在导出中显示为1。
在设置格式后
在ODM导出中的有代码列表的字段
在我们的示例中为所有四个项目应用通用格式名称(YESNO)之后,这些项目在ODM导出输出中表示,如下所示,每个项目都使用CodeListRef
指向相同的代码列表:
我们定义的格式已添加到 CodeList
:
在CSV/Excel导出中的有代码列表的字段
在我们的示例中,设置格式之后,查看Items信息,唯一的区别是格式名称已更改为“ YESNO”,即所有四个字段都有一种通用格式:
在我们的示例中,设置格式后,CodeLists表如下所示:
SAS格式
在Viedoc Designer中应用格式后,导入SAS仅创建一种格式:
修改格式类型
也可以更改输出导出值以及格式类型(整数/字符串)。
如果在我们的示例中,将输出导出值更改为文本值,则必须将格式类型更改为字符串:
此操作不会更改ODM xml文件中字段的内容:
......但是定义的输出导出值已添加到Alias
部分中:
Excel文件中的Items表现在显示为“字符串”作为代码的数据类型,并且内容长度有所不同,因为新代码现在为“是!”。 (长度= 4)和“否!”(长度= 3):
Excel文件中的CodeLists表现在具有新Code Value的:
因此,我们可以说,结果是,导出输出中的原始Code Value替换为输出导出值中设置的新值(在我们的示例中,“ 0”和“ 1”被替换为“ NO!”, 分别为“是!”)。
输出ID和标签
此页面使您能够修正和修改输出ID和标签,而不会影响现有的可见性条件,功能和/或数据检查(因为它们使用栏ID)。
蓝色单元格是可编辑的。 确保您的研究设置了唯一且相关的输出栏ID,并且所有输出标签都不太长,并且正确描述了该字段。
请注意!不允许具有与栏ID相同的输出栏标签。 在那种情况下,Viedoc会将输出输出栏标签更改为栏标签。
这在不同的情况下可能很有用,例如:
- 当字段在设计中没有问题文本时。
- 当问题文本很长并且您想将其缩短以导出输出时。
- 您想要一个更具描述性的标签。
列表中的项(字段)按数据组分组,然后按该组中的字段顺序排序。 例如,对于以下表单:
OID和栏标签如下所示:
您可以通过单击导出至Excel将所有字段导出到Excel。
在我们的例子中( 在格式中),如果我们将第一项(IE01)的输出栏标签设置为“Inclusion 01”:
...与在表单>字段设置>导出下设置输出栏标签相同:
结果,在ODM xml文件中,我们可以看到两个附加内容:SASFieldName
和一个新的Alias
:
当设计中存在此类alias和/或SASFieldName
时,生成的导出将使用此标签和ID,而不是问题文本和字段ID导出的数据。
例如 Excel将这些显示为:
在SAS中,这显示为: