com.plumtree.server
Interface IPTAdminFolder

All Superinterfaces:
IPTLocalizable, IPTObject, IPTUnknown

public interface IPTAdminFolder
extends IPTObject

All administrative objects in Plumtree are stored in a foldering system. The folders are called Admin Folders, and the Admin Catalog is the container for the Admin Folders.

See Also:
IPTAdminCatalog

Method Summary
 IPTAdminCatalog GetAdminCatalog()
          Returns the Admin Catalog
 java.lang.Object[][] GetDefaultOrderBy()
          Returns the default order by as a 1x2 array.
 int GetFolderLevel()
          Returns the folder level (the number of ancestor folders)
 int GetFolderType()
          Returns the folder type.
 int GetJobType()
          Returns the job type associated with this folder
 int GetParentFolderID()
          Returns the ID of the folder containing this folder, or 0 if no parent
 java.lang.Object[] GetParentIDs()
          Returns the IDs of folders that contain this folder as an array
 java.lang.String GetPath()
          Returns the path to this admin folder as a string.
 IPTQueryResult GetPathAsQueryResult()
          Returns path as query result, which includes PT_PROPID_OBJECTID and PT_PROPID_NAME.
 IPTQueryResult QueryObjects(boolean bSecureCountOnly)
          Queries objects that are in this folder based on class ids.
 IPTQueryResult QueryObjectsCount(boolean bSecureCountOnly)
          Returns the type of objects that are in this folder along with the count of how many each is.
 IPTQueryResult QuerySubfolders(int lPropIDMask, int lDepth, int vOrderBy, int lSkipRows, int lMaxRows, java.lang.Object[][] vQueryFilter)
          Queries the subfolders.
 IPTQueryResult QuerySubfolders(int lPropIDMask, int lDepth, java.lang.Object vOrderBy, int lSkipRows, int lMaxRows, java.lang.Object[][] vQueryFilter)
          Queries the subfolders.
 int QuerySubfoldersCount()
          Returns the number of immediate subfolders
 void SetDefaultOrderBy(java.lang.Object[][] Value)
          Sets the default order by.
 void SetFolderType(int Value)
          Sets the folder type.
 void SetJobType(int Value)
          Sets the job type of the folder
 
Methods inherited from interface com.plumtree.server.IPTObject
GetAdminFolderID, GetClassID, GetCreated, GetImageUUID, GetLastModified, GetObjectProperties, SetAdminFolderID, SetImageUUID, SetLastModified
 
Methods inherited from interface com.plumtree.server.IPTLocalizable
GetDescription, GetIsLocalized, GetLocalizedDescription, GetLocalizedDescriptions, GetLocalizedName, GetLocalizedNames, GetName, GetPrimaryLang, GetSupportsLocalization, SetDescription, SetIsLocalized, SetLocalizedDescriptions, SetLocalizedNames, SetName, SetPrimaryLang
 
Methods inherited from interface com.plumtree.server.IPTUnknown
GetInterfaces
 

Method Detail

GetPath

public java.lang.String GetPath()
Returns the path to this admin folder as a string. NOT LOCALIZED. Should call GetPathAsQueryResult instead.
Returns:
path string

GetParentIDs

public java.lang.Object[] GetParentIDs()
Returns the IDs of folders that contain this folder as an array
Returns:
Object[] of parent ids

GetFolderLevel

public int GetFolderLevel()
Returns the folder level (the number of ancestor folders)
Returns:
int

GetDefaultOrderBy

public java.lang.Object[][] GetDefaultOrderBy()
Returns the default order by as a 1x2 array. The first element is the prop id to order by. The second element is whether it's ascending or descending.
Returns:
Object[][]
See Also:
PT_PROPIDS, PT_ORDERBY_SETTINGS

SetDefaultOrderBy

public void SetDefaultOrderBy(java.lang.Object[][] Value)
Sets the default order by. Takes in a 1x2 array The first element is the prop id to order by. The second element is whether it's ascending or descending.
Parameters:
vValue - 1x2 Object array
See Also:
PT_PROPIDS, PT_ORDERBY_SETTINGS

GetAdminCatalog

public IPTAdminCatalog GetAdminCatalog()
Returns the Admin Catalog
Returns:
IPTAdminCatalog
See Also:
IPTAdminCatalog

GetParentFolderID

