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