# mulesoft Zuora AQuA Connector - Full Documentation --- product: Zuora AQuA Connector version: 1.0 is-latest-version: true --- # Zuora AQuA Connector > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Zuora AQuA Connector v1.0.0 Anypoint Connector for Zuora AQuA (Zuora AQuA Connector) is a smart connector that is generated using REST Connect 2.0. Zuora AQuA Connector enables you to connect to the Zuora platform and use all the operations provided by the Zuora AQuA API, including: - Creating a batch query - Deleting batch query jobs by ID - Retrieving an aggregate query using the job ID - Retrieving batch query jobs partner project by partner project ID - Retrieving a file by the file ID For information about the Zuora AQuA API methods and parameters, see the Zuora AQuA API Documentation. ## About Connectors Anypoint connectors are Mule runtime engine (Mule) extensions that enable you to connect to APIs and resources on external systems, such as Salesforce, Zuora AQuA, ServiceNow, and Twitter. ## Before You Begin To use the Zuora AQuA connector, you must be familiar with Zuora AQuA, Mule, Anypoint Connectors, Anypoint Studio, Mule concepts, elements in a Mule flow, and Global Elements. Before creating an app, you must have access to the Zuora AQuA target resource and Anypoint Platform. You must also understand how to create a Mule app using Anypoint Studio. ## Next Step After you have read this topic, you are ready to create an app with [Anypoint Studio](https://docs.mulesoft.com/zuora-aqua-connector/latest/zuora-aqua-connector-studio). ## See Also - [Zuora AQuA connector in Anypoint Exchange](https://www.mulesoft.com/exchange/com.mulesoft.connectors/mule-zuora-aqua-connector/) - [Zuora AQuA Release Notes](https://docs.mulesoft.com/release-notes/connector/zuora-aqua-release-notes-mule-4) - [Salesforce Help](https://help.salesforce.com) - [REST Connect Connector Generator](https://docs.mulesoft.com/exchange/to-deploy-using-rest-connect) --- product: Zuora AQuA Connector version: 1.0 is-latest-version: true --- # Zuora Aqua Connector Reference > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Support Version: Select Zuora AQuA Connector v1.0.0 ## Configurations --- ### Config #### Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Name | String | The name for this configuration. Connectors reference the configuration with this name. | x | |
Connection | The connection types to provide to this configuration. | x | ||
Response Timeout | Number | The timeout for request to the remote service. |
| |
Response Timeout Unit | Enumeration, one of:
| A time unit that qualifies the response timeout |
| |
Name | String | The identifier of this element used to reference it in other components | x | |
Expiration Policy | Configures the minimum amount of time that a dynamic configuration instance can remain idle before it is eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances when appropriate. |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Default Headers | Array of Default Header | |||
Query Parameters | Array of Default Query Param | |||
Connection Timeout | Number | The timeout for establishing connections to the remote service |
| |
Connection Timeout Unit | Enumeration, one of:
| A time unit that qualifies the connection timeout |
| |
Use Persistent Connections | Boolean | If |
| |
Max Connections | Number | The maximum number of outbound connections kept open at the same time |
| |
Connection Idle Timeout | Number | A timeout for how long a connection can remain idle before it is closed |
| |
Connection Idle Timeout Unit | Enumeration, one of:
| A time unit that qualifies the connection idle timeout | SECONDS | |
Proxy Config | Reusable configuration element for outbound connections through a proxy | |||
Stream Response | Boolean | Whether or not to stream the received responses |
| |
Response Buffer Size | Number | The space (in bytes) for the buffer where the HTTP response will be stored. |
| |
Username | String | The username to authenticate the requests | ||
Password | String | The password to authenticate the requests | ||
Base Uri | String | Parameter base URI, each instance or tenant gets its own |
| |
TLS Configuration | ||||
Reconnection | When the application is deployed, a connectivity test is performed on all connectors. If set to |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
Zuora Entity Ids | String | An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is valid only for a single entity, or you do not have Zuora multi-entity enabled, you do not need to set this header. | ||
Content | Binary | The content to use | #[payload] | |
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component. | ||
Streaming Strategy |
| Configure to use repeatable streams. | ||
Custom Query Parameters | Object | |||
Custom Headers | Object | |||
Response Timeout | Number | The timeout for request to the remote service. | ||
Response Timeout Unit | Enumeration, one of:
| A time unit that qualifies the response timeout. | ||
Target Variable | String | The name of a variable to store the operation’s output. | ||
Target Value | String | An expression to evaluate against the operation’s output and store the expression outcome in the target variable. | #[payload] | |
Reconnection Strategy | A retry strategy in case of connectivity errors. |
Type | Any |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
id | String | The ID of the job. | x | |
Zuora Entity Ids | String | An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is valid only for a single entity, or you do not have Zuora multi-entity enabled, you do not need to set this header. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component | ||
Streaming Strategy |
| Configure to use repeatable streams. | ||
Custom Query Parameters | Object | #[null] | ||
Custom Headers | Object | |||
Response Timeout | Number | The timeout for request to the remote service. | ||
Response Timeout Unit | Enumeration, one of:
| A time unit that qualifies the response timeout | ||
Target Variable | String | The name of a variable to store the operation’s output. | ||
Target Value | String | An expression to evaluate against the operation’s output and store the expression outcome in the target variable | #[payload] | |
Reconnection Strategy | A retry strategy in case of connectivity errors |
Type | Any |
Attributes Type |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
id | String | The ID of the job. | x | |
Zuora Entity Ids | String | An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is valid only for a single entity, or you do not have Zuora multi-entity enabled, you do not need to set this header. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component | ||
Streaming Strategy |
| Configure to use repeatable streams. | ||
Custom Query Parameters | Object | #[null] | ||
Custom Headers | Object | |||
Response Timeout | Number | The timeout for request to the remote service. | ||
Response Timeout Unit | Enumeration, one of:
| A time unit which qualifies the Response Timeout} | ||
Target Variable | String | The name of a variable to store the operation’s output. | ||
Target Value | String | An expression to evaluate against the operation’s output and store the expression outcome in the target variable | #[payload] | |
Reconnection Strategy | A retry strategy in case of connectivity errors |
Type | Any |
Attributes Type |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
partner | String | The partner field indicates the unique ID of a data integration partner. | x | |
project | String | The project field contains the unique ID of a data integration project for a particular partner. | x | |
Zuora Entity Ids | String | An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is only valid for a single entity, or you do not have Zuora Multi-entity enabled, you do not need to set this header. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component | ||
Streaming Strategy |
| Configure to use repeatable streams. | ||
Custom Query Parameters | Object | #[null] | ||
Custom Headers | Object | |||
Response Timeout | Number | The timeout for request to the remote service. | ||
Response Timeout Unit | Enumeration, one of:
| A time unit which qualifies the Response Timeout} | ||
Target Variable | String | The name of a variable to store the operation’s output. | ||
Target Value | String | An expression to evaluate against the operation’s output and store the expression outcome in the target variable | #[payload] | |
Reconnection Strategy | A retry strategy in case of connectivity errors |
Type | Any |
Attributes Type |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
File id | String | The Zuora ID of the file to retrieve. | x | |
Zuora Entity Ids | String | An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is only valid for a single entity, or you do not have Zuora Multi-entity enabled, you do not need to set this header. | ||
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component | ||
Streaming Strategy |
| Configure to use repeatable streams. | ||
Custom Query Parameters | Object | #[null] | ||
Custom Headers | Object | |||
Response Timeout | Number | The timeout for request to the remote service. | ||
Response Timeout Unit | Enumeration, one of:
| A time unit which qualifies the Response Timeout} | ||
Target Variable | String | The name of a variable to store the operation’s output. | ||
Target Value | String | An expression to evaluate against the operation’s output and store the expression outcome in the target variable | #[payload] | |
Reconnection Strategy | A retry strategy in case of connectivity errors |
Type | Any |
Attributes Type |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration | String | The name of the configuration to use. | x | |
Object Store Name | String | The name of the objectStore that holds the JobId’s from the PostQuery results. | ||
Entity Parameters | ||||
Expected Status | Enumeration, one of:
| The expected status of the job to be retrieved. | COMPLETED | |
Config Ref | ConfigurationProvider | The name of the configuration to use to execute this component | ||
Primary Node Only | Boolean | Whether this source should only be executed on the primary node when running in Cluster | ||
Scheduling Strategy | scheduling-strategy | Configures the scheduler that triggers the polling | x | |
Streaming Strategy |
| Configure to use repeatable streams. | ||
Redelivery Policy | Defines a policy for processing the redelivery of the same message | |||
Reconnection Strategy | A retry strategy in case of connectivity errors |
Type | Any |
Attributes Type | Any |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Key | String | x | ||
Value | String | x |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Key | String | x | ||
Value | String | x |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Host | String | x | ||
Port | Number | x | ||
Username | String | |||
Password | String | |||
Non Proxy Hosts | String |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Enabled Protocols | String | A comma separated list of protocols enabled for this context. | ||
Enabled Cipher Suites | String | A comma separated list of cipher suites enabled for this context. | ||
Trust Store | ||||
Key Store | ||||
Revocation Check |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path | String | The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store. | ||
Password | String | The password used to protect the trust store. | ||
Type | String | The type of store used. | ||
Algorithm | String | The algorithm used by the trust store. | ||
Insecure | Boolean | If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path | String | The location (which will be resolved relative to the current classpath and file system, if possible) of the key store. | ||
Type | String | The type of store used. | ||
Alias | String | When the key store contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default. | ||
Key Password | String | The password used to protect the private key. | ||
Password | String | The password used to protect the key store. | ||
Algorithm | String | The algorithm used by the key store. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Only End Entities | Boolean | Only verify the last element of the certificate chain. | ||
Prefer Crls | Boolean | Try CRL instead of OCSP first. | ||
No Fallback | Boolean | Do not use the secondary checking method (the one not selected before). | ||
Soft Fail | Boolean | Avoid verification failure when the revocation server can not be reached or is busy. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Url | String | The URL of the OCSP responder. | ||
Cert Alias | String | Alias of the signing certificate for the OCSP response (must be in the trust store), if present. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path | String | The path to the CRL file. |
| 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 true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy. | ||
Reconnection Strategy | The reconnection strategy to use. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Frequency | Number | How often in milliseconds to reconnect | ||
Blocking | Boolean | If false, the reconnection strategy will run in a separate, non-blocking thread | ||
Count | Number | How many reconnection attempts to make. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Frequency | Number | How often in milliseconds to reconnect | ||
Blocking | Boolean | If false, the reconnection strategy will run in a separate, non-blocking thread |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Max Idle Time | Number | A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration | ||
Time Unit | Enumeration, one of:
| A time unit that qualifies the maxIdleTime attribute |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Entity Id | String | An optional parameter if the Zuora customer has multiple entities (either entityId or entityName must be specified). | ||
Entity Name | String | An optional parameter if the Zuora customer has multiple entities (either entityId or entityName must be specified). |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Initial Buffer Size | Number | The amount of memory to allocate to consume the stream and provide random access to it. If the stream contains more data than fits into this buffer, then the buffer expands according to the Buffer size increment attribute, with an upper limit of Max in memory size. | ||
Buffer Size Increment | Number | This specifies 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, and that a | ||
Max Buffer Size | Number | The maximum amount of memory to use. If more than that is used then a | ||
Buffer Unit | Enumeration, one of:
| The unit in which all these attributes are expressed |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
In Memory Size | Number | Defines the maximum memory that the stream should use to keep data in memory. If more than that is consumed then it will start to buffer the content on disk. | ||
Buffer Unit | Enumeration, one of:
| The unit in which Max in memory size is expressed |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Max Redelivery Count | Number | The maximum number of times a message can be redelivered and processed unsuccessfully before triggering a process-failed-message | ||
Message Digest Algorithm | String | The secure hashing algorithm to use. If not set, the default is SHA-256. | ||
Message Identifier | Defines which strategy is used to identify the messages. | |||
Object Store | ObjectStore | The object store where the redelivery counter for each message is going to be stored. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Use Secure Hash | Boolean | Whether to use a secure hash algorithm to identify a redelivered message. | ||
Id Expression | String | Defines one or more expressions to use to determine when a message has been redelivered. This property may only be set if useSecureHash is false. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Status Code | Number | x | ||
Headers | Object | x | ||
Reason Phrase | String | x |