Basic Configuration
BMC Remedy Connector Reference - Mule 4
BMC Remedy Connector v3.0
Release Notes: BMC Remedy Connector Release Notes
Configuration
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 that can be provided to this configuration. |
x |
||
Expiration Policy |
ExpirationPolicy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. The runtime purges the instances as it sees fit. |
Basic Configuration Type
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Username |
String |
The username required to authenticate the end user. |
x |
|
Password |
String |
The password associated with the username. |
x |
|
Server |
String |
The remedy server URL that we want to connect. |
x |
|
Server Port |
Number |
The serverPort which we want to use. |
||
Authentication |
String |
|||
Locale |
String |
|||
Reconnection |
Reconnection |
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. |
||
Cache Timeout Seconds |
Number |
3600 |
||
Attachment As String |
Boolean |
true |
||
Enum As Id |
Boolean |
false |
Operations
-
Create
-
Create Single
-
Delete Entry
-
Disconnect Server
-
Get
-
Get Single
-
Query
-
Update
-
Update Single
-
Upsert
-
Upsert Single
Create
<remedy:create>
Creates the entries in the specified Remedy form.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Entry |
Array of Object |
A list of maps representing the objects to create. |
|
|
Target Variable |
String |
The name of a variable in which the operation’s output is placed. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and the outcome of that expression is stored in the target variable. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Create Single
<remedy:create-single>
Creates a single entry in the specified Remedy form.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Entry |
Object |
A map representing the object to create. |
|
|
Target Variable |
String |
The name of a variable in which the operation’s output is placed. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and the outcome of that expression ide stored in the target variable. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Delete Entry
<remedy:delete-entry>
Removes the form entry with the indicated ID from the specified server. You can delete entries from base forms only. To remove entries from join forms, delete them from the underlying base forms.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form that containing the entry |
x |
|
Entry ID |
String |
The ID of the entry to be deleted. |
x |
|
Delete Option |
Number |
Specify 0 for this parameter (reserved for future use). |
x |
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Disconnect Server
Get
<remedy:get>
Gets the entries with the specified IDs in the specified Remedy form.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Entry ID |
Array of String |
A list containing the IDs for the objects to be retrieved |
|
|
Results use Field IDs |
Boolean |
Optional - Whether the returned value uses the field ID as the key. |
false |
|
Target Variable |
String |
The name of a variable in which the operation’s output is placed. |
||
Target Value |
String |
An expression to evaluate against the operation’s output, and to store the outcome of that expression in the target variable. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Get Single
<remedy:get-single>
Gets the single entry with the specified ID in the specified Remedy form.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Entry ID |
String |
The ID of the object to retrieve. |
|
|
Result uses Field IDs |
Boolean |
Optional - Whether the returned value uses the field ID as the key. |
false |
|
Target Variable |
String |
The name of a variable in which the operation’s output is placed. |
||
Target Value |
String |
An expression to evaluate against the operation’s output, and to store the outcome of that expression in the target variable. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Query
<remedy:query>
Gets the entries in the specified Remedy form that match the query string.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Query |
String |
The qualification string to be parsed |
|
|
Result with Field ID |
Boolean |
Optional - Whether the returned value uses the field ID as the key. |
false |
|
Target Variable |
String |
The name of a variable in which the operation’s output is placed. |
||
Target Value |
String |
An expression to evaluate against the operation’s output, and to store the outcome of that expression in the target variable. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Update
<remedy:update>
Updates the entries in the specified Remedy form.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Entry |
Array of Object |
A list of maps representing the new versions of the objects to be updated. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Update Single
<remedy:update-single>
Updates the single entry in the specified Remedy form.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Entry |
Object |
A map representing the new version of the object to be updated. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Upsert
<remedy:upsert>
Creates the entries in the specified Remedy form.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Entry |
Array of Object |
A list of maps representing the objects to be created or updated. |
|
|
Target Variable |
String |
The name of a variable in which the operation’s output is placed. |
||
Target Value |
String |
An expression to evaluate against the operation’s output, and to store the outcome of that expression in the target variable. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Upsert Single
<remedy:upsert-single>
Upserts the single entry in the specified Remedy form.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Remedy Form Type |
String |
The Remedy Form to use. |
x |
|
Entry |
Object |
A map representing the object to be created or updated |
|
|
Target Variable |
String |
The name of a variable in which the operation’s output is placed. |
||
Target Value |
String |
An expression to evaluate against the operation’s output, and to store the outcome of that expression in the target variable. |
|
|
Reconnection Strategy |
|
A retry strategy in case of connectivity errors. |
Reconnection Type
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. |
Reconnect Type
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to reconnect (in milliseconds). |
||
Count |
Number |
The number of reconnection attempts to make. |
||
blocking |
Boolean |
If false, the reconnection strategy runs in a separate, non-blocking thread. |
true |
Reconnect Forever Type
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often in milliseconds to reconnect. |
||
blocking |
Boolean |
If false, the reconnection strategy runs in a separate, non-blocking thread. |
true |
Expiration Policy
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. |