Managing Object Records

Each Vault has a data model consisting of objects, their fields, and their relationships. Object records are pieces of data within this model. For example, Product is a standard Vault object, while WonderDrug is an object record for that object.

Accessing Object Records

You can work with object records from Business Admin > Objects or from object tabs. For details see Accessing Object Records.

How to Create or Edit Object Records

To create a new object record or edit an existing record:

  1. From a custom object tab or Business Admin > Objects > [Object Name], click Create or open the object record and click Edit.
  2. When creating a new record, select an object type if prompted.
  3. Fill in details for the object record. These vary based on what Admins have set up for the object. Depending on your Admin’s configuration for the object, there may be default field values that appear when you either create or save your object record.
  4. Optional: To prevent users from selecting this object record, you can set the status to Inactive. If the object is otherwise set up, users will be able to select all Active object records.
  5. Click Save. To create another object record, click Save + Create. Vault will open a blank object record instead of displaying the saved object record.
  6. Optional: To create records and stay on the same page, enable the Create records in pop-up dialog option for a custom tab or related object section.

When editing a record from the object record details page, the Save button is only clickable after you update a field value. If you decide not to edit any fields, click Cancel to exit edit mode.

Additionally, if you are editing a text field with a maximum length more than 128 characters, Vault automatically resizes the field to accommodate your entire entry.

Other Ways to Create Object Records

You can create object records by:

Record Status & Record States

For objects that use lifecycles, you cannot change the Status for a record directly. To make a record active or inactive, you must move it into a lifecycle state associated with that status. For example, Approved state would correspond to Active status, while Retired would correspond to Inactive status.

Actions to move an object record depend on your Vault’s configuration. For example, the Vault configuration may allow you to directly move a record from Draft to In Review status with a user action from the record’s Actions menu. For another object, you may need to start a workflow on the object record that will collect signatures before moving the record to In Review. In some cases, object records will move into new lifecycle states based on a scheduled job, or on actions that another user takes on a related object record. The actions that are available depend on object-level security, record-level security, and object configuration.

Default Field Values

Default field values may be specific values configured by an Admin, or a calculated value based on a formula.

Empty, required object reference fields that reference an object with a single record default to reference that single object record. For existing object records, those fields will only default when editing the record from the object record details page, and not when inline editing from the object record list page. In addition, these fields do not default when creating records for join objects using the Relate Multiple Records option.

Create Records in Pop-Up Dialog

The record creation dialog box allows you to create records without leaving the list view in a custom tab or the related object section of a source object.

To enable the dialog box when creating object records from a custom tab:

  1. Navigate to Admin > Configuration > Tabs > [object].
  2. Enable the Create records in pop-up dialog option.

When creating object records from a custom tab that has this option enabled, you will enter record details in a pop-up dialog box rather than on the new record’s details page.

When you click Save, Vault creates the record and keeps you in the list view of object records. Clicking Save + Create creates the record and brings up a new dialog box to create another record.

To enable the dialog box when creating object records from a related object section:

  1. From an object’s page layout, click the pencil icon on a related object section.
  2. Enable the Create records in pop-up dialog option.

How to Change Object Types

If you’re working with an object that uses object types, you may sometimes select the wrong object type for a new record. To associate an object record with a different object

  1. Open an object record.
  2. From the Actions menu, select Change Type.
  3. Select the new object type and click Continue.
  4. Enter field values where needed. You’ll lose the values in any fields that are not associated with the new object type, but Vault preserves the current values for any common fields. Vault does not apply field defaults configured on the new type.
  5. Click Save.

Related object sections can display child or referring object records in a relationship with the record you’re viewing.

You may also see the Show in Tab link, which opens the related list in a custom tab. This option only appears for objects with custom tabs.

It’s possible to create and relate object records without leaving the context of the original record. This option is available:

  • For objects related through an object reference field
  • For objects related through a simple join relational object
  • For objects related through a complex join relational object, if enabled for that object
  • From a document, using an object reference field on the document

For example, Teresa is creating Study Person records for her team members. Teresa must fill the Study Team Role field for each team member. She may need to create a new Study Team Role reference record for her team member Robert’s role. She can create and relate a record directly from Robert’s Study Person record, using a related object section in the page layout.

Note that this option is not available on related object and document sections configured to filter related lists.

The object page layout configuration controls options for creating related objects. In some related object sections, the configuration blocks creation of new object records. Depending on configuration, new record creation may happen in a pop-up dialog, which allows you to stay in the original object record, or it may navigate you to related object record pages.

To create related object records using a related object section in an object page layout:

  1. Open the object record and scroll to the related object section.
  2. Click Create and fill in the required fields.
  3. Click Save.

Vault enforces object type filters when you create records from related object record sections. For example, if an Admin sets the object type filter on a section to include only the Pharmaceutical and Medical Device object types, you would only be able to create records of those object types from this section. Note that Vault applies all filters that an Admin has configured, but only displays fields that you have Read permission on.

If enabled, Vault can default field values associated with the equals and includes filter operators on records created from related object sections. For example, if you set a related list filter for a Product picklist to equal “Cholecap”, Vault will populate that picklist with “Cholecap” when you create a record from the related object section. Contact Veeva Support to enable default filters on fields other than object type.

How to Create a New Reference Record

To create a new reference record:

  1. Click into an object reference field.
  2. Scroll to the bottom of the picklist.
  3. Click + Create {Object}.
  4. The Create {Objects} dialog opens with the referenced object’s fields. Fill in the required fields as well as any additional fields needed.
  5. Click Save.
  6. The dialog closes. Finish creating or editing your object record.
  7. Click Save.

