EDC/CTMS FTP スパーク接続のための設定
スパーク統合を機能させるには、管理者が関連するレコードを設定し、接続をアクティブ化する必要があります。このセットアップには、EDC (CDMS) および CTMS Vault の両方で設定手順が必要です。
前提条件
- ご所属の組織は CTMS (臨床操作) Vault と EDC (CDMS) Vault を有している必要があります。
- ご所属の組織はセット症例ステータスルールを使用する必要があります。
必須権限
Vault 所有者権限を有するユーザは、デフォルトでこれらすべての設定アクションを実行できます。ご利用の Vault がカスタム設定のセキュリティプロファイルを使用して組織内のユーザが管理者エリアにアクセスできるようにするには、次の権限を有する必要があります:
タイプ | 権限 | 制御 |
---|---|---|
セキュリティプロファイル | アプリケーション: 接続を管理する | [管理者] > [接続]の順位アクセスし、接続を確立する能力 |
セキュリティプロファイル | オブジェクト: 治験: 編集, オブジェクト: 治験実施国: 編集, オブジェクト: 国: 編集, オブジェクト: 治験実施施設: 編集 |
治験、治験実施国、国、および治験実施施設オブジェクト内のレコードを編集する能力 |
Vault EDC/CTMS の Spark 接続のレコード
次の標準レコードは、Vault EDC/CTMS スパーク接続で使用するために用意されています:
接続
以下の接続レコードは、管理者 > 接続から使用できます:
- CDMS/Clinical Operations の接続 (
cdms_clinops_connection__v
) は CTMS Vault と EDC Vault 両方で使用できます。
Vault 間接続は使用する前に接続を確立する必要があります。
統合ポイント
CDMS/Clinical Operations の接続レコードには、標準の統合ポイントレコードが CDMS Vault にあり、以下のデフォルトの統合レコードが含まれます:
統合名 | 統合ポイント 名 | 送信元 | 宛先 | データ内容 |
---|---|---|---|---|
CTMS から CDMS への治験データ | 治験転送 | CTMS | EDC |
|
治験実施国転送 | CTMS | EDC |
|
|
治験実施施設転送 | CTMS | EDC |
|
|
CDMS から CTMS への症例データ | 症例転送 | EDC | CTMS |
|
CDMS から CTMS への症例イベントデータ | イベント定義転送 | EDC | CTMS |
|
イベント転送 | EDC | CTMS |
|
|
CDMS から CTMS プロトコールからの逸脱データ | プロトコールからの逸脱転送 | EDC | CTMS |
|
CDMS から CTMS への手続きデータ | 手続き転送 | EDC | CTMS |
|
設定の概要
次のタスクは接続を設定するために要求されます:
- CTMS Vault 内: フィールドとユーザアクションを関連オブジェクトに追加します。詳細はこちらを参照してください.
- EDC Vault 内: 症例ステータスフィールドのセット症例ステータスが存在しない場合は作成します。
- EDC Vault 内: Create or update the 治験状況および施設状況参照関係を必要に応じて作成または更新します。
- CTMS と EDC Vault の両方で、オブジェクトとオブジェクトフィールド参照関係をマッピングし、既存のレコードを接続します。
- 両方の Vault の接続を確立します。
CTMS Vault の設定については、こちらで説明を確認できます。
治験実施状況と施設状況の参照関係を設定する
EDC では、以下のフィールドに参照関係があります:
- 治験 > 治験ステータス: CTMS の治験ライフサイクルは、EDC の治験ステータス選択リスト値にマッピングします。
- 施設 > 施設ステータス: CTMS の施設ライフサイクル状態は、EDC の治験ステータス選択リスト値にマッピングします。
CTMS Vault にカスタム治験または施設ライフサイクル状態がある場合、EDC Vault にさらに参照関係を追加してください。
- EDC Vault で、管理者 > 接続 > CDMS から CTMS への接続 > 参照関係に進みます。
study_status__v
またはsite_status__v
参照関係を選択します。- 追加をクリックします。
- ソースキーの場合は、CTMS Vault からカスタムライフサイクル状態の名前を入力します。
- EDC 内で適切なターゲットキーを選択します。これはカスタム設定のライフサイクル状態に関連付ける治験状況です。
- 保存をクリックします。
- CTMS のすべてのカスタム治験または施設ライフサイクル状態にこれらの手順を繰り返します。
開発の相の参照関係を設定する
臨床操作の各開発の相は、EDC の開発の相にマッピングされる必要があります。開発の相は EDC 内のシステム設定のフィールドと CTMS 臨床操作内のカスタムフィールドであるため、このマッピングは手動で設定される必要があります:
- EDC Vault で、管理者 > 接続 > CDMS から CTMS への接続 > 参照関係に進みます。
- study_phase__v 参照関係を選択します。
- テンプレートのエクスポートをクリックします。
- エディタでエクスポートした CSV ファイルを開きます。
- CTMS Vault で、管理者 > 企業管理者 > 選択リストに進み、開発の相の選択リストをクリックします。
-
ソース名 (選択リスト値ラベル) とソースキー (選択リスト値名) を CSV ファイルにコピーアンドペーストします。CTMS Vault の選択リスト値ラベルと選択リスト値名が、EDC Vault の選択リスト値ラベルと選択リスト値名と一致することを確認します。CTMS の複数の項目を EDC の 1 つの項目にマッピングさせることができます。必要に応じて EDC にカスタム選択リスト値を追加することができます。エラーを防ぐため、CTMS Vault の選択リスト値ごとにマッピングする必要があります。結果として生じる CSV ファイルは次の例のように見えることがあります:
- エディタで CSV ファイルを保存します。
- EDC Vault で、管理者 > 接続 > CDMS/Clinial Operations 接続 > 参照関係に進み、
study_phase__v
参照関係に参照関係テンプレートを読み込みます。
国オブジェクトのマッピング
国オブェクトレコードは、治験実施国オブジェクトレコードを作成するために、EDC と CTMS 間にマッピングされる必要があります:
- CTMS Vault と EDC Vault 両方で、Vault ローダを使用して国オブジェクトレコードをエクスポートします。編集不可フィールドを含めるチェックボックスを選択するようにしてください。
- 結果として作成された CSV ファイルをエディタで開きます。
- 入力用スプレッドシートファイルで
VLOOKUP
関数を使用して、EDC の適切なリンクフィールドに CTMS のグローバル ID フィールドの値を入力します。VLOOKUP
関数の使用に関する詳細情報は、お使いのスプレッドシートエディタのマニュアルをご覧ください。 VLOOKUP
関数で国が自動的に解決されない場合、入力用スプレッドシートに追加します。1 つの Vault に存在するが他の Vault には存在しない国は、他の Vault で作成およびマッピングする必要があります。ID
とlink__sys
の列に入力したファイルを保存します。- EDC Vault に CSV ファイルを読み込みます。
既存レコードデータの接続
この Spark メッセージ接続の実装前の設定によって、Vault のバージョンごとに異なるデータがある場合があります。このセクションでは、それぞれの状況で行うことについて説明します。
このセクションに記載されるすべての手順は、CTMS Vault の Vault CDMS への接続、または EDC Vault の Vault Clinical Operations への接続を“はい”に設定する前に完了させる必要があります。
あなたの状態に最も一致する状況を見つけ、クリックして展開し、手順に従ってください。
- EDC で治験を手動で作成し、CTMS のその治験のグローバル ID を EDC のその治験のリンクフィールドに追加します。
- CTMS の Vault CDMS への接続フィールドを“はい”に設定します。
- Spark メッセージ接続は、CTMS のデータで EDC の治験を更新し、その治験に関する CTMS データの治験実施国と施設をすべて作成します。
- 治験ごとに、CTMS のグローバル ID を取得し、その値を EDC で対応する治験のリンクフィールドにコピーします。
- 治験実施国ごとに、CTMS のグローバル ID を取得し、その値を EDC で対応する治験実施国のリンクフィールドにコピーします。
- 施設ごとに、CTMS のグローバル ID を取得し、その値を EDC で対応する施設のリンクフィールドにコピーします。
- CTMS の Vault CDMS への接続フィールドを“はい”に設定します。
- Spark メッセージ接続は、EDC の治験、治験実施国、および施設を CTMS のデータで更新します
- これらのステップは EDC 内の Vault ローダでのみ実行可能であることにも注意してください。
- CTMS で EDC からすべての治験、治験実施国、および施設を作成します。
- 治験ごとに、CTMS のグローバル ID を取得し、その値を EDC でその治験のリンクフィールドにコピーします。
- 治験実施国ごとに、CTMS のグローバル ID を取得し、その値を EDC でその治験実施国のリンクフィールドにコピーします。
- 施設ごとに、CTMS のグローバル ID を取得し、その値を EDC でその施設のリンクフィールドにコピーします。
- CTMS の Vault CDMS への接続フィールドを“はい”に設定します。
- Spark メッセージ接続は、EDC の治験、治験実施国、および施設を CTMS のデータで更新します。
- これらのステップは EDC 内の Vault ローダでのみ実行可能であることにも注意してください。
- これはこの Spark メッセージ接続に有効なケースではなく、この情報は外部 EDC システムからプルされた可能性があります。
- 治験、治験実施国、および施設が前の設定セクションで説明した手順に従い CTMS に接続されることを確認してください。
- 被験者ごとに、EDC のグローバル ID を取得し、その値を CTMS で対応する被験者のリンクフィールドにコピーします。
- イベントごとに、EDC のグローバル ID を取得し、その値を CTMS で対応する被験者来院のリンクフィールドにコピーします。
- イベント定義の最新バージョンの場合、CTMS のプライベートキーを取得し、その値を EDC でその来院定義のリンクフィールドにコピーします。
- EDC の Vault CDMS への接続フィールドを“はい”に設定します。
- Spark メッセージ接続は、CTMS の被験者、被験者来院、および来院定義を EDC のデータで更新します。
- これらのステップは CTMS 内の Vault ローダでのみ実行可能であることにも注意してください。
- 治験、治験実施国、および施設が前の設定セクションで説明した手順に従い CTMS に接続されることを確認してください。
- CTMS の Vault CDMS への接続フィールドを“はい”に設定します。
- Spark メッセージ接続は、CTMS の被験者、被験者来院、および来院定義を EDC のデータで更新します。
統合ポイントの設定
プロトコール逸脱統合ポイントの設定
プロトコールからの逸脱データを EDC から CTMS Vault 内の接続された治験に送信するように EDC Vault を設定できます。この機能が有効になっていると、Vault はプロトコールからの逸脱を EDC から CTMS に転送し、CTMS 内でプロトコールからの逸脱を作成します。
これは一方向接続です。EDC はプロトコールからの逸脱を CTMS に送信しますが、CTMS はプロトコールからの逸脱用に一切のデータを EDC に送信しません。変更されたプロトコールからの逸脱または CTMS で作成されたプロトコールからの逸脱のいずれかを対象とします。
この統合を設定するには、CTMS Vault 内で次のアクション実行してください:
- カテゴリと重要度に対応するように選択リスト値を作成する。
- PD PV サブカテゴリオブジェクトから、サブカテゴリをカテゴリにマッピングする。
- カテゴリ、サブカテゴリ、および重要度の参照関係を追加します。
選択リスト値を作成する
カテゴリと重要度に対応するように選択リスト値を作成するには:
- CTMS Vault 内で、[管理者] > [企業管理者] > [選択リスト]の順に移動します。
- プロトコールからの逸脱 / 違反カテゴリ または プロトコール違反 / 逸脱重要度選択リストのいずれかを選択します。両方の選択リストに対してこれらの手順を実行する必要があります。
- 編集をクリックします。
- それぞれのカテゴリまたは重要度に対して:
- 選択リスト値ラベルを入力します。これは、スタジオで作成したカテゴリまたは重要度のラベルです。
- 選択リスト値名を入力します。これは、スタジオで作成したカテゴリまたは重要度の名前です。
- 保存をクリックします。
サブカテゴリをカテゴリにマッピングする
プロトコールからの逸脱サブカテゴリオブジェクトから、サブカテゴリをカテゴリにマッピングするには:
- CTMS Vault 内で、[管理者] > [企業管理者] > [PD PV サブカテゴリ]の順に移動します。
- + 作成をクリックします。
- PD PV サブカテゴリの場合は、EDC からサブカテゴリのラベルを入力します。
- カテゴリを選択してサブカテゴリと一致させます。このフィールドのオプションは、プロトコールからの逸脱 / 違反カテゴリ選択リスト内で作成した選択リスト値です。
- 保存をクリックします。
- サブカテゴリごとに手順 2-5 を繰り返します。
参照関係を追加
カテゴリ (in category_pdv__ctms)、サブカテゴリ (in pd_pv_subcategory__ctms)、および重要度 (in severity_pdv__ctms) の参照関係を作成できるようになりました。
参照関係を追加するには:
- CTMS Vault で、管理者 > 接続 > CDMS/臨床操作接続に進みます。
- 参照関係をクリックしてそのセクションを展開します。
- category_pdv__ctms、pd_pv_subcategory__ctms、またはseverity_pdv__ctmsの参照関係ターゲットオブジェクトがすでに存在する場合は、それをクリックして開きます。存在しない場合は[+ 追加]を追加します。
- 手順3に新しい参照関係ターゲットオブジェクトを追加した場合、[参照関係]ダイアログ内で次のオプションを選択します:
- category_pdv__ctms:
- 参照関係タイプ: 選択リスト
- ターゲットオブジェクト: プロトコールからの逸脱 / 違反カテゴリ
- pd_pv_subcategory__ctms:
- 参照関係タイプ: オブジェクト
- ターゲットオブジェクト: プロトコールからの逸脱 / サブカテゴリ
- severity_pdv__ctms:
- 参照関係タイプ: 選択リスト
- ターゲットオブジェクト: プロトコール違反 / 逸脱重要度
- category_pdv__ctms:
- + 追加をクリックします。
- ソースキーの場合は、スタジオでの入力通りに、カテゴリ、サブカテゴリ、または重要度の名前 (完全一致、大文字・小文字を区別する) を入力します。
- ターゲットキーの場合:
- category_pdv__ctms (カテゴリ) と severity_pdv__ctms (重要度) に対して、選択リスト値名を入力します。
- pd_pv_subcategory__ctms (サブカテゴリ) に対して、プロトコールからの逸脱サブカテゴリレコードの名前を入力します。
- 保存をクリックします。
- すべてのカテゴリ、サブカテゴリ、重大度に参照関係を追加するまで、上記のステップを繰り返します。
統合をアクティブ化する
プロトコールからの逸脱統合をアクティブ化するには:
- EDC Vault で、管理者 > 接続 > CDMS から CTMS への接続の順に進みます。
- 統合をクリックしてそのセクションを展開します。
- リスト内で、クリックして CDMS から CTMS プロトコールからの逸脱データを開きます。
- 編集をクリックします。
- ステータスに対して、[アクティブ]を選択して統合をアクティブ化します。
- 保存をクリックします。
接続を確立する
両方の Vaults で必要な設定を完了したら、接続を確立 (アクティブ化) できます。接続が確立されると、Vault EDC と Vault CTMS がデータ共有を開始します。
接続を確立するには:
- EDC Vault で、管理者 > 接続 > CDMS から CTMS への接続の順に進みます。
- アクションメニューから、接続ファイルのダウンロードを選択します。
- 接続ファイルのダウンロードダイアログ内で、ダウンロードをクリックします。
- CTMS vault で、管理者 > 接続 > CDMS から CTMS への接続の順に進みます。
- アクションメニューから、ファイルから接続を選択します。
- [選択]をクリックし、手順 3 でダウンロードした接続ファイルを選択します。
- 続行をクリックします。
- 接続ファイルにリモート Vault ID が含まれる場合は、これで接続が確立されます。これで両方の接続レコードの状態がアクティブになります。
- 任意の作業: 構成ファイルにリモート Vault ID が含まれない場合は、両方 Vault に承認ワークフローが開始されます。各 Vault の接続 レコードに移動し、[完了]をクリックします。
- 任意の作業: 表示されるダイアログで、接続の承認を選択します。これで接続レコードの状態が承認済みになります。両方の Vault が接続を承認すると、両方のレコードがアクティブの状態に移動し、接続が確立されます。