omero.api

Interface _IAdminOperationsNC

All Superinterfaces:

_ServiceInterfaceOperationsNC

All Known Subinterfaces:

IAdmin

All Known Implementing Classes:

_IAdminDisp, _IAdminTie

public interface _IAdminOperationsNC
extends _ServiceInterfaceOperationsNC

Administration interface providing access to admin-only functionality as well as JMX-based server access and selected user functions. Most methods require membership in privileged groups. Methods which return Experimenter or ExperimenterGroup instances fetch and load all related instances of ExperimenterGroup or Experimenter, respectively.

Method Summary

Modifier and Type	Method and Description
void	addGroupOwners_async(AMD_IAdmin_addGroupOwners __cb, ExperimenterGroup group, java.util.List<Experimenter> owners) Adds the given users to the owner list for this group.
void	addGroups_async(AMD_IAdmin_addGroups __cb, Experimenter user, java.util.List<ExperimenterGroup> groups) Adds a user to the given groups.
void	canUpdate_async(AMD_IAdmin_canUpdate __cb, IObject obj) Returns true if the currently logged in user can modify the given IObject.
void	changeExpiredCredentials_async(AMD_IAdmin_changeExpiredCredentials __cb, java.lang.String name, java.lang.String oldCred, java.lang.String newCred) Used after an ExpiredCredentialException instance is thrown.
void	changeGroup_async(AMD_IAdmin_changeGroup __cb, IObject obj, java.lang.String omeName) Deprecated. changeGroup() is deprecated. use omero::cmd::Chgrp2() instead.
void	changeOwner_async(AMD_IAdmin_changeOwner __cb, IObject obj, java.lang.String omeName) Deprecated. changeOwner() is deprecated. use omero::cmd::Chown2() instead.
void	changePassword_async(AMD_IAdmin_changePassword __cb, RString newPassword) Changes the password for the current user.
void	changePasswordWithOldPassword_async(AMD_IAdmin_changePasswordWithOldPassword __cb, RString oldPassword, RString newPassword) Changes the password for the current user by passing the old password.
void	changePermissions_async(AMD_IAdmin_changePermissions __cb, IObject obj, Permissions perms) Deprecated. changePermissions() is deprecated. use omero::cmd::Chmod2() instead.
void	changeUserPassword_async(AMD_IAdmin_changeUserPassword __cb, java.lang.String omeName, RString newPassword) Changes the password for the a given user.
void	containedExperimenters_async(AMD_IAdmin_containedExperimenters __cb, long groupId) Fetches all Experimenter users contained in this group.
void	containedGroups_async(AMD_IAdmin_containedGroups __cb, long experimenterId) Fetches all ExperimenterGroup groups of which the given user is a member.
void	createExperimenter_async(AMD_IAdmin_createExperimenter __cb, Experimenter user, ExperimenterGroup defaultGroup, java.util.List<ExperimenterGroup> groups) Creates and returns a new user in the given groups.
void	createExperimenterWithPassword_async(AMD_IAdmin_createExperimenterWithPassword __cb, Experimenter user, RString password, ExperimenterGroup defaultGroup, java.util.List<ExperimenterGroup> groups) Creates and returns a new user in the given groups with password.
void	createGroup_async(AMD_IAdmin_createGroup __cb, ExperimenterGroup group) Creates and returns a new group.
void	createRestrictedSystemUser_async(AMD_IAdmin_createRestrictedSystemUser __cb, Experimenter experimenter, java.util.List<AdminPrivilege> privileges) Creates and returns a new system user.
void	createRestrictedSystemUserWithPassword_async(AMD_IAdmin_createRestrictedSystemUserWithPassword __cb, Experimenter experimenter, java.util.List<AdminPrivilege> privileges, RString password) Creates and returns a new system user.
void	createSystemUser_async(AMD_IAdmin_createSystemUser __cb, Experimenter experimenter) Creates and returns a new system user.
void	createUser_async(AMD_IAdmin_createUser __cb, Experimenter experimenter, java.lang.String group) Creates and returns a new user.
void	deleteExperimenter_async(AMD_IAdmin_deleteExperimenter __cb, Experimenter user) Removes a user by removing the password information for that user as well as all GroupExperimenterMap instances.
void	deleteGroup_async(AMD_IAdmin_deleteGroup __cb, ExperimenterGroup group) Removes a group by first removing all users in the group, and then deleting the actual ExperimenterGroup instance.
void	getAdminPrivileges_async(AMD_IAdmin_getAdminPrivileges __cb, Experimenter user) Gets the light administrator privileges for the given user.
void	getAdminsWithPrivileges_async(AMD_IAdmin_getAdminsWithPrivileges __cb, java.util.List<AdminPrivilege> privileges) Gets the administrators who have all the given privileges.
void	getCurrentAdminPrivileges_async(AMD_IAdmin_getCurrentAdminPrivileges __cb) Gets the light administrator privileges for the current user.
void	getDefaultGroup_async(AMD_IAdmin_getDefaultGroup __cb, long experimenterId) Retrieves the default ExperimenterGroup group for the given user id.
void	getEventContext_async(AMD_IAdmin_getEventContext __cb) Returns an implementation of EventContext loaded with the security for the current user and thread.
void	getExperimenter_async(AMD_IAdmin_getExperimenter __cb, long id) Fetches an Experimenter and all related ExperimenterGroup.
void	getGroup_async(AMD_IAdmin_getGroup __cb, long id) Fetches an ExperimenterGroup and all contained Experimenter users.
void	getLeaderOfGroupIds_async(AMD_IAdmin_getLeaderOfGroupIds __cb, Experimenter exp) Finds the ids for all groups for which the given Experimenter is owner/leader.
void	getMemberOfGroupIds_async(AMD_IAdmin_getMemberOfGroupIds __cb, Experimenter exp) Finds the ids for all groups for which the given Experimenter is a member.
void	getMyUserPhotos_async(AMD_IAdmin_getMyUserPhotos __cb) Retrieves the OriginalFile object attached to this user as specified by uploadMyUserPhoto.
void	getSecurityRoles_async(AMD_IAdmin_getSecurityRoles __cb) Returns the active Roles in use by the server.
void	lookupExperimenter_async(AMD_IAdmin_lookupExperimenter __cb, java.lang.String name) Looks up an Experimenter and all related ExperimenterGroup by name.
void	lookupExperimenters_async(AMD_IAdmin_lookupExperimenters __cb) Looks up all Experimenter experimenters present and all related ExperimenterGroup groups.
void	lookupGroup_async(AMD_IAdmin_lookupGroup __cb, java.lang.String name) Looks up an ExperimenterGroup and all contained Experimenter users by name.
void	lookupGroups_async(AMD_IAdmin_lookupGroups __cb) Looks up all ExperimenterGroup groups present and all related Experimenter experimenters.
void	lookupLdapAuthExperimenter_async(AMD_IAdmin_lookupLdapAuthExperimenter __cb, long id) Looks up Experimenter experimenters who use LDAP authentication (has set dn on password table).
void	lookupLdapAuthExperimenters_async(AMD_IAdmin_lookupLdapAuthExperimenters __cb) Looks up all ids of Experimenter experimenters who use LDAP authentication (has set dn on password table).
void	moveToCommonSpace_async(AMD_IAdmin_moveToCommonSpace __cb, java.util.List<IObject> objects) Moves the given objects into the user group to make them visible and linkable from all security contexts.
void	removeGroupOwners_async(AMD_IAdmin_removeGroupOwners __cb, ExperimenterGroup group, java.util.List<Experimenter> owners) removes the given users from the owner list for this group.
void	removeGroups_async(AMD_IAdmin_removeGroups __cb, Experimenter user, java.util.List<ExperimenterGroup> groups) Removes an experimenter from the given groups.
void	reportForgottenPassword_async(AMD_IAdmin_reportForgottenPassword __cb, java.lang.String name, java.lang.String email) Deprecated. reportForgottenPassword() is deprecated. use omero::cmd::ResetPasswordRequest() instead.
void	setAdminPrivileges_async(AMD_IAdmin_setAdminPrivileges __cb, Experimenter user, java.util.List<AdminPrivilege> privileges) Sets the set of light administrator privileges for the given user.
void	setDefaultGroup_async(AMD_IAdmin_setDefaultGroup __cb, Experimenter user, ExperimenterGroup group) Sets the default group for a given user.
void	setGroupOwner_async(AMD_IAdmin_setGroupOwner __cb, ExperimenterGroup group, Experimenter owner) Adds the user to the owner list for this group.
void	synchronizeLoginCache_async(AMD_IAdmin_synchronizeLoginCache __cb) Uses JMX to refresh the login cache if supported.
void	unsetGroupOwner_async(AMD_IAdmin_unsetGroupOwner __cb, ExperimenterGroup group, Experimenter owner) Removes the user from the owner list for this group.
void	updateExperimenter_async(AMD_IAdmin_updateExperimenter __cb, Experimenter experimenter) Updates an experimenter if admin or owner of group.
void	updateExperimenterWithPassword_async(AMD_IAdmin_updateExperimenterWithPassword __cb, Experimenter experimenter, RString password) Updates an experimenter if admin or owner of group.
void	updateGroup_async(AMD_IAdmin_updateGroup __cb, ExperimenterGroup group) Updates an experimenter group if admin or owner of group.
void	updateSelf_async(AMD_IAdmin_updateSelf __cb, Experimenter experimenter) Allows a user to update his/her own information.
void	uploadMyUserPhoto_async(AMD_IAdmin_uploadMyUserPhoto __cb, java.lang.String filename, java.lang.String format, byte[] data) Uploads a photo for the user which will be displayed on his/her profile.

