public final class UserContext extends PredefinedPermissions
UserContext
object represents the current logged-in user. It contains information about the user (user name, login name, etc) as well as the
permissions this user has. All users have some predefined fields which value is not necessarily set, but one can also add new custom fields to any user.PredefinedPermissions
,
UserContextPredefinedFields
Modifier and Type | Field and Description |
---|---|
static GUID |
FID_STREET
The field ID of the user's mail address street name.
|
static int |
PASSWORD_OPTIONS_CANNOT_CHANGE_PASSWORD
Password setting value.
|
static int |
PASSWORD_OPTIONS_MUST_CHANGE_PASSWORD_WITH_NEXT_LOGIN
Password setting value.
|
static int |
PASSWORD_OPTIONS_PASSWORD_NEVER_EXPIRES
Password setting value.
|
PERMISSION_ASSET_COLLECT, PERMISSION_ASSET_DELETE, PERMISSION_ASSET_DOWNLOAD, PERMISSION_ASSET_EMAIL, PERMISSION_ASSET_SHOW_ORIGINAL, PERMISSION_ASSET_TRANSFER, PERMISSION_ASSET_VERSIONING, PERMISSION_CAN_ACCESS_ALL_ASSET_ACTIONS, PERMISSION_CAN_ACCESS_ALL_ASSET_HANDLING_SETS, PERMISSION_CAN_ACCESS_ALL_CATEGORY_QUERIES, PERMISSION_CAN_ACCESS_ALL_CATEGORY_VIEW_SETS, PERMISSION_CAN_ACCESS_ALL_CROP_TEMPLATES, PERMISSION_CAN_ACCESS_ALL_METADATA_TEMPLATES, PERMISSION_CAN_ACCESS_ALL_PERMISSION_TEMPLATES, PERMISSION_CAN_ACCESS_ALL_PRINT_SETS, PERMISSION_CAN_ACCESS_ALL_RECORD_FILTERS, PERMISSION_CAN_ACCESS_ALL_RECORD_QUERIES, PERMISSION_CAN_ACCESS_ALL_RECORD_VIEW_SETS, PERMISSION_CATALOG_AUTO_TAGGING_USER, PERMISSION_CATALOG_LOG_ADMIN, PERMISSION_CATALOG_MANAGE_CATALOG_MIRRORING, PERMISSION_CATALOG_MANAGE_CENTRAL_ASSET_LOCATION, PERMISSION_CATALOG_MANAGE_TRIGGERS, PERMISSION_CATALOG_MODIFY_CATALOG_CATEGORY_PERMISSIONS, PERMISSION_CATALOG_MODIFY_SETTINGS, PERMISSION_CATALOG_MONITOR_ADMIN, PERMISSION_CATALOG_OPEN, PERMISSION_CATALOG_TRIGGER_ADMIN, PERMISSION_CATALOG_VIDEO_CLOUD_ADMIN, PERMISSION_CATALOG_VIDEO_CLOUD_CONSUMER, PERMISSION_CATALOG_VIDEO_CLOUD_CONTRIBUTOR, PERMISSION_CATALOG_VIEW_SETTINGS, PERMISSION_ITEM_CREATE, PERMISSION_ITEM_DELETE, PERMISSION_ITEM_MODIFY, PERMISSION_ITEM_MODIFY_ASSET_REFERENCE, PERMISSION_ITEM_MODIFY_PERMISSIONS, PERMISSION_ITEM_MODIFY_TRIGGERS, PERMISSION_ITEM_VIEW, PERMISSION_MEDIA_DELIVERY_CLOUD_ADMIN, SERVER_PERMISSION_BACKUP_ADMIN, SERVER_PERMISSION_BROWSE_EXTERNAL_USERS, SERVER_PERMISSION_BROWSE_USERS, SERVER_PERMISSION_CAN_ACCESS_ALL_CATALOG_TEMPLATES, SERVER_PERMISSION_CAN_ACCESS_ALL_CATALOGS, SERVER_PERMISSION_CAN_ACCESS_ALL_COLLECTIONS, SERVER_PERMISSION_CAN_ACCESS_ALL_FILESYSTEM_COMPANION_INSTANCES, SERVER_PERMISSION_CAN_ACCESS_ALL_REPORT_SETS, SERVER_PERMISSION_CAN_ACCESS_ALL_SCHEDULER_JOBS, SERVER_PERMISSION_CREATE_DOWNLOAD_COLLECTION, SERVER_PERMISSION_CREATE_EXTERNAL_USERS, SERVER_PERMISSION_CREATE_SHARED_ASSET_ACTION, SERVER_PERMISSION_CREATE_SHARED_ASSETHANDLING_SET, SERVER_PERMISSION_CREATE_SHARED_CATALOG_TEMPLATE, SERVER_PERMISSION_CREATE_SHARED_CATEGORY_QUERY, SERVER_PERMISSION_CREATE_SHARED_CATEGORYVIEW_SET, SERVER_PERMISSION_CREATE_SHARED_COLLECTION, SERVER_PERMISSION_CREATE_SHARED_CROP_TEMPLATES, SERVER_PERMISSION_CREATE_SHARED_FILESYSTEM_COMPANION_INSTANCE, SERVER_PERMISSION_CREATE_SHARED_METADATA_TEMPLATE, SERVER_PERMISSION_CREATE_SHARED_PERMISSION_TEMPLATE, SERVER_PERMISSION_CREATE_SHARED_PRINT_SET, SERVER_PERMISSION_CREATE_SHARED_RECORD_FILTER, SERVER_PERMISSION_CREATE_SHARED_RECORD_QUERY, SERVER_PERMISSION_CREATE_SHARED_RECORDVIEW_SET, SERVER_PERMISSION_CREATE_SHARED_REPORT_SET, SERVER_PERMISSION_CREATE_SHARED_SCHEDULER_JOB, SERVER_PERMISSION_CREATE_UPLOAD_COLLECTION, SERVER_PERMISSION_DELETE_SHARED_ASSET_ACTION, SERVER_PERMISSION_DELETE_SHARED_ASSETHANDLING_SET, SERVER_PERMISSION_DELETE_SHARED_CATALOG_TEMPLATE, SERVER_PERMISSION_DELETE_SHARED_CATEGORY_QUERY, SERVER_PERMISSION_DELETE_SHARED_CATEGORYVIEW_SET, SERVER_PERMISSION_DELETE_SHARED_COLLECTION, SERVER_PERMISSION_DELETE_SHARED_CROP_TEMPLATES, SERVER_PERMISSION_DELETE_SHARED_FILESYSTEM_COMPANION_INSTANCE, SERVER_PERMISSION_DELETE_SHARED_METADATA_TEMPLATE, SERVER_PERMISSION_DELETE_SHARED_PERMISSION_TEMPLATE, SERVER_PERMISSION_DELETE_SHARED_PRINT_SET, SERVER_PERMISSION_DELETE_SHARED_RECORD_FILTER, SERVER_PERMISSION_DELETE_SHARED_RECORD_QUERY, SERVER_PERMISSION_DELETE_SHARED_RECORDVIEW_SET, SERVER_PERMISSION_DELETE_SHARED_REPORT_SET, SERVER_PERMISSION_DELETE_SHARED_SCHEDULER_JOB, SERVER_PERMISSION_FORCE_READ_ONLY_CATALOG_ACCESS, SERVER_PERMISSION_MAIL_ADMIN, SERVER_PERMISSION_MANAGE_USER_ASSET_ACTIONS, SERVER_PERMISSION_MANAGE_USER_ASSETHANDLING_SET, SERVER_PERMISSION_MANAGE_USER_CATALOG_TEMPLATES, SERVER_PERMISSION_MANAGE_USER_CATEGORY_QUERIES, SERVER_PERMISSION_MANAGE_USER_CATEGORYVIEW_SET, SERVER_PERMISSION_MANAGE_USER_COLLECTIONS, SERVER_PERMISSION_MANAGE_USER_CROP_TEMPLATES, SERVER_PERMISSION_MANAGE_USER_METADATA_TEMPLATES, SERVER_PERMISSION_MANAGE_USER_PERMISSION_TEMPLATES, SERVER_PERMISSION_MANAGE_USER_PRINT_SETS, SERVER_PERMISSION_MANAGE_USER_RECORD_FILTERS, SERVER_PERMISSION_MANAGE_USER_RECORD_QUERIES, SERVER_PERMISSION_MANAGE_USER_RECORDVIEW_SET, SERVER_PERMISSION_MEDIA_DELIVERY_CLOUD_ADMIN, SERVER_PERMISSION_MODIFY_SHARED_ASSET_ACTION, SERVER_PERMISSION_MODIFY_SHARED_ASSETHANDLING_SET, SERVER_PERMISSION_MODIFY_SHARED_CATALOG_TEMPLATE, SERVER_PERMISSION_MODIFY_SHARED_CATEGORY_QUERY, SERVER_PERMISSION_MODIFY_SHARED_CATEGORYVIEW_SET, SERVER_PERMISSION_MODIFY_SHARED_COLLECTION, SERVER_PERMISSION_MODIFY_SHARED_CROP_TEMPLATES, SERVER_PERMISSION_MODIFY_SHARED_FILESYSTEM_COMPANION_INSTANCE, SERVER_PERMISSION_MODIFY_SHARED_METADATA_TEMPLATE, SERVER_PERMISSION_MODIFY_SHARED_PERMISSION_TEMPLATE, SERVER_PERMISSION_MODIFY_SHARED_PRINT_SET, SERVER_PERMISSION_MODIFY_SHARED_RECORD_FILTER, SERVER_PERMISSION_MODIFY_SHARED_RECORD_QUERY, SERVER_PERMISSION_MODIFY_SHARED_RECORDVIEW_SET, SERVER_PERMISSION_MODIFY_SHARED_REPORT_SET, SERVER_PERMISSION_MODIFY_SHARED_SCHEDULER_JOB, SERVER_PERMISSION_MODIFY_USER_SETTINGS_ASSETHANDLING, SERVER_PERMISSION_MODIFY_USER_SETTINGS_DISPLAY, SERVER_PERMISSION_MODIFY_USER_SETTINGS_GENERAL, SERVER_PERMISSION_MODIFY_USER_SETTINGS_PRINT, SERVER_PERMISSION_MODIFY_USER_SETTINGS_SEARCH, SERVER_PERMISSION_REPLACE_USER_SETTINGS_PATH, SERVER_PERMISSION_ROBOFLOW_EXECUTE, SERVER_PERMISSION_ROBOFLOW_MANAGE, SERVER_PERMISSION_RUN_AS, SERVER_PERMISSION_RUN_AS_ALL_USERS, SERVER_PERMISSION_SET_DEFAULT_SHARED_ASSET_ACTION, SERVER_PERMISSION_SET_DEFAULT_SHARED_ASSETHANDLING_SET, SERVER_PERMISSION_SET_DEFAULT_SHARED_CATALOG_TEMPLATE, SERVER_PERMISSION_SET_DEFAULT_SHARED_CATEGORYVIEW_SET, SERVER_PERMISSION_SET_DEFAULT_SHARED_COLLECTION, SERVER_PERMISSION_SET_DEFAULT_SHARED_CROP_TEMPLATES, SERVER_PERMISSION_SET_DEFAULT_SHARED_FILESYSTEM_COMPANION_INSTANCE, SERVER_PERMISSION_SET_DEFAULT_SHARED_METADATA_TEMPLATE, SERVER_PERMISSION_SET_DEFAULT_SHARED_PERMISSION_TEMPLATE, SERVER_PERMISSION_SET_DEFAULT_SHARED_PRINT_SET, SERVER_PERMISSION_SET_DEFAULT_SHARED_RECORD_FILTER, SERVER_PERMISSION_SET_DEFAULT_SHARED_RECORDVIEW_SET, SERVER_PERMISSION_SET_DEFAULT_SHARED_REPORT_SET, SERVER_PERMISSION_SET_DEFAULT_SHARED_SCHEDULER_JOB, SERVER_PERMISSION_SITES_ADMIN, SERVER_PERMISSION_USE_EXTERNAL_USERS, SERVER_PERMISSION_USER_ADMIN, SERVER_PERMISSION_USER_ADMIN_DEPARTMENT_RO, SERVER_PERMISSION_USER_ADMIN_DEPARTMENT_RW, SERVER_PERMISSION_VAULT_ADMIN, SERVER_PERMISSION_VIEW_SHARED_ASSET_ACTION, SERVER_PERMISSION_VIEW_SHARED_ASSETHANDLING_SET, SERVER_PERMISSION_VIEW_SHARED_CATALOG_TEMPLATE, SERVER_PERMISSION_VIEW_SHARED_CATEGORY_QUERY, SERVER_PERMISSION_VIEW_SHARED_CATEGORYVIEW_SET, SERVER_PERMISSION_VIEW_SHARED_CROP_TEMPLATES, SERVER_PERMISSION_VIEW_SHARED_METADATA_TEMPLATE, SERVER_PERMISSION_VIEW_SHARED_PERMISSION_TEMPLATE, SERVER_PERMISSION_VIEW_SHARED_PRINT_SET, SERVER_PERMISSION_VIEW_SHARED_RECORD_FILTER, SERVER_PERMISSION_VIEW_SHARED_RECORD_QUERY, SERVER_PERMISSION_VIEW_SHARED_RECORDVIEW_SET, SERVER_PERMISSION_WORKFLOW_ADMIN, TOKEN_PERMISSION_SEPARATOR
Modifier and Type | Method and Description |
---|---|
GUID |
findFieldByName(java.lang.String fieldName)
Find a field by name and return it's
GUID . |
java.util.Collection<java.lang.String> |
getAssetActionNames(Catalog catalog)
Returns all Asset Action names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getAssetHandlingSetNames(Catalog catalog)
Returns all Asset Handling Set names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getCategoryQueryNames(Catalog catalog)
Returns all server-side category query names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getCategoryViewSetNames(Catalog catalog)
Returns all Category View Set names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getCropTemplateNames(Catalog catalog)
Returns all crop template names available to this user for the given catalog.
|
CumulusSession |
getCumulusSession()
Returns the current
CumulusSession object. |
java.util.Collection<java.lang.String> |
getCustomPermissions(Catalog catalog)
Returns all custom permissions assigned to this user for a specific catalog.
|
java.util.Collection<java.lang.String> |
getCustomServerPermissions()
Returns all custom server permissions assigned to this user.
|
java.lang.String |
getDisplayName()
Returns the display name for this user.
|
java.lang.String |
getDisplayOrLoginName()
Returns the display name for this user.
|
java.lang.String |
getEmailAddress()
Returns the email address as stored.
|
java.lang.String |
getEmailAddressRFC822()
Returns the email address formatted according to RFC822.
|
java.lang.String |
getFieldName(GUID fieldUID)
Returns the name of a field in the default language ID.
|
java.lang.String |
getFieldName(GUID fieldUID,
int languageId)
Returns the name of a field.
|
int |
getFieldType(GUID fieldUID)
Returns the type of a user context field with the given
GUID . |
java.util.Set<GUID> |
getFieldUIDs()
Returns the available field UIDs.
|
java.lang.Object |
getFieldValue(GUID fieldUID)
Return the value of a user context field in the default language.
|
java.lang.Object |
getFieldValue(GUID fieldUID,
int languageId)
Return the value of a user context field.
|
java.lang.String |
getLoginName()
Returns the logging name.
|
java.util.Collection<java.lang.String> |
getMetadataTemplateNames(Catalog catalog)
Returns all server-side metadata template names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getPermissions(Catalog catalog)
Returns all permissions assigned to this user for a specific catalog.
|
java.util.Collection<java.lang.String> |
getPermissionTemplateNames(Catalog catalog)
Returns all permission template names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getPrintSetNames(Catalog catalog)
Returns all print set names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getRecordFilterNames(Catalog catalog)
Returns all record filter names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getRecordQueryNames(Catalog catalog)
Returns all server-side record query names available to this user for the given catalog.
|
java.util.Collection<java.lang.String> |
getRecordViewSetNames(Catalog catalog)
Returns all Record View Set names available to this user for the given catalog.
|
java.util.Set<java.lang.String> |
getRoleUIDs()
Returns all role UIDs of the roles this user is a member of.
|
java.util.Collection<java.lang.String> |
getServerPermissions()
Returns all server permissions assigned to this user.
|
java.lang.String |
getUniqueUserID()
Returns the unique user uid for this user.
|
boolean |
hasPermission(java.lang.String permission,
Catalog catalog)
Returns whether this user has the given permission in the specified catalog.
|
boolean |
hasPermission(java.lang.String permission,
Catalog catalog,
java.lang.String tableName)
Returns whether this user has the given permission in the specified sub-table in the specified catalog.
|
boolean |
hasPermission(java.lang.String permission,
Item item)
Returns whether the current user has the specified permission on the given item either through the catalog permissions or by a permission being assigned
to the item itself.
|
boolean |
hasPermission(java.lang.String permission,
ItemCollection itemCollection)
Returns whether the current user has the specified permission on the given item collection.
|
boolean |
hasRecordLiveFilter(Catalog catalog)
Returns whether this user has a live filter applied for the specified catalog.
|
boolean |
hasServerPermission(java.lang.String permission)
Returns whether this user has the given server permission.
|
boolean |
isAdmin()
Returns whether this user is the Cumulus admin user.
|
boolean |
isGuest()
Returns whether the user is the guest user.
|
getAllPermissions, getAllServerPermissions
public static final GUID FID_STREET
public static final int PASSWORD_OPTIONS_MUST_CHANGE_PASSWORD_WITH_NEXT_LOGIN
public static final int PASSWORD_OPTIONS_CANNOT_CHANGE_PASSWORD
public static final int PASSWORD_OPTIONS_PASSWORD_NEVER_EXPIRES
public CumulusSession getCumulusSession()
CumulusSession
object.CumulusSession
object.public java.lang.String getUniqueUserID()
public java.util.Set<java.lang.String> getRoleUIDs()
public java.lang.String getLoginName()
public java.lang.String getDisplayOrLoginName()
[FirstName] [Middle Name] [Last Name]. If no name part can be found, the login name is returned.
public java.lang.String getDisplayName()
[FirstName] [Middle Name] [Last Name]. If no name part can be found, an empty String is returned.
public java.lang.String getEmailAddressRFC822()
John President <john@canto.com>
public java.lang.String getEmailAddress()
public java.util.Set<GUID> getFieldUIDs()
public java.lang.Object getFieldValue(GUID fieldUID)
fieldUID
- the field GUID
.public java.lang.Object getFieldValue(GUID fieldUID, int languageId)
fieldUID
- the field GUID
.languageId
- the field language.public GUID findFieldByName(java.lang.String fieldName)
GUID
.fieldName
- the field name.GUID
or null
if the name doesn't match a field.public java.lang.String getFieldName(GUID fieldUID)
fieldUID
- the field GUID
.public java.lang.String getFieldName(GUID fieldUID, int languageId)
fieldUID
- the field GUID
.languageId
- the field language.public int getFieldType(GUID fieldUID)
GUID
.fieldUID
- the field GUID
.public boolean hasPermission(java.lang.String permission, Catalog catalog)
hasPermission(String, Item)
.permission
- the permission to check. This is either a predefined permission or a custom string. You can get a list of all predefined permissions by
calling PredefinedPermissions.getAllPermissions()
.catalog
- the catalog to check the permission for.true
if the user has the permission; false
otherwise.public boolean hasPermission(java.lang.String permission, Item item)
permission
- the permission to check. This is either a predefined permission or a custom string. You can get a list of all predefined permissions by
calling PredefinedPermissions.getAllPermissions()
.item
- the item to check the permission fortrue
if the user has the permission on the item; false
otherwise.public boolean hasPermission(java.lang.String permission, ItemCollection itemCollection)
permission
- the permission to check. This is either a predefined permission or a custom string. You can get a list of all predefined
permissions by calling PredefinedPermissions.getAllPermissions()
.itemCollection
- the item collection to check the permission fortrue
if the user has the permission on the item collection; false
otherwise.public boolean hasPermission(java.lang.String permission, Catalog catalog, java.lang.String tableName)
hasPermission(String, Item)
.permission
- the permission to check. This is either a predefined permission or a custom string. You can get a list of all predefined permissions by
calling PredefinedPermissions.getAllPermissions()
.catalog
- the catalog to check the permission for.tableName
- The name of the sub-table to check the permission for.true
if the user has the permission; false
otherwise.public boolean hasServerPermission(java.lang.String permission)
permission
- the server permission to check. This is either a predefined permission or a custom string. You can get a list of all predefined server
permissions by calling PredefinedPermissions.getAllServerPermissions()
true
if the user has the server permission; false
otherwise.public boolean isGuest()
true
if the user is the guest user; false
otherwise.public boolean isAdmin()
true
if this is the Cumulus admin user, otherwise falsepublic java.util.Collection<java.lang.String> getPermissions(Catalog catalog)
catalog
- the catalog.public java.util.Collection<java.lang.String> getCustomPermissions(Catalog catalog)
catalog
- the catalog.public java.util.Collection<java.lang.String> getServerPermissions()
public java.util.Collection<java.lang.String> getCustomServerPermissions()
public java.util.Collection<java.lang.String> getRecordViewSetNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getCategoryViewSetNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getAssetHandlingSetNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getAssetActionNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getRecordQueryNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getCategoryQueryNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getMetadataTemplateNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getPrintSetNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getCropTemplateNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getRecordFilterNames(Catalog catalog)
catalog
- catalogpublic java.util.Collection<java.lang.String> getPermissionTemplateNames(Catalog catalog)
catalog
- catalogpublic boolean hasRecordLiveFilter(Catalog catalog)
catalog
- The catalog to checkwww.canto.com
Canto, the Canto logo, the Cumulus logo, and Cumulus are registered trademarks of Canto GmbH, registered in the U.S. and other countries.