使用深层链接打开主题表单

现在，用户可以在 Clinical One Cloud Service 中创建用于打开特定主题表单的深层链接。

以前的版本引入了用于在 Clinical One Cloud Service 中打开特定页面的深层链接，包括“研究设置”选项卡、“主题列表”页面和“查询列表”页面。有关详细信息，请参阅将 Clinical One Cloud Service 直接打开到所需的页面和新建深层链接页面。

发行版 26.3 扩展了与主题表单的深度链接。现在，您可以创建直接打开特定主题表单的深层链接 URL。如果适用，深层链接 URL 也可以打开特定的重复表单条目和重复部分条目。

赞助商用户的详细资料

赞助商用户现在可以创建深层链接 URL 以打开特定主题表单。主动（生产）、测试和培训学习模式以及培训研究都支持深度链接。

注：

培训研究是 Clinical One Cloud Service 中的专用学习环境，仅用于培训目的。创建深层链接 URL 时，不要将培训研究与培训模式混淆。
您可以为以下主题表单类型和导航目标创建深层链接 URL：
  • 一部分表单
  • 两部分表单
  • 实验室表单
  • 重复表单实例
  • 重复节实例

有关更多信息，请参见 Generate deep links in the Sponsor and CRO User Guide after the assessment environment is upgrade。

要创建深层链接 URL：
  • 确定要创建的深层链接 URL 的类型。使用下表标识所需的 URL 参数。

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

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

    省略 formEntry、formInstanceId、sectionEntry 和 sectionInstanceId，或者将这些参数设置为 false。
    重复表单条目
    URL 必须包含以下参数：
    • 表级参数
    • formEntry=true
    • 表单实例标识
    重复部分条目 URL 必须包含以下参数：
    • 表级参数
    • sectionEntry=true（对于两部分形式，必须始终为 true。）
    • 部分实例标识
    • formInstanceId（包括节条目属于特定表单实例的时间。）
  • 登录到 Clinical One Cloud Service 并复制主页 URL。此 URL 将成为用于创建深层链接 URL 的 {BaseURL}。

  • 复制以下主题表单深链接 URL 模板，并将 {BaseURL} 替换为主页 URL。然后，使用下表，将括在括号 ({}) 中的每个占位符值替换为适合您的研究的值。例如，将 {mode} 替换为 active ，使参数变为 mode=active 。

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

    表 1-2 参数说明

    深链接 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 用户界面中使用。
    is 培训
    为培训研究创建深层链接 URL 时添加以下参数：
    &isTraining=true

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

研究用户的详细信息

研究用户现在可以使用深层链接 URL 打开特定的主题表单。当用户选择深层链接 URL 时， Clinical One Cloud Service 将在打开请求的主题表单之前验证并授权用户。深层链接 URL 仅用于导航，不创建、更新或删除主题数据。
  • 用户必须具有有效的 Clinical One Cloud Service 身份证明才能使用深层链接 URL。
  • 如果用户已具有活动的 Clinical One Cloud Service 会话，则直接打开请求的表单。否则，系统会提示用户登录。
  • 仅当用户有权访问研究、试验机构、受试者、访视和表单时， Clinical One Cloud Service 才会打开请求的表单。
  • 如果深度链接 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 中打开相应的主题表单。如果可用，该链接将打开最具体的源上下文，例如重复表单条目或重复部分条目。
  • 深层链接 URL 仅可用于在引入此功能后输入的新或更新的逐字词。不使用深层链接 URL 更新现有逐字记录术语。

父主题：用户体验