Learn how to update your Vault’s configuration to enable the Study Site Reporter feature.
About the Feature
Study site reporters were added in Vault Safety 20R1. Upgraded Vaults must perform the following configuration changes to enable this feature.
This feature allows Admins to set up Study Contact records, which users can then select as Site Reporters during Case intake. Upon Case promotion, all required details of the Site Reporter are automatically populated on the Case, increasing data entry efficiency and accuracy.
In 23R1, support for study site reporters on Inbox Items was added to Vault Safety. You must first contact Veeva Support to enable this feature in your Vault. Then, perform the 23R1 configuration.
Manage Studies: Set Up Study Site Reporters describes how to set up Study Site Reporters, once you enable this feature.
(23R1) Add the Site Reporter Field to the Inbox Item Layout
Perform the following steps to add the Site Reporter field to the Inbox Item Details section:
- In Admin, go to Configuration > Objects > Inbox Item > Layouts > Inbox Item Detail Page Layout.
- In the Details section, select the Edit icon.
- In the Fields dropdown, add Site Reporter between Study Arm and Worldwide UID.
- Select Done.
- Save the page.
Update the Study Detail Page Layout
To edit the Study object, in the Admin area, go to Configuration > Objects > Study.
On the Study > Layouts tab, open the Study Detail Page Layout, and then make the following updates:
Study Sites Section
Update the Study Sites section with the following settings:
- Remove the Study field
- Add the following fields:
- Study Site Number
- Site Name
- Registration
Study Contacts Section
Insert a Study Contacts related object section with the following settings:
Label | Type | Creation Option | Columns |
---|---|---|---|
Study Contacts | Related Object: Study Person | New Page |
|
Configure the Study Site Object
The Study Site object is new for this feature. You must configure layouts, layout rules, and validation rules. To edit the Study Site object, in the Admin area, go to Configuration > Objects > Study Site.
Layout
On the Study Site > Layouts tab, open the Study Site Detail Page Layout, and then make the following updates:
Details Section
Update the Details section with the following settings:
- Change the Section Layout to One Column.
- Add the following fields:
- Organization
- Study
- Study Site Number
- Registration
- Site
- Site Name
- Country
- space
Study Contacts Section
Insert a new Study Contacts related object section with the following settings:
Label | Type | Creation Option | Columns |
---|---|---|---|
Study Contacts | Related Object: Study Person | New Page | Name |
Layout Rules
Go to Study Site > Layouts > Study Site Detail Page Layout > Layout Rules, and then add the following layout rules:
Rule Label | Hide the following Page Layout Items | IF this Layout Rule Expression is TRUE |
---|---|---|
New Record |
|
status__v != 'active__v' && status__v != 'inactive__v' |
Workflow Timeline |
|
not(isBlank(name__v)) |
Validation Rules
On the Study Site > Validation Rule tab, add the following validation rule:
Label | Error Message | Location | Validation Expression |
---|---|---|---|
Site is Mandatory | Please enter a Site. | Site | not(isBlank(site__vr.name__v))
|
Configure the Study Person Object
The Study Person object is new for this feature. You must configure field criteria VQL, layouts, and layout rules. To edit the Study Person object, in the Admin area, go to Configuration > Objects > Study Person.
Person Field VQL
On the Study Person > Fields tab, locate the Person field, and then modify the Criteria VQL as follows:
object_type__vr.api_name__v = 'study_person__v' and organization__v = {{this.organization__v}} and country__v = {{this.study_site__vr.country__v}}
Layout
Go to Case > Layouts > Study Person Detail Page Layout, and then update the Details section to include the following fields:
- Change the Section Layout to One Column
- Add the following fields:
- Organization
- Study
- Study Site
- Person
- Name
Layout Rules
On the Study Person object, configure the Study Person Detail Page Layout to add the following layout rules:
Rule Label | Hide the following Page Layout Items | IF this Layout Rule Expression is TRUE |
---|---|---|
Workflow Timeline | Section: Workflow Timeline | not(isBlank(name__v)) |
Update the Person Object
You must update layouts, layout rules, and validation rules on the Person object. To edit the Person object, in the Admin area, go to Configuration > Objects > Person.
Layout
On the Person > Layouts tab, open the Person Detail Page Layout, and then edit the layout to insert the following sections:
Details
Insert a One Column Details section with the following fields:
- Qualification
- Title
- First Name
- Middle Name
- Last Name
- Organization
- Department
- Telephone
- Mobile
- Fax
- Language
- space
Address
Insert a One Column Address section with the following fields:
- Street Address
- City
- State/Province
- Country
- Postal Code
- space
System Information
Insert a Two Column System Information section with the following fields:
- Last Modified Date
- Last Modified By
- Status
- Created Date
- Created By
- Name
Layout Rules
Go to Person > Layouts > Study Person Detail Page Layout > Layout Rules, and then add the following layout rule:
Rule Label | Hide the following Page Layout Items | IF this Layout Rule Expression is TRUE |
---|---|---|
New Record |
|
status__v != 'active__v' && status__v != 'inactive__v' |
Validation Rules
Go to Person > Validation Rules, and then delete the Country is Mandatory validation rule.
Update the Case Object
You must add the Study Site and Site Reporter fields to the Case layout:
- Go to Admin > Configuration > Objects > Case > Layouts > Case Page Layout.
- In the Study section, add the following fields:
- Study Site
- Site Reporter
- Select Save.
Update Permission Sets
On the Users & Groups > Permission Sets page, configure the following Object Permissions:
Case Field Permissions
- Go to the Case Intake Actions permission set, and then go to Objects > Case.
- Under Object Level Permissions, grant Edit access to the following fields:
- Study Site
- Site Reporter
Study Person Object Permissions
- Enable the permission to Read both the Study Person object and the Person > Study Person object type for the following permission sets:
- Case Distribution Actions
- Case Entry Actions
- Case Intake Actions
- Case Review Actions
- Safety Operations Actions
- Safety Writer
- Submission Actions
- Enable the permissions to Read, Create, Edit, and Delete for both the Study Person object and the Person > Study Person object type for the following permission set:
- Administration Actions