ディープ・リンクの生成

統合アプリケーション、ドキュメント、電子メールおよびその他の外部リソースから特定のClinical One Cloud Serviceページおよびサブジェクト・フォームを開くディープ・リンクを作成します。

ディープ・リンクは、特定のClinical One Cloud Serviceページまたはサブジェクト・フォームを直接開くURLです。

スポンサ・ユーザーは、ディープ・リンクURLを作成して、特定の「Study Settings」タブ、「Subject List」ページ、「Query List」ページおよびサブジェクト・フォームを開くことができます。ディープ・リンクは、アクティブ(本番)、テストおよびトレーニング・モード、およびトレーニング・スタディでサポートされています。

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で開きます。使用可能な場合、リンクによって、繰返しフォーム・エントリや繰返しセクション・エントリなど、最も具体的なソース・コンテキストが開きます。
  • この機能が導入される前に入力された詳細な用語については、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
    • 訪問ID
    • フォームID

    formEntry、formInstanceId、sectionEntryおよびsectionInstanceIdを省略するか、これらのパラメータをfalseに設定します。

    繰返しフォーム・エントリ
    URLには、次のパラメータを含める必要があります。
    • フォーム・レベルのパラメータ
    • formEntry=true
    • フォーム・インスタンスID
    繰返しセクション・エントリ URLには、次のパラメータを含める必要があります。
    • フォーム・レベルのパラメータ
    • sectionEntry=true (2セクション・フォームの場合、これは常にtrueである必要があります。)
    • セクション・インスタンスID
    • formInstanceId (セクション・エントリが特定のフォーム・インスタンスに属する場合に含めます。)
  2. ベースURLの取得

    Clinical One Cloud Serviceにサインインし、ブラウザのアドレス・バーからホーム・ページのURLをコピーします。このURLは、すべてのディープ・リンクの作成に使用される{BaseURL}になります。

  3. 次の表を使用して、中カッコ({})で囲まれた各プレースホルダ値を試験に適した値に置き換えます。たとえば、{mode}activeに置き換えると、パラメータはmode=activeになります。

    一部のパラメータ値は、Clinical One Cloud Serviceユーザー・インタフェースから直接使用できません。subjectIdvisitIdformIdなどの値を取得するには、アナリティクス・ユーザー・ガイドデータセットの説明の項を参照するか、REST API for Clinical One Cloud Serviceガイドで適切なAPIを確認してください。

    表4-14パラメータの説明

    ディープ・リンク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ユーザー・インタフェースから取得します。
    isTraining
    トレーニング・スタディのディープ・リンクURLを作成する場合は、次のパラメータを追加します。
    &isTraining=true

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

  4. ディープ・リンクURLの使用

    完成したディープ・リンクURLをコピーし、統合アプリケーション、ドキュメント、電子メールまたはその他の外部リソースで使用します。その後、認可されたユーザーは、ディープ・リンクURLを選択して、指定したClinical One Cloud Serviceページまたはサブジェクト・フォームを開くことができます。

    ディープ・リンクURLが正しく構成されていない場合、それを使用しようとしたユーザーは、Clinical One Cloud Serviceのホーム・ページに移動します。次の問題が発生したかどうかはユーザーに通知されません。
    • URLをタイプ
    • ユーザーは、試験、施設、症例、ビジットまたはフォームにアクセスできません。
    • URLは正しく構成されていますが、1つ以上のIDが正しくありません。