IM InfoSphere Identity Insight, Version 8.0


reopenAlert() SOAP API method

Transitions a closed alert to an unassigned open disposition. The UMF API equivalent of the reopenAlert method are the SOA_REOPEN_ALERT_REQUEST input document and the SOA_REOPEN_ALERT_RESPONSE output document.

Syntax

reopenAlert
(
 alertIdentifier,
 reopenedByUser,
 openDispositionID,
 comment,
 additionalinfo
 
);

Description

Parameters
alertIdentifier
Type: AlertIdentifier
Nullable: No
This parameter identifies the alert for which the disposition is being updated.
reopenedByUser
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.
openDispositionID
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>
  <reopenAlert xmlns="http://services/">
   <alertIdentifier xmlns="">
    <alertType>ROLE_ALERT</alertType>
    <alertID>71</alertID>
   </alertIdentifier>
   <reopenedByUser xmlns="">admin</reopenedByUser>
   <openDispositionID xsi:type="xsd:long" xmlns="">1</openDispositionID>
   <comment xmlns="">sample reopen comment</comment>
   <additionalInfo xsi:nil="true" xmlns=""/>
  </reopenAlert>
 </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>
  <reopenAlertResponse xmlns="http://services/">
   <alertReopened xmlns="">TRUE</alertReopened>
  </reopenAlertResponse>
 </soapenv:Body>
</soapenv:Envelope>




Feedback



Last updated: 2011