IM InfoSphere Identity Insight, Version 8.0


getRoleAlertByID() SOAP API method

Requests and obtains the details of a role alert that is identified by the specified role alert ID. The UMF API equivalent of the getRoleAlertByID method are the SOA_ROLE_ALERT_BY_ID_REQUEST input document and the SOA_ROLE_ALERT_BY_ID_RESPONSE output document.

Syntax

getRoleAlertByID
(
 alertID,
 depth,
 additionalinfo

 
);

Description

Parameters
alertID
Type: long integer (64-bit)
Nullable: No
This parameter identifies the alert being requested.
depth
Type: DepthSetting
Nullable: Yes
This parameter indicates the level of detail for the response. If not specified, then FULL is assumed.
Valid Values: FULL
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>
  <getRoleAlertByID xmlns="http://services/">
   <alertID xsi:type="xsd:long" xmlns="">1</alertID>
   <depth xsi:type="ns1:DepthSetting" xmlns:ns1="http://common/" xmlns="">
    <value>FULL</value>
   </depth>
   <additionalInfo xsi:nil="true" xmlns=""/>
  </getRoleAlertByID>
 </soapenv:Body>
</soapenv:Envelope>

Description

Returns
getRoleAlertByIDResponse
roleAlert
minOccurs="0"
type="xsd_2:RoleAlertDetail"
RoleAlertDetail
AlertDetail
alertID
type=" xsd_1:AlertIdentifier
AlertIdentifier
alertType
type=" xsd_2:AlertType
AlertType
type="xsd:string"
Values: ROLE_ALERT, ATTRIBUTE_ALERT, TRANSACTION_ALERT, EVENT_ALERT
alertID
type="xsd:long"
timestamp
type="xsd:dateTime"
alertAnalysis
maxOccurs="unbounded"
minOccurs="0"
type=" xsd_1:AlertAnalysis
AlertAnalysis
dispositionID
type="xsd:long"
comment
type="xsd:string"
timestamp
type="xsd:dateTime"
createdBy
type="xsd:string"
dispositionID
type="xsd:long"
roleAlertRuleID
type="xsd:long"
entities
type=" xsd_2:EntityDetail
EntityDetail
entityID
type="xsd:long"
largeEntity
minOccurs="0"
type="xsd:boolean"
entityType
minOccurs="0"
type="xsd:string"
bestName
minOccurs="0"
type=" xsd_1:NameDetail
NameDetail
AttributeDetail
IdentityHandle
internalID
type="xsd:long"
externalID
type="xsd:string"
dataSourceCode
type="xsd:string"
externalReference
type="xsd:string"
lastModifiedTimestamp
type="xsd:dateTime"
validFromTimestamp
type="xsd:dateTime"
validThroughTimestamp
type="xsd:dateTime"
nameID
type="xsd:long"
nameTypeCode
type="xsd:string"
givenName
type="xsd:string"
surname
type="xsd:string"
generation
type="xsd:string"
prefix
type="xsd:string"
suffix
type="xsd:string"
culture
type="xsd:string"
bestAddress
minOccurs="0"
type=" xsd_1:AddressDetail
AddressDetail
base="xsd_1:AttributeDetail"
AttributeDetail
IdentityHandle
internalID
type="xsd:long"
externalID
type="xsd:string"
dataSourceCode
type="xsd:string"
externalReference
type="xsd:string"
lastModifiedTimestamp
type="xsd:dateTime"
validFromTimestamp
type="xsd:dateTime"
validThroughTimestamp
type="xsd:dateTime"
addressID
type="xsd:long"
addressTypeCode
type="xsd:string"
street1
type="xsd:string"
street2
type="xsd:string"
street3
type="xsd:string"
city
type="xsd:string"
state
type="xsd:string"
stateAbbreviation
type="xsd:string"
country
type="xsd:string"
countryISOCode
type="xsd:string"
postalCode
type="xsd:string"
buildingType
type="xsd:string"
latitude
type="xsd:decimal"
longitude
type="xsd:decimal"
leftovers
type="xsd:string"
bestNumber
minOccurs="0"
type=" xsd_1:NumberDetail
NumberDetail
AttributeDetail
IdentityHandle
internalID
type="xsd:long"
externalID
type="xsd:string"
dataSourceCode
type="xsd:string"
externalReference
type="xsd:string"
lastModifiedTimestamp
type="xsd:dateTime"
validFromTimestamp
type="xsd:dateTime"
validThroughTimestamp
type="xsd:dateTime"
numberID
type="xsd:long"
numberValue
type="xsd:string"
location
type="xsd:string"
numberTypeID
type="xsd:long"
userDefinedStatus
type="xsd:string"
bestEmail
minOccurs="0"
type=" xsd_1:EmailDetail
EmailDetail
AttributeDetail
IdentityHandle
internalID
type="xsd:long"
externalID
type="xsd:string"
dataSourceCode
type="xsd:string"
externalReference
type="xsd:string"
lastModifiedTimestamp
type="xsd:dateTime"
validFromTimestamp
type="xsd:dateTime"
validThroughTimestamp
type="xsd:dateTime"
emailID
type="xsd:long"
emailAddress
type="xsd:string"
userEmailType
type="xsd:string"
userDefinedStatus
type="xsd:string"
roleIDs
maxOccurs="unbounded"
minOccurs="0"
type="xsd:long"
identities
maxOccurs="unbounded"
minOccurs="0"
type=" xsd_1:IdentityDetail
identityHandle
internalID
type="xsd:long"
externalID
type="xsd:string"
dataSourceCode
type="xsd:string"
externalReference
type="xsd:string"
roleIDs
type="xsd:long"
attributes
type=" xsd_1:AttributeDetail
identityHandle
type=" xsd_1:IdentityHandle
internalID
type="xsd:long"
externalID
type="xsd:string"
dataSourceCode
type="xsd:string"
externalReference
type="xsd:string"
lastModifiedTimestamp
type="xsd:dateTime"
validFromTimestamp
type="xsd:dateTime"
validThroughTimestamp
type="xsd:dateTime"
relationshipPath
type=" xsd_3:RelationshipPath
RelationshipPath
fromEntityID
type="xsd:long"
toEntityID
type="xsd:long"
pathStrength
minOccurs="0"
type="xsd:float
degreesOfSeparation
minOccurs="0"
type="xsd:int
relationships
maxOccurs="unbounded"
minOccurs="0"
type=" xsd_1:Relationship
Relationship
fromEntityID
type="xsd:long"
toEntityID
type="xsd:long"
resolutionDetail
type=" xsd_2:ResolutionDetail
ResolutionDetail
relationshipConfidence
minOccurs="0"
type="xsd:int
likenessConfidence
minOccurs="0"
type="xsd:int
resolutionID
minOccurs="0"
type="xsd:long"
resolutionRuleID
minOccurs="0"
type="xsd:long"
resolutionRuleDescription
minOccurs="0"
type="xsd:string"
contributors
maxOccurs="unbounded"
minOccurs="0"
type=" xsd_1:ResolutionContributor
adjustedPathStrength
type="xsd:float:
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>
  <getRoleAlertByIDResponse xmlns="http://services/">
   <roleAlert xmlns="">
    <alertID>
     <alertType>ROLE_ALERT</alertType>
     <alertID>1</alertID>
    </alertID>
    <timestamp>2008-07-28T15:11:51</timestamp>
    <dispositionID>1</dispositionID>
    <roleAlertRuleID>1</roleAlertRuleID>
    <entities>
     <entityID>2</entityID>
     <roleIDs>1</roleIDs>
     <largeEntity>FALSE</largeEntity>
     <entityType>PERSON</entityType>
     <bestName>
      <identityHandle>
       <internalID>3</internalID>
       <externalID>190-020028</externalID>
       <dataSourceCode>100</dataSourceCode>
       <externalReference>190-020028</externalReference>
      </identityHandle>
      <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
      <nameID>3</nameID>
      <nameTypeCode>M</nameTypeCode>
      <givenName>WILLIAM</givenName>
      <surname>BROWNSR</surname>
     </bestName>
     <bestAddress>
      <identityHandle>
       <internalID>3</internalID>
       <externalID>190-020028</externalID>
       <dataSourceCode>100</dataSourceCode>
       <externalReference>190-020028</externalReference>
      </identityHandle>
      <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
      <addressID>4</addressID>
      <addressTypeCode>O</addressTypeCode>
      <street1>111 First St</street1>
      <city>LV</city>
      <state>NV</state>
      <country>USA</country>
      <postalCode>89110</postalCode>
     </bestAddress>
     <bestNumber>
      <identityHandle>
       <internalID>3</internalID>
       <externalID>190-020028</externalID>
       <dataSourceCode>100</dataSourceCode>
       <externalReference>190-020028</externalReference>
      </identityHandle>
      <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
      <numberID>3</numberID>
      <numberTypeID>2</numberTypeID>
      <numberValue>191-54-2667</numberValue>
     </bestNumber>
     <identities>
      <identityHandle>
       <internalID>2</internalID>
       <externalID>190-020025</externalID>
       <dataSourceCode>100</dataSourceCode>
       <externalReference>190-020025</externalReference>
      </identityHandle>
      <roleIDs>1</roleIDs>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:NameDetail">
       <identityHandle>
        <internalID>2</internalID>
        <externalID>190-020025</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020025</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <nameID>2</nameID>
       <nameTypeCode>M</nameTypeCode>
       <givenName>BILL</givenName>
       <surname>BROWNJR</surname>
      </attributes>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:AddressDetail">
       <identityHandle>
        <internalID>2</internalID>
        <externalID>190-020025</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020025</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <addressID>2</addressID>
       <addressTypeCode>H</addressTypeCode>
       <street1>4170 Rue Sere</street1>
       <city>St Laurent</city>
       <state>Quebec</state>
       <country>Canada</country>
       <postalCode>h4t1a6</postalCode>
      </attributes>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:NumberDetail">
       <identityHandle>
        <internalID>2</internalID>
        <externalID>190-020025</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020025</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <numberID>2</numberID>
       <numberTypeID>2</numberTypeID>
       <numberValue>191-54-2667</numberValue>
      </attributes>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:CharacteristicDetail">
       <identityHandle>
        <internalID>2</internalID>
        <externalID>190-020025</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020025</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <characteristicID>2</characteristicID>
       <characteristicValue>M</characteristicValue>
       <characteristicTypeID>2</characteristicTypeID>
      </attributes>
     </identities>
     <identities>
      <identityHandle>
       <internalID>3</internalID>
       <externalID>190-020028</externalID>
       <dataSourceCode>100</dataSourceCode>
       <externalReference>190-020028</externalReference>
      </identityHandle>
      <roleIDs>1</roleIDs>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:NameDetail">
       <identityHandle>
        <internalID>3</internalID>
        <externalID>190-020028</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020028</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <nameID>3</nameID>
       <nameTypeCode>M</nameTypeCode>
       <givenName>WILLIAM</givenName>
       <surname>BROWNSR</surname>
      </attributes>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:AddressDetail">
       <identityHandle>
        <internalID>3</internalID>
        <externalID>190-020028</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020028</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <addressID>3</addressID>
       <addressTypeCode>B</addressTypeCode>
       <street1>4170 Rue Sere</street1>
       <city>St Laurent</city>
       <state>Quebec</state>
       <country>Canada</country>
       <postalCode>h4t1a6</postalCode>
      </attributes>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:AddressDetail">
       <identityHandle>
        <internalID>3</internalID>
        <externalID>190-020028</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020028</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <addressID>4</addressID>
       <addressTypeCode>O</addressTypeCode>
       <street1>111 First St</street1>
       <city>LV</city>
       <state>NV</state>
       <country>USA</country>
       <postalCode>89110</postalCode>
      </attributes>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:NumberDetail">
       <identityHandle>
        <internalID>3</internalID>
        <externalID>190-020028</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020028</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <numberID>3</numberID>
       <numberTypeID>2</numberTypeID>
       <numberValue>191-54-2667</numberValue>
      </attributes>
      <attributes xmlns:ns2="http://entity/results/" xsi:type="ns2:CharacteristicDetail">
       <identityHandle>
        <internalID>3</internalID>
        <externalID>190-020028</externalID>
        <dataSourceCode>100</dataSourceCode>
        <externalReference>190-020028</externalReference>
       </identityHandle>
       <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
       <characteristicID>3</characteristicID>
       <characteristicValue>M</characteristicValue>
       <characteristicTypeID>2</characteristicTypeID>
      </attributes>
     </identities>
    </entities>
    <relationshipPath>
     <fromEntityID>2</fromEntityID>
     <toEntityID>2</toEntityID>
     <pathStrength>100.00</pathStrength>
     <degreesOfSeparation>0</degreesOfSeparation>
     <relationships>
      <fromEntityID>2</fromEntityID>
      <toEntityID>2</toEntityID>
      <resolutionDetail>
       <relationshipConfidence>100</relationshipConfidence>
       <likenessConfidence>100</likenessConfidence>
       <resolutionID>3</resolutionID>
       <resolutionRuleID>1</resolutionRuleID>
       <resolutionRuleDescription>Name &amp; Unique Number</resolutionRuleDescription>
       <contributors xmlns:ns1="http://resolution/results/" xsi:type="ns1:ResolvedName">
        <givenNameScore xsi:type="xsd:double">95.000</givenNameScore>
        <surnameScore xsi:type="xsd:double">78.000</surnameScore>
        <fullNameScore xsi:type="xsd:double">79.000</fullNameScore>
        <nameAlgorithm>NAME_COMPARATOR_2</nameAlgorithm>
        <inboundName>
         <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
         <nameID>3</nameID>
         <nameTypeCode>M</nameTypeCode>
         <givenName>WILLIAM</givenName>
         <surname>BROWNSR</surname>
        </inboundName>
        <existingName>
         <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
         <nameID>2</nameID>
         <nameTypeCode>M</nameTypeCode>
         <givenName>BILL</givenName>
         <surname>BROWNJR</surname>
        </existingName>
       </contributors>
       <contributors xmlns:ns1="http://resolution/results/" xsi:type="ns1:ResolvedAddress">
        <matchType>FULL_ADDRESS</matchType>
        <score>8</score>
        <inboundAddress>
         <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
         <addressID>3</addressID>
         <addressTypeCode>B</addressTypeCode>
         <street1>4170 Rue Sere</street1>
         <city>St Laurent</city>
         <state>Quebec</state>
         <country>Canada</country>
         <postalCode>h4t1a6</postalCode>
        </inboundAddress>
        <existingAddress>
         <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
         <addressID>2</addressID>
         <addressTypeCode>H</addressTypeCode>
         <street1>4170 Rue Sere</street1>
         <city>St Laurent</city>
         <state>Quebec</state>
         <country>Canada</country>
         <postalCode>h4t1a6</postalCode>
        </existingAddress>
       </contributors>
       <contributors xmlns:ns1="http://resolution/results/" xsi:type="ns1:ResolvedNumber">
        <inboundNumber>
         <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
         <numberID>3</numberID>
         <numberTypeID>2</numberTypeID>
         <numberValue>191-54-2667</numberValue>
        </inboundNumber>
        <existingNumber>
         <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
         <numberID>2</numberID>
         <numberTypeID>2</numberTypeID>
         <numberValue>191-54-2667</numberValue>
        </existingNumber>
       </contributors>
       <contributors xmlns:ns1="http://resolution/results/" xsi:type="ns1:ResolvedDate">
        <scoreAdjustment>5</scoreAdjustment>
        <inboundCharacteristic xmlns:ns1="http://entity/results/"
         xsi:type="ns1:CharacteristicDetail">
         <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
         <characteristicID>3</characteristicID>
         <characteristicValue>M</characteristicValue>
         <characteristicTypeID>2</characteristicTypeID>
        </inboundCharacteristic>
        <existingCharacteristic xmlns:ns1="http://entity/results/"
         xsi:type="ns1:CharacteristicDetail">
         <lastModifiedTimestamp>2008-07-28T15:11:51</lastModifiedTimestamp>
         <characteristicID>2</characteristicID>
         <characteristicValue>M</characteristicValue>
         <characteristicTypeID>2</characteristicTypeID>
        </existingCharacteristic>
        <dateScore>0</dateScore>
       </contributors>
      </resolutionDetail>
     </relationships>
    </relationshipPath>
    <adjustedPathStrength>100.00</adjustedPathStrength>
   </roleAlert>
  </getRoleAlertByIDResponse>
 </soapenv:Body>
</soapenv:Envelope>




Feedback



Last updated: 2011