Jira アクション

以下の Jira アクションを使用して、レシピ内のワークフローを実行できます。

要件

リンクしている Jira アカウントには、各アクションの個々のリソースに対する十分な権限が必要です。詳細については、Jira プロジェクトの権限に関するドキュメントを参照してください。

Create issue (課題の作成)

このアクションを使用すると、指定したプロジェクト、課題タイプ、フィールド値に基づいて Jira で課題が作成されます。

Create issueCreate issue アクション

入力項目

入力項目説明
Project issue type 課題のプロジェクトと課題タイプ。
Sample project issue type Jira フィールド設定スキームによる定義に従って、指定したプロジェクト課題タイプに関連付けられたカスタムフィールドを取得するために使用されます。
標準フィールドSummary課題の概要。
Reporter課題の報告者。
Description課題の説明。
Issue priority課題の優先度。
カスタムフィールド各種のフィールドユーザーの Jira フィールド設定によって定義されたカスタムフィールド。

Project issue type

Project issue type (プロジェクト課題タイプ) を選択すると、データピルを割り当てるために、対応する課題タイプのフィールド (Jira 課題タイプスキームによって指定されているもの) が自動的に取得されます。

プロジェクト課題タイプのピックリストピックリストを使用したプロジェクト課題タイプの指定

プロジェクト Key と課題タイプ Name のデータピルを2つのハイフン「--」で区切って使用して (たとえば、Key--Name)、プロジェクト課題タイプを動的に生成することもできます。これは特に、さまざまなプロジェクトと課題タイプの範囲から課題を動的に作成する場合に便利です。

動的なプロジェクト課題タイププロジェクトキーと課題タイプ名を使用した動的なプロジェクト課題タイプの作成

プロジェクト Key と課題タイプ Name のデータピルを使用して課題を動的に作成または更新する場合は、Workato が設計時に課題の入力項目を生成できなくなります。これは、Jira からどのフィールドを取得するか設計時にはまだわからないからです。このような場合は、Sample project issue type (サンプルプロジェクト課題タイプ) を使用して入力項目を生成する必要があります。

Sample project issue type

Sample project issue type (サンプルプロジェクト課題タイプ) は一般に、複数のプロジェクトと課題タイプの範囲全体にわたって課題を動的に作成する場合に使用されます。

課題が持つフィールドはプロジェクトごとに異なります。そこで利用できるのが、さまざまなプロジェクトと課題タイプで使われ得る課題フィールドすべてを含んだサンプルプロジェクト課題タイプ (Jira で定義されたもの) です。

ここでサンプルプロジェクト課題タイプを指定すると、そのタイプに関係するすべてのフィールドが取り込まれ、レシピに表示されます。これにより、新しく作成される課題にデータピルをマッピングできるようになります。

この方法を使用すれば、さまざまなプロジェクトと課題タイプの範囲から動的に作成される課題すべてに対応するデータピルのマッピングが可能です。

サンプルプロジェクト課題タイプサンプルプロジェクト課題タイプを使用して、さまざまな課題タイプとプロジェクトに対応したフィールドを取得する

Summary

作成される課題の概要。デフォルトでは、このフィールドは必須です (Jira フィールド設定で任意項目として定義されない限り)。

Reporter

この課題を報告しているユーザー。報告者の Jira ユーザー名を使用します。たとえば、報告者のメールアドレスが johndoe@workato.com なら johndoe を使用します。

Description

課題の説明。

Issue priority

課題の優先度。Jira アカウントから有効な課題の優先度の値が取得されます。

Issue priorityIssue priority

出力項目

出力項目説明
ID 作成された課題の ID。
Key 更新された課題のキー。
self 更新された課題の完全な表現にアクセスするための self リンク。

トラブルシューティング

プロジェクト課題タイプが見つからない

