生成深层链接

创建深层链接，以从集成应用程序、文档、电子邮件和其他外部资源打开特定的 Clinical One Cloud Service 页面和主题表单。

深层链接是直接打开特定 Clinical One Cloud Service 页面或主题表单的 URL。

赞助者用户可以创建深层链接 URL，以打开特定的“研究设置”选项卡、“主题列表”页面、“查询列表”页面和主题表单。主动（生产）、测试和培训模式以及培训研究都支持深度链接。

与 Clinical One Cloud Service 集成的应用程序（例如 Oracle Central Coding ）包括可打开最具体可用源上下文的深层链接 URL。例如，使用逐字词的深层链接 URL，将在相关重复表单条目或部分条目可用时打开该信息。
  • Clinical One Cloud Service 会自动为 Oracle Central Coding 生成适当的深层链接 URL。赞助者用户不需要手动创建这些 URL。
  • 在 Oracle Central Coding 中选择逐字词的研究名称链接将在 Clinical One Cloud Service 中打开相应的主题表单。如果可用，该链接将打开最具体的源上下文，例如重复表单条目或重复部分条目。
  • 对于在引入此功能之前输入的逐字词，Oracle Central Coding 中不提供深度链接 URL。

创建深层链接之前

  • 用户必须具有有效的 Clinical One Cloud Service 凭证，并有权访问目标研究、试验机构、受试者、访视和表单。
  • 如果用户尚未具有活动的 Clinical One Cloud Service 会话，则系统会提示用户在打开请求的页面或主题表单之前登录。
  • 如果深度链接 URL 无效，或者用户无权访问请求的资源，则 Clinical One Cloud Service 会将用户重定向到主页。

创建深层链接

  1. 确定深层链接 URL 的类型，以创建并复制下面的适当深层链接 URL 模板。

    表 4-12 按目标排列的深层链接 URL 模板

    深度链接目标 深层链接 URL 模板
    “研究设置”下的常规选项卡 
    {BaseURL}?ojr=clinicalone/settings&mode={mode}&studyId={studyId}
    “研究设置”下的站点和实验室选项卡 
    {BaseURL}?ojr=clinicalone/settings/sites&mode={mode}&studyId={studyId}
    查询列表页 
    {BaseURL}?ojr=clinicalone/runtime/querymanagement&mode={mode}&studyId={studyId}
    主题列表页 
    {BaseURL}?ojr=clinicalone/runtime/subjects&mode={mode}&studyId={studyId}
    主题表单 
    {BaseURL}?ojr=clinicalone/runtime/subjects/dataCapture&mode={mode}&studyId={studyId}&subjectId={subjectId}&visitId={visitId}&eventInstanceNum={eventInstanceNum}&formId={formId}&formEntry={formEntry}&formInstanceId={formInstanceId}&sectionEntry={sectionEntry}&sectionInstanceId={sectionInstanceId}
    主题表单深度链接 URL 需要特定参数，具体取决于您的目标。

    表 4-13 主题表单深层链接 URL 参数

    深度链接类型 必需的 URL 参数
    表单层
    URL 必须包含以下参数：
    • 研究 ID
    • 模式
    • 主题标识
    • 访问 ID
    • 表格标识

    省略 formEntry、formInstanceId、sectionEntry 和 sectionInstanceId，或者将这些参数设置为 false。
    重复表单条目
    URL 必须包含以下参数：
    • 表级参数
    • formEntry=true
    • 表单实例标识
    重复部分条目 URL 必须包含以下参数：
    • 表级参数
    • sectionEntry=true（对于两部分形式，必须始终为 true。）
    • 部分实例标识
    • formInstanceId（包括节条目属于特定表单实例的时间。）
  2. 获取基本 URL

    登录到 Clinical One Cloud Service ，然后从浏览器的地址栏复制主页 URL。此 URL 将成为用于创建所有深层链接的 {BaseURL}。

  3. 使用下表，将括在括号 ({}) 中的每个占位符值替换为适合您的研究的值。例如，将 {mode} 替换为 active ，以便参数变为 mode=active 。

    某些参数值不能直接从 Clinical One Cloud Service 用户界面获得。要获取 subjectId 、 visitId 和 formId 等值，请参阅分析用户指南中的数据集说明部分，或查看 REST API for Clinical One Cloud Service 指南以查找相应的 API。

    表 4-14 参数说明

    深链接 URL 参数 说明
    研究 ID 研究 GUID。要获取此值，请打开研究设置并转至常规选项卡。
    模式

    进入所需的研究模式：活动、测试或培训。对于培训研究，请将模式参数设置为全部。

    主题标识 主题标识符
    访问 ID 访问标识符
    事件实例编号

    访问实例标识符。当目标表单属于重复访视（如未计划的访视或周期）时，需要执行此操作。从 Clinical One Cloud Service 用户界面获取此值。

    从为非重复访问中的表单创建的深层链接 URL 中省略 eventInstanceNum 。

    表格标识 表单标识符
    formEntry 设置为 true 以打开重复表单条目。仅当 sectionEntry 参数设置为 false 或省略时使用。
    表单实例标识 重复表单实例标识符。从 Clinical One Cloud Service 用户界面获取此值。
    部分条目 设置为 true 以打开重复的节条目。仅当 formEntry 参数设置为 false 或省略时使用。
    部分实例标识 重复节实例标识符。从 Clinical One Cloud Service 用户界面获取此值。
    isTraining
    为培训研究创建深层链接 URL 时添加以下参数：
    &isTraining=true

    培训研究是 Clinical One Cloud Service 中的专用学习环境，仅用于培训目的。不要将培训学习与培训模式混淆。

  4. 使用深层链接 URL

    复制已完成的深层链接 URL 并将其用于集成应用程序、文档、电子邮件或其他外部资源。然后，授权用户可以选择深层链接 URL 以打开指定的 Clinical One Cloud Service 页面或主题表单。

    如果构建的深度链接 URL 不正确，则尝试使用该 URL 的用户将转到 Clinical One Cloud Service 的主页。系统不会通知用户遇到了以下哪些问题。
    • 在 URL 中键入
    • 用户无权访问研究、试验机构、主题、访视或表单。
    • URL 构造正确，但一个或多个 ID 不正确。

父主题：配置研究