Sun[TM] Identity Manager 8.0 Resources Reference |
RemedyThe Remedy resource adapter is defined in the com.waveset.adapter.RemedyResourceAdapter class.
Resource Configuration Notes
If you set the ARTCPPORT and ARRPC environment variables, then these values will override the values specified in the Remedy TCP Port and Remedy RPC Socket resource parameters.
Identity Manager Installation Notes
You must place multiple Remedy API libraries in the directory where the Gateway is installed. These libraries can be found on the Remedy server.
Remedy 4.x and 5.x
Remedy 6.3
Remedy 7.0
where XX matches the version of Remedy. For example, arapi45.dll on Remedy 4.5.
Usage Notes
Workflows
See Identity Manager Administration for more information about Remedy integration.
If you do not enable the Active Sync functionality, then the Remedy adapter automates the integration of Remedy tickets into a Identity Manager workflow.
If you use the Active Sync functionality, then the adapter can be configured to support the following features:
With Active Sync, the Remedy adapter uses the Update Search Filter, Last Fetched Conjunction, and Last Fetched Filter resource parameters to determine which tickets are returned. The Update Search Filter or Last Fetched Filter, or both, should be used.
The Update Search Filter parameter is an optional parameter that contains an executable Remedy search expression. This parameter can contain any valid search expression that can be entered in the Advanced Search Criteria of the Remedy User application. (Valid search expressions can contain fields, selection values, and keywords.) The adapter does not attempt to check the validity of the search expression.
The following examples illustrate search expressions that would work with the Help Desk Cases sample form provided with the Remedy User application.
If the Last Fetched Filter parameter is used, then the Last Fetched Conjunction parameter must also be specified. The Last Fetched Conjection parameter may contain one of the following values:
The Last Fetched Filter parameter specifies another Remedy search expression, but this expression can contain one or more user attributes defined in Identity Manager. This feature allows you to construct an expression that compares values returned in a previous poll to values returned in the current poll. For example, if the Case ID+ field on your Remedy form contains an ID that is unique for every ticket, then this value can be compared on each poll. If the value is higher on the current poll than on the previous poll, then return information about the ticket. The following expression illustrates this feature:
'Case ID+' > "$(caseId)"
The value specified between the parentheses must be a Waveset User Attribute defined on the schema map page. The $(caseId) token will be replaced with the value returned on the previous poll. An example value might be HD0000045.
Note
The first time the adapter polls, the Last Fetched Filter is not applied, because there are no previously fetched values. The filter will be run in all subsequent polls.
The adapter concatenates the Update search filter, Last Fetched Conjunction, and Last Fetched Filter resource parameters and sends a search expression similar to the following:
'Status' = "New" AND 'Case ID+' > "HD00000045"
Gateway Timeouts
The Remedy adapter allows you to use the RA_HANGTIMEOUT resource attribute to specify a timeout value, in seconds. This attribute controls how long before a request to the gateway times out and is considered hung.
You must manually add this attribute to the Resource object as follows:
<ResourceAttribute name='Hang Timeout' displayName='com.waveset.adapter.RAMessages:RESATTR_HANGTIMEOUT' type='int' description='com.waveset.adapter.RAMessages:RESATTR_HANGTIMEOUT_HELP' value='NewValue'>
</ResourceAttribute>The default value for this attribute is 0, indicating that Identity Manager will not check for a hung connection.
Security Notes
This section provides information about supported connections and privilege requirements.
Supported Connections
Identity Manager uses Remedy APIs to communicate with the Remedy adapter.
Required Administrative Privileges
The account used to login to the Remedy server must be on the permission list of all Remedy objects accessed by Identity Manager.
Provisioning Notes
The attributes of Remedy users are based on a schema that is established within the Remedy application. Refer to the Remedy documentation for information about the schema and details of its operation.
The Remedy adapter supports the following provisioning capabilities:
The following table summarizes the provisioning capabilities of this adapter.
Feature
Supported?
Enable/disable account
Not applicable
Expire passwords
No
Rename account
No
Pass-through authentication
No
Before/after actions
No
Data loading methods
Account Attributes
The Remedy adapter does not provide default account attributes. Use the following guidelines when adding custom attributes:
Resource Object Management
None
Identity Template
The identity template for Remedy is generated by the Remedy system. Any identity template established through Identity Manager is ignored.
Sample Forms
None
Troubleshooting
Use the Identity Manager debug pages to set trace options on the following class:
com.waveset.adapter.RemedyResourceAdapter
In addition, you can set the following Identity Manager logging parameters for the resource instance:
Tracing can also be enabled on the following methods to diagnose problems connecting to the gateway: