Viedoc数据导入应用

  • Published by Viedoc System 2022-09-09
  • Print

简介

Viedoc提供导入数据的可能性，比如您可通过我们的Viedoc数据导入应用导入实验室数据。 导入时

  1. 能将提供的数据通过数据映射文件转换成符合CDISC ODM格式的临床数据格式。
  2. 导入通过Viedoc API进入Viedoc。

本课将描述如何通过我们的数据导入应用将数据导入Viedoc。包括概述和以下步骤：

  1. 下载在Viedoc Designer中定义的以Define-XML格式存在的数据映射文档。
  2. 在Viedoc Admin中创建API客户端编号。更多信息请参考API配置。
  3. 创建配置文件。
  4. 准备工作文件夹。
  5. 下载Viedoc导入应用。
  6. 将数据拖拽进工作文件夹。
  7. 运行Viedoc导入应用。

更多信息

本课并不包括如何创建Define-XML格式的数据映射文件。若您想要获得该信息，请查看Creating a data mapping for import of data.

更多信息请查看我们的视频教程如何使用Viedoc数据导入应用。

关于将数据导入Viedoc

Viedoc数据导入应用

Viedoc提供导入数据的可能性，比如您可通过我们的Viedoc数据导入应用导入实验室数据

导入时能将提供的数据通过数据映射文件转换成符合CDISC ODM格式的临床数据格式，您需要以下一些文件：

  • 一个数据映射文件，用来将数据“翻译”成CDISC ODM格式，

  • 一个配置文件，

  • 需要导入Viedoc的数据文件。该文件通常来说是CSV格式，其他自由格式的文件若在配置文件中定义，则也可使用。

然后Viedoc数据导入应用就可将CDISC ODM格式的临床数据通过API导入Viedoc。使用时需要：

  • Viedoc用户名，密码和相应的权限。

  • 研究相应的Viedoc API客户端编号。

您可在Viedoc Designer数据映射窗口下载最新的Viedoc数据导入应用。更多信息请看3.6下载Viedoc数据导入应用。

数据映射文件

数据映射文件可以定义如何将外部数据映射到Viedoc中的表单项中。它描述了要导入的数据文件的每一列，以及Viedoc中数据的目的地。

数据映射文件是在Viedoc Designer中的通用设置中创建的。在内部，数据映射以CDISC Define-XML格式存储。对于要导入的每种类型的数据文件，应创建一个单独的数据映射文件。 有关如何创建数据映射文件的说明，

请参见 Creating a data mapping for import of data.

配置文件

配置文件定义以下内容：

  • 数据应导入哪个Viedoc研究，
  • 在哪里找到数据映射文件，
  • 在哪里找到包含应导入数据的数据文件，
  • 数据应导入哪个API实例（v4，v4training，v4jp等），
  • 导入数据时应使用的登录凭据。

必须在配置文件中定义以上信息。 （可选）您也可以使用配置文件来定义以下内容：

  • 当导入的数据包含尚未添加到研究中的受试者时，是否要在数据导入期间自动创建新受试者，
  • 当导入的数据包含尚未启动的访视数据时，是否要在数据导入期间启动访视，
  • 读取导入的文件时，读取导入的文件时应使用哪种字符编码，
  • 解析导入文件时，应使用哪个文件定界符。

配置文件是可以在任何文本编辑器中创建的XML文件。一个配置文件可以包含多个导入项目和研究的导入配置。

若您想要了解更多创建配置文件的信息，请查看3.5创建配置文件和准备工作文件夹。

使用Viedoc数据导入应用导入数据

简介

这部分将教您怎么样使用Viedoc数据导入应用导入数据。

创建数据映射文件

创建映射文件是在Viedoc Designer中完成的，请遵循指南Creating a data mapping for import of data。在数据映射文件中，数据文件的每一列都应映射到Viedoc中的相应表单项。对于每种要导入的数据文件类型，您都需要一个数据映射文件。

映射数据文件中的所有列后，保存数据映射，然后发布通用设计版本设置。

下载数据映射文件

下载数据映射文件（另请参阅eLearning中的数据映射中的说明）：

1 在数据映射中，点击编辑。
2 点击您创建的数据映射后的下载，包括数据映射的XML文件下载完成。

创建Viedoc API客户端编号

请参考API配置。

创建配置文件和准备工作文件夹

在您的电脑中创建文件夹结构

