We are pleased to bring you the following additions and enhancements to Developer Portal features in 22R2. REST API features added in 22R2 only affect API v22.2, unless otherwise noted.
Release Dates:
Vault is scheduled to rollover the signing certificate used to sign SAML Single Sign-on requests and Spark messaging connections. There is no expected downtime.
Your IT organization must ensure that the new certificate is configured on your Enterprise Identity Provider system prior to the New Certificate Rollover Event on April 29, 2022. Please ensure that your Spark messaging integrations do not cache the old certificate. Failure to utilize the new certificate by this date may cause login issues for SAML users, and Spark messaging integrations may fail.
Learn more about the action required for the certificate rollover process in Vault Help.
Beginning in 22R1.2, Vault is upgrading from HTTP/1.1 to HTTP/2 as the default protocol to shape and optimize traffic before it passes through the network to the user.
HTTP/1.1 is still supported, so no immediate action is required. However, Vault will assume all clients can leverage the HTTP/2 protocol. To avoid potential performance degradation, we strongly recommend reviewing your configurations and policies to ensure proper HTTP/2 support.
If an end-user’s configuration does not support HTTP/2, both the browser and server fall back to HTTP/1.1. For example, a firewall, VPN configuration, or browser policy setting could downgrade HTTP/2 traffic to HTTP/1.1. They may also classify it as unknown TCP traffic. This may negatively impact Vault performance, so we recommend upgrading to HTTP/2 as soon as possible.
With this release, we are removing the following fields from the Quality Event object. If your integration requires a value for any of these fields, you must update your integration.
| Field Label | Field Name |
|---|---|
| AR Contact Person | ar_contact_person__v |
| AR Contact Person’s Details | ar_contact_details__v |
| Authorized Representative | authorized_representative__v |
| Importer | importer__v |
| Importer Contact Details | importer_contact_details__v |
| Incident - Healthcare Facility | incident_healthcare_facility__v |
| Manufacturer | manufacturer__v |
| Manufacturer - Contact Person | manufacturer_contact_person__v |
| Manufacturer Contact Details | mfg_contact_details__v |
| Manufacturing Site - Contact Info | mfg_site_contact_info__v |
| Product Categorization | product_categorization__v |
| Reporter’s Contact Information | reporter_contact_info__v |
| Reporter - Occupation | reporter_occupation__v |
Release Date: June 24, 2022
In this release, we are deprecating the Veeva Site Connect: Distribute to Sites API endpoint:
POST /api/{version}/cdxdocsend/sendSafetyDistribution
In its place, we are adding the following new endpoint:
POST /api/{version}/app/clinical/safetydistribution/sendSafetyDistribution
With this new endpoint, Study Site IDs are no longer needed when sending Safety Distributions. This makes sending distributions via API easier and more reliable.
External Notifications provide a way to send emails and share documents to Persons associated to distribution groups. Prior to 22R2, Admins manually associated a Person to a distribution group through the user interface. In 22R2, Admins can define distribution group filters and automate distribution group membership through the Create Distribution Group Membership action. Distribution group filters provide a way to constrain Person records that have matching field data that match that of the external notification enabled record. The Create Distribution Group Membership action automates distribution group memberships with matching Person records. For customers that have complex rules, a new Vault Java SDK extension provides a way to populate distribution group memberships using their own custom logic via SDK.
Learn more about External Notifications.
Release Date: June 3, 2022
Vault Loader Multi-File Load and Multi-File Extract API requests with a version of v21.3 or lower in the request will always pass through v21.3 to the underlying APIs (Vault Objects, Documents, VQL) to load or extract data records. API requests with v22.1 or higher in the request will pass through the version provided in the request to the underlying APIs (Vault Objects, Documents, VQL) for load and extract.
Vault Loader Command Line Interface (CLI) tool jar files downloaded from Vault Version 21R3.0 or lower will always pass through v21.3 to the underlying APIs (Vault Objects, Documents, VQL) for load or extract commands. CLI tool jar files downloaded from Vault Version 22R1.0 or higher will pass through the CLI tool version to the underlying APIs (Vault Objects, Documents, VQL) for load and extract commands.
To support General Release customers who need this feature, we’ve released part of this feature functionality early to 21R1.0. Learn more about what’s available for use in 21R1.0 in the maintenance release notes in Vault Help.
With this feature, users can retrieve component dependencies for an outbound package and easily add dependent components to the package in a subsequent API call. This ensures the exported VPK has all of the required components for a successful deployment.
GET /api/{version}/vobjects/outbound_package__v/{package_id}/dependencies
View this endpoint in the v22.2 API Reference.
This feature introduces new VQL query target options: FAVORITES and RECENT. These options allow developers to execute VQL queries on documents using the Vault REST API and filter the results to documents that have been marked as favorite (FAVORITES) or the most recently viewed documents (RECENT). For more information on the Favorites and Recent Documents lists, see About Library & Document Tabs in Vault Help.
Learn more about the FAVORITES and RECENT query target options.
One Workflow VQL query targets now support object workflows. Additionally, this feature introduces two new query targets: active_workflow_item__sys and inactive_workflow_item__sys. These query targets allow developers to retrieve object and document IDs for the associated workflow without requiring the data to be linked to workflow tasks. Learn more about querying workflows.
This feature allows developers to build a VQL query from an integration rule and create a query string that can be used with HTTP Callout to query the source Vault. Only integration rules with a primary query object are supported. Learn more in the Javadocs.
Developers now have the option to not display a success banner when executing an action. By implementing a new method, suppressBanner, on the PostExecutionUserActionUIBehavior.Builder interface, developers can suppress the success banner.
Release Date: May 6, 2022
Individual users may now only make one asynchronous call to retrieve login audit data at a time. For example, https://myvault.veevavault.com/api/v21.3/audittrail/login_audit_trail will only accept one request per user at a time when the return type CSV is requested.
View the Retrieve Audit Details endpoint in the v22.2 REST API Reference.
Starting in API v22.1, the Document Field Metadata API now applies field-level security to the API results. If the field is hidden for the API user, the field will not be returned in the API. If the field is read-only, the editable attribute will be false.
This enhancement means the queryable attribute can now be used to accurately detect whether the field is accessible in VQL by the currently authenticated API user.
The Vault Loader Multi-File Extract API now provides trailing zeroes in the CSV export for number and currency fields.
The feature introduces a new SDK interface that allows developers to retrieve document field and document type metadata. Document types can be retrieved by type, subtype, classification, and document type detail ID, and document fields can be filtered by name, document type, status, and requiredness. Learn more in the Javadocs
Custom code from the Vault Java SDK now runs as the new Java SDK Service Account user rather than the System user. This new user appears in the Users & Groups Admin tab and audit trails. Vault does not include this user in license counts. Existing code is unaffected by this change.
This feature provides support for Custom and Vault tokens in VQL queries executed using QueryService. Developers can populate a prepared query using strongly typed values for Boolean, Date, DateTime, Number, String, and List of String, and QueryService will format the values as required by VQL syntax. Vault tokens are also supported in Vault API v22.2+. Learn more about Token Request for Query Builder.
Developers can now get the file size of email attachments sent to Vault using the getFileSize() method. This method returns the size in bytes of these email attachments for emails ingested using the EmailProcessor interface. Learn more in the Javadocs.
Developers can now set the Reply-To address for email notifications in NotificationService. The new setReplyToByPersonId() and setReplyToByUserId() methods in NotificationParameters allow developers to set the Reply-To by Person ID or User ID, respectively. Learn more in the Javadocs.
With this feature, we’ve aligned the behavior of blank Description fields. Previously, description fields intentionally left blank were sometimes null and sometimes an empty String. Beginning in 22R1.2, if a description field is left empty, the field will always be explicitly set to an empty String. This means developers may now see API or MDL responses which used to be description() are now returned as description(''), and should adjust integrations as necessary.