Agile
Represents an agile board and the set of sprints that belong to the board.
Extends BaseEntity.
Properties
Name | Type | Description | Read-only |
|---|---|---|---|
author | | The user who created the board. |  |
name | | The name of the agile board. | |
sprints | | The set of sprints that are associated with the board. | |
Methods
findByName
static findByName(name)Returns a set of agile boards that have the specified name.
Parameters
Name | Type | Description |
|---|---|---|
name | | The name of an agile board. |
Return Value
Type | Description | |
|---|---|---|
| A set of agile boards that are assigned the specified name. |
becomes
becomes(fieldName, expected)Checks whether a field is set to an expected value in the current transaction.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | | The name of the field to check. |
expected | | The expected value. |
Return Value
Type | Description | |
|---|---|---|
| If the field is set to the expected value, returns `true`. |
canBeReadBy
canBeReadBy(fieldName, user)Checks whether a user has permission to read the field.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | | The name of the field. |
user | | The user for whom the permission to read the field is checked. |
Return Value
Type | Description | |
|---|---|---|
| If the user can read the field, returns `true`. |
canBeWrittenBy
canBeWrittenBy(fieldName, user)Checks whether a user has permission to update the field.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | | The name of the field. |
user | | The user for whom the permission to update the field is checked. |
Return Value
Type | Description | |
|---|---|---|
| If the user can update the field, returns `true`. |
findSprintByName
findSprintByName(name)Finds a specific sprint by name.
Parameters
Name | Type | Description |
|---|---|---|
name | | The name of the sprint. |
Return Value
Type | Description | |
|---|---|---|
| If a sprint with the specified name is found, the corresponding Sprint object is returned. Otherwise, the return value is null. |
isChanged
isChanged(fieldName)Checks whether the value of a field is changed in the current transaction.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | | The name of the field to check. |
Return Value
Type | Description | |
|---|---|---|
| If the value of the field is changed in the current transaction, returns `true`. |
oldValue
oldValue(fieldName)Returns the previous value of a single-value field before an update was applied. If the field is not changed in the transaction, this value is equal to the current value of the field.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | | The name of the field. |
Return Value
Type | Description | |
|---|---|---|
| previous If the field is changed in the current transaction, the previous value of the field. Otherwise, the current value of the field. |
required
required(fieldName, message)Asserts that a value is set for a field. If a value for the required field is not set, the specified message is displayed in the user interface.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | | The name of the field to check. |
message | | The message that is displayed to the user that describes the field requirement. |