Jelly Tags

ampersand (&)

apostrophe or single quote (')

double quote (")

less than (<)

greater than (>)

projectroleid

int

This is the id of the project role.

actors

string

A comma delimited list of either users or groups

actortype

string

This defines the type 'actor' you are sending to the tag. Currently this field can contain either 'atlassian-user-role-actor' for users, or 'atlassian-group-role-actor' for groups.

projectroleid

int

This is the id of the project role.

actors

string

This a comma delimited list of either user names or group names

actortype

string

This defines the 'actor' type. Currently this field can contain either 'atlassian-user-role-actor' for users, or 'atlassian-group-role-actor' for groups.

projectkey

string

This is the key of the project you wish to add users or groups to for the specified role.

issue-key

string

The issue to add the comment to (required).

commenter

string

Currently logged in user

Username of the user to make the comment (Must have browse and comment permissions).

comment

string

Comment to be added to the issue (required).

groupLevel

string

none

Name of group that can see this comment. NOTE: If this is specified you can not specify the roleLevel parameter.

roleLevel

string

none

Name or Id of Project Role that can see this comment. NOTE: If this is specified you can not specify the groupLevel parameter.

created

string

Current Date/Time

Date/Time the Comment was created in format yyyy-MM-dd hh:mm:ss.0

updated

string

Current Date/Time

Date/Time the Comment was last updated in format yyyy-MM-dd hh:mm:ss.0. This can be used if you are trying to import a comment with specific pre-existing values.

editedBy

string

Currently logged in user

Username of the user who last updated the comment. This can be used if you are trying to import a comment with specific pre-existing values.

tweakIssueUpdateDate

boolean

true

If an updated date is provided, the issue's updated date will be updated with that value. If the tweakIssueUpdateDate parameter is set to false, the issue's updated timestamp will be left untouched.

project-key

string

The key of the project you want to add the component to (not required if nested inside atag).

name

string

Name of the component (required).

description

string

Description of the component.

componentLead

string

The username of the Component's lead. Leave blank for no lead.

ffldId

string

Field ID of the field to add (required). e.g. "description", "duedate", etc.

screen

string

Screen ID or Name (required). e.g. "1" or "Default Screen".

tab

string

0

Tab ID or Name. e.g. "0" or "Field Tab".

fieldPosition

int

last position

Position to insert the field into. Range of values is from 1 to the number of fields on the screen.

schemeId

string

If not nested in a CreatePermissionScheme tag, specifies the scheme Id to add the permission to (0 is the default permission scheme).

permissions

required string

A comma-separated list of permissions to grant:
String — Permission

• Project — Administer projects
• Browse — Browse projects
• Create — Create issues
• Edit — Edit issues
• ScheduleIssue — Schedule issues
• Move — Move issues
• Assign — Assign issues
• Assignable — Assignable user
• Resolve — Resolve issues
• Close — Close issues
• ModifyReporter — Modify reporter
• Comment — Add comments
• CommentEditAll — Edit all comments
• CommentEditOwn — Edit own comments
• CommentDeleteAll — Delete all comments
• CommentDeleteOwn — Delete own comments
• Delete — Delete issues
• Work — Work on issues
• WorklogEditAll — Edit all worklogs
• WorklogEditOwn — Edit own worklogs
• WorklogDeleteOwn — Delete own worklogs
• WorklogDeleteAll — Delete all worklogs
• Link — Link issues
• Attach — Create attachments
• AttachDeleteAll — Delete all attachments
• AttachDeleteOwn — Delete own attachments
• ViewVersionControl — View version control
• ViewVotersAndWatchers — View voters and watchers
• ManageWatcherList — Manage watcher list
• SetSecurity — Set issue security level

type

string

Type of recipient for the permission:

• group
• projectrole
• user
• lead
• assignee
• reporter
• userCF
• groupCF

group

string

If type is 'group' (or type is unspecified), specifies the group name to grant permissions to.

projectroleid

int

If type is 'projectrole', specifies the id of the projectrole to grant permissions to.

user

string

If type is 'user', specifies the user name to grant permissions to.

userCF

string

If type is 'userCF', specifies the id of a User custom field, e.g. 'customfield_10000', identifying the user to be granted the permission.

groupCF

string

If type is 'groupCF', specifies the id of a group-selecting custom field (e.g. a select-list with group names as values) whose members should be granted this permission. E.g. 'customfield_10000'.

username

string

Username to add to Group (required if not in atag).

group-name

string

Group to add User to (required if not in atag). Note: if the group has the 'JIRA System Administrators' global permission, and the logged-in user does not, an error message will be displayed and the operation will not succeed.

project-key

string

The key of the project you want to add the component too (not required if nested inside atag).

name

string

Name of the version (required).

description

string

The description of the version.

releaseDate

string

The release date of the version.

schedule

string

Schedule of the version.

key

string

Key of the issue to assign.

assignee

string

User to assign issue to.

key

string

Key of the issue to attach the file to. (Required)

filepath

string

Path (on the server) of the file to attach. (Required)

option

string

add

Behavior when a file with same name is already attached. (Optional). The options are:

• skip — do not attach file if a file with this name is already attached.
• override — overwrite existing attached file
• add — add the file as another attachment

created

string

Current Date/Time

Date/Time the attachment was created, in format yyyy-MM-dd hh:mm:ss.0 (Optional)

fieldType

string

Field type as appears as the key in the plugin descriptor

fieldScope

string

One of global, project or issuetype

fieldName

string

Name of custom field

projectKey

string

Key of the related project. Only valid for scope "project"

issueType

string

Issue type. Only valid for scope "issuetype"

description

string

Description of the field to be displayed when adding a value

searcher

string

A valid related custom field searcher

customFieldIdVar

string

The name of the variable to place the new custom field.

group-name

string

Name of group to create (required).

jelly.group.name

string

Name of group being created.

project-key

string

Key of the project to add the issue to (required if not nested in atag).

issueType

string

First issue type

The string name of the Issue Type this issue should be created for (e.g. Bug).

summary

string

Summary of the issue being created (required).

priority

string

First priority

The string name of the Priority (e.g. Major).

components

string

The string name of the Component.

versions

string

The string name of the Affected Version.

fixVersions

string

The string name of the Fix For Version.

assignee

string

The username of the user to assign this issue to (logged in user requires the assign issue permission and user specified requires the assignable permission). Set to "-1" for Automatic assignment.

reporter

string

(see description)

The username of the user who is reporting this issue. The user is logged in and then the issue is created. The user is logged out again when the Create Issue tag closes.
If the logged in user does not have Modify Reporter privilege, then the default value of this attribute is the username of the logged in user. If, however, the logged in user does have Modify Reporter privilege, there is not a default value, and this attribute is mandatory. See JRA-12984 for further explanation.
(Broken? See JRA-5620.)

environment

string

Description of the environment.

description

string

Detailed description of the issue.

duedate

string

Due date of the issue. The format required is the current JIRA date format.
Note: As the default JIRA date format is locale-specific (e.g. 12/Jan/05), you may wish to use the yyyy-mm-dd ISO format instead. To do this, set the following properties on JIRA's 'Advanced Settings' page:

• jira.date.picker.java.format to value yyyy-MM-dd
• jira.date.picker.javascript.format to value %Y-%m-%e
  
  See Changing the Due Date Input Format for more information about changing these values.

created

string

Current Date/Time

Date/Time the Issue was created in format yyyy-MM-dd hh:mm:ss.0

updated

string

Current Date/Time

Date/Time the Issue was updated in format yyyy-MM-dd hh:mm:ss.0

issueIdVar

string

The name of the variable to place the ID of the new Issue.

issueKeyVar

string

The name of the variable to place the Key of the new Issue.

duplicateSummary

string

Setting this attribute to 'ignore' will allow Issue with the same summary to be created.

security-level

string

Sets the security level of an issue. Value is the name of a level, e.g. 'Secret'.

id

long

ID of the custom field with the customfield_ prefix

value

string

string representation of the custom field value. Note that this may be different to the displayed value (e.g. The project picker uses the project id as the String value but displays the project name)

key

string

Key is used for multi-dimensional data. Currently, only Cascading selects supports its use. Omit to specify the value of parent, use "1" as the value for child

name

String

deprecated Name of the custom field.

name

required string

Name of the permission scheme.

description

string

Permission scheme description.

jelly.permission.scheme.id

string

Id of the created permission scheme

key

string

The project key used to create Issue Keys (required).

name

string

The name of the project (required).

lead

string

The username of the user that is the project lead (required).

url

string

The URL of the site for this project.

description

string

The description of this project.

jelly.project.id

string

Id of the Project that was created.

jelly.project.key

string

Key of the Project that was created.

name

string

The name for the project role you will be creating

description

string

The description for the project role you will be creating

jelly.role.id

Long

The id of the project role

jelly.role.name

string

The name of the project role

jelly.role.description

string

The description of the project role

username

string

Username of the user being created (required).

password

string

User's password. If the password field is left blank, a random password will be auto-generated.

confirm

string

Confirmation of users password (required).

fullname

string

Descriptive name of the user (required).

email

string

Email address of the user (required).

sendEmail

boolean

false

If provided, specifies whether to send a confirmation email.

jelly.new.username

string

Username of the user being created.

projectroleid

int

The id of the project role you want to delete.

confirm

string

To delete the project role this value must be set to 'true'.

projectroleid

int

The id of the project role you want to query

var

string

The name of the variable you wish to have the returned role actors placed into

projectroleid

int

The id of the project role you want

var

string

The name of the variable you wish to have the project role assigned to

projectkey

string

The key of the project you want to query

projectroleid

int

The id of the project role you want to query

var

string

The name of the variable you want the returned 'role actors' object assigned to

name

string

The name of the project role

var

string

The name of the variable you want the returned result assigned to.

key

string

The key of the issue to link from (origin of link - required)

linkKey

string

The key of the issue to link to (destination of link - required)

linkDesc

string

linkDesc is taken from the 'Inward Description' or the 'Outward Description' of the link. (required)

username

string

Username of the user to log in.

password

string

Password of the user to log in.

jelly.user

User

User logged in.

jelly.username

string

Username of the User logged in.

projectroleid

int

The id of the project role you wish to remove default actors from

actors

string

A comma delimited list of users or groups you wish to remove from the default project role

actortype

string

The type of 'actor' you are removing. Currently the available options are 'atlassian-group-role-actor' or 'atlassian-user-role-actor'

projectroleid

int

The id of the project role you wish to remove members from

actors

string

A comma delimited list of users or groups you wish to remove from the project role

projectkey

string

The key of the project the project role is associated with

actortype

string

The type of 'actor' you are working with. Currently the available options are 'atlassian-group-role-actor' or 'atlassian-user-role-actor'

name

string

Username of the user to remove (required).

filterid

int

The id of the filter which will be used to run the search request.

size-var

string

The variable that will hold the number of issues returned from the search request.

var

string

The variable that will hold the issues returned from the search request.

project-key

string

The key of the project you want to add the component to (required).

componentName

string

Name of the component (required).

assigneeType

string

Default assignee type (required).
Assignee Types:

• projectDefault
• componentLead
• projectLead
• unassigned

user

string

Currently logged in user

Username of the user to execute the workflow transition. The user needs to have the adequate permissions to execute the transition. Please note that the permissions required also depend on the fields that are updated during the transition. (See other attributes below).

key

string

The key of the issue to execute the transition on.

workflowAction

string

The id or name of the workflow transition to execute. If the argument can be converted to a number it is assumed to be an id of the transition. Otherwise it is assumed to be a name.

resolution

string

The id or name of the resolution to set on the issue during the transition. Please note that the transition must expect the resolution to be updated, otherwise an error is generated if this attribute is supplied. If the argument can be converted to a number it is assumed to be an id of the resolution. Otherwise it is assumed to be a name.

assignee

string

The username of the user to assign an issue to during the transition. The "user" executing the transition must have permissions to assign issues if this attribute is supplied. Please note that the transition must expect the assignee to be updated, otherwise an error is generated if this attribute is supplied.
Use value "-automatic-" to let JIRA assign the issue to the default assignee.

fixVersions

string

A comma separated list of version ids or names to set as "fix for" versions during the transition. The "user" executing the transition must have permissions to set "fix for" versions if this attribute is supplied. Please note that the transition must expect the "fix for" versions to be updated, otherwise an error is generated if this attribute is supplied. If a value in the provided comma separated list can be converted to a number it is assumed to be an id of a version. Otherwise it is assumed to be a name.

comment

string

The comment to add to the issue during the transition. The "user" executing the transition must have permissions to add comments and the transition must be expecting comments to be added during its execution for the comment to be added successfully.

groupLevel

string

The level for the comment. The level must be a name of a group the user is a member of. NOTE: If this is specified you can not specify the roleLevel parameter.

roleLevel

string

Name or Id of Project Role that can see this comment. NOTE: If this is specified you can not specify the groupLevel parameter.

projectroleid

int

The id of the project role you want to query

name

string

The name you want the project role updated with

description

string

The description you want the project role updated with