Deleting a Rule

This RESTful web service request can be used to remove a rule.

HTTP Method: POST

REST URL Format:

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

where:

host

Is the name of the system where WebFOCUS is installed.

port

Is the port number used by WebFOCUS.

ItemRestricted

Is the path to the item that is being restricted. For example:

/WFC/Repository/ParentFolder/FolderName

Body Format:

IBIRS_action=removeRule&IBIRS_path=ItemRestricted&IBIRS_subjectPath=GroupUser&
IBIRS_role=Role

where:

ItemRestricted

Is the path to the item that is being restricted. For example:

/WFC/Repository/ParentFolder/FolderName

GroupUser

Is the path to a particular group or user ID to which a specific role was applied. For example:

/SSYS/USERS/userid

Role

Is the specific role that was applied to GroupUser. For example, List, Run, and ListAndRun.

Example:

In the following example, a rule is removed for user ID (restid) to list and run items from the Quarterly folder within Financial_Reports.

POST Request:

http://localhost:8080/ibi_apps/rs/ibfs/WFC/Repository/Financial_Reports/Quarterly

Body:

IBIRS_action=removeRule&IBIRS_path=/WFC/Repository/Financial_Reports/Quarterly
&IBIRS_subjectPath=/SSYS/USERS/restid&IBIRS_role=ListAndRun

Response:

<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<ibfsrpc _jt="IBFSResponseObject" language="EN" name="removeRule" returncode="10000" returndesc="SUCCESS" subreturncode="0"
         subsystem="SSYS" type="simple">
   <ibfsparams size="3">
      <entry key="IBIRS_role" value="ListAndRun"/>
      <entry key="IBIRS_subjectPath" value="/SSYS/USERS/restid"/>
      <entry key="IBIRS_" value="/WFC/Repository/Financial_Reports/Quarterly"/>
   </ibfsparams>
   <rootObject _jt="IBFSPermissionSetObject" description="List and run content" dummy="false" fullPath="IBFS:/SSYS/ROLES/ListAndRun"
               handle="10330" name="ListAndRun" policy="////D///9+f/////f/////////8AAAA="
               rsPath="/ibi_apps/rs/ibfs/SSYS/ROLES/ListAndRun" showPermissions="false" subsysNameList="WFC" type="PermissionSet">
      <pSet _jt="IBSSPermissionSet" compLvl="0" description="List and run content" id="10330" name="ListAndRun" shipped="true">
         <policy _jt="IBSSPolicy" derivedDate="1349182611014">
            <policy _jt="EnumMap" _keyJT="IBSSOperation" size="2">
               <entry>
                  <key _jt="IBSSOperation" name="opList"/>
                  <value _jt="IBSSVerb" name="PERMIT"/>
               </entry>
               <entry>
                  <key _jt="IBSSOperation" name="opRun"/>
                  <value _jt="IBSSVerb" name="PERMIT"/>
               </entry>
            </policy>
         </policy>

         <subsysList _jt="ArrayList" size="1">
            <item _jt="IBFSSubsystem" index="0" name="WFC"/>
         </subsysList>
      </pSet>
   </rootObject>
</ibfsrpc>

If the value for the returncode attribute in the XML response is 10000, then the rule was successfully removed.