IM Relationship Resolution Information Center, Version 4.2

WS_ALERT format code

When you are building a Web services pipeline search to return all role alerts in the entity database involving a specific entity, use the built-in format code WS_ALERT. This format code is specified in the UMF_QUERY input document that contains the criteria for the query.

Example of a Web services pipeline search using the WS_ALERT format code

This example Web services pipeline search returns a list of all role alerts in which Joe Franklin, entity ID 87, is involved.
Note: This example is formatted for readability and does not follow the required one line per UMF record format.

To request the role alerts for entity ID 87 (Joe Franklin), create a new UMF_QUERY input document with the request:

<UMF_QUERY>
	<FORMAT_CODE>WS_ALERT</FORMAT_CODE>
	<DSRC_CODE>1589</DSRC_CODE>
	<DSRC_REF>BB123-9003</DSRC_REF>
	<ENTITY_ID>87</ENTITY_ID>
</UMF_QUERY>

After sending this UMF_QUERY document through Web services for processing by a Web services pipeline, the calling application receives a response in the following UMF_QUERY_RESULT document:

<UMF_QUERY_RESULT>
 	<ALERT>
		<CONFLICT_ID>2</CONFLICT_ID>
		<CONFLICT_RULES_DESC>Bad Guy Knows Employee</CONFLICT_RULES_DESC>
		<CONF_ENTITY1>87</CONF_ENTITY1>
		<CONF_ENTITY2>376</CONF_ENTITY2>
		<DEGREE_OF_SEP>1</DEGREE_OF_SEP>
		<INBOUND_ENTITY_ID>87</INBOUND_ENTITY_ID>
		<NAME1>FRANKLIN, JOSEPH</NAME1>
		<NAME2>MILLER, SUSAN</NAME2>
		<PATH_STRENGTH>80</PATH_STRENGTH>
	</ALERT>
	<ALERT>
		<CONFLICT_ID>5</CONFLICT_ID>
		<CONFLICT_RULES_DESC>Bad Guy Knows Vendor</CONFLICT_RULES_DESC>
		<CONF_ENTITY1>87</CONF_ENTITY1>
		<CONF_ENTITY2>10651</CONF_ENTITY2>
		<DEGREE_OF_SEP>1</DEGREE_OF_SEP>
		<INBOUND_ENTITY_ID>87</INBOUND_ENTITY_ID>
		<NAME1>FRANKLIN, JOSEPH</NAME1>
		<NAME2>MARTINEZ, JULIO</NAME2>
		<PATH_STRENGTH>64</PATH_STRENGTH>
	</ALERT>
	<DSRC_CODE>1589</DSRC_CODE>
	<FROMNODE>BB123-9003</FROMNODE>
</UMF_QUERY_RESULT>

From this response, you can see that there are two role alerts for Joe Franklin: an alert where employee Susan Miller knows Joe, and an alert where vendor Julio Martinez knows Joe.



Feedback

Last updated: 2009