Skip navigation links

com.essbase.api.datasource
Interface IEssCube.IEssSecurityFilter

All Superinterfaces:

IEssBaseObject

Enclosing interface:

IEssCube

public static interface IEssCube.IEssSecurityFilter

extends IEssBaseObject

The IEssSecurityFilter is cube security filter.

Version:

1.0, 04/24/2002

Author:

Srini Ranga

Nested Class Summary

static interface

IEssCube.IEssSecurityFilter.IEssFilterRow IEssFilterRow represents a security filter row.

Method Summary

IEssCube.IEssSecurityFilter	copy(java.lang.String destName) Deprecated. - use copyFilter(String)
IEssCube.IEssSecurityFilter	copy(java.lang.String destName, java.lang.String destAppName, java.lang.String destCubeName) Deprecated. - use copyFilter(String, String, String)
void	copyFilter(java.lang.String destName) Copies this security filter.
void	copyFilter(java.lang.String destName, java.lang.String destAppName, java.lang.String destCubeName) Copies this security filter.
void	delete() Deletes this security filter.
short	getAccess() Gets the default filter access level.
IEssCube.IEssSecurityFilter.IEssFilterRow	getFilterRow() Get the next filter row.
java.lang.String	getName() Gets the name of the security filter.
java.lang.String[]	getSecurityFilterList() Gets the list of users who are assigned a filter.
boolean	isActive() Checks if this filter is currently in effect cube.
void	rename(java.lang.String newName) Renames this security filter.
void	setFilterRow(java.lang.String row, IEssCube.EEssCubeAccess access) Deprecated. - The EEssCubeAccess does not cover the supported privileges
void	setFilterRow(java.lang.String row, short access) Set a filter row.
void	verifyFilter(java.lang.String[] RowStrings) Verifies the syntax of a series of filter row strings against a specified database.

Method Detail

getName

java.lang.String getName()
                         throws com.essbase.api.base.EssException

Gets the name of the security filter.

Returns:

The security filter name.

Throws:

com.essbase.api.base.EssException - if an error occurs.

isActive

boolean isActive()
                 throws com.essbase.api.base.EssException

Checks if this filter is currently in effect cube.

Returns:

true if filter is currently in effect.

Throws:

com.essbase.api.base.EssException - if an error occurs.

getAccess

short getAccess()
                throws com.essbase.api.base.EssException

Gets the default filter access level.

Returns:

The default filter access level.

Throws:

com.essbase.api.base.EssException - if an error occurs.

copy

IEssCube.IEssSecurityFilter copy(java.lang.String destName)
                                 throws com.essbase.api.base.EssException

Deprecated. - use copyFilter(String)

Copies this security filter.

Parameters:

destName - The destination name of the copied filter.

Throws:

com.essbase.api.base.EssException - if an error occurs.

copyFilter

void copyFilter(java.lang.String destName)
                throws com.essbase.api.base.EssException

Copies this security filter.

Parameters:

destName - The destination name of the copied filter.

Throws:

com.essbase.api.base.EssException - if an error occurs.

copy

IEssCube.IEssSecurityFilter copy(java.lang.String destName,
                                 java.lang.String destAppName,
                                 java.lang.String destCubeName)
                                 throws com.essbase.api.base.EssException

Deprecated. - use copyFilter(String, String, String)

Copies this security filter.

Parameters:

destAppName - The destination application name.

destCubeName - The destination cube name.

destName - The name for the filter copy.

Returns:

The security filter.

Throws:

com.essbase.api.base.EssException - if an error occurs.

copyFilter

void copyFilter(java.lang.String destName,
                java.lang.String destAppName,
                java.lang.String destCubeName)
                throws com.essbase.api.base.EssException

Copies this security filter.

Parameters:

destAppName - The destination application name.

destCubeName - The destination cube name.

destName - The destination name of the copied filter.

Throws:

com.essbase.api.base.EssException - if an error occurs.

rename

void rename(java.lang.String newName)
            throws com.essbase.api.base.EssException

Renames this security filter.

Parameters:

newName - for the filter.

Throws:

com.essbase.api.base.EssException - if an error occurs.

delete

void delete()
            throws com.essbase.api.base.EssException

Deletes this security filter. This function requires the caller to have database Design privilege for the specified database.

Throws:

com.essbase.api.base.EssException - if an error occurs.

setFilterRow

void setFilterRow(java.lang.String row,
                  IEssCube.EEssCubeAccess access)
                  throws com.essbase.api.base.EssException

Deprecated. - The EEssCubeAccess does not cover the supported privileges

Set a filter row. This function should be called repeatedly after calling setFilter(), once for each row of the filter, terminating the row list with a NULL row string pointer This function requires the caller to have database designer privilege for the specified database.

Parameters:

row - - next row of the filter

access - - Access level for the filter row.

Throws:

com.essbase.api.base.EssException - if an error occurs.

See Also:

setFilterRow(String, short)

setFilterRow

void setFilterRow(java.lang.String row,
                  short access)
                  throws com.essbase.api.base.EssException

Set a filter row. This function should be called repeatedly after calling setFilter(), once for each row of the filter, terminating the row list with a NULL row string pointer This function requires the caller to have database designer privilege for the specified database.

Parameters:

row - - next row of the filter

access - - Access level for the filter row. EssGlobalStrings.ESS_ACCESS_NONE, EssGlobalStrings.ESS_ACCESS_READ, EssGlobalStrings.ESS_ACCESS_WRITE, EssGlobalStrings.ESS_ACCESS_METAREAD

Throws:

com.essbase.api.base.EssException - if an error occurs.

Since:

11.1.1, 9.3.1.1

getFilterRow

IEssCube.IEssSecurityFilter.IEssFilterRow getFilterRow()
                                                       throws com.essbase.api.base.EssException

Get the next filter row. This function should be called repeatedly after calling getFilter(), until a NULL row string pointer is returned.

Returns:

IEssCube.IEssSecurityFilter.IEssFilterRow; If successful, returns the next filter row (if any); returns null if invoked after receiving the last row.

Throws:

com.essbase.api.base.EssException - if an error occurs.

getSecurityFilterList

java.lang.String[] getSecurityFilterList()
                                         throws com.essbase.api.base.EssException

Gets the list of users who are assigned a filter.

Returns:

If successful, returns an array of user names .

Throws:

com.essbase.api.base.EssException - if an error occurs.

verifyFilter

void verifyFilter(java.lang.String[] RowStrings)
                  throws com.essbase.api.base.EssException

Verifies the syntax of a series of filter row strings against a specified database. Follow this call with successive calls to IEssCube.IEssSecurityFilter.verifyFilterRow() to verify all rows for the filter. This function requires the caller to have database designer privilege for the specified database.

Parameters:

RowStrings - - Array of Row Strings. The last element must be a null.

Throws:

com.essbase.api.base.EssException

Skip navigation links