Vault Loader allows you to perform bulk actions on groups in your Vault. Before loading groups, prepare the CSV input file containing group field names and values.
When creating new groups, the group
label__v is the only required field and must be set to a unique value.
When updating groups, the group
id field is required. Vault uses group IDs to match existing groups with those specified in the input.
The upsert action is a combination of create and update. Create one input with fields and values required to create new groups and update existing group information.
How to Load Groups
To create, update, or upsert groups:
- In the left panel of the Loader tab, click Load.
- For the CSV File, click Choose and select the CSV input file.
- In the Object Type picklist, select Groups.
- In the Action Type picklist, select Create, Update, or Upsert.
- Click Start Load.
Before processing the request, Vault validates the selected CSV file. If the file is valid, Vault begins processing the request. When finished, you’ll receive a Vault notification and email with request details and CSV output files.
Before beginning the Vault Loader job to create or update groups, Vault checks that the selected CSV file meets certain criteria:
- Is not empty
- Does not contain empty columns
- Includes a valid header row. Invalid header rows are those with no columns that match to metadata for the records you’re loading.
If your file is not valid, Vault displays a notification, stops the process, and allows you to select a new CSV file. If some of the header columns do not match metadata for your Vault, the notification will allow you to stop the load or ignore those columns and proceed.
Vault group records are configured with a set of standard fields. With the exception of system-managed fields such as
create_by__v, you can configure most user fields with values.
- Configure String fields with user-defined alphanumeric values.
- Configure ObjectReference fields with available values.
- Set Boolean fields to true or false.
To see the fields and values configured for an individual group in your Vault, go to Admin > Users & Groups > Groups and click into a group.
The group ID is a system-managed numeric field with values automatically assigned to each new group. The
id field values cannot be edited. System-managed groups have single-digit IDs (id: 1, 2, 3, etc.). Custom groups are typically assigned larger values (id: 123456789).
To find the ID of an individual group in your Vault, go to Admin > Users & Groups > Groups and click into a group record. The group ID is located at the end of the URL in the address bar.
For example: myvault.veevavault.com/ui/#admin/users_group/detail=&g=20020002
The user ID is a system-managed numeric field with values automatically assigned to each new user. The
id field values cannot be edited.
To find the ID of an individual user in your Vault, go to Admin > Users & Groups > Users and click into a user record. The user ID is located at the end of the URL in the address bar.
For example: myvault.veevavault.com/ui/#admin/users_group/detail=&u=11001