IssueWorkItem
Extends: BaseWorkItem
Represents a work item that has been added to an issue.
Properties
Name | Type | Description | Read-only |
|---|---|---|---|
author | | The user to whom the work is attributed in the work item. |  |
becomesRemoved | | When `true`, the entity is removed in the current transaction. Otherwise, `false`. | |
created | | The date when the work item was created. | |
creator | | The user who added the work item to the issue. | |
date | | The date and time that is assigned to the work item. Stored as a Unix timestamp in UTC. The time part is set to midnight for the current date. | |
description | | The work item description. | |
duration | | The duration of the work item in minutes.Writable since 2018.1.40800 | |
isNew | | When `true`, the entity is created in the current transaction. Otherwise, `false`. | |
isUsingMarkdown | | When `true`, the work item description is parsed as Markdown. When `false`, the work item description is parsed as YouTrack Wiki.Changing this value does not transform the markup from one syntax to another. | |
type | | The work item type. | |
updated | | The date when the work item was last updated. | |
Methods
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. |
Returns:
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. |
Returns:
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. |
Returns:
Type | Description |
|---|---|
| If the user can update the field, returns `true`. |
delete
delete()Permanently deletes the work item.
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. |
Returns:
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 changedin the transaction, returns null.
Parameters:
Name | Type | Description |
|---|---|---|
fieldName | | The name of the field. |
Returns:
Type | Description |
|---|---|
| If the field is changed in the current transaction, the previous value of the field.Otherwise, null. |
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. |