探しているプロジェクト課題タイプが見つからない場合は、リンクしている Jira アカウントが、プロジェクトや課題/課題タイプを表示するための十分な権限を持っていない可能性があります。

Jira ワークスペースの Jira 管理者であれば、Jira の権限ヘルパーを使用して、リンクしている Jira アカウントの権限を確認してください。

詳細については、Jira の権限に関するドキュメントを参照するか、Jira の権限ヘルパーに関するガイドをご覧ください。Jira 管理者でない場合は、Jira 管理者に相談して支援を受けてください。

フィールド/カスタムフィールドが見つからない

探しているフィールドが見つからない場合は、以下のことが考えられます。

  1. リンクしている Jira アカウントが、そのフィールドを表示するための十分な権限を持っていない可能性があります。詳細については、Jira の権限に関するドキュメントを参照するか、Jira の権限ヘルパーに関するガイドをご覧ください。Jira 管理者でない場合は、Jira 管理者に相談して支援を受けてください。

  2. カスタムフィールドのフィールド設定が、プロジェクトで使用されている課題タイプと正しく関連付けられていない可能性があります。Jira 管理者であれば、フィールド設定を調べて正しい課題タイプに関連付けられていることを確認し、さらに課題タイプスキームが正しいプロジェクトに関連付けられていることを確認してください。Jira 管理者でない場合は、Jira 管理者に相談して支援を受けてください。

Get issue (課題の取得)

このアクションを使用すると、課題 ID またはキーを使用して1つの課題を取得できます。

入力項目

入力項目説明
Issue ID or key 取得する課題の課題 ID またはキー。

出力項目

出力項目説明
ID 課題の ID。
self 課題の完全な表現にアクセスするための self リンク。
Key 課題のキー。
フィールド 課題の展開されたフィールド。Workato はすべてのパラメータを自動的に取得および展開します。

詳細については、リソース展開に関する Jira Cloud REST API のドキュメントをご覧ください。

Search issues (課題の検索)

このアクションにより、課題フィールドに指定した値と完全に一致する1つ以上の課題を取得できます。

注 : 指定する課題フィールドの値は AND フィルターになります。つまり、すべてのフィールド値と一致する課題のみが返されます。部分一致は返されません。

Search issuesSearch issues アクション

入力項目説明
Issue ID 完全一致で検索する課題 ID。
Issue key 完全一致で検索する課題キー。
Summary 完全一致で検索する要約。
Priority 完全一致で検索する優先度。
Status 完全一致で検索するステータス。
Resolution 完全一致で検索する解決策 (該当する場合)。
Assignee 完全一致で検索する担当者の名前またはメールアドレス (該当する場合)。
Project 完全一致で検索するプロジェクト ID、キー、または名前。
Epic link 完全一致で検索するリンクされたエピックのキーまたは名前。
Labels 検索するラベルのコンマ区切りリスト。

出力項目

このアクションの出力は、課題のリストです。

出力項目説明
ID 課題の ID。
self 課題の完全な表現にアクセスするための self リンク。
Key 課題のキー。
フィールド 課題の展開されたフィールド。Workato はすべてのパラメータを自動的に取得および展開します。

詳細については、リソース展開に関する Jira Cloud REST API のドキュメントをご覧ください。
List size 取得した課題の数。

Update issue (課題の更新)

このアクションは、課題 ID またはキーを使用して1つの課題を更新します。ユーザーは サンプルプロジェクト課題タイプ を使用して、プロジェクトと課題タイプに関連付けられたカスタムフィールドを取得する必要もあります。

Update issue アクションUpdate issue アクション

入力項目

入力項目説明
Issue ID or key 更新する課題の正確な課題 ID またはキー。
Sample project issue type Jira フィールド設定スキームによる定義に従って、指定したプロジェクト課題タイプに関連付けられたカスタムフィールドを取得するために使用されます。
Description 更新する課題の説明。
Issue priority 更新する課題の優先度。
各種フィールドSample project issue type の選択後に取得される、課題の残りのフィールド。

