Package omero.api

Interface _IAdminOperationsNC

    • 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

      • 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

      • 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

      • 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

      • 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

      • 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

      • 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

      • 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

      • 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

      • 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