Method Detail

canUpdate_async

void canUpdate_async(AMD_IAdmin_canUpdate __cb,
                     IObject obj)
              throws ServerError

Returns true if the currently logged in user can modify the given IObject. This uses the same logic that would be applied during a Hibernate flush to the database.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

getExperimenter_async

void getExperimenter_async(AMD_IAdmin_getExperimenter __cb,
                           long id)
                    throws ServerError

Fetches an Experimenter and all related ExperimenterGroup.

Parameters:

__cb - The callback object for the operation.

id - id of the Experimenter

Throws:

ApiUsageException - if id does not exist.

ServerError

lookupExperimenter_async

void lookupExperimenter_async(AMD_IAdmin_lookupExperimenter __cb,
                              java.lang.String name)
                       throws ServerError

Looks up an Experimenter and all related ExperimenterGroup by name.

Parameters:

__cb - The callback object for the operation.

name - Name of the Experimenter

Throws:

ApiUsageException - if omeName does not exist.

ServerError

lookupExperimenters_async

void lookupExperimenters_async(AMD_IAdmin_lookupExperimenters __cb)
                        throws ServerError

Looks up all Experimenter experimenters present and all related ExperimenterGroup groups.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

getGroup_async

void getGroup_async(AMD_IAdmin_getGroup __cb,
                    long id)
             throws ServerError

