String
Veeva Vault Connector 1.4 Reference - Mule 4
Configuration
Default Configuration for Veeva Vault Connector.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Name |
Name for this configuration. Connectors reference the configuration with this name. |
x |
||
Connection |
Connection types for this configuration. |
x |
||
Expiration Policy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
Basic Connection
Uses basic connection for authorization.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Response Timeout |
Number |
Maximum amount of time in milliseconds that the connector waits for the Veeva Vault response. If the time elapses, a Response Timeout exception is thrown. |
|
|
Burst API Limit Profile |
One of: |
Burst API limit profile configuration in which the Veeva Vault burst API limit exceed is configured. It is enabled by default. |
||
Daily API Limit Profile |
One of: |
Daily API limit profile configuration in which the Veeva Vault daily API limit exceed is configured. It is enabled by default. |
||
Host |
String |
Host. |
||
Port |
Number |
Port. |
||
Username |
String |
Username to authenticate against the proxy server. |
||
Password |
String |
Password to authenticate against the proxy server. |
||
NTLM Domain |
String |
NTLM domain. |
||
Vault URL |
String |
Veeva Vault instance URL required for connection. |
x |
|
Version |
String |
Version for the Veeva Vault instance required. |
|
|
Client Id |
String |
Client ID required to send with each request header to the Vault instance. |
x |
|
Username |
String |
Username for the Veeva Vault instance required for connection. |
x |
|
Password |
String |
Password for the Veeva Vault instance required for connection. |
x |
|
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
OAuth 2.0 / Open ID Connection Provider
Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more information, refer to Configuring OAuth 2.0 for Connectors or Configuring OAuth 2.0 for Connectors on CloudHub.
Authorizes against any OpenID provider and later exchanges the issued access token for a Veeva session ID.
For more information on how to configure this connection type, refer to OAuth 2.0 / Open ID Connection Provider.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Response Timeout |
Number |
Maximum amount of time in milliseconds that the connector waits for the Veeva Vault response. If the time elapses, a Response Timeout exception is thrown. |
|
|
Burst API Limit Profile |
One of: |
Burst API limit profile configuration in which the Veeva Vault burst API limit exceed is configured. It is enabled by default. |
||
Daily API Limit Profile |
One of: |
Daily API limit profile configuration in which the Veeva Vault daily API limit exceed is configured. It is enabled by default. |
||
Host |
String |
Host. |
||
Port |
Number |
Port. |
||
Username |
String |
Username to authenticate against the proxy server. |
||
Password |
String |
Password to authenticate against the proxy server. |
||
NTLM Domain |
String |
NTLM domain. |
||
Vault URL |
String |
Veeva Vault instance URL required for connection. |
x |
|
Version |
String |
Version for the Veeva Vault instance required. |
|
|
Client Id |
String |
Client ID required to send with each request header to the Vault instance. |
x |
|
OIDC Profile ID |
String |
OIDC profile ID generated by Veeva when creating a new OIDC profile. |
x |
|
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
|||
Consumer Key |
String |
OAuth consumer key, as registered with the service provider. |
x |
|
Consumer Secret |
String |
OAuth consumer secret, as registered with the service provider. |
x |
|
Authorization Url |
String |
URL of the service provider’s authorization endpoint. |
|
|
Access Token Url |
String |
URL of the service provider’s access token endpoint. |
|
|
Scopes |
String |
OAuth scopes to request during the OAuth dance. This value defaults to the scopes in the annotation. |
|
|
Resource Owner Id |
String |
Resource owner ID to use with the authorization code grant type. |
||
Before |
String |
Name of a flow to execute immediately before starting the OAuth dance. |
||
After |
String |
Name of a flow to execute immediately after receiving an access token. |
||
Listener Config |
String |
Configuration for the HTTP listener that listens for requests on the access token callback endpoint. |
x |
|
Callback Path |
String |
Path of the access token callback endpoint. |
x |
|
Authorize Path |
String |
Path of the local HTTP endpoint that triggers the OAuth dance. |
x |
|
External Callback Url |
String |
URL that the OAuth provider uses to access the callback endpoint if the endpoint is behind a proxy or accessed through an indirect URL. |
||
Object Store |
String |
Configures the object store that stores data for each resource owner. If not configured, Mule uses the default object store. |
Operations
Create Document Renditions
<veevavault:create-document-renditions>
Creates document renditions in bulk on Veeva Vault using document metadata provided in CSV or JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Document Metadata |
Binary |
Document metadata as an Input Stream. The payload must be in the format specified in the Metadata Format field. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Create Documents
<veevavault:create-documents>
Creates single or multiple documents on Veeva Vault using document metadata provided in CSV or JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Document Metadata |
Binary |
Document metadata as an Input Stream. The payload must be in the format specified in the Metadata Format field. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Create Object Records
<veevavault:create-object-records>
Creates bulk object records for the selected vault object using object metadata provided in CSV or JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Name |
String |
Object name. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Object Metadata |
Binary |
Vault object metadata in CSV or JSON format as an Input Stream to create bulk object records on the vault. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Delete Document Renditions
<veevavault:delete-document-renditions>
Deletes document renditions in bulk from Veeva Vault using document metadata provided in CSV or JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Document Metadata |
Binary |
Document metadata in CSV OR JSON format as an Input Stream to delete multiple document renditions from the vault. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Delete Documents
<veevavault:delete-documents>
Deletes single or multiple documents from Veeva Vault using document metadata provided in CSV or JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Document Metadata |
Binary |
Document metadata in CSV or JSON format as an Input Stream to delete single or multiple documents from the vault. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Delete Object Records
<veevavault:delete-object-records>
Deletes object records in bulk from the selected vault object using object metadata provided in CSV or JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Name |
String |
Object name. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Object Metadata |
Binary |
Vault object metadata in CSV or JSON format as an Input Stream to create bulk object records on the vault. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Export Documents
<veevavault:export-documents>
Queries a set of documents to export to your vault’s FTP staging server.
Use the Export Documents operation in a separate asynchronous flow by using Async Scope and passing the payload with document IDs. When used asynchronously, the Export Documents operation executes in separate flow thread and waits for the specified polling interval to poll the job status until it is successful while the main flow continues its process.
The FTP staging area in the folder stores the exported documents, with the
{root}/{userId}/{jobId}/{documentIds}/{versions}
hierarchy structure.
The following example shows the Export Documents operation returning job results as a response:
[ { "file": "/41601/249051/0_1/TestDocument.docx", "user_id__v": 1885110, "id": 249051, "responseStatus": "SUCCESS", "minor_version_number__v": 1, "major_version_number__v": 0 }, { "file": "/41601/249050/0_1/TestDocument.docx", "user_id__v": 1885110, "id": 249050, "responseStatus": "SUCCESS", "minor_version_number__v": 1, "major_version_number__v": 0 }, { "file": "/41601/249052/0_1/TestDocument.docx", "user_id__v": 1885110, "id": 249052, "responseStatus": "SUCCESS", "minor_version_number__v": 1, "major_version_number__v": 0 } ]
This example contains the following attributes:
-
file
Uses the"/{jobId}/{documentId}/{major-minor-version}/{filename}"
format, which is the absolute file path location on the Vault FTP server staging area. -
user_id__v
Vault system user ID of a user whose credentials are configured in the connector. The folder is created on the Vault FTP server staging area root location under where the exported file is located. The folder is created with the name of the user ID prefixed with the letteru
, for example/uXXXXXXX/{jobId}/{documentId}/{major-minor-version}/{filename}\)
. -
id
Document ID of the exported document file. -
major_version_number__v
Major version number of the exported document file. -
minor_version_number__v
Minor version number of the exported document file.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Document Metadata |
Binary |
Document metadata in CSV or JSON format as an Input Stream to export documents from vault. |
|
|
Source |
Boolean |
To exclude source files, set to |
|
|
Renditions |
Boolean |
To include renditions, set to |
|
|
All Versions |
Boolean |
To include all versions or the latest version, set to |
|
|
Polling Interval |
Number |
Poll the vault at the specified interval, in seconds, until the job is successful. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Get Audit Details
<veevavault:get-audit-details>
Retrieves all audit details for a specific audit type. Place a For-Each/Splitter element after this operation to fetch each JSON data (page) in sequential order.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Audit Type |
String |
Audit type. |
x |
|
Start Date |
String |
Start date to retrieve audit information. This date cannot be more than 30 days ago. Dates must be of |
||
End Date |
String |
End date to retrieve audit information. This date cannot be more than 30 days ago. Dates must be of |
||
Fetch Size |
Number |
Number of limits or records per page. |
|
|
Batch Size |
Number |
Number of pages per batch. |
|
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Get Document Renditions Types
<veevavault:get-document-renditions-types>
Retrieves document rendition types using the document ID metadata in JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Document Metadata |
Binary |
Document ID metadata in a JSON format payload, for example, |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Get Documents
<veevavault:get-documents>
Retrieves document details from Veeva Vault. You can either:
-
Provide document properties (document type, subtype, and classification) to retrieve document details.
If document properties are provided, the Get Documents operation builds the VQL query dynamically. The VQL query is then executed on the vault to retrieve document details.
-
Have document properties (document type, subtype, and classification) fetched to retrieve document details.
If document properties are not provided, the document properties metadata is fetched using
/api/{version}/metadata/objects/documents/properties
and the VQL query is built based on the document metadata properties added or inserted in the Document Properties list. If metadata properties are not provided, then all queryable document properties are used and executed in the VQL query.
Place a For-Each/Splitter element after this operation to fetch each document’s data (page) sequentially.
This operation provides a paging mechanism based on Mule standard pagination. Refer to Streaming and Pagination for more details.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Type |
String |
Document type to retrieve the type. |
||
SubType |
String |
Document subtype to retrieve the type. |
||
Classification |
String |
Document classification to retrieve the classification. |
||
Document Properties |
Array of String |
List of document properties to build a VQL query. |
||
WHERE Clause |
String |
WHERE clause that is appended to dynamically build a VQL query. |
||
Fetch Size |
Number |
Fetch size which limits the records per page. |
|
|
Batch Size |
Number |
Batch size which accommodates the number of pages in a specified number of batches. |
|
|
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Get Object Records
<veevavault:get-object-records>
Retrieves object records details using object metadata fields to build a VQL query dynamically and execute on the vault to get object details. Place a For-Each/Splitter element after this operation to fetch each object records (page) sequentially.
This operation provides a paging mechanism based on Mule standard pagination. Refer to Streaming and Pagination for more details.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Name |
String |
Object name. |
x |
|
Object Fields |
Array of String |
Object fields list to include in the dynamic VQL query. |
||
WHERE Clause |
String |
WHERE clause. |
||
Fetch Size |
Number |
Number of limits or records per page. |
|
|
Batch Size |
Number |
Number of pages per batch. |
|
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Get Picklists
<veevavault:get-picklists>
Retrieves all available values configured on a picklist.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Picklist Name |
String |
Picklist name. |
||
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Invoke REST API
<veevavault:invoke-rest-api>
Invokes generic Veeva Vault REST APIs.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Method |
Enumeration, one of:
|
HTTP method to send the request. |
|
|
Path |
String |
Path in which the request is sent, for example, |
|
|
Body |
Any |
Body of the request message. |
|
|
Headers |
Object |
HTTP headers the message must include. |
||
URI Parameters |
Object |
URI parameters that are provided in the Path field. |
||
Query Parameters |
Object |
Query parameters the request must include. |
||
Request Streaming Mode |
Enumeration, one of:
|
Whether the request must be sent using streaming or not. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Query
<veevavault:query>
Executes the specified VQL query on the vault and retrieves the result in a paginated data input stream. Place a For-Each/Splitter element after the Query operation to fetch each record in sequential order.
This operation provides a paging mechanism based on Mule standard pagination. Refer to Streaming and Pagination for more details.
Do not specify LIMIT/PAGESIZE and OFFSET/PAGEOFFSET in the VQL query. These parameters are incorporated internally.
|
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
VQL Query |
String |
VQL query required as per Veeva API documentation. |
x |
|
Input Parameters |
Object |
Input parameters in the format |
||
Fetch Size |
Number |
Number of limits or records per page. |
|
|
Batch Size (DEPRECATED) |
Number |
Number of batches of Fetch Size elements to return. This field is deprecated. |
|
|
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Spark Validator
<veevavault:spark-message-validator>
Validates and verifies Spark messages triggered from the vault with a signature and public key. Upon successful validation and verification, the Spark message can be further processed in the Mule flow according to your business requirements. Refer to https://developer.veevavault.com/sdk/#spark-messagingSpark Messaging feature and functionalities and setup for more details.
The output of the Spark Validator operation includes Spark attributes (optional) with the Spark message as it is received from the vault.
Before triggering a Spark message from the vault, make sure to raise a support ticket with Veeva Vault Support to increase the time interval (for example, 10 seconds) for the Spark message to resend or retry. By default, the time interval is configured as 5 seconds, which is less than the time required for the Spark Validator operation to complete message validation and verification. |
As per Veeva Systems, the public key (00001.pem) expires every two years. You receive notification in advance advising you of the expiration date. If you are using the Spark Validator operation in a Mule application flow, after the public key expiration date you must remove the public key file from the path configured in the Public Key Path field. A new public key will be created during execution of the key removal. If you don’t do this, Spark message verification fails as INVALID_SPARK_MESSAGE . The Mule application deployed on CloudHub with the default path must be restarted for successful Spark message verification.
|
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Include Spark Headers |
Boolean |
Flag to include Spark headers received from the vault in the Spark validator output. |
|
|
Public Key Path |
String |
Directory path to store the public key (00001.pem) file that is used to verify incoming Spark messages with a signature. Retrieved from the vault, if not specified. |
|
|
Spark Headers |
Object |
Spark headers received from the vault and embedded in the Spark message. |
|
|
Spark Message |
Input Stream |
Spark message body received from the vault. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Unauthorize
<veevavault:unauthorize>
Deletes all the access token information of a given resource owner ID so that it is impossible to execute any operation for that user without doing the authorization dance again.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Resource Owner Id |
String |
ID of the resource owner for whom to invalidate access. |
Update Documents
<veevavault:update-documents>
Updates bulk documents using editable metadata in the payload provided in CSV or JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Document Metadata |
Binary |
Editable document metadata in CSV OR JSON format as an Input Stream to update single or multiple documents on the vault. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Update Object Records
<veevavault:update-object-records>
Updates object records in bulk using object metadata in CSV or JSON format.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Name |
String |
Object name. |
x |
|
Metadata Format |
Enumeration, one of:
|
Metadata format. |
x |
|
Object Metadata |
Binary |
Vault object metadata in CSV or JSON format as an Input Stream to create bulk object records on the vault. |
|
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Throws
-
VEEVAVAULT:API_LIMIT_EXCEEDED
-
VEEVAVAULT:INVALID_KEY_FORMAT
-
VEEVAVAULT:INVALID_SESSION_ID
-
VEEVAVAULT:EXECUTION
-
VEEVAVAULT:CLIENT_PROTOCOL
-
VEEVAVAULT:INVALID_DATA
-
VEEVAVAULT:RESPONSE_TIMEOUT
-
VEEVAVAULT:IOEXCEPTION
-
VEEVAVAULT:PARAMETER_REQUIRED
-
VEEVAVAULT:CONNECTIVITY
-
VEEVAVAULT:INVALID_AUTH
-
VEEVAVAULT:INVALID_DOCUMENT
-
VEEVAVAULT:USERNAME_OR_PASSWORD_INCORRECT
-
VEEVAVAULT:RETRY_EXHAUSTED
-
VEEVAVAULT:JSON_EXCEPTION
-
VEEVAVAULT:ATTRIBUTE_NOT_SUPPORTED
-
VEEVAVAULT:OPERATION_NOT_ALLOWED
-
VEEVAVAULT:METHOD_NOT_SUPPORTED
-
VEEVAVAULT:NO_PERMISSION
-
VEEVAVAULT:INVALID_SPARK_MESSAGE
-
VEEVAVAULT:INVALID_TOKEN
-
VEEVAVAULT:MALFORMED_URL
-
VEEVAVAULT:INSUFFICIENT_ACCESS
-
VEEVAVAULT:INACTIVE_USER
-
VEEVAVAULT:SESSION_EXPIRED
Types
Reconnection
Configures a reconnection strategy for an operation.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Fails Deployment |
Boolean |
When the application is deployed, a connectivity test is performed on all connectors. If set to |
||
Reconnection Strategy |
Reconnection strategy to use. |
Reconnect
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
||
Count |
Number |
How many reconnection attempts the Mule app can make. |
Reconnect Forever
Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
Expiration Policy
Configures an expiration policy strategy.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Idle Time |
Number |
Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
||
Time Unit |
Enumeration, one of:
|
Time unit for the Max Idle Time field. |
Repeatable In Memory Stream
Configures the in-memory streaming strategy by which the request fails if the data exceeds the MAX buffer size. Always run performance tests to find the optimal buffer size for your specific use case.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Initial Buffer Size |
Number |
Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by Buffer Size Increment, with an upper limit of Max In Memory Size value. |
||
Buffer Size Increment |
Number |
This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a |
||
Max Buffer Size |
Number |
Maximum size of the buffer. If the buffer size exceeds this value, Mule raises a |
||
Buffer Unit |
Enumeration, one of:
|
Unit for the Initial Buffer Size, Buffer Size Increment, and Buffer Unit fields. |
Repeatable File Store Stream
Configures the repeatable file-store streaming strategy by which Mule keeps a portion of the stream content in memory. If the stream content is larger than the configured buffer size, Mule backs up the buffer’s content to disk and then clears the memory.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
In Memory Size |
Number |
Maximum amount of memory that the stream can use for data. If the amount of memory exceeds this value, Mule buffers the content to disk. To optimize performance:
|
||
Buffer Unit |
Enumeration, one of:
|
Unit for the In Memory Size field. |
Repeatable In Memory Iterable
Configures the repeatable in memory iterable type.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Initial Buffer Size |
Number |
Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by Buffer Size Increment, with an upper limit of Max In Memory Size value. |
||
Buffer Size Increment |
Number |
This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a |
||
Max Buffer Size |
Number |
Maximum size of the buffer. If the buffer size exceeds this value, Mule raises a |
Repeatable File Store Iterable
Configures the file store iterable type.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
In Memory Objects |
Number |
Maximum amount of instances to keep in memory. If more than that is required, content on the disk is buffered. |
||
Buffer Unit |
Enumeration, one of:
|
Unit for the In Memory Size field. |
HTTP Response Attributes
Configures HTTP response attributes for the configuration.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Status Code |
Number |
HTTP status code of the response. Former 'http.status'. |
x |
|
Reason Phrase |
String |
HTTP reason phrase of the response. Former 'http.reason'. |
x |
|
Headers |
Object |
Map of HTTP headers in the message. Former properties. |
x |
Burst Api Limit Config
Use Burst API Limit Profile if the specified burst API limit of the Veeva Vault API reaches or exceeds the configured threshold value.
If the value of Burst API Limit Profile is set to Burst api limit config (Default)
, the connector evaluates the specified burst API limit of the Veeva Vault API response header (X-VaultAPI-BurstLimitRemaining
) against the configured threshold value. If the remaining burst API limit reaches or exceeds the configured threshold value, the connector waits for the specified amount of time to restart the count for Burst Limit Remaining.
For more information, refer to https://developer.veevavault.com/docs/#api-rate-limitsAPI Rate Limit Headers.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Api Limit |
Number |
Veeva Vault API threshold limit. When this threshold is reached or exceeded, the connector waits the specified time. |
|
|
Wait Time |
Number |
Time the connector waits once the threshold value reaches or exceeds the remaining API calls. |
|
|
Max Wait Unit |
Enumeration, one of:
|
Time unit for the Wait Time field. |
|
Daily Api Limit Config
Use Daily API Limit Profile to configure the API limit threshold that is evaluated against the remaining daily API limit calls. If the daily API limit calls reach or exceed the specified API limit threshold value, an exception is thrown. Daily API Limit Profile is disabled by default.
For more information, refer to https://developer.veevavault.com/docs/#api-rate-limitsAPI Rate Limit Headers.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Api Limit |
Number |
API limit threshold value to set the allowed daily limit for the number of API calls. Once the API limit threshold value is reached, the connector throws an |
|