出力項目

出力項目はありません。

課題スキーマを取得する

Jiraオブジェクトのすべてのフィールドの名前とスキーマを取得します。このアクションを使用して、スキーマをデータベースやデータウェアハウスに複製します。

入力フィールド

入力フィールド説明
出力フィールドJiraから取得するフィールドを選択するか、手動で指定することによって、Jiraから取得するフィールドを決定します。
フィールドを選択をクリックすると、Jiraチケットの利用可能なすべてのフィールドのドロップダウンが生成されます。すべて選択をクリックしてすべてのフィールドを含めるか、指定した特定のフィールドのみを含めることができます。
フィールドを入力を選択した場合、レシピで使用するフィールドのIDのカンマ区切りリストを指定する必要があります。例えば、parent,lastViewedです。

出力フィールド

このアクションの出力は、Jiraの問題のスキーマを詳細に記述したJSONオブジェクトです。このオブジェクトには、オブジェクトのフィールドを記述するフィールドオブジェクトのリストが含まれています。

オブジェクトスキーマ

出力フィールド説明
名前オブジェクトの名前、例: issue
ラベルオブジェクトの表示ラベル、例: issue

フィールドスキーマ

取得したすべてのオブジェクトには、以下のフィールドが含まれています:

出力フィールド説明
フィールド名フィールドの名前、例: issue
フィールドラベルオブジェクトの表示ラベル、例: issue
オリジナルタイプJiraのフィールドのデータタイプ。
マップされたタイプオリジナルタイプがWorkatoでマップされるデータタイプ。このタイプは、データがデータベースにロードされる際の列のデータタイプを決定するために使用されます。詳細を見る
オーダラブルブール値。trueの場合、このフィールドはオーダラブルです。
ナビゲーション可能ブール値。trueの場合、このフィールドはナビゲーション可能です。
検索可能ブール値。trueの場合、このフィールドは検索可能です。
カスタムフィールドブール値。trueの場合、このフィールドはユーザーによって作成されました。

Search assignable users (割り当て可能なユーザーの検索)

このアクションは、指定した課題に割り当てることができるユーザーすべてのリストを取得します。ユーザーのログインユーザー名を指定することで、このリストを単一のユーザーに絞り込むことができます。

Search assignable usersSearch assignable users アクション

入力項目

入力項目説明
Project ID or key プロジェクトの正確なプロジェクト ID またはキー。
Issue ID or key 更新する課題の正確な課題 ID またはキー。
Username 割り当て可能なユーザーのリストを単一のユーザーに絞り込みます。割り当て可能なユーザーすべてを取得する場合は、このフィールドを空白にします。

出力項目

このアクションの出力は、指定した課題に割り当てることができるユーザーすべてのリストです。

出力項目説明
Groupsユーザーが属するグループ。
Application rolesユーザーが属するアプリケーションロール。
Self URL 割り当て可能なユーザーの完全な表現にアクセスするための self リンク。
Key 割り当て可能なユーザーのキー。
Name 割り当て可能なユーザーのログインユーザー名。
Email address 割り当て可能なユーザーのメールアドレス。
Avatar URLs 割り当て可能なユーザーのアバター画像の URL。
Display name割り当て可能なユーザーの表示名。
Active ブール値。
割り当て可能なユーザーのアカウントがアクティブなら true
割り当て可能なユーザーのアカウントが非アクティブなら false です。デフォルトは true です。
Time zone割り当て可能なユーザーのタイムゾーン設定。
List sizeこの課題に対する割り当て可能なユーザーの数。

Assign user to issue (課題へのユーザーの割り当て)

このアクションは、ユーザーの Jira ユーザー名を使用して課題を割り当てます (たとえば、メールアドレスが johndoe@workato.com なら johndoe を使用する)。また、既存の担当者は置き換えられます。

