Agile
Represents an agile board and the set of sprints that belong to the board.
Extends BaseEntity.
Properties
Name | Type | Description |
---|---|---|
author | User | Read-only. The user who created the board. |
becomesRemoved | Boolean | Read-only. When `true`, the entity is removed in the current transaction. Otherwise, `false`. This property can become `true` only in on-change rules when the rule is triggered on the removal of an issue or an article. In the rule code, the `runOn` rule property must contain the `removal` parameter set to `true`. Available since 2017.4.37915 runOn: {removal: true} |
currentSprint | Sprint | Read-only. The sprint that is considered to be in active development at the current moment. Available since 2023.1 |
isNew | Boolean | Read-only. When `true`, the entity is created in the current transaction. Otherwise, `false`. Available since 2018.2.42351 |
name | String | Read-only. The name of the agile board. |
sprints | Set.<Sprint> | Read-only. The set of sprints that are associated with the board. |
Methods
findByExtensionProperties
Searches Agile by the extension properties query.
Available since 2024.3.43260
Parameters
Name | Type | Description |
---|---|---|
extensionPropertiesQuery | Object | The extension properties query. |
Return Value
Type | Description |
---|---|
Set.<Agile> | The set of Agile entities found by the extension properties query. |
Example
findByName
Returns a set of agile boards that have the specified name.
Parameters
Name | Type | Description |
---|---|---|
name | String | The name of an agile board. |
Return Value
Type | Description |
---|---|
Set.<Agile> | A set of agile boards that are assigned the specified name. |
addIssue
Adds the issue to the current sprint of the board.
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue that is added to the board. |
becomes
Checks whether a field is set to an expected value in the current transaction.
Parameters
Name | Type | Description |
---|---|---|
fieldName | string | The name of the field to check. |
expected | string | The expected value. |
Return Value
Type | Description |
---|---|
boolean | If the field is set to the expected value, returns `true`. |
canBeReadBy
Checks whether a user has permission to read the field.
Parameters
Name | Type | Description |
---|---|---|
fieldName | string | The name of the field. |
user | User | The user for whom the permission to read the field is checked. |
Return Value
Type | Description |
---|---|
boolean | If the user can read the field, returns `true`. |
canBeWrittenBy
Checks whether a user has permission to update the field.
Parameters
Name | Type | Description |
---|---|---|
fieldName | string | The name of the field. |
user | User | The user for whom the permission to update the field is checked. |
Return Value
Type | Description |
---|---|
boolean | If the user can update the field, returns `true`. |
containsIssue
Checks whether the issue belongs to the board.
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue for which the condition is checked. |
Return Value
Type | Description |
---|---|
Boolean | If the issue belongs to the board, returns ``true``. |
findSprintByName
Finds a specific sprint by name.
Parameters
Name | Type | Description |
---|---|---|
name | String | The name of the sprint. |
Return Value
Type | Description |
---|---|
Sprint | If a sprint with the specified name is found, the corresponding Sprint object is returned. Otherwise, the return value is null. |
getAddedSprints
Gets all sprints of this board where the issue is added during the current transaction.
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue for which added sprints are returned. |
Return Value
Type | Description |
---|---|
Set.<Sprint> | A set of sprints where the issue is added. |
getIssueSprints
Returns the sprints that an issue is assigned to on an agile board.
Available since 2018.1.39547
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue for which you want to get the sprints that it is assigned to. |
Return Value
Type | Description |
---|---|
Set.<Sprint> | The sprints that the issue is assigned to on the agile board. |
getRemovedSprints
Gets all sprints of this board from which the issue is removed during the current transaction.
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue for which removed sprints are returned. |
Return Value
Type | Description |
---|---|
Set.<Sprint> | A set of sprints from which the issue is removed. |
getSprints
Gets all sprints of this board where the issue belongs.
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue for which sprints are returned. |
Return Value
Type | Description |
---|---|
Set.<Sprint> | A set of sprints where the issue belongs. |
is
Checks whether a field is equal to an expected value.
Available since 2019.2.55603
Parameters
Name | Type | Description |
---|---|---|
fieldName | string | The name of the field to check. |
expected | string | The expected value. |
Return Value
Type | Description |
---|---|
boolean | If the field is equal to the expected value, returns `true`. |
isAdded
Checks whether the issue gets added to the board in the current transaction.
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue for which the condition is checked. |
Return Value
Type | Description |
---|---|
Boolean | If the issue gets added to the board, returns ``true``. |
isChanged
Checks whether the value of a field is changed in the current transaction.
Parameters
Name | Type | Description |
---|---|---|
fieldName | string | The name of the field to check. |
Return Value
Type | Description |
---|---|
boolean | If the value of the field is changed in the current transaction, returns `true`. |
isRemoved
Checks whether the issue gets removed from the board in the current transaction.
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue for which the condition is checked. |
Return Value
Type | Description |
---|---|
Boolean | If the issue gets removed from the board, returns ``true``. |
oldValue
Returns the previous value of a single-value field before an update was applied. If the field is not changed in the transaction, returns null.
Parameters
Name | Type | Description |
---|---|---|
fieldName | string | The name of the field. |
Return Value
Type | Description |
---|---|
Object | If the field is changed in the current transaction, the previous value of the field. Otherwise, null. |
removeIssue
Removes the issue from all sprints of this board where it belongs.
Parameters
Name | Type | Description |
---|---|---|
issue | Issue | The issue that is removed from the board. |
required
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 | string | The name of the field to check. |
message | string | The message that is displayed to the user that describes the field requirement. |
was
Checks whether a field was equal to an expected value prior to the current transaction.
Available since 2019.2.55603
Parameters
Name | Type | Description |
---|---|---|
fieldName | string | The name of the field to check. |
expected | string | The expected value. |
Return Value
Type | Description |
---|---|
boolean | If the field was equal to the expected value, returns `true`. |