com.versionone.om
Class Member

java.lang.Object
  extended by com.versionone.om.Entity
      extended by com.versionone.om.BaseAsset
          extended by com.versionone.om.Member

public class Member
extends BaseAsset

Represents a user or member in the VersionOne system.


Field Summary
 
Fields inherited from class com.versionone.om.BaseAsset
STATE_ACTIVE, STATE_CLOSED
 
Fields inherited from class com.versionone.om.Entity
ASSET_STATE_VALUE, ASSET_VALUE, CHANGE_DATE_UTC, CONTENT_TYPE_VALUE, CONTENT_VALUE, CREATE_DATE_UTC, DELETE_OPERATION, DESCRIPTION_VALUE, FILENAME_VALUE, NAME_VALUE
 
Method Summary
 Conversation createConversation(Member author, java.lang.String content)
          Creates conversation which mentioned this member.
 Conversation createConversation(Member author, java.lang.String content, java.util.Map<java.lang.String,java.lang.Object> attributes)
          Creates conversation which mentioned this asset.
 Conversation createConversation(java.lang.String content)
          Creates conversation with this member as author.
 java.util.Collection<Project> getAssignedProjects()
          Gets Projects this member is assigned to.
 Role getDefaultRole()
           
 java.util.Collection<Effort> getEffortRecords(EffortFilter filter)
          A collection of Effort Records that belong to this member.
 java.lang.String getEmail()
           
 java.util.Collection<Conversation> getExpressions()
           
 java.util.Collection<Conversation> getMentionedInExpressions()
           
 boolean getNotifyViaEmail()
          A flag indicating whether this member desires to receive e-mail notifications.
 java.util.Collection<Epic> getOwnedEpics(EpicFilter filter)
          Epics owned by this member.
 java.util.Collection<Issue> getOwnedIssues(IssueFilter filter)
          A read-only collection of Issues owned by this member.
 java.util.Collection<PrimaryWorkitem> getOwnedPrimaryWorkitems(PrimaryWorkitemFilter filter)
          Gets Stories and Defects owned by this member.
 java.util.Collection<Request> getOwnedRequests(RequestFilter filter)
          A read-only collection of Requests owned by this member.
 java.util.Collection<SecondaryWorkitem> getOwnedSecondaryWorkitems(SecondaryWorkitemFilter filter)
          Tasks and Tests owned by this member.
 java.util.Collection<Theme> getOwnedThemes(ThemeFilter filter)
          A collection of Themes owned by this member.
 java.lang.String getPhone()
           
 java.lang.String getShortName()
           
 java.lang.Double getTotalDetailEstimate(WorkitemFilter filter)
          Return the total detail estimate for all workitems owned by this member optionally filtered.
 java.lang.Double getTotalDone(WorkitemFilter filter)
          Return the total done for all workitems owned by this member optionally filtered.
 java.lang.Double getTotalEstimate(PrimaryWorkitemFilter filter)
          Return the total estimate for all stories and defects owned by this member optionally filtered.
 java.lang.Double getTotalToDo(WorkitemFilter filter)
          Return the total to do for all workitems owned by this member optionally filtered.
 java.lang.String getUsername()
           
 void setDefaultRole(Role defaultRole)
           
 void setEmail(java.lang.String value)
           
 void setNotifyViaEmail(boolean value)
           
 void setPassword(java.lang.String value)
           
 void setPhone(java.lang.String value)
           
 void setShortName(java.lang.String shortName)
           
 void setUsername(java.lang.String value)
           
 
Methods inherited from class com.versionone.om.BaseAsset
canClose, canDelete, canReactivate, close, createAttachment, createAttachment, createLink, createLink, createNote, createNote, delete, getAttachments, getCustomDropdown, getCustomField, getDescription, getLinks, getName, getNotes, getReferencedInExpressions, getURL, isActive, isClosed, reactivate, setDescription, setName
 
Methods inherited from class com.versionone.om.Entity
equals, get, getChangeComment, getChangeDate, getChangedBy, getCreateComment, getCreateDate, getCreatedBy, getID, getInstance, hashCode, save, save, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Method Detail

getShortName

public java.lang.String getShortName()
Returns:
The short or abbreviated name of the user or member. This name is often used in the owner's dropdown.

setShortName

public void setShortName(java.lang.String shortName)
Parameters:
shortName - The short or abbreviated name of the user or member. This name is often used in the owner's dropdown.

getDefaultRole

public Role getDefaultRole()
Returns:
The default role of the user or member. Determines the member's permissions when assigned to a project. Also determines the member's global privileges.

setDefaultRole

public void setDefaultRole(Role defaultRole)
Parameters:
defaultRole - The default role of the user or member. Determines the member's permissions when assigned to a project. Also determines the member's global privileges.

getUsername

public java.lang.String getUsername()
Returns:
The username this user or member uses to login to the VersionOne system.

setUsername

public void setUsername(java.lang.String value)
Parameters:
value - The username this user or member uses to login to the VersionOne system.

setPassword

public void setPassword(java.lang.String value)
Parameters:
value - The password this user or member uses to login to the VersionOne system. This is a write-only property.

