One member's nomination of another member for a recognition badge, awaiting a decision from an approver. The nomination records who was nominated, which badge for, who nominated them and why. It stays pending until it is processed, at which point the result code is set to a for accepted or r for rejected and the approver and processing date are stamped on it. When a nomination is accepted the resulting RecognitionAward is linked back through the awarded property. Note that findForOrg deliberately returns only nominations with no result code, ie those still waiting to be dealt with.
Group: Database Entities
Implements: Serializable, Relational
Properties
| Property | Returns | Description |
|---|---|---|
| awarded | RecognitionAward | The award created when this nomination was accepted. Null while the nomination is still pending, and for rejected nominations. Loaded lazily. |
| createdBy | Profile | The member who raised the nomination. Never null for a persisted nomination, and loaded lazily. |
| createdDate | Date | When the nomination was raised. Never null, and pending nominations are listed oldest first by this date. |
| id | long | The database identifier of this nomination. |
| nominatedBadge | RecognitionBadge | The badge the member is being nominated for. Never null for a persisted nomination. |
| nominee | Profile | The member being nominated, who receives the badge if the nomination is accepted. Never null for a persisted nomination. |
| processedBy | Profile | The approver who accepted or rejected the nomination. Null while it is still pending, and loaded lazily. |
| processedDate | Date | When the nomination was accepted or rejected. Null while it is still pending. |
| reason | String | Free-text explanation given by the nominator for why this member deserves the badge, shown to the approver. |
| resultCode | String | The outcome of the nomination: a for accepted, r for rejected. Null while the nomination is still waiting to be dealt with, which is how pending nominations are found. |
Methods
getId() · setOrganisation(Organisation organisation) · getNominatedBadge() · setNominatedBadge(RecognitionBadge nominatedBadge) · getNominee() · setNominee(Profile nominee) · getCreatedBy() · setCreatedBy(Profile createdBy) · getCreatedDate() · setCreatedDate(Date createdDate) · getAwarded() · setAwarded(RecognitionAward awarded) · getProcessedDate() · setProcessedDate(Date processedDate) · getProcessedBy() · setProcessedBy(Profile processedBy) · getResultCode() · setResultCode(String resultCode) · getReason() · setReason(String reason) · rowId()
getId()
Returns: long
The database identifier of this nomination.
setOrganisation(Organisation organisation)
Returns: void
Sets the organisation the nomination belongs to.
| Parameter | Description |
|---|---|
organisation | the owning organisation |
getNominatedBadge()
Returns: RecognitionBadge
The badge the member is being nominated for. Never null for a persisted nomination.
setNominatedBadge(RecognitionBadge nominatedBadge)
Returns: void
Sets the badge the member is being nominated for.
| Parameter | Description |
|---|---|
nominatedBadge | the badge nominated for |
getNominee()
Returns: Profile
The member being nominated, who receives the badge if the nomination is accepted. Never null for a persisted nomination.
setNominee(Profile nominee)
Returns: void
Sets the member being nominated.
| Parameter | Description |
|---|---|
nominee | the nominated member |
getCreatedBy()
Returns: Profile
The member who raised the nomination. Never null for a persisted nomination, and loaded lazily.
setCreatedBy(Profile createdBy)
Returns: void
Sets the member who raised the nomination.
| Parameter | Description |
|---|---|
createdBy | the member who nominated |
getCreatedDate()
Returns: Date
When the nomination was raised. Never null, and pending nominations are listed oldest first by this date.
setCreatedDate(Date createdDate)
Returns: void
Sets the date the nomination was raised.
| Parameter | Description |
|---|---|
createdDate | the date the nomination was raised |
getAwarded()
Returns: RecognitionAward
The award created when this nomination was accepted. Null while the nomination is still pending, and for rejected nominations. Loaded lazily.
setAwarded(RecognitionAward awarded)
Returns: void
Links the award created when this nomination was accepted.
| Parameter | Description |
|---|---|
awarded | the resulting recognition award |
getProcessedDate()
Returns: Date
When the nomination was accepted or rejected. Null while it is still pending.
setProcessedDate(Date processedDate)
Returns: void
Sets the date the nomination was accepted or rejected.
| Parameter | Description |
|---|---|
processedDate | the date the nomination was decided |
getProcessedBy()
Returns: Profile
The approver who accepted or rejected the nomination. Null while it is still pending, and loaded lazily.
setProcessedBy(Profile processedBy)
Returns: void
Sets the approver who accepted or rejected the nomination.
| Parameter | Description |
|---|---|
processedBy | the member who decided the nomination |
getResultCode()
Returns: String
The outcome of the nomination: a for accepted, r for rejected. Null while the nomination is still waiting to be dealt with, which is how pending nominations are found.
setResultCode(String resultCode)
Returns: void
Sets the outcome of the nomination.
| Parameter | Description |
|---|---|
resultCode | a for accepted, r for rejected, or null to make it pending again |
getReason()
Returns: String
Free-text explanation given by the nominator for why this member deserves the badge, shown to the approver.
setReason(String reason)
Returns: void
Sets the explanation for why this member deserves the badge.
| Parameter | Description |
|---|---|
reason | the nomination reason |
rowId()
Returns: Long
The database identifier of this nomination, as required by the Relational interface.