You can also create new reference records after clicking the Binocular icon to search existing reference records:

  1. Click into an object reference field.
  2. Click the Binocular icon.
  3. Add or remove references from the object record as needed. Note that you can hover over a reference field to see up to 1000 characters of the value of that field. Click Select All to add all available references. If you accidentally click this button, you can click Unselect All to clear all selected references.
  4. Click Create.
  5. The Create {Objects} dialog opens. Fill the required fields as well as any additional fields needed.
  6. Click Save.

How to Create a New Relational Reference Record

You can use the create and relate option on an object record for all simple relational objects and, if enabled, for complex relational objects. Navigate to an object record through Business Admin > Objects or a custom tab.

To create a new relational reference record:

  1. Open the object record and scroll to the relevant Related Object section.
  2. Click Add.
  3. Click Create and fill the required fields.
  4. Click Save.
  5. Click OK.

To add an existing relational reference record:

  1. Open an object record and scroll to the relevant Related Object section.
  2. Click Add.
  3. Add or remove references from the object record as needed.
    • Click Select All to add all available references. After you click this button, it appears as Unselect All.
    • Click Unselect All to clear all selected references.
    • The Select All option only works for the selection of 500 records or fewer.
  4. Click Ok.

In Vaults where two objects share the same parent object and have a relationship to each other, Vault auto-populates the parent object field when using Create to create a record for a sibling object from the context of the related record.

There are several ways to add related documents to an object record without leaving the record:

  • Add one or more existing documents. You can add any document to the record on which you have the Edit Fields permission.
  • Upload source files to create new documents that relate to the record.
  • Create a new document from a template, provided you have the permissions required to create document types.

Creating and relating documents this way updates the document field that creates the object relationship, for example, the document’s Product or Marketing Campaign field. Note that an Admin must configure the object page layout to add the Related Documents section.

How to Relate Existing Documents

To relate existing documents:

  1. Open an object record.
  2. In the Related Documents section, click Add. If an Admin has configured filters on which documents can be added to this section, you must have Read permission on all fields used in the filter in order to access this section.
  3. The Select Documents dialog opens. Filter as needed to find your documents. If an Admin has configured filters on which documents can be added to this section, you will only see the documents that fit that criteria.
  4. Optional: Add additional search criteria or filters to find the correct target document. If needed, select a different standard view in the top right of the dialog. In addition to the standard Library views, you can limit the view to your Favorites, or to documents that are currently in your Cart.
  5. Select documents to relate to the object record by selecting their checkboxes.
  6. Remove documents related to the object record by clearing their checkboxes.
  7. Click Close.

How to Relate New Documents - Upload

You can create and relate a document by uploading directly to a Related Documents section. Note that this option is not available on Related Document sections configured to filter related lists.

To do this:

  1. Open an object record.
  2. In the Related Documents section, click Add.
  3. In the Search: Documents dialog, click Create.
  4. In the Create Document dialog, select Upload, and click Continue.
  5. To select files, drag and drop them into the blue area or click Choose. Uploading multiple files creates multiple documents.
  6. If prompted, choose whether to classify the documents with a document type immediately or later. For unclassified documents, you will skip the steps to select a document type and populate fields.
  7. If you chose to classify the documents, select a document type using the document type selector. This selection determines the relevant document fields, lifecycles, and workflows.
  8. Click Next. Vault immediately begins uploading the files and shows the progress on the page. If Duplicate Content Detection is enabled, Vault will notify you if the same file already exists.
  9. Complete the fields. An asterisk (*) indicates required fields. You can complete these fields before the upload completes. You can edit fields for multiple documents at one time.
  10. Click Save. If the Save button is disabled, the upload is not complete or required fields are blank.

The uploaded document is now available in the Library. Depending on the file size, the thumbnail and viewable rendition can take up to several minutes to appear.

How to Relate New Documents - From Template

You can create and relate a document from a template. Note that this option is not available on Related Document sections configured to filter related lists.

To do this:

  1. Open an object record.
  2. In the Related Documents section, click Add.
  3. In the Search: Documents dialog, click Create.
  4. In the Create Document dialog, select Document from Template, and click Continue.
  5. Select a document type.
  6. Choose a template from the picklist and click Next.
  7. Fill any required fields and other fields as necessary.
  8. Click Save.

Field Dependencies

Adding documents from an object record does not honor field dependencies.

Creating and relating documents from object records honors field dependencies with two exceptions:

  • If the relevant object field is hidden or read-only based on the document type, Vault ignores this dependency and populates the field.
  • If the relevant object field is hidden, read-only, or limited to certain values based on another field value, Vault ignores this dependency and populates the field.

Show in Tab

Click Show in Tab in a related document section to view a dynamically-generated list of related documents in a tab. Within the tab, you can:

  • Apply additional filters
  • Perform bulk actions
  • Start multi-document workflows
  • Save custom views

Multi-Document Viewer

In the multi-document viewer, you can view all documents in the Related Documents section of an object record. To view all documents related to an object record, select All Related Documents from the object record Actions menu.

How to Delete Object Records

Certain object relationships and deletion rules may prevent you from deleting an object record. To delete an object record:

  1. Open an object record.
  2. Choose Delete from the Actions menu.
  3. Click Continue on the Delete Record screen prompt.

Limitations on Object Record Deletion

In situations where an object record is in use within your Vault, you will not be able to delete that record. In these cases, you can change the record’s Status to Inactive to prevent users from accessing the option, without compromising configurations or document metadata.

Your Admin can also define deletion rules, which affect how Vault behaves when you attempt to delete an object record that is either the parent object record in a parent-child relationship or the referenced object record in a reference relationship. See Configuring Vault Objects for details.

Maximum Number of Object Records

For each standard data store object, Vault allows up to 100,000,000 records. If your organization requires more records than this, consider using the Raw object data store option.