Assign user to issue アクションAssign user to issue アクション

入力項目

入力項目説明
Issue ID or key 割り当てる課題の課題 ID またはキー。
Assignee username課題が割り当てられるユーザーのユーザー名。

出力項目

出力項目はありません。

Download attachment (添付ファイルのダウンロード)

このアクションにより、後続のアクションに使用する添付ファイルを課題からダウンロードできます。

Download attachmentDownload attachment アクション

このアクションは、Jira やその他のチケット管理アプリケーション (たとえば、ServiceNow、Freshdesk など) で、スクリーンショット (チケットに添付されているもの) を同期する際に非常に有用です。たとえば、ユーザーやカスタマーサクセス担当者が Jira の課題にスクリーンショットを添付している場合に、その添付ファイルをダウンロードして、対応する開発タスク (Jira や Github) に再びアップロードできます。

入力項目

入力項目説明
Attachment URI 添付ファイルをサポートするオブジェクトのステップ出力から取得可能な、ファイルのコンテンツを含むデータピル。たとえば、Get issue アクションからの Content データピル。

出力項目

出力項目説明
Attachment content 添付ファイルのコンテンツ。
Size 添付ファイルのサイズ (バイト単位)。

Upload attachment (添付ファイルのアップロード)

このアクションにより、既存の課題に添付ファイルをアップロードできます。

Upload attachment アクションUpload attachment アクション

入力項目

入力項目説明
Issue ID or key 添付ファイルをアップロードする課題の課題 ID またはキー。
File content 課題にアップロードするファイルのコンテンツ。
File name アップロードする添付ファイルのファイル名。

Issue ID or Key

添付ファイルをアップロードする課題の課題 ID またはキーを入力します。

File content

このフィールドを使用して、添付ファイルをサポートするオブジェクトのステップ出力から取得できる、添付ファイルのコンテンツをアップロードできます (たとえば、先行する Download attachment アクションの出力からの Attachment content データピル)。

File content の例File content の例

ファイルのテキストコンテンツを入力した後に (後続の File name フィールドで) .txt.csv といったファイル拡張子を使用することで、.txt ファイルや .csv ファイルをアップロードすることもできます。

File content にテキストを入力する例File content にテキストを入力する例

出力項目

出力項目説明
self アップロードされた添付ファイルの完全な表現にアクセスするための self リンク。
IDアップロードされた添付ファイルの添付ファイル ID
Filenameアップロードされた添付ファイルの添付ファイル ID
Authorself 添付ファイル作成者の完全な表現にアクセスするための self リンク。
Name添付ファイル作成者の名前。
Key添付ファイル作成者のキー。
Account ID添付ファイル作成者の Atlassian アカウント ID。
Email address添付ファイル作成者のメールアドレス。
Avatar URLs添付ファイル作成者のアバター画像の URL。
Display Name添付ファイル作成者の表示名。
Active ブール値。
添付ファイル作成者のアカウントがアクティブなら true
添付ファイル作成者のアカウントが非アクティブなら false です。
Timezone添付ファイル作成者のタイムゾーン設定。
Created添付ファイルがアップロードされた日付/時刻。
Size添付ファイルのサイズ (バイト単位)。
MIME Type添付ファイルの種類とフォーマット。
Content添付ファイル自体へのリンク。添付ファイルをサポートする、後続のアクションステップで使用できます (たとえば、Download attachment アクションAttachment URI フィールド)。
List size課題の添付ファイルの数。

Create comment (コメントの作成)

このアクションは、既存の課題に対するコメントを作成します。

Create commentCreate comment アクション

入力項目

入力項目説明
Issue ID or key コメントを追加する課題の課題 ID またはキー。
Comment text追加するコメントのコンテンツ。
VisibilityRoleコメントの可視性を制限する場合に、コメントを見られるようにするロールの名前。

出力項目

