com.jivesoftware.community
Interface ProfileFieldManager

All Superinterfaces:

JiveManager

public interface ProfileFieldManager
extends JiveManager

Defines methods used to create, access, update, and remove profile fields data. All user profile data is managed via the ProfileManager.

Method Summary

ProfileField	createProfileField(ProfileField field) Creates a new profile field.
void	deleteProfileField(long fieldID) Removes a profile field from the system.
void	editProfileField(ProfileField field) Edits the profile field data.
void	editProfileFieldOptions(ProfileField field) Edits the ProfileFieldOption objects for a profile field.
ProfileField	getProfileField(long fieldID) Gets a profile field object by its id.
java.util.List<ProfileField>	getProfileFields() Gets the list of all profile fields in the system.
void	setIndex(ProfileField field, int newIndex) Sets the index of the profile field.

Methods inherited from interface com.jivesoftware.community.JiveManager

destroy, initialize

Method Detail

createProfileField

ProfileField createProfileField(ProfileField field)
                                throws UnauthorizedException

Creates a new profile field.

Parameters:

field - the new profile field to create.

Returns:

the new profile field

Throws:

UnauthorizedException - if not the system admin.

getProfileField

ProfileField getProfileField(long fieldID)

Gets a profile field object by its id.

Parameters:

fieldID - the id of the profile field.

Returns:

the profile field object corresponding to the fieldID.

editProfileField

void editProfileField(ProfileField field)
                      throws UnauthorizedException

Edits the profile field data.

Parameters:

field - the profile field to edit.

Throws:

UnauthorizedException - if not the system admin.

editProfileFieldOptions

void editProfileFieldOptions(ProfileField field)
                             throws UnauthorizedException

Edits the ProfileFieldOption objects for a profile field.

Parameters:

field - the field containing the edited ProfileFieldOption objects.

Throws:

UnauthorizedException - if not the system admin.

deleteProfileField

void deleteProfileField(long fieldID)
                        throws UnauthorizedException

Removes a profile field from the system. This method will also remove all the user data and ProfileFieldOption objects associated with the field.

Parameters:

fieldID - the id of the field to remove

Throws:

UnauthorizedException - if not the system admin.

getProfileFields

java.util.List<ProfileField> getProfileFields()

Gets the list of all profile fields in the system.

Returns:

a list of all profile fields in the system.

setIndex

void setIndex(ProfileField field,
              int newIndex)
              throws UnauthorizedException

Sets the index of the profile field. The index value can be used to display the fields in an arbitrary order. Index values are from 0 to getProfileFields().size() - 1.

Parameters:

field - the profile field to adjust the index of.

newIndex - the new index value for the field.

Throws:

UnauthorizedException - if not the system admin.