public int GetParentFolderID()
Returns the ID of the folder containing this folder, or 0 if no parent
Returns:
int

QuerySubfoldersCount

public int QuerySubfoldersCount()
Returns the number of immediate subfolders
Returns:
int

QuerySubfolders

public IPTQueryResult QuerySubfolders(int lPropIDMask,
                                      int lDepth,
                                      int vOrderBy,
                                      int lSkipRows,
                                      int lMaxRows,
                                      java.lang.Object[][] vQueryFilter)
Queries the subfolders. This can be immediate (depth 0 or child depth 1).
Parameters:
lPropIDMask - prop ids to query
lDepth - 0 or 1
vOrderBy - can be an Object[][] with 2 columns and one row. The first column holds the property ID to order by, from PT_PROPIDS. The second column holds the order to order, from PT_ORDERBY_SETTINGS
lSkipRows - number of rows to skip at the beginning, or 0 for none
lMaxRows - maximum number of rows to return, or -1 for all
vQueryFilter - is a 2D array with 3 columns. The first column holds the property id, from PT_PROPIDS. The second column holds the operator, from PT_FILTEROPS. The third column holds the value to be matched.
Returns:
IPTQueryResult
See Also:
PT_PROPIDS, PT_ORDERBY_SETTINGS

QuerySubfolders

public IPTQueryResult QuerySubfolders(int lPropIDMask,
                                      int lDepth,
                                      java.lang.Object vOrderBy,
                                      int lSkipRows,
                                      int lMaxRows,
                                      java.lang.Object[][] vQueryFilter)
Queries the subfolders. This can be immediate (depth 0 or child depth 1).
Parameters:
lPropIDMask - prop ids to query
lDepth - 0 or 1
vOrderBy - a PT_PROPIDS to order the result by
lSkipRows - number of rows to skip at the beginning, or -1 for none
lMaxRows - maximum number of rows to return, or -1 for all
vQueryFilter - is a 2D array with 3 columns. The first column holds the property id, from PT_PROPIDS. The second column holds the operator, from PT_FILTEROPS. The third column holds the value to be matched.
Returns:
IPTQueryResult
See Also:
PT_PROPIDS, PT_ORDERBY_SETTINGS, PT_FILTEROPS

QueryObjectsCount

public IPTQueryResult QueryObjectsCount(boolean bSecureCountOnly)
Returns the type of objects that are in this folder along with the count of how many each is. The result is returned in a query result with prop ids PT_PROPID_CLASSID and PT_PROPID_OBJECTCOUNT.
Parameters:
bSecureCountOnly - only accepts false
Returns:
IPTQueryResult

QueryObjects

public IPTQueryResult QueryObjects(boolean bSecureCountOnly)
Queries objects that are in this folder based on class ids. Queries can be either secure (only returns objects the current user has access to), or insecure. The resulting IPTQueryResult will have 2 pieces of information: PT_PROPID_CLASS and PT_PROPID_OBJECTID.
Parameters:
bSecureCountOnly - secure or insecure queries supported
Returns:
IPTQueryResult

GetJobType

public int GetJobType()
Returns the job type associated with this folder
Returns:
PT_ADMIN_FOLDER_JOB_TYPES
See Also:
PT_ADMIN_FOLDER_JOB_TYPES

SetJobType

public void SetJobType(int Value)
Sets the job type of the folder
Parameters:
lJobType - one of PT_ADMIN_FOLDER_JOB_TYPES
See Also:
PT_ADMIN_FOLDER_JOB_TYPES

GetFolderType

public int GetFolderType()
Returns the folder type.
Returns:
Can be regular folder, subportal folder, or community folder as defined in PT_ADMIN_FOLDER_TYPES.
See Also:
PT_ADMIN_FOLDER_TYPES

SetFolderType

public void SetFolderType(int Value)
Sets the folder type.
Parameters:
lFolderType - one of PT_ADMIN_FOLDER_TYPES.

GetPathAsQueryResult

public IPTQueryResult GetPathAsQueryResult()
Returns path as query result, which includes PT_PROPID_OBJECTID and PT_PROPID_NAME. Then name is correctly localized.
Returns:
IPTQueryResult
See Also:
IPTQueryResult, PT_PROPIDS


Copyright © 2003 Plumtree Software Inc. All Rights Reserved.