Vault Loader: Create & Update Groups


Vault Loader allows you to perform bulk actions on groups in your vault. 

How to Load Groups

Before loading groups, prepare the CSV input file containing group field names and values. 

To create, update, or upsert groups:

  1. In the left panel of the Loader tab, click Load.
  2. For the CSV File, click Choose and select the CSV input file.
  3. In the Object Type picklist, select Groups.
  4. In the Action Type picklist, select Create, Update, or Upsert.
  5. 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. 

Preparing the CSV Input Files

Creating Groups

When creating new groups, the group label__v is the only required field and must be set to a unique value.

Updating Groups

When updating groups, the group id field is required. Vault uses group IDs to match existing groups with those specified in the input.

Upserting Groups

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.

Retrieving Group Fields & Values

Vault group records are configured with a set of standard fields. Except for ystem-managed fields such as id and created_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.

Refer to the Vault API Group Metadata to see all fields configured on the Groups object. You can also retrieve all groups in your vault with the API or command-line tool.

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.

About Group ID Fields

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).

Currently, you can only retrieve lists of group IDs through the Vault Groups API or command-line tool. In the next release, Vault will be configured with this functionality.

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

About User ID Fields

The user ID is a system-managed numeric field with values automatically assigned to each new user. The id field values cannot be edited.

Currently, you can only retrieve lists of group IDs through the Vault Users API or command-line tool. In the next release, Vault will be configured with this functionality.

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