ワークフロープロパティ設定

Jira’s workflow properties let you set restrictions on certain steps or transitions of a workflow. Thus, the issue view can be modified depending on the issue status in the workflow.

In this document, you’ll learn about:

We don’t recommend using all of the available workflow properties because we can’t guarantee that some data and operations, like bulk operations, won’t be corrupted.

For details on how to set properties in a workflow, see Working with workflows.

Jira workflow properties

The following table lists workflow properties you can use in a transition or step of a workflow. Check the API documentation for more technical details: Jira API Documentation - JiraWorkflow constant values

The names of Jira’s workflow properties start with the prefix jira. If you have third-party apps installed on the instance, they might introduce custom properties. If a property doesn’t start with jira, this is a third-party property. To learn more about it, reference the app’s documentation.

名前説明Related
issues
参考

jira.field.
resolution.
exclude

Value: Resolution id

Allows you to add comma-separated resolution IDs to the transition properties where you don’t want to show particular resolutions.N/AN/A

jira.field.
resolution.
include

Value: Resolution id

Allows you to add comma-separated resolution IDs to the transition properties.JRA-16443N/A

jira.i18n.
submit

Value: I18n property key

The transition property that allows you to customize the name of a button on a screen.JRA-16443N/A

jira.i18n.
title

Value: I18n property key

The transition property that allows you to customize the description of a button on a screen. You can see this description when you hover over the button.JRA-6798N/A

jira.i18n.
description

Value: I18n property key

ワークフロー トランジションの説明をカスタマイズできるトランジション プロパティ。JRA-6798N/A

jira.issue.
editable

: truefalse

課題のフィールド編集とサブタスク作成を制限するステップ プロパティ。N/Aワークフローで作業する

jira.
permission
[.S].X.Y

  • 権限の対象ユーザー、
    グループ、
    またはプロジェクト ロール

  • すべてのユーザーを拒否する場合は
    denied

詳細

X は権限で、Y はターゲットです。

X は次のいずれかです。
browseedittransitionmoveassignableassignresolvedeletelinksetsecuritycomment
attachwork

Y には、denied を使用して
すべてのユーザーを拒否するか、
次のいずれかを使用します。groupuser
assigneereporter
leaduserCFgroupCFprojectrole

.S は、
subtasks を親課題のターゲット サブタスクに適用する場合の
オプションです。

数字を追加して、
同じ XY
倍数を指定できます。

権限を一部のユーザーまたは
すべてのユーザーに制限するステップ プロパティ。

  • テスト ユーザーに課題の編集を
    許可: jira.permission.
    edit.user=test-user

  • 次のグループからのコメントを許可 jupiter and mars: jira.permission.
    comment.group.
    1=jupiterjira.

    permission.
    comment.group.2=mars

  • 全員のファイル アタッチ権限を拒否:
    jira.permission.
    attach.denied=denied

  • カスタム フィールドで指定されたグループにのみ課題の割り当てを許可:
    jira.permission.
    assign.groupCF=
    customfield_
    11000

  • Jira 管理者のみに課題の編集を許可:
    jira.permission.
    edit.group=jira-administrators

JRA-6381

JRA-34621

JRA-35917

WorkflowBased
PermissionManager
クラスの説明 (API ドキュメント)

opsbar-
sequence

: 0 以上の整数値

[課題を表示] ページでの遷移を許可しますN/A高度なワークフロー設定 (トランジションのカスタマイズ)

ユースケース

ワークフロー プロパティの一部を適用できる仕組みのユース ケースをご確認ください。

プロパティユースケースユース ケースの値
jira.field.
resolution.
exclude

特定のステータスに対して特定の解決状況を無効にします。たとえば、あるステータスの重複した解決状況を利用できないようにするためです。

重要な注意事項

名前の代わりに解決状況の ID を使用する必要があります。解決方法 ID を見つける方法は次のとおりです。

  1. 画面右上で [管理] > [課題] の順に選択します。
  2. [課題の属性] で、[解決状況] を選択します。
  3. ID を取得する解決方法の横にある [編集] を選択します。
  4. ? の後にある URL に ID が表示されます。例: 完了の場合は id=10000 です。

除外する解決状況のカンマで区切られた ID のリスト。例: "10000,10001"

プロパティに複数の解決状況を追加する

そのためには、解決状況の ID のリストをカンマで区切って追加する必要があります。

