規則による通知メールの送信

特定の条件が発生した際に、ユーザのグループにメール通知を送信するためにルールを使用することができます。例えば、ケースブックに新規の有害事象フォームが送信されたときに、試験の医学モニターに通知を送信することができます。

前提条件

メール送信ルールとメールグループを使用するために、Vault で試験別ロールを有効にし、試験で自動配置モデルを使用している必要があります。

メール送信ルールアクションを設定する前に、まずメールグループを作成する必要があります。

デフォルトでは、CDMS スタディデザイナー試験ロールを持つユーザは下記のアクションを実行することができます。組織がユーザ定義のスタディロールを使用している場合、ロールに以下の権限が付与されている必要があります。

タイプ	権限ラベル	制御
標準タブ	Studio タブ	Studio タブへのアクセス権限
機能権限	治験のデザイン	Studio から治験デザイン定義と治験スケジュールを作成する権限

治験に制限付きデータが含まれている場合、それを閲覧するには制限ありデータアクセス権限が必要です。

試験の役割について詳しくご確認ください。

メール送信ルールの作成

メール送信ルールを作成するには:

Studio > ユーザ定義ルール (User Defined Rules) で新規ルールを作成 (Create a new Rule) を選択し、必要なフィールドに入力して、ルール式 (Rule Expression) を作成します。
メール送信ルールアクションを選択し、必須の選択を行います。
保存をクリックします。

被験者とメッセージテンプレートの作成

メール送信アクションを選択すると、メッセージテンプレートエディタが開きます。ここで、通知を受け取るメールグループを選択します（システム管理のメールグループはルールで利用可能ではありません）。次に、テキスト、トークン、HTMLフォーマットを使用して、テンプレートの件名とテンプレートのメッセージを作成します。

トークンとは、Vault がトークンによって表される値と差し替える特定フォーマットのテキストのことです。${Custom.tokenName} のフォーマットを使用します。トークンは、ルール詳細パネルで選択したフォーム上のアイテムごとに存在します。Vault がメール通知を送信する際、このトークンは項目の値と置換されます。

トークンを挿入するには、リストでトークンを探します。トークンにカーソルを合わせ、追加 () をクリックします。Vault は、件名またはメッセージフィールド内の最後のカーソル位置にトークンを追加します。メッセージフィールドには繰り返しアイテムグループトークンのみを含めることができますが、症例フィールドには含めることができないことに注意してください。

トークン

Vaultには、さまざまなメタデータや症例データに対応するトークンもあります。

名前	トークン	説明
ケースブックバージョン	`${Custom.@Casebook.version__v}`	被験者のケースブックに割り当てられたケースブックバージョン
イベント日付	`{Custom.@Event.event_date__v}`	フォームを含んでいるイベントのイベント日
イベントが発生していません	`${Custom.@Event.did_not_occur__v}`	イベントの未実施ステータス
事象シーケンス	`${Custom.@Event.sequence__v}`	繰り返しイベントグループ内のイベント用の、イベントインスタンスのシーケンス番号（サイクル）
イベントの訪問方法	`${Custom.@Event.visit_method__v}`	イベントの訪問方法
事象グループ順序	`${Custom.@EventGroup.sequence__v}`	繰り返しイベントグループのイベントグループインスタンスのシーケンス番号（サイクル）
フォーム順序	`${Custom.@Form.sequence__v}`	繰り返しフォームの、フォームインスタンスのシーケンス番号
フォームURL	`${Custom.@Form.url__v}`	受信者の権限に応じて、データ入力タブまたはレビュータブのフォームへの直接リンクです。Vaultはリンクテキストとして「フォームを表示するにはここをクリック」を使用します。
アイテムの現在の値	`${Custom.@Form.ig_name.item}`	アイテムの現在の値
アイテムの前回サブミット値	`${Custom.@Form.ig_name.item.previous_submit_value__v}`	対象のアイテムの、前回のフォーム送信時の値。注：メールに含めるには、これがルール式に存在する必要があります。
施設名	`${Custom.@Site.site_name__v}`	施設の名前
施設番号	`${Custom.@Site.name__v}`	施設の施設番号
施設試験実施国	`${Custom.@Site.study_country__v}`	施設の試験実施国
試験名	`${Custom.@Study.name__v}`	試験の名前
施設試験責任医師長	`${Custom.@Site.principal_investigator__v}`	被験者の施設に割り当てられた試験責任医師長の名前
患者名	`${Custom.@Subject.name__v}`	被験者の被験者 ID
症例ステータス	`${Custom.@Subject.subject_status__v}`	フォーム送信時点での被験者の被験ステータス

テキストフォーマットのための HTML タグ

Vault では、HTML タグの限られたセットを使用して、メッセージ (Message) テンプレート内のテキストをフォーマットすることができます。

使用可能なタグは以下の通りです:

タグ	説明	許可された属性	例
`<b></b>`	太字体	なし	`<b>太字のテキスト</b>`
`<em></em>`	強調表示	なし	`<em>強調書体のテキスト</em>`
`<i></i>`	イタリック体	なし	`<i>I斜体のテキスト</i>`
`<p></p>`	パラグラフ	なし	`<p>被験者: ${Custom.@Subject.name__v} について、新たな重篤な有害事象が報告されました。<p>`
`<ol> <li></li> </ol>`	順序付きリストとリスト項目 (番号付きリスト)	なし	`<ol> <li>フォームのレビュー</li> <li>評価の実施</li> </ol>`
`<ul> <li></li> </ul>`	順序なしリストとリスト項目 (箇条書きリスト)	なし	`<ul> <li>${Custom.@Study.name__v}</li> <li>${Custom.@Site.site_name__v}</li> <li>${Custom.@Subject.name__v}</li> </ul>`
`<blockquote></blockquote>`	インデント付き blockquotes	なし	`<blockquote>引用ブロック</blockquote>`
`<img>`	画像ファイル	"src"、"alt"、"width"、"height"	`<img src="http://www.veeva.com/images/veeva_logo.png" alt="Veeva Systems logo" height="50" width="200">`
`<span></span>`	スタイリングのための span タグ	"スタイル"	`<span style="color: red; font-weight: bold;">span</span>`
`<a></a>`	リンク	"href"、"target"、"title"、"rel"	`<a target="_blank" href="http://www.veeva.com/" title="Veeva Systems Inc." rel="noopener">Veeva.comを参照してください</a>`

バージョン管理と展開

メールグループおよび関連レコードは、ケースブックのバージョン管理の対象ではありません。ルール、レビュー計画、その他のバージョンのないオブジェクトと同様に、ケースブック定義が公開されているかどうかにかかわらず、いつでもメールグループを作成および編集することができます。

展開プロセスでは、すべてのメールグループ構成が環境から環境へ自動的に移行されます。