Fetches an ExperimenterGroup and all contained Experimenter users.

Parameters:

__cb - The callback object for the operation.

id - id of the ExperimenterGroup

Throws:

ApiUsageException - if id does not exist.

ServerError

lookupGroup_async

void lookupGroup_async(AMD_IAdmin_lookupGroup __cb,
                       java.lang.String name)
                throws ServerError

Looks up an ExperimenterGroup and all contained Experimenter users by name.

Parameters:

__cb - The callback object for the operation.

name - Name of the ExperimenterGroup

Throws:

ApiUsageException - if groupName does not exist.

ServerError

lookupGroups_async

void lookupGroups_async(AMD_IAdmin_lookupGroups __cb)
                 throws ServerError

Looks up all ExperimenterGroup groups present and all related Experimenter experimenters. The experimenter's groups are also loaded.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

containedExperimenters_async

void containedExperimenters_async(AMD_IAdmin_containedExperimenters __cb,
                                  long groupId)
                           throws ServerError

Fetches all Experimenter users contained in this group. The returned users will have all fields filled in and all collections unloaded.

Parameters:

__cb - The callback object for the operation.

groupId - id of the ExperimenterGroup

Throws:

ServerError

containedGroups_async

void containedGroups_async(AMD_IAdmin_containedGroups __cb,
                           long experimenterId)
                    throws ServerError

Fetches all ExperimenterGroup groups of which the given user is a member. The returned groups will have all fields filled in and all collections unloaded.

Parameters:

__cb - The callback object for the operation.

experimenterId - id of the Experimenter. Not null.

Throws:

ServerError

getDefaultGroup_async

void getDefaultGroup_async(AMD_IAdmin_getDefaultGroup __cb,
                           long experimenterId)
                    throws ServerError

Retrieves the default ExperimenterGroup group for the given user id.

Parameters:

__cb - The callback object for the operation.

experimenterId - of the Experimenter. Not null.

