IssueAttachment
Represents a file that is attached to an issue.
Extends PersistentFile.
Properties
Name | Type | Description | Read-only |
|---|---|---|---|
author | | The user who attached the file to the issue. |  |
becomesRemoved | | When `true`, the entity is removed in the current transaction. Otherwise, `false`. Available since 2017.4.37915 | |
created | | The date and time when the attachment was created as a timestamp. | |
extension | | The extension that defines the file type. | |
isNew | | When `true`, the entity is created in the current transaction. Otherwise, `false`. Available since 2018.2.42351 | |
isRemoved | | If the attachment is removed, this property is `true`. | |
issue | | The issue that the file is attached to. | |
metaData | | The dimentions of an image file. For an image file, the value is `rw=&rh=`, for a non-image file the value is `empty`. | |
name | | The name of the file. | |
permittedGroup | | The group for which the attachment is visible when the visibility is restricted to a single group. | |
permittedGroups | | The groups for which the issue is visible when the visibility is restricted to multiple groups. | |
permittedUsers | | The list of users for whom the attachment is visible. | |
size | | The size of the attached file in bytes. | |
updated | | The date and time the attachment was last updated as a timestamp. | |
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. |
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`. |
delete
delete()Permanently deletes the attachment.
Available since 2018.1.40030
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, returns null.
Parameters
Name | Type | Description |
|---|---|---|
fieldName | | The name of the field. |
Return Value
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. |