getEmail

public java.lang.String getEmail()
Returns:
The Email for this member.

setEmail

public void setEmail(java.lang.String value)
Parameters:
value - The Email for this member.

getPhone

public java.lang.String getPhone()
Returns:
The phone number for this member.

setPhone

public void setPhone(java.lang.String value)
Parameters:
value - The phone number for this member.

getAssignedProjects

public java.util.Collection<Project> getAssignedProjects()
Gets Projects this member is assigned to.

Returns:
assigned Projects.

getMentionedInExpressions

public java.util.Collection<Conversation> getMentionedInExpressions()
Returns:
Conversation items that contain mentions of the member.

getExpressions

public java.util.Collection<Conversation> getExpressions()
Returns:
Conversation messages created by the member.

getOwnedPrimaryWorkitems

public java.util.Collection<PrimaryWorkitem> getOwnedPrimaryWorkitems(PrimaryWorkitemFilter filter)
Gets Stories and Defects owned by this member.

Parameters:
filter - Criteria to filter stories and defects on. Pass a DefectFilter or StoryFilter to get only Defects or Stories, respectively.
Returns:
selected Workitems.

getOwnedSecondaryWorkitems

public java.util.Collection<SecondaryWorkitem> getOwnedSecondaryWorkitems(SecondaryWorkitemFilter filter)
Tasks and Tests owned by this member.

Parameters:
filter - Filter for Tasks and Tests.
Returns:
Collection of bases of a Tasks or Tests in the VersionOne System.

getOwnedThemes

public java.util.Collection<Theme> getOwnedThemes(ThemeFilter filter)
A collection of Themes owned by this member.

Parameters:
filter - Limit the themes returned (If null, then all items returned).
Returns:
A collection themes that belong to this member filtered by the passed in filter.

getOwnedIssues

public java.util.Collection<Issue> getOwnedIssues(IssueFilter filter)
A read-only collection of Issues owned by this member.

Parameters:
filter - Limit the issues returned (If null, then all items returned).
Returns:
A collection issues that belong to this member filtered by the passed in filter.

getOwnedRequests

public java.util.Collection<Request> getOwnedRequests(RequestFilter filter)
A read-only collection of Requests owned by this member.

Parameters:
filter - Limit the requests returned (If null, then all items returned).
Returns:
A collection requests that belong to this member filtered by the passed in filter.

getOwnedEpics

public java.util.Collection<Epic> getOwnedEpics(EpicFilter filter)
Epics owned by this member.

Parameters:
filter - Limit the epics returned (If null, then all items returned).
Returns:
A collection epics that belong to this member filtered by the passed in filter.

getEffortRecords

public java.util.Collection<Effort> getEffortRecords(EffortFilter filter)
A collection of Effort Records that belong to this member.

Parameters:
filter - Limit the efforts returned (If null, then all items returned).
Returns:
A collection efforts that belong to this member filtered by the passed in filter.

getTotalEstimate

public java.lang.Double getTotalEstimate(PrimaryWorkitemFilter filter)
Return the total estimate for all stories and defects owned by this member optionally filtered.

Parameters:
filter - Criteria to filter stories and defects on. Pass a DefectFilter or StoryFilter to get only Defects or Stories, respectively.
Returns:
total estimate of selected Workitems.

getTotalDetailEstimate

public java.lang.Double getTotalDetailEstimate(WorkitemFilter filter)
Return the total detail estimate for all workitems owned by this member optionally filtered.

Parameters:
filter - Criteria to filter workitems on.
Returns:
total detail estimate of selected Workitems.

getTotalToDo

public java.lang.Double getTotalToDo(WorkitemFilter filter)
Return the total to do for all workitems owned by this member optionally filtered.

Parameters:
filter - Criteria to filter workitems on.
Returns:
total to do of selected Workitems.

getTotalDone

public java.lang.Double getTotalDone(WorkitemFilter filter)
Return the total done for all workitems owned by this member optionally filtered.

Parameters:
filter - Criteria to filter workitems on.
Returns:
total done of selected Workitems.

createConversation

public Conversation createConversation(Member author,
                                       java.lang.String content)
Creates conversation which mentioned this member.

Overrides:
createConversation in class BaseAsset
Parameters:
Author - of conversation.
content - Content of conversation.
Returns:
Created conversation.

createConversation

public Conversation createConversation(Member author,
                                       java.lang.String content,
                                       java.util.Map<java.lang.String,java.lang.Object> attributes)
Creates conversation which mentioned this asset.

Overrides:
createConversation in class BaseAsset
Parameters:
author - Author of conversation.
content - Content of conversation.
attributes - additional attributes for the Conversation.
Returns:
Created conversation

createConversation

public Conversation createConversation(java.lang.String content)
Creates conversation with this member as author.

Parameters:
content - Content of conversation.
Returns:
Created conversation.

getNotifyViaEmail

public boolean getNotifyViaEmail()
A flag indicating whether this member desires to receive e-mail notifications.


setNotifyViaEmail

public void setNotifyViaEmail(boolean value)