创建文件夹存储配置文件，数据映射文件和需要导入的数据：

  1. 在您的电脑中创建工作文件夹。您可看到有一个工作文件夹叫“helipad”直接创建在C盘中，请查看3.5.3 一个正确的文件夹结构的实例。
  2. 在工作文件夹中，为每个需要导入的项目创建子文件夹，比如“ProjectFolder1”。

  3. 将数据映射文件存储在工作文件夹相应的项目文件夹中。

创建配置文件

创建配置文件：

1

在所选的文本编辑器中，根据以下示例创建XML文件（如有必要，复制并粘贴文本）：

<?xml version="1.0" encoding="utf-8"?>
<ViedocImportConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<BasePath>C:\helipad</BasePath>
<ImportConfiguration>
<FolderName>ProjectFolder1</FolderName>
<DefineXmlFileName>DemoStudy-Datamapping.xml</DefineXmlFileName>
<ApiUrl>https://v4api.viedoc.net/HelipadService.svc</ApiUrl>
<ClientGuid>5091c8d8-dbe8-4119-9caa-0b5cbc747759</ClientGuid>
<UserName>majd@viedoc.net</UserName>
<Password>YourP@ssw0rd</Password>
<AllowCreatingSubjects>true</AllowCreatingSubjects>
<AllowInitiatingStudyEvents>true</AllowInitiatingStudyEvents>
<FileDelimiter>,</FileDelimiter>
<FileEncoding>utf-8</FileEncoding>
</ImportConfiguration>
</ViedocImportConfiguration>
2

编辑XML标记并指定以下信息。

请注意！ 所有的XML标记都是大小写敏感的！

<BasePath> 包含配置文件和不同项目文件夹的工作文件。
在 <ImportConfiguration> 中，定义以下信息：

a) <FolderName>: 映射文件和导入数据文件的工作文件夹。这应该是一个子文件夹。

b) <DefineXmlFileName>: 数据映射文件的名称。

c) <ApiUrl>: 您要将数据导入到其中的Viedoc API实例的URL。 URL的名称如下：应用程序+实例+国家（斯德哥尔摩实例中不使用国家/地区名称）。

所有除了日本的URL:

  • https://v4api.viedoc.net/HelipadService.svc
  • https://v4apitraining.viedoc.net/HelipadService.svc
  • https://v4apistage.viedoc.net/HelipadService.svc

日本的URL:

  • https://v4apijp.viedoc.net/HelipadService.svc
  • https://v4apitrainingjp.viedoc.net/HelipadService.svc
  • https://v4apistagejp.viedoc.net/HelipadService.svc

d) <ClientGuid>: Viedoc API客户端编号。

e) <UserName>: 用来登录Viedoc的用户名。

f) <Password>: 用来登录Viedoc的密码。第一次运行应用后，密码将被加密。

g) <AllowCreatingSubjects>: 设置为true时，如果数据文件包含尚未添加到研究中的受试者，则在导入期间会自动创建新受试者。默认为true。

h) <AllowInitiatingStudyEvents>: 设置为true时，如果数据文件包含尚未启动的访视，则在导入期间会自动启动访视。默认为true。

i) <FileDelimiter>: 设置解析导入文件时使用的定界符。默认值为“，”（逗号）。支持所有可能的符号和制表符作为文件定界符。

j) <FileEncoding>: 指定在解析导入的文件时使用的字符编码类型，有关所有支持的编码的列表，请参阅表2。默认为 utf-8.

请注意 <ClientGuid>， <UserName> 和 <Password> 必须是在Viedoc API实例中定义在 <ApiUrl> 标记中的。

<AllowCreatingSubjects>， <AllowInitiatingStudyEvents>， <FileDelimiter>和<FileEncoding> 标记定义是可选的。如果没有详细说明，应用会选择默认。
3 如果您相应导入多种类型的数据文件，请在每种数据文件中添加新的<ImportConfiguration>然后再在步骤2的XML标记中编辑。
4 将配置文件保存在工作文件夹中。

名称