Throws:

ServerError

lookupLdapAuthExperimenter_async

void lookupLdapAuthExperimenter_async(AMD_IAdmin_lookupLdapAuthExperimenter __cb,
                                      long id)
                               throws ServerError

Looks up Experimenter experimenters who use LDAP authentication (has set dn on password table).

Parameters:

__cb - The callback object for the operation.

id - id of the Experimenter. Not null.

Throws:

ServerError

lookupLdapAuthExperimenters_async

void lookupLdapAuthExperimenters_async(AMD_IAdmin_lookupLdapAuthExperimenters __cb)
                                throws ServerError

Looks up all ids of Experimenter experimenters who use LDAP authentication (has set dn on password table).

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

getMemberOfGroupIds_async

void getMemberOfGroupIds_async(AMD_IAdmin_getMemberOfGroupIds __cb,
                               Experimenter exp)
                        throws ServerError

Finds the ids for all groups for which the given Experimenter is a member.

Parameters:

__cb - The callback object for the operation.

exp - Non-null, managed (i.e. with id)

Throws:

ServerError

getLeaderOfGroupIds_async

void getLeaderOfGroupIds_async(AMD_IAdmin_getLeaderOfGroupIds __cb,
                               Experimenter exp)
                        throws ServerError

Finds the ids for all groups for which the given Experimenter is owner/leader.

Parameters:

__cb - The callback object for the operation.

exp - Non-null, managed (i.e. with id)

Throws:

ServerError

getCurrentAdminPrivileges_async

void getCurrentAdminPrivileges_async(AMD_IAdmin_getCurrentAdminPrivileges __cb)
                              throws ServerError

Gets the light administrator privileges for the current user.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

getAdminPrivileges_async

void getAdminPrivileges_async(AMD_IAdmin_getAdminPrivileges __cb,
                              Experimenter user)
                       throws ServerError

Gets the light administrator privileges for the given user.

Parameters:

__cb - The callback object for the operation.

user - the user whose privileges are being queried

Throws:

ServerError

getAdminsWithPrivileges_async

void getAdminsWithPrivileges_async(AMD_IAdmin_getAdminsWithPrivileges __cb,
                                   java.util.List<AdminPrivilege> privileges)
                            throws ServerError

Gets the administrators who have all the given privileges. Consistent with the results from "getAdminPrivileges".

Parameters:

__cb - The callback object for the operation.

privileges - the required privileges

Throws:

ServerError

updateSelf_async

void updateSelf_async(AMD_IAdmin_updateSelf __cb,
                      Experimenter experimenter)
               throws ServerError

Allows a user to update his/her own information. This is limited to the fields on Experimenter, all other fields (groups, etc.) are ignored. The experimenter argument need not have the proper id nor the proper omeName (which is immutable). To change the users default group (which is the only other customizable option), use setDefaultGroup

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

uploadMyUserPhoto_async

void uploadMyUserPhoto_async(AMD_IAdmin_uploadMyUserPhoto __cb,
                             java.lang.String filename,
                             java.lang.String format,
                             byte[] data)
                      throws ServerError

Uploads a photo for the user which will be displayed on his/her profile. This photo will be saved as an OriginalFile object with the given format, and attached to the user's Experimenter object via an FileAnnotation with the namespace: openmicroscopy.org/omero/experimenter/photo (NSEXPERIMENTERPHOTO). If such an OriginalFile instance already exists, it will be overwritten. If more than one photo is present, the oldest version will be modified (i.e. the highest updateEvent id). Note: as outlined in ticket 1794 this photo will be placed in the user group and therefore will be visible to everyone on the system.

Parameters:

__cb - The callback object for the operation.

filename - Not null. String name which will be used.

data - Not null. Data from the image. This will be written to disk.

Throws:

ServerError

getMyUserPhotos_async

void getMyUserPhotos_async(AMD_IAdmin_getMyUserPhotos __cb)
                    throws ServerError

Retrieves the OriginalFile object attached to this user as specified by uploadMyUserPhoto. The return value is order by the most recently modified file first.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

updateExperimenter_async

void updateExperimenter_async(AMD_IAdmin_updateExperimenter __cb,
                              Experimenter experimenter)
                       throws ServerError

Updates an experimenter if admin or owner of group. Only string fields on the object are taken into account. The root and guest experimenters may not be renamed. Before a SecurityViolation would be thrown, however, this method will pass to #updateSelf if the current user matches the given experimenter.

