ディープ・リンクを使用した症例フォームのオープン

ユーザーは、Clinical One Cloud Serviceで特定のサブジェクト・フォームを開くためのディープ・リンクを作成できるようになりました。

以前のリリースでは、Clinical One Cloud Serviceの特定のページを開くためのディープ・リンクが導入されました。これには、「Study Settings」タブ、「Subject List」ページ、「Query List」ページなどがあります。詳細は、必要なページに直接Open Clinical One Cloud Serviceおよび新しいディープ・リンク・ページを参照してください。

リリース26.3では、サブジェクト・フォームへのディープ・リンクが拡張されています。特定のサブジェクト・フォームを直接開くディープ・リンクURLを作成できるようになりました。該当する場合、ディープ・リンクURLでは、特定の繰返しフォーム・エントリおよび繰返しセクション・エントリを開くこともできます。

スポンサ・ユーザーの詳細

スポンサ・ユーザーは、特定のサブジェクト・フォームを開くためのディープ・リンクURLを作成できるようになりました。ディープ・リンクは、アクティブ(本番)、テストおよびトレーニング・スタディ・モード、およびトレーニング・スタディでサポートされています。

注意:

トレーニング・スタディは、トレーニング目的にのみ使用されるClinical One Cloud Service専用のスタディ環境です。ディープ・リンクURLを作成するときに、トレーニング・スタディをトレーニング・モードと混同しないでください。
次のサブジェクト・フォーム・タイプおよびナビゲーション・ターゲットに対してディープ・リンクURLを作成できます。
  • 1セクション・フォーム
  • 2セクション・フォーム
  • ラボフォーム
  • 繰返しフォーム・インスタンス
  • 繰返しセクション・インスタンス

詳細は、評価環境のアップグレード後に「スポンサおよびCROユーザー・ガイド」の「ディープ・リンクの生成」を参照してください。

ディープ・リンクURLを作成するには:
  • 作成するディープ・リンクURLのタイプを決定します。次の表を使用して、必要なURLパラメータを識別します。

    表1-1サブジェクト・フォームのディープ・リンクURLパラメータ

    ディープ・リンクのタイプ 必須URLパラメータ
    フォーム・レベル
    URLには、次のパラメータを含める必要があります。
    • 試験ID
    • モード
    • サブジェクトID
    • 訪問ID
    • フォームID

    formEntry、formInstanceId、sectionEntryおよびsectionInstanceIdを省略するか、これらのパラメータをfalseに設定します。
    繰返しフォーム・エントリ
    URLには、次のパラメータを含める必要があります。
    • フォーム・レベルのパラメータ
    • formEntry=true
    • フォーム・インスタンスID
    繰返しセクション・エントリ URLには、次のパラメータを含める必要があります。
    • フォーム・レベルのパラメータ
    • sectionEntry=true (2セクション・フォームの場合、これは常にtrueである必要があります。)
    • セクション・インスタンスID
    • 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。この値を取得するには、試験設定を開くと、「一般」タブに移動します。
    モード

    目的の試験モード(アクティブ、テストまたはトレーニング)を入力します。トレーニング・スタディの場合、modeパラメータをallに設定します。

    サブジェクトID サブジェクト識別子
    訪問ID ビジットID
    eventInstanceNum

    インスタンス識別子にアクセスしてください。これは、ターゲット・フォームが繰返しビジット(未スケジュール・ビジットやサイクルなど)に属する場合に必要です。この値は、Clinical One Cloud Serviceユーザー・インタフェースから取得します。

    非繰返しビジットでフォーム用に作成されたディープ・リンクURLからeventInstanceNumを省略します。

    フォームID フォーム識別子
    フォーム入力 繰返しフォーム・エントリを開くには、trueに設定します。sectionEntryパラメータが falseに設定されているか、省略されている場合にのみ使用します。
    フォーム・インスタンスID 繰返しフォーム・インスタンス識別子。Clinical One Cloud Serviceユーザー・インタフェースで使用できます。
    セクション入力 繰返しセクション・エントリを開くには、trueに設定します。formEntryパラメータがfalseに設定されているか、省略されている場合にのみ使用します。
    セクション・インスタンスID 繰返しセクション・インスタンス識別子。Clinical One Cloud Serviceユーザー・インタフェースで使用できます。
    トレーニング
    トレーニング・スタディのディープ・リンクURLを作成する場合は、次のパラメータを追加します。
    &isTraining=true

    トレーニング・スタディは、トレーニング目的にのみ使用されるClinical One Cloud Service専用のスタディ環境です。トレーニング・スタディをトレーニング・モードと混同しないでください。

試験ユーザーの詳細

試験ユーザーは、ディープ・リンクURLを使用して特定の症例フォームを開くことができるようになりました。ユーザーがディープ・リンクURLを選択すると、Clinical One Cloud Serviceは、リクエストされたサブジェクト・フォームを開く前にユーザーを認証および認可します。ディープ・リンクURLはナビゲーションにのみ使用され、サブジェクト・データを作成、更新または削除しません。
  • ディープ・リンクURLを使用するには、ユーザーに有効なClinical One Cloud Service資格証明が必要です。
  • ユーザーがすでにアクティブな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で「Study」名のリンクを選択すると、対応するサブジェクト・フォームがClinical One Cloud Serviceで開きます。使用可能な場合、リンクによって、繰返しフォーム・エントリや繰返しセクション・エントリなど、最も具体的なソース・コンテキストが開きます。
  • ディープ・リンクURLは、この機能が導入された後に入力された新しい用語または更新された用語に対してのみ使用できます。既存の冗長用語は、ディープ・リンクURLで更新されません。

親トピック: ユーザー・エクスペリエンス