たとえば、1000010001 の ID を含む解決状況を除外する場合は、値 "10000,10001" を設定する必要があります。

jira.field.
resolution.
include
特定のステータスに対して特定の解決状況を有効にします。たとえば、あるステータスの重複した解決状況を利用できるようにするためです。

含める解決状況のカンマで区切られた ID のリスト。例: "10000,10001"

プロパティに複数の解決状況を追加するには、上記の手順をご確認ください。

jira.issue.
editable

課題が特定のステータスにある場合、その課題を編集可能にします。初期設定では、このプロパティが設定されていない場合、課題は常に編集可能です。

true
課題に特定のステータスが付いている場合に編集を無効にします。これは、課題がプロセスの最終段階にあり、完了などの最終ステータスが付いている場合に役立ちます。false
jira.
permission
[.S].X.

このプロパティは次の形式で使用します。jira.permission.
[subtasks.]{permission}.
{user}.{suffix}

重要な注意事項

これらのワークフロー権限は、権限スキームで設定された権限をローカルに制限する場合にのみ使用し、権限を付与する目的では使用しないでください。

たとえば、権限スキームで、コメントの追加権限が 1 つのプロジェクト ロール (開発者など) にのみ付与されている場合、ワークフロー プロパティを使用してこの権限を他のロール (マネージャーなど) に付与することはできません。

マネージャー ロールが権限スキームから除外されている場合、このロールをワークフロー プロパティに追加しても機能しません。

  • subtasks はオプションです。この部分を追加すると、権限は課題のサブタスクに適用されます。追加しない場合、権限は課題自体に適用されます。

  • permission は、権限クラスで指定された短い名前です。

  • user は、付与または拒否された権限の種類です。

  • suffix はオプションです。同じタイプを複数回追加した場合に、プロパティを一意にするために使用します。
    例: jira.permission.edit.
    group.1
    jira.permission.edit.
    group.2
権限で使用できる値

admin, use, sysadmin,
project, browse, create,
edit, scheduleissue, assign, assignable, attach, resolve,
close, comment, delete, work, worklogdeleteall, worklogdeleteown,
worklogeditall,
worklogeditown, link,
sharefilters,
groupsubscriptions, move, setsecurity, pickusers, 
viewversioncontrol,
modifyreporter, viewvotersandwatchers, managewatcherlist,
bulkchange, commenteditall, commenteditown,
commentdeleteall, 
commentdeleteown,
attachdeleteall, attachdeleteown, 
viewworkflowreadonly

ユーザーで使用できる値

group, user, assignee, reporter, lead, userCF, projectrole

jira.
permission.*
.denied

jira.permission.
edit.denied は、
課題に特定のステータスが付いている場合に、
管理者を含むすべてのユーザーの課題編集を
無効にします。

空であることが必須です。
jira.permission.
work.denied
は、
課題に特定のステータスが付いている場合に、
作業ログを無効にします。
これはエピックのステータスを追加するのに
役立ちます。
空であることが必須です。

jira.permission.
attach.denied
disables
new attachments for issues in
a particular status. For example,
if you want users to add
attachments only when the
the issue has the status
In
Progress
, add this property to every status except In
Progress
.

You can set this property for all workflow statuses but allow only particular users to create attachments by giving them the Create attachment permission. This provides protection against anonymous users or attackers attaching large files to the system, which may bring Jira down after the disk space runs out.

空であることが必須です。

jira.permission.
comment.denied
は、
課題が特定のステータスの場合にコメントを無効にします。
たとえば、課題が解決した後は
ユーザーにコメントさせたくない場合、
このプロパティを解決状況ステータスに追加できます。

コメントを完全に無効にすると、
トランジション画面では表示できなくなります。

空であることが必須です。

ワークフロー プロパティの設定

ワークフロー ステップまたはトランジション プロパティを追加する方法は次のとおりです。

  1. [管理] > [課題] の順に移動します。

  2. 左側のパネルで [ワークフロー] を選択します。

  3. プロパティを設定するワークフローの場合は [編集] を選択します。

  4. プロパティを追加するステータスまたはトランジションを選択します。

  5. メニューで [プロパティ] を選択します。

  6. プロパティのキーと値を入力するページが表示されます。

  7. [追加] を選択します。



Last modified on Mar 2, 2023

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.