IM InfoSphere Identity Insight, Version 8.0


dispositionAlert() SOAP API method

Changes the disposition of the alert without changing the alert status. The UMF API equivalent of the dispositionAlert method are the SOA_DISPOSITION_ALERT_REQUEST input document and the SOA_DISPOSITION_ALERT_RESPONSE output document.

Syntax

dispositionAlert
(
 alertIdentifier,
 dispositionID,
 dispositionedByUser, 
 comment,
 additionalinfo
 
);

Description

Parameters
alertIdentifier
Type: AlertIdentifier
Nullable: No
This parameter identifies the alert for which the disposition is being updated.
dispositionedByUser
Type: String
Nullable: No
This parameter identifies the user name of the analyst performing the change in disposition for the alert. The user should be a recognized active user.
dispositionID
Type: long integer (64-bit)
Nullable: No
This parameter identifies the disposition to be assigned to the alert.
comment
Type: String
Nullable: No
This parameter details the reasons why the disposition is being changed for the alert.
additionalinfo
Type: CustomInformation
Nullable: Yes
This parameter is reserved for field customizations to the WSDL and XSLT transforms without changing the signature of the method.
Example Request
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soapenv:Body>
  <dispositionAlert xmlns="http://services/">
   <alertID xmlns="">
    <alertType>ROLE_ALERT</alertType>
    <alertID>4</alertID>
   </alertID>
   <dispositionID xsi:type="xsd:long" xmlns="">3</dispositionID>
   <dispositionedByUser xmlns="">admin</dispositionedByUser>
   <comment xmlns="">disposition alert comment</comment>
   <additionalInfo xsi:nil="true" xmlns=""/>
  </dispositionAlert>
 </soapenv:Body>
</soapenv:Envelope>

Description

Returns
boolean
Values:
TRUE
request executed
FALSE
request NOT executed
Example Response
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
 <soapenv:Body>
  <dispositionAlertResponse xmlns="http://services/">
   <success xmlns="">TRUE</success>
  </dispositionAlertResponse>
 </soapenv:Body>
</soapenv:Envelope>




Feedback



Last updated: 2011