出力項目説明
self 新規コメントの完全な表現にアクセスするための self リンク。
ID 新規コメントの ID。
Author self コメント作成者の完全な表現にアクセスするための self リンク。
Name コメント作成者の名前。
Keyコメント作成者のキー。
Account IDコメント作成者の Atlassian アカウント ID。
Email addressコメント作成者のメールアドレス。
Avatar URLsコメント作成者のアバター画像の URL。
Display nameコメント作成者の表示名。
Activeブール値。
コメント作成者のアカウントがアクティブなら true
コメント作成者のアカウントが非アクティブなら false です。
Timezoneコメント作成者のタイムゾーン設定。
Body新規コメントの本文。
Update author self 更新作成者の完全な表現にアクセスするための self リンク。
Name 更新作成者の名前。
Key更新作成者のキー。
Account ID更新作成者の Atlassian アカウント ID。
Email address更新作成者のメールアドレス。
Avatar URLs更新作成者のアバター画像の URL。
Display name更新作成者の表示名。
Activeブール値。
更新作成者のアカウントがアクティブなら true
更新作成者のアカウントが非アクティブなら false です。
Timezone更新作成者のタイムゾーン設定。
Created コメントが作成された日付/時刻。
Updated コメントが更新された日付/時刻。
Visibilitytype コメントを閲覧するために付与される可視性のタイプ (たとえば、role)。
Value 可視性の値 (たとえば、administrators)。

Get issue comments (課題のコメントの取得)

このアクションは、既存の課題に付けられたコメントのリストを取得します。

入力項目

入力項目説明
Issue ID or keyコメントを取得する対象の課題の課題 ID またはキー。

出力項目

このアクションの出力は、指定した課題に付けられたコメントのリストです。

出力項目説明
self コメントの完全な表現にアクセスするための self リンク。
ID コメントの ID。
Author self コメント作成者の完全な表現にアクセスするための self リンク。
Name コメント作成者の名前。
Keyコメント作成者のキー。
Account IDコメント作成者の Atlassian アカウント ID。
Email addressコメント作成者のメールアドレス。
Avatar URLsコメント作成者のアバター画像の URL。
Display nameコメント作成者の表示名。
Activeブール値。
コメント作成者のアカウントがアクティブなら true
コメント作成者のアカウントが非アクティブなら false です。
Timezoneコメント作成者のタイムゾーン設定。
Body新規コメントの本文。
Update author self 更新作成者の完全な表現にアクセスするための self リンク。
Name 更新作成者の名前。
Key更新作成者のキー。
Account ID更新作成者の Atlassian アカウント ID。
Email address更新作成者のメールアドレス。
Avatar URLs更新作成者のアバター画像の URL。
Display name更新作成者の表示名。
Activeブール値。
更新作成者のアカウントがアクティブなら true
更新作成者のアカウントが非アクティブなら false です。
Timezone更新作成者のタイムゾーン設定。
Created コメントが作成された日付/時刻。
Updated コメントが更新された日付/時刻。
Visibilitytype コメントを閲覧するために付与される可視性のタイプ (たとえば、role)。
Value 可視性の値 (たとえば、administrators)。
List size課題に付けられたコメントの数。

Update comment (コメントの更新)

このアクションは、既存の課題のコメントを更新します。

Update commentUpdate comment アクション

入力項目

入力項目説明
Issue ID or key 更新するコメントが付けられている課題の課題 ID またはキー。
Comment textコメントを更新する内容。
VisibilityRole更新されたコメントの可視性を制限する場合に、コメントを見られるようにするロールの名前。

出力項目

