YouTrack Standalone 2017.2 Help

UserGroup

Extends: BaseEntity

Represents a group of users.

Properties

Name

Type

Description

Read-only

static allUsersGroup

UserGroup

The All Users group.

checkbox marked

static fieldType

String

Field type. Used when defining rule requirements.

checkbox marked

becomesRemoved

Boolean

When `true`, the entity is removed in the current transaction. Otherwise, `false`.

checkbox marked

description

String

The description of the group.

checkbox marked

isAllUsersGroup

Boolean

If the group is the All Users group, this property is `true`.

checkbox marked

isAutoJoin

Boolean

If the auto-join option is enabled for the group, this property is `true`.

checkbox marked

isNew

Boolean

When `true`, the entity is created in the current transaction. Otherwise, `false`.

checkbox marked

name

String

The name of the group.

checkbox marked

users

Set.<User>

A list of users who are members of the group.

checkbox marked

Methods

 

findByName

static findByName(name)

Finds a group by name.

Parameters:

Name

Type

Description

name

String

The name of the group to search for.

Returns:

Type

Description

UserGroup

The specified user group, or null when a group with the specified name is not found.

 

becomes

becomes(fieldName, expected)

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.

Returns:

Type

Description

boolean

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

string

The name of the field.

user

User

The user for whom the permission to read the field is checked.

Returns:

Type

Description

boolean

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

string

The name of the field.

user

User

The user for whom the permission to update the field is checked.

Returns:

Type

Description

boolean

If the user can update the field, returns `true`.

 

isChanged

isChanged(fieldName)

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.

Returns:

Type

Description

boolean

If the value of the field is changed in the current transaction, returns `true`.

 

notifyAllUsers

notifyAllUsers(subject, body)

Sends an email notification to all of the users who are members of the group.

issue.oldValue('permittedGroup').notifyAllUsers('Visibility has been changed', 'The visibility group for the issue ' + issue.getId() + ' has been changed to ' + permittedGroup.name);

Parameters:

Name

Type

Description

subject

String

The subject line of the email notification.

body

String

The message text of the email notification.

 

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

string

The name of the field.

Returns:

Type

Description

Object

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

string

The name of the field to check.

message

string

The message that is displayed to the user that describes the field requirement.

 

Last modified: 7 March 2019