治験のデプロイ
治験設計の作成後、それを展開します。設計は、開発環境から TST 環境やトレーニング環境に、または TST 環境から本番環境にデプロイできます。
前提条件
標準のCDMS 展開管理者の治験ロールを持つユーザは、デフォルトで展開を開始することができます。CDMS リードデータマネージャまたはEDC リードデータマネージャの治験ロールを持つユーザは、デフォルトで修正を実行することができます。
タイプ | 権限ラベル | 制御 |
---|---|---|
標準タブ | EDC ツールタブ | EDC ツールタブへのアクセス権限 |
機能権限 | 展開の管理 | EDC ツールから治験環境の作成と管理、治験の展開、ツール > システムツールから Vault レベルの設定の管理と展開、CDB でリスト、チェック、ビューを管理および展開する権限 |
治験に制限付きデータが含まれている場合、それを閲覧するには制限ありデータアクセス権限が必要です。
治験ロールについて詳しくご確認ください。
展開の要件
治験を展開する前に、次の条件を満たす必要があります:
- 新しいケースブックバージョンに、これらの変更不可が含まれていないこと。
- ケースブック定義が、エラーなしで発行の検証に合格していること。
- ソース環境での設計のテストがすべて終了していること。
- ターゲット環境のステータスが展開中または削除済みではないこと。
展開パッケージに含まれるコンポーネント
次の表に、展開パッケージに含まれるコンポーネントを示します:
レコード | 含まれる |
---|---|
治験オブジェクト & スケジュール | はい |
署名定義 | はい |
治験設定 (Studio の治験設定) | はい |
ルール | はい |
レビュープラン | はい |
ビュー & ビューセット | はい |
注釈 | はい |
コーダツール - 治験設定 | はい |
コーダツール - 同義語、リスト名を自動コード化しない | はい |
コーディング設定 | はい |
カスタムユーザの治験ロール | はい |
カスタムオブジェクト | はい |
インテグレーション設定 (Studio での管理時) | はい |
治験実施データ | いいえ |
治験設定 | いいえ |
治験ユーザ | いいえ |
安全性情報の配布実施国 | いいえ |
安全性情報の配布実施施設 | いいえ |
展開に含まれないもの
次の構成レコードは展開に含まれません。以下は環境ごとに再設定する必要があります:
- 以下を含むシステムツール設定:
- カスタム変更理由設定レコード
- カスタムレポートとカスタムダッシュボード
- 以下を含むコーダツール設定:
- 同義語リスト
- リストを自動コード化しない
- 以下を含むEDCツール設定:
- 評価用ロールの割り当て
- レビュープラン割り当て基準
- FTP 設定
- メール通知グループ内のユーザ
- 手順の統合設定
- カスタム Java SDK 設定 (カスタムトリガーなど)
カスタム Vault オブジェクト設定を展開するには、それらのオブジェクトを展開リストに追加する必要があります。詳細については、デプロイメントリストにカスタム構成レコードを追加するを参照してください。
破壊的な変更を含む展開に関する警告
Vault では、破壊的な変更を含む展開が可能ですが、これらのバージョンでは修正プロセスが停止する可能性があります。破壊的な変更とは、治験スケジュールからイベントグループ、イベント、フォーム、品目グループ、または品目を削除すること、またはこれらのレコードの 1 つをスケジュール内のある場所から別の場所に移動することを指します (詳細については、ケースブックのバージョンと改訂の管理を参照してください)。
展開が失敗する原因
次のシナリオでは、展開が失敗します:
既存のフォームでのコーディング設定の変更
フォームのコーディング設定への変更が含まれており、そのフォームに対する既存のコードリクエストがターゲット環境に存在する場合、展開は失敗します。
ソース環境からの治験の展開
治験を展開するには:
- EDC ツールで治験マスターに移動します。
- 環境リストからソース環境 (展開元となる環境) を探します。
- 環境にカーソルを合わせると、アクションメニューが表示されます。
- 任意の作業: ソース環境に治験データに対する詳細 PDF を生成しない場合、詳細 PDF の作成チェックボックスをオフにします。
- 任意の作業: ソース環境の治験実行データを削除する場合、治験データの削除チェックボックスをオンにします。
- 任意の作業: 展開の含める Vault レベルの設定を選択する場合、システムデータを含めるチェックボックスをオンにします。注: これらのオプションは、別の Vault 環境に展開する場合にのみ使用することができます。設定のチェックボックスをオンにすると、その設定を展開に含めることができます。また、これらはシステムツールから個別に展開することもできます。
- 任意の作業: 変更理由を入力します。
- 展開をクリックする。本番環境以外への展開では、これで展開プロセスを開始します。本番環境への展開の場合、確認ダイアログが表示されます。
- 本番環境への展開の場合: 確認欄に「PUBLISH」と入力します。次に、展開をクリックします。
治験の展開ジョブが開始されます。終了後、Vault はメール通知を送信します。
展開のステータスは、展開履歴で確認することができます。詳細については、展開履歴の使用を参照してください。
デプロイとライセンシング: あなたのスタディにロック中、保留中またはアーカイブ済みの請求ステータスがある場合、本番へのデプロイは利用不可です。
宛先環境で修正を実行する
展開が完了すると、リードデータマネージャは宛先環境で修正を実行して、施設と被験者を新しく展開されたバージョンにアップグレードすることができます。
修正の実行方法についてはケースブックバージョンの管理を参照してください。
展開リストにカスタムオブジェクトを追加する
治験の展開内容に、カスタムの Vault オブジェクト設定を含めることができます。これを行うには、システムツールの展開リストに対象となるオブジェクトを追加する必要があります。詳細については、展開リストにカスタムオブジェクトを追加するを参照してください。
Vault はカスタムオブジェクトの構成のみを展開し、レコードは展開しません。ホワイトリストされたオブジェクトのオブジェクトレコードを環境から環境へ移動する必要がある場合、Vault 所有者は Vault ローダーを使用して実行できます。
展開履歴
治験に関連するすべての展開イベントは展開履歴ページに記録されます。
展開履歴へのアクセス
スタディマスターを開いて表示されるリストから、すべての環境のデプロイ履歴を確認することができます。
展開履歴にアクセスするには:
検索とフィルタリング
検索バーを使用すると、特定の展開イベントを検索することができます。また、ドロップダウンのフィルタメニューを使用して、ソース、宛先、タイプでリストをフィルタリングすることもできます。
展開イベント
次の展開イベントが展開履歴に記録されます:
- インスタンスの作成: Vault が新しい治験インスタンス (環境) を作成しています。このイベントは、何らかのタイプの環境が新規に作成されると開始されます。
- インスタンスの削除: Vault が新しい治験インスタンス (環境) を削除しています。このイベントは、何らかのタイプの環境が削除されると開始されます。
- 展開: Vault がソース環境からターゲット環境に治験を展開しています。
展開のログと出力ファイル
展開イベントでは、出力ファイルとログファイルの 2 つのファイルが生成されます。これらのファイルをダウンロードするには、展開履歴列にあるダウンロードアイコン () をクリックします。
展開のステータス
展開イベントには、以下のステータスが適用されます:
ステータス | 説明 |
---|---|
待機中 | 展開管理者が展開を開始しましたが、Vault はまだ展開ジョブを開始していません。 |
エクスポート | Vault が、ソース環境から治験パッケージをエクスポートしています。 |
インポート中 | Vault が、宛先環境に治験パッケージをインポートしています。 |
完了 | 展開が正常に完了しました。詳細については、展開の出力ファイルとログファイルをダウンロードして確認してください。 |
完了しましたが、ドキュメントンエラーが発生しました | 展開は正常に完了しましたが、SDS および比較レポートの生成時にエラーが発生しました。 |
失敗 | 展開に失敗しました。詳細については、ログファイルをダウンロードして確認してください。 |