出力項目説明
self 更新されたコメントの完全な表現にアクセスするための self リンク。
ID 更新されたコメントの ID。
Author self コメント作成者の完全な表現にアクセスするための self リンク。
Name コメント作成者の名前。
Keyコメント作成者のキー。
Account IDコメント作成者の Atlassian アカウント ID。
Email addressコメント作成者のメールアドレス。
Avatar URLsコメント作成者のアバター画像の URL。
Display nameコメント作成者の表示名。
Activeブール値。
コメント作成者のアカウントがアクティブなら true
コメント作成者のアカウントが非アクティブなら false です。
Timezoneコメント作成者のタイムゾーン設定。
Body新規コメントの本文。
Update author self 更新作成者の完全な表現にアクセスするための self リンク。
Name 更新作成者の名前。
Key更新作成者のキー。
Account ID更新作成者の Atlassian アカウント ID。
Email address更新作成者のメールアドレス。
Avatar URLs更新作成者のアバター画像の URL。
Display name更新作成者の表示名。
Activeブール値。
更新作成者のアカウントがアクティブなら true
更新作成者のアカウントが非アクティブなら false です。
Timezone更新作成者のタイムゾーン設定。
Created コメントが作成された日付/時刻。
Updated コメントが更新された日付/時刻。
Visibilitytype コメントを閲覧するために付与される可視性のタイプ (たとえば、role)。
Value 可視性の値 (たとえば、administrators)。

Create user (ユーザーの作成)

このアクションは、Jira インスタンス内にユーザーを作成します。

警告 : このアクションを使用すると企業の Jira ライセンス数が増加し、毎月の Jira サブスクリプション料金に影響が及びます。

Create userCreate user アクション

入力項目

出力項目説明
Email 作成されるユーザーのメールアドレス。
Display name 作成されるユーザーの表示名。
Password 作成されるユーザーのパスワード。
Login username 通常はユーザーのメールアドレスの先頭部分です。たとえば、ユーザーのメールアドレスが johndoe@workato.com なら johndoe を使用します。

出力項目

出力項目説明
Self URL 新規に作成されたユーザーの完全な表現にアクセスするための self リンク。
Key 新規に作成されたユーザーのキー。
Name 新規に作成されたユーザーのログインユーザー名。
Email address 新規に作成されたユーザーのメールアドレス。
Avatar URLs 新規に作成されたユーザーのアバター画像の URL。
Display name新規に作成されたユーザーの表示名。
Active ブール値。
コメント作成者のアカウントがアクティブなら true
コメント作成者のアカウントが非アクティブなら false です。デフォルトは true です。
Time zone新規に作成されたユーザーのタイムゾーン設定。

トラブルシューティング

ユーザーを作成できない

ユーザーを作成できない場合は、リンクしている Jira アカウントが、ユーザーを作成するための十分な権限を持っていない可能性があります。

詳細については、Jira の権限に関するドキュメントを参照するか、Jira の権限ヘルパーに関するガイドをご覧ください。Jira 管理者でない場合は、Jira 管理者に相談して支援を受けてください。

Get user details (ユーザーの詳細の取得)

このアクションは、指定されたユーザー名と一致するユーザーレコードを取得します。そのユーザーが存在しない場合、アクションは失敗します。

Get user detailsGet user details アクション

入力項目

入力項目説明
Username 正確な Jira ユーザー名。たとえば、ユーザーのメールアドレスが johndoe@workato.com なら johndoe を使用します。

出力項目

出力項目説明
Groupsユーザーが属するグループ。
Application rolesユーザーが属するアプリケーションロール。
Self URL ユーザーの完全な表現にアクセスするための self リンク。
Key ユーザーのキー。
Name ユーザーのログインユーザー名。
Email address ユーザーのメールアドレス。
Avatar URLs ユーザーのアバター画像の URL。
Display nameユーザーの表示名。
Active ブール値。
ユーザーのアカウントがアクティブなら true
ユーザーのアカウントが非アクティブなら false です。デフォルトは true です。
Time zoneユーザーのタイムゾーン設定。
Localeユーザーのロケール。
Expandリクエストパラメータに含まれる展開されたリソース、すなわち (ユーザーが属する) groupsapplicationRoles

Last updated: