com.crystaldecisions.sdk.occa.infostore
Interface ISecurityInfo

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2, which can be retrieved by calling IInfoObject.getSecurityInfo2().

public interface ISecurityInfo

The ISecurityInfo interface allows you to set the security roles, rights, and limits on an object for a specific user or group. Roles are predefined set of object rights that are designed to cover the most common cases of security access. It is recommended that you start by using roles, and then apply more granular rights if necessary. Specifically, rights permit a user or group to perform specific actions on an object; limits restrict the number of instances for each object, user, or group that are allowed on the system. Users or groups that are given specific object rights and limits are called object principals.

SAP BusinessObjects Enterprise uses object security, which means that roles, rights, and limits are set for each InfoObject in the system and not for each principal. For example, all folders have a set of available rights that the system makes available to them. You can use a report's SecurityInfo object to determine which of these rights you want to give to a particular user or group. Specifically, you can use the getKnownRights method to select the rights that you want to grant or deny to a principal, and then add these rights to the principal's SecurityRights collection.

See Also:

ISecurityRights

Nested Class Summary

static interface

ISecurityInfo.CeRightModes Deprecated.

Method Summary

boolean	checkCustomRight(int RightID, java.lang.String kind) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
boolean[]	checkCustomRights(int[] rights, java.lang.String[] kinds, boolean useCache) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
boolean	checkRight(int RightID) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
boolean[]	checkRights(int[] rights) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
boolean[]	checkRights(int[] rights, boolean useCache) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
boolean	checkSystemRight(int RightID) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
boolean[]	checkSystemRights(int[] rights, boolean useCache) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
IObjectPrincipal	getAnyPrincipal(int PrincipalID) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
IRightID[]	getKnownLimits() Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
IRightID[]	getKnownRights() Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
IObjectPrincipals	getObjectPrincipals() Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
IObjectPrincipals	getObjectPrincipals(int flag) Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()
IObjectPrincipals	newObjectPrincipals() Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Method Detail

checkRight

boolean checkRight(int RightID)
                   throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns whether the specified right is permitted for the current user.

Parameters:

RightID - The right ID of the right to be checked.

Returns:

A boolean indicating whether the specified right is permitted for this object. If the value is true the specified right is permitted for this object, otherwise false.

Throws:

SDKException - This is thrown if the process is unsuccessful.

checkSystemRight

boolean checkSystemRight(int RightID)
                         throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns whether the specified system right is defined for the current user.

Parameters:

RightID - The right ID of the right to be checked.

Returns:

A boolean indicating whether the specified right is permitted for this object. If the value is true the specified right is permitted for this object, otherwise false.

Throws:

SDKException - This is thrown if the process is unsuccessful.

checkCustomRight

boolean checkCustomRight(int RightID,
                         java.lang.String kind)
                         throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns whether the specified custom right is defined for the current user.

Parameters:

RightID - The right ID of the right to be checked.

kind - The kind of the right to be checked. The kind represents the InfoObject type.

Returns:

A boolean indicating whether the specified right is permitted for this object. If the value is true the specified right is permitted for this object, otherwise false.

Throws:

SDKException - This is thrown if the process is unsuccessful.

checkRights

boolean[] checkRights(int[] rights)
                      throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns multiple rights from the CMS in a single batch. Using this method is the easiest way to determine the current user's net rights. This method is particularly useful when you are working with inheritance. For example, if the right to schedule a report has been explicitly granted to the current user, but that user is also set to inherit rights from a parent folder on which the right has been denied, the user will not be permitted to schedule the report.

Parameters:

rights - A int[] array specifying right ids.

Returns:

A boolean array indicating whether specified rights are permitted for this object. If the value is true the specified rights are permitted for this object, otherwise false.

Throws:

SDKException - This is thrown if the process is unsuccessful.

checkRights

boolean[] checkRights(int[] rights,
                      boolean useCache)
                      throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Sets whether rights that have been cached will be used. When set to false, rights will be retrieved from the server regardless of whether they exist in the cache. When set to true if rights have been cached they will be used, and if they have not been cached they will be retrieved from the server. Using this method is the easiest way to determine the current user's net rights. This method is particularly useful when you are working with inheritance. For example, if the right to schedule a report has been explicitly granted to the current user, but that user is also set to inherit rights from a parent folder on which the right has been denied, the user will not be permitted to schedule the report.

Parameters:

rights - A int[] array specifying right ids.

useCache - This value should be set to false to retrieve rights from the server rather than using cached rights.

Returns:

A boolean array indicating whether specified rights are permitted for this object. If the value is true the specified rights are permitted for this object, otherwise false.

Throws:

SDKException - This is thrown if the process is unsuccessful.

checkSystemRights

boolean[] checkSystemRights(int[] rights,
                            boolean useCache)
                            throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns multiple system rights from the CMS in a single batch. Using this method is the easiest way to determine the current user's net rights. This method is particularly useful when you are working with inheritance. For example, if the right to schedule a report has been explicitly granted to the current user, but that user is also set to inherit rights from a parent folder on which the right has been denied, the user will not be permitted to schedule the report.

Parameters:

rights - A int[] array specifying system right ids.

useCache - This value should be set to false to retrieve rights from the server rather than using cached rights.

Returns:

A boolean array indicating whether specified system rights are permitted for this object. If the value is true the specified rights are permitted for this object, otherwise false.

Throws:

SDKException - This is thrown if the process is unsuccessful.

checkCustomRights

boolean[] checkCustomRights(int[] rights,
                            java.lang.String[] kinds,
                            boolean useCache)
                            throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns custom rights from the CMS in a single batch.Using this method is the easiest way to determine the current user's net rights. This method is particularly useful when you are working with inheritance. For example, if the right to schedule a report has been explicitly granted to the current user, but that user is also set to inherit rights from a parent folder on which the right has been denied, the user will not be permitted to schedule the report.

Parameters:

rights - A int[] array specifying system right ids.

kinds - A String[] array specifying the InfoObject types.

useCache - This value should be set to false to retrieve rights from the server rather than using cached rights.

Returns:

A boolean array indicating whether specified system rights are permitted for this object. If the value is true the specified rights are permitted for this object, otherwise false.

Throws:

SDKException

getKnownRights

IRightID[] getKnownRights()
                          throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns a collection of rights that this object supports.

Returns:

An array of IRightID objects specifying the rights this object supports.

Throws:

SDKException - This is thrown if the process is unsuccessful.

getObjectPrincipals

IObjectPrincipals getObjectPrincipals()
                                      throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns the collection of principals that have rights on the object.

Returns:

The IObjectPrincipals collection that contains the principals that have rights on this object.

Throws:

SDKException - This is thrown if the process is unsuccessful.

getObjectPrincipals

IObjectPrincipals getObjectPrincipals(int flag)
                                      throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Throws:

SDKException

newObjectPrincipals

IObjectPrincipals newObjectPrincipals()
                                      throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Throws:

SDKException

getAnyPrincipal

IObjectPrincipal getAnyPrincipal(int PrincipalID)
                                 throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns the effective rights and limits for any principal, even if the principal does not have explicit rights to the object.

Parameters:

PrincipalID - The ID of the principal as an int.

Returns:

The read-only IObjectPrincipal object containing the effective rights for the specified principal.

Throws:

SDKException - This is thrown if the process is unsuccessful.

getKnownLimits

IRightID[] getKnownLimits()
                          throws SDKException

Deprecated. Since version 12.0, ISecurityInfo has been replaced by ISecurityInfo2 accessible through IInfoObject.getSecurityInfo2()

Returns a collection of limits that this object supports.

Returns:

An array of IRightID objects specifying the limits this object supports.

Throws:

SDKException - This is thrown if the process is unsuccessful.