Parameters:

__cb - The callback object for the operation.

experimenter - the Experimenter to update.

Throws:

ServerError

updateExperimenterWithPassword_async

void updateExperimenterWithPassword_async(AMD_IAdmin_updateExperimenterWithPassword __cb,
                                          Experimenter experimenter,
                                          RString password)
                                   throws ServerError

Updates an experimenter if admin or owner of group. Only string fields on the object are taken into account. The root and guest experimenters may not be renamed.

Parameters:

__cb - The callback object for the operation.

experimenter - the Experimenter to update.

Throws:

ServerError

updateGroup_async

void updateGroup_async(AMD_IAdmin_updateGroup __cb,
                       ExperimenterGroup group)
                throws ServerError

Updates an experimenter group if admin or owner of group. Only string fields on the object are taken into account. The root, system and guest groups may not be renamed, nor may the user's current group.

Parameters:

__cb - The callback object for the operation.

group - the ExperimenterGroup to update.

Throws:

ServerError

createUser_async

void createUser_async(AMD_IAdmin_createUser __cb,
                      Experimenter experimenter,
                      java.lang.String group)
               throws ServerError

Creates and returns a new user. This user will be created with the default group specified.

Parameters:

__cb - The callback object for the operation.

experimenter - a new Experimenter instance

group - group name of the default group for this user

Throws:

ServerError

createSystemUser_async

void createSystemUser_async(AMD_IAdmin_createSystemUser __cb,
                            Experimenter experimenter)
                     throws ServerError

Creates and returns a new system user. This user will be created with the System (administration) group as default and will also be in the user group.

Parameters:

__cb - The callback object for the operation.

experimenter - a new Experimenter instance

Throws:

ServerError

createRestrictedSystemUser_async

void createRestrictedSystemUser_async(AMD_IAdmin_createRestrictedSystemUser __cb,
                                      Experimenter experimenter,
                                      java.util.List<AdminPrivilege> privileges)
                               throws ServerError

Creates and returns a new system user. This user will be created with the System (administration) group as default and will also be in the user group. Their light administrator privileges will be set as given.

Parameters:

__cb - The callback object for the operation.

experimenter - a new Experimenter instance

privileges - the privileges to set for the user

Throws:

ServerError

createRestrictedSystemUserWithPassword_async

void createRestrictedSystemUserWithPassword_async(AMD_IAdmin_createRestrictedSystemUserWithPassword __cb,
                                                  Experimenter experimenter,
                                                  java.util.List<AdminPrivilege> privileges,
                                                  RString password)
                                           throws ServerError

Creates and returns a new system user. This user will be created with the System (administration) group as default and will also be in the user group. Their light administrator privileges and password will be set as given.

Parameters:

__cb - The callback object for the operation.

experimenter - a new Experimenter instance

privileges - the privileges to set for the user

Throws:

ServerError

createExperimenter_async

void createExperimenter_async(AMD_IAdmin_createExperimenter __cb,
                              Experimenter user,
                              ExperimenterGroup defaultGroup,
                              java.util.List<ExperimenterGroup> groups)
                       throws ServerError

Creates and returns a new user in the given groups.

Parameters:

__cb - The callback object for the operation.

user - A new Experimenter instance. Not null.

defaultGroup - Instance of ExperimenterGroup. Not null.

groups - Array of ExperimenterGroup instances. Can be null.

Throws:

ServerError

createExperimenterWithPassword_async

void createExperimenterWithPassword_async(AMD_IAdmin_createExperimenterWithPassword __cb,
                                          Experimenter user,
                                          RString password,
                                          ExperimenterGroup defaultGroup,
                                          java.util.List<ExperimenterGroup> groups)
                                   throws ServerError

Creates and returns a new user in the given groups with password.

Parameters:

__cb - The callback object for the operation.

user - A new Experimenter instance. Not null.

password - Not-null. Must pass validation in the security sub-system.

defaultGroup - Instance of ExperimenterGroup. Not null.

groups - Array of ExperimenterGroup instances. Can be null.

Throws:

SecurityViolation - if the new password is too weak.

ServerError

createGroup_async

void createGroup_async(AMD_IAdmin_createGroup __cb,
                       ExperimenterGroup group)
                throws ServerError

