Listing Rules for a Subject

This RESTful web service request can be used to retrieve a list of rules for a specific subject.

HTTP Method: POST

REST URL Format:

http://host:port/ibi_apps/rs/ibfs/GroupUser

where:

host

Is the name of the system where WebFOCUS is installed.

port

Is the port number used by WebFOCUS.

GroupUser

Is the path to a particular group or user ID. For example:

/SSYS/USERS/userid

Body Format:

IBIRS_action=listRulesForSubject

Example:

In the following example, a list rules is returned for user ID called restid.

POST Request:

http://localhost:8080/ibi_apps/rs/ibfs/restid

Body:

IBIRS_action=listRulesForSubject

Response:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<ibfsrpc _jt="IBFSResponseObject" language="EN" name="listRulesForSubject" returncode="10000" returndesc="SUCCESS" subreturncode="0" subsystem="SSYS" type="simple">
	<ibfsparams size="1">
		<entry key="IBIRS_path" value="/SSYS/USERS/restid"/>
	</ibfsparams>
	<rootObject _jt="IBFSObject" container="true" description="Rules for User:restid" dummy="false" fullPath="NO PATH/RulesList" name="RulesList" type="IBFSFolder">
		<children _jt="ArrayList" size="1">
			<item _jt="IBFSRuleObject" compLvl="0" dummy="false" index="0" pSetName="ListAndRun" parent="RulesList" resPathName="IBFS:/WFC/Repository/Financial_Reports/Quarterly" subject="restid" subjectType="U" type="Rule">
				<verb _jt="IBSSVerb" name="PERMIT"/>
				<applyTo class="com.ibi.ibss.IBSSApplyTo" name="FOLDER_AND_CHILDREN"/>
			</item>
		</children>
	</rootObject>
</ibfsrpc>

If the value for the returncode attribute in the XML response is 10000, then the rules were successfully returned.


WebFOCUS