编码类型
gb2312 中文简体（GB2312）
utf-16 Unicode
unicodeFFFE Unicode （大端序）
Winodws-1252 西欧语言（Windows）
x-mac-korean 韩语（Mac）
x-mac-chinesesimp 中文简体（Mac）
utf-32 Unicode（UTF-32）
utf-32BE Unicode（UTF-32 大端序）
us-ascii US-ASCII
x-cp20936 中文简体（GB2312-80）
x-cp20949 韩国语 Wansung
iso-8859-1 西欧语言（ISO）
iso-8859-8 希伯来语（ISO-Visual）
iso-8859-8-1 希伯来语（ISO-Logical）
iso-2022-jp 日语（JIS）
csISO2022JP 日语（JIS-Allow 1 byte Kana）
iso-2022-jp 日语（JIS-Allow 1 byte Kana- SO/SI）
iso-2022-kr 韩语（ISO）
x-cp50227 中文简体 （ISO-2022）
euc-jp 日语（EUC）
EUC-CN 中文简体（EUC）
euc-kr 韩语（EUC）
hz-gb-2312 中文简体（HZ）
GB18030 中文简体（GB18030）
x-iscii-de ISCII梵文
x-iscii-be ISCII孟加拉语
x-iscii-ta ISCII泰米尔语
x-iscii-te ISCII泰卢固语
x-iscii-as ISCII阿萨姆语
x-iscii-or ISCII奥里亚语
x-iscii-ka ISCII卡纳达语
x-iscii-ma ISCII马拉雅拉姆语
x-iscii-gu ISCII古吉拉特语
x-iscii-pa ISCII旁遮普语
utf-7 Unicode（UTF-7）
utf-8 Unicode（UTF-8）

一个正确的文件夹结构的实例

您可看到有一个工作文件夹叫“helipad”其中包括了工作文件夹命名为ProjectFolder1 和配置文件ViedocImportConfiguration.xml。

需要导入的数据文件也应该存在该文件夹中。

下载Viedoc数据导入应用

若您需要下载并安装Viedoc数据导入应用：

1 在Viedoc Designer中的通用设计版本配置中，在数据映射中点击编辑以打开数据映射窗口。
2 点击下载Viedoc导入应用。您将会下载一个压缩文件。
3 保存文件并解压。

将数据移入工作文件夹

将文件保存在项目文件夹中。

运行Viedoc导入应用

运行Viedoc导入应用：

1 双击应用以运行应用。

当您第一次使用时，您将会看到以下弹窗：
2

点击更多信息，再点击运行。


您将看到以下窗口：
3

输入配置文件的路径，例如：c：\ helipad \ ViedocImportConfiguration.xml，然后按Enter。 该应用程序将数据文件中的数据导入Viedoc，并将数据文件移动到项目文件夹中的存档文件夹中（如果尚未创建，则系统会自动创建存档文件夹）。

运行该应用程序时，它将遍历配置文件中指定的所有项目文件夹，并导入在这些项目文件夹中找到的所有数据文件的数据。如果在特定项目文件夹中找不到数据文件，则将跳过该项目。

导入后，应用程序将自动关闭。

您可以在Viedoc Admin中监视导入状态。为此，请在Viedoc Admin的API配置字段中单击编辑图标，以打开API设置窗口。提交数据历史记录列表显示用于导入的客户端ID，导入的日期和时间以及状态。可以下载数据导入的内容和日志文件。

注意！应用程序参照的路径可以通过更改设置文件的参照来更新。这个设置文件可以通过以下路径找到：C:\Users\USERNAMEHERE\AppData\Local\Viedoc. 同时也需要注意AppData文件夹默认情况下可能是隐藏状态。

导入更多数据

每当您要导入新数据时，请将数据文件保存在相应的项目文件夹中，然后双击Viedoc导入应用 Data Import Application图标再次运行该应用程序。无需指定配置文件的路径，因为应用程序在首次运行时已经存储了该信息。

您可以随时编辑配置文件以添加，编辑或删除导入项目。

关于密码

如果您在配置文件中指定了密码，则Viedoc数据导入应用程序在首次运行该应用程序时会用加密的密码替换该密码。加密的密码保存在配置文件中。

如果未在配置文件中指定密码，则应用程序在启动时会要求您输入密码。

要输入密码，请按Y（是），输入密码，然后按Enter。再次输入密码，然后按Enter。系统会将您的密码作为加密密码保存在配置文件中。

如果按N（否）或15秒钟不按任何键或输入错误的密码，则应用程序将无法登录，也不会导入任何数据。应用将显示为： Error logging in: Invalid userName or password.

如果您更改了Viedoc密码，请用新密码替换配置文件中的旧密码，然后保存配置文件。下次运行Viedoc数据导入应用程序时，将使用新密码登录和导入数据。