Creates and returns a new group. The omero.model.Details.setPermissions method should be called on the instance which is passed. The given Permissions will become the default for all objects created while logged into this group, possibly modified by the user's umask settings. If no permissions is set, the default will be omero.model.Permissions.USER_PRIVATE, i.e. a group in which no user can see the other group member's data. See also ticket 1434

Parameters:

__cb - The callback object for the operation.

group - a new ExperimenterGroup instance. Not null.

Throws:

ServerError

addGroups_async

void addGroups_async(AMD_IAdmin_addGroups __cb,
                     Experimenter user,
                     java.util.List<ExperimenterGroup> groups)
              throws ServerError

Adds a user to the given groups.

Parameters:

__cb - The callback object for the operation.

user - A currently managed entity. Not null.

Throws:

ServerError

removeGroups_async

void removeGroups_async(AMD_IAdmin_removeGroups __cb,
                        Experimenter user,
                        java.util.List<ExperimenterGroup> groups)
                 throws ServerError

Removes an experimenter from the given groups.

• The root experimenter is required to be in both the user and system groups.
• An experimenter may not remove themselves from the user or system group.
• An experimenter may not be a member of only the user group, some other group is also required as the default group.
• An experimenter must remain a member of some group.

Parameters:

__cb - The callback object for the operation.

user - A currently managed entity. Not null.

Throws:

ServerError

setDefaultGroup_async

void setDefaultGroup_async(AMD_IAdmin_setDefaultGroup __cb,
                           Experimenter user,
                           ExperimenterGroup group)
                    throws ServerError

Sets the default group for a given user.

Parameters:

__cb - The callback object for the operation.

user - A currently managed Experimenter. Not null.

group - The group which should be set as default group for this user. Not null.

Throws:

ServerError

setGroupOwner_async

void setGroupOwner_async(AMD_IAdmin_setGroupOwner __cb,
                         ExperimenterGroup group,
                         Experimenter owner)
                  throws ServerError

Adds the user to the owner list for this group. Since Beta 4.2 multiple users can be the owner of a group.

Parameters:

__cb - The callback object for the operation.

group - A currently managed ExperimenterGroup. Not null.

owner - A currently managed Experimenter. Not null.

Throws:

ServerError

unsetGroupOwner_async

void unsetGroupOwner_async(AMD_IAdmin_unsetGroupOwner __cb,
                           ExperimenterGroup group,
                           Experimenter owner)
                    throws ServerError

Removes the user from the owner list for this group. Since Beta 4.2 multiple users can be the owner of a group.

Parameters:

__cb - The callback object for the operation.

group - A currently managed ExperimenterGroup. Not null.

owner - A currently managed Experimenter. Not null.

Throws:

ServerError

addGroupOwners_async

void addGroupOwners_async(AMD_IAdmin_addGroupOwners __cb,
                          ExperimenterGroup group,
                          java.util.List<Experimenter> owners)
                   throws ServerError

Adds the given users to the owner list for this group.

Parameters:

__cb - The callback object for the operation.

group - A currently managed ExperimenterGroup. Not null.

owners - A set of currently managed Experimenters. Not null.

Throws:

ServerError

removeGroupOwners_async

void removeGroupOwners_async(AMD_IAdmin_removeGroupOwners __cb,
                             ExperimenterGroup group,
                             java.util.List<Experimenter> owners)
                      throws ServerError

removes the given users from the owner list for this group.

Parameters:

__cb - The callback object for the operation.

group - A currently managed ExperimenterGroup. Not

owners - A set of currently managed Experimenters. Not null.

Throws:

ServerError

deleteExperimenter_async

void deleteExperimenter_async(AMD_IAdmin_deleteExperimenter __cb,
                              Experimenter user)
                       throws ServerError

Removes a user by removing the password information for that user as well as all GroupExperimenterMap instances.

Parameters:

__cb - The callback object for the operation.

user - Experimenter to be deleted. Not null.

Throws:

ServerError

deleteGroup_async

void deleteGroup_async(AMD_IAdmin_deleteGroup __cb,
                       ExperimenterGroup group)
                throws ServerError

Removes a group by first removing all users in the group, and then deleting the actual ExperimenterGroup instance.

Parameters:

__cb - The callback object for the operation.

group - ExperimenterGroup to be deleted. Not null.

Throws:

ServerError

changeOwner_async

void changeOwner_async(AMD_IAdmin_changeOwner __cb,
                       IObject obj,
                       java.lang.String omeName)
                throws ServerError

Deprecated. changeOwner() is deprecated. use omero::cmd::Chown2() instead.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

changeGroup_async

void changeGroup_async(AMD_IAdmin_changeGroup __cb,
                       IObject obj,
                       java.lang.String omeName)
                throws ServerError

Deprecated. changeGroup() is deprecated. use omero::cmd::Chgrp2() instead.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

changePermissions_async

void changePermissions_async(AMD_IAdmin_changePermissions __cb,
                             IObject obj,
                             Permissions perms)
                      throws ServerError

Deprecated. changePermissions() is deprecated. use omero::cmd::Chmod2() instead.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

moveToCommonSpace_async

void moveToCommonSpace_async(AMD_IAdmin_moveToCommonSpace __cb,
                             java.util.List<IObject> objects)
                      throws ServerError

Moves the given objects into the user group to make them visible and linkable from all security contexts. See also ticket 1794

Parameters:

__cb - The callback object for the operation.

objects -

Throws:

ServerError

setAdminPrivileges_async

void setAdminPrivileges_async(AMD_IAdmin_setAdminPrivileges __cb,
                              Experimenter user,
                              java.util.List<AdminPrivilege> privileges)
                       throws ServerError

Sets the set of light administrator privileges for the given user.

Parameters:

__cb - The callback object for the operation.

user - the user whose privileges are to be set

Throws:

ServerError

changePassword_async

void changePassword_async(AMD_IAdmin_changePassword __cb,
                          RString newPassword)
                   throws ServerError

Changes the password for the current user.

Warning:This method requires the user to be authenticated with a password and not with a one-time session id. To avoid this problem, use changePasswordWithOldPassword.

See also ticket 911 and ticket 3201

Parameters:

__cb - The callback object for the operation.

newPassword - Possibly null to allow logging in with no password.

Throws:

SecurityViolation - if the user is not authenticated with a password.

ServerError

changePasswordWithOldPassword_async

void changePasswordWithOldPassword_async(AMD_IAdmin_changePasswordWithOldPassword __cb,
                                         RString oldPassword,
                                         RString newPassword)
                                  throws ServerError

Changes the password for the current user by passing the old password.

Parameters:

__cb - The callback object for the operation.

oldPassword - Not-null. Must pass validation in the security sub-system.

newPassword - Possibly null to allow logging in with no password.

Throws:

SecurityViolation - if the oldPassword is incorrect.

ServerError

changeUserPassword_async

void changeUserPassword_async(AMD_IAdmin_changeUserPassword __cb,
                              java.lang.String omeName,
                              RString newPassword)
                       throws ServerError

Changes the password for the a given user.

Parameters:

__cb - The callback object for the operation.

newPassword - Not-null. Might must pass validation in the security sub-system.

Throws:

SecurityViolation - if the new password is too weak.

ServerError

synchronizeLoginCache_async

void synchronizeLoginCache_async(AMD_IAdmin_synchronizeLoginCache __cb)
                          throws ServerError

Uses JMX to refresh the login cache if supported. Some backends may not provide refreshing. This may be called internally during some other administrative tasks. The exact implementation of this depends on the application server and the authentication/authorization backend.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

changeExpiredCredentials_async

void changeExpiredCredentials_async(AMD_IAdmin_changeExpiredCredentials __cb,
                                    java.lang.String name,
                                    java.lang.String oldCred,
                                    java.lang.String newCred)
                             throws ServerError

Used after an ExpiredCredentialException instance is thrown.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

reportForgottenPassword_async

void reportForgottenPassword_async(AMD_IAdmin_reportForgottenPassword __cb,
                                   java.lang.String name,
                                   java.lang.String email)
                            throws ServerError

Deprecated. reportForgottenPassword() is deprecated. use omero::cmd::ResetPasswordRequest() instead.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

getSecurityRoles_async

void getSecurityRoles_async(AMD_IAdmin_getSecurityRoles __cb)
                     throws ServerError

Returns the active Roles in use by the server.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError

getEventContext_async

void getEventContext_async(AMD_IAdmin_getEventContext __cb)
                    throws ServerError

Returns an implementation of EventContext loaded with the security for the current user and thread. If called remotely, not all values of EventContext will be sensible.

Parameters:

__cb - The callback object for the operation.

Throws:

ServerError