Jira スポーク

ストアでアプリを要求する

ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

統合ハブサブスクリプション

このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - IntegrationHub の概要」を参照してください。

重要:

このスポークは、統合ハブ Professional サブスクリプションの一部として新規顧客が利用できます。既存の顧客は、このスポークを統合ハブ標準サブスクリプションの一部として利用できます。

スポークバージョン

Jira スポーク v 4.3.2 が最新バージョンです。

スポークの依存関係

アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。

ServiceNow IntegrationHub アクションテンプレート：データストリーム (com.glide.hub.action_type.datastream)
Complex Object (com.glide.cobject)
ServiceNow IntegrationHub アクションステップ - 接続情報の取得 (com.glide.hub.action_step.get_connection_info)
ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
ServiceNow IntegrationHub アクションステップ - REST (com.glide.hub.action_step.rest)
ServiceNow Flow Designer - 動的入力 (com.glide.hub.dynamic_inputs)
統合 - 外部認証フレームワーク (com.glide.external.app)

注:

これらのプラグインの一部はライセンス可能な機能であり、スポーク実装以外で使用する場合は適切なライセンスが必要です。ライセンスの詳細については、アカウントマネージャーにお問い合わせください。

サポートされているバージョン

このスポークは API version v2 用に構築されていますが、それ以降のバージョンと互換性がある可能性があります。

注:

Jira インスタンスが別の API バージョンをサポートしている場合は、属性関連リストの [API バージョン] で API バージョンを指定します。デフォルトでは、API バージョンは 2 です。接続レコードの作成については、「Jira スポークの接続の設定」を参照してください。
Jira Service Desk はスポークではサポートされていません。

Jira Webhook モジュール

双方向 Webhook をセットアップして、必須イベントに関する通知を受けることができます。ルーティングポリシーでは、 ServiceNow インスタンスに通知するために満たすべき条件が定義されます。これらの条件は、通知を希望するJiraのイベントに基づいています。条件が満たされると、ルーティングポリシーが関連するサブフローをトリガーし、Jira タスクを自動化します。

双方向 Webhook には別途セットアップが必要で、スポークアクションを使用しないで単独で使用できます。デフォルトでは、Jira Webhooks アプリケーションが Jira で利用可能で、次のモジュールがあります。

Jira Webhook レジストリ
Jira WebHook ルーティングポリシー

Jira Webhook レジストリモジュールを使用してトークンを割り当て、API パスを指定します。コールバック URL を生成し、URL を Jira アカウントに入力する必要があります。デフォルトのルーティングポリシーは、Jira WebHook ルーティングポリシーモジュールで提供されます。デフォルトのルーティングポリシーは、次のフィールドをサポートしています。


カテゴリ	フィールド
問題	Jira インスタンス URL Webhook イベント問題の説明作成日時更新日時問題の解決以前の問題の解決問題サマリー問題タイプ以前の問題タイプ問題の優先度以前の問題の優先度問題のステータス以前の問題ステータス問題ステータスカテゴリ以前の問題ステータスカテゴリプロジェクト
コメント	Jira インスタンス URL Webhook イベントコメント作成日時更新日時問題サマリー問題タイプ問題の優先度問題のステータス問題ステータスカテゴリプロジェクト
作業ログ	Jira インスタンス URL Webhook イベント作業ログの所要時間作成日時更新日時
添付ファイル	Jira インスタンス URL Webhook イベント作成日時添付ファイル名添付ファイルサイズ添付 MIME タイプ
プロジェクト	Jira インスタンス URL Webhook イベントプロジェクト
バージョン	Jira インスタンス URL Webhook イベントバージョンバージョン説明バージョンに結合バージョン説明に結合

ルーティングポリシーの他の条件を使用するには、Jira WebHook ルーティングポリシーモジュールにルーティングポリシーを作成し、要件に従って条件を指定します。Webhook の設定と構成の詳細については、双方向 Webhook を設定を参照してください。

スポークのサブフロー

Jiraでは、さまざまな JiraWebhook イベントを処理するためのサンプルサブフローが提供されます。利用可能なサンプルサブフローは、[Jira Webhook の処理] です。[Jira Webhook の処理] サブフローは、次のフィールドをサポートしています。


カテゴリ	フィールド
問題	ユーザー問題添付ファイル問題変更ログプロジェクト
コメント	問題プロジェクトコメント
作業ログ	作業ログ
添付ファイル	添付ファイル
プロジェクト	プロジェクト
バージョン	バージョン
Webhook イベント
タイムスタンプ
ペイロード注: これは Jira ペイロード全体です。

デフォルトのサブフローをカスタマイズするには、サンプルサブフローのコピーを作成し、ペイロードを解析して、要件に従ってサブフローをカスタマイズする必要があります。ペイロードは、サブフローへの入力の 1 つです。

サブフローをカスタマイズするときは、サブフローが無限ループを回避するように構成されていることを確認する必要があります。

注:

スポークサブフローを使用するように Webhook を設定する必要があります。Webhook の設定と構成の詳細については、双方向 Webhook を設定を参照してください。
デフォルトで、サンプルサブフローはユーザーとして実行されます。サブフローは、システムとして実行するように設定できます。

スポークのアクション

フローデザイナーでJira スポークのアクションを使用して、Now Platformでイベントが発生したときにJiraタスクを自動化します。使用可能なアクションは次のとおりです。

注:

このリリース以降の一部のスポークアクションに、接続エイリアスの入力はありません。
以前のバージョンのアクションを使用するインスタンス内の既存のフローは、引き続き機能します。ただし、こうした以前のアクションは、廃止されたサフィックスを追加すると名前が変更され、このバージョン以降は使用できなくなります。
一部のスポークアクションでは、エラー評価機能が提供されています。


カテゴリ	フィールド	説明
Audit Management	監査ログストリームを検索	Atlassian Jira ユーザーサブスクリプションのログインアクティビティを取得します。
グループ管理	グループにユーザーを追加	Jiraのグループに指定されたユーザーを追加します。
	グループを作成	Jiraにグループを作成します。
	グループストリームを検索	デフォルトグループを含む、Atlassian アカウント内のすべてのグループを取得します。注: このアクションは、クラウドサブスクリプションでのみ Jira 使用できます。
	グループ名ストリームでユーザーを検索	Atlassian グループ内のすべてのメンバーの詳細を取得します。
	グループを削除	指定されたグループをJiraから削除します。
	グループからユーザーを削除	Jiraのグループから指定されたユーザーを削除します。
問題管理	コメントを追加	Jiraで指定した問題にコメントを追加します。
	ウォッチャーを追加	指定された問題のウォッチャーとして、指定されたユーザーを追加します。
	問題を割り当て	Jiraの問題をユーザーに割り当てます。
	添付ファイルをコピー	ServiceNow レコードに関連付けられている必要な添付ファイルを、Jira の必要な問題にコピーします。
	問題を作成	Jiraに問題を作成します。組織がJiraをどのように使用しているかに応じて、ソフトウェアのバグ、プロジェクトタスク、ヘルプデスクチケットなど、様々な形で問題が現れます。Jiraの問題は、Now Platformのタスクを表します。
	問題を作成	最大 50 件の問題を一括で作成します。アクションによって作成される問題のタイプは、Jira セットアップによって異なります。
	添付ファイルを削除	Jiraの必要な添付ファイルを削除します。
	問題を削除	Jiraの問題を削除します。
	監視を削除	指定された問題のウォッチャーとして、ユーザーを削除します。
	移行を実行	Jiraの問題をある状態から別の状態に移行します。
	プロジェクトで問題タイプステータスを検索 (Look up Issue Type Statuses by Project)	プロジェクトのステータスの詳細を取得します。
	問題を検索	問題の詳細を取得します。
	問題の優先度を検索	問題の優先度のリストと個々の問題の優先度の詳細を取得します。
	問題ストリームを検索	Atlassian Jira の問題からユーザーアクティビティを取得します。
	Sprint 問題ストリームを検索	指定されたスプリントのすべての問題の詳細を取得します。
	移行を検索	指定された問題 ID のすべての移行に関する情報を取得します。
	ウォッチャーを検索	指定された問題のウォッチャーのリストを取得します。
	問題を更新	入力として渡された値でJiraの問題の一連のフィールドを更新します。
メタデータの取得	ボード (メタデータ) を取得 (Get Boards (Metadata))	Jiraのすべてのボードの詳細を取得します。
	作成可能なフィールド (メタデータ) を取得 (Get Creatable Fields (Metadata))	必要な Jira プロジェクトのすべてのフィールドのリストを取得します。
	編集可能なフィールド (メタデータ) を取得 (Get Editable Fields (Metadata))	必要なJira問題のすべての編集可能なフィールドのリストを取得します。
	問題タイプ (メタデータ) を取得 (Get Issue Types (Metadata))	必要なJiraプロジェクト内のすべての問題タイプのリストを取得します。
	プロジェクト (メタデータ) を取得 (Get Projects (Metadata))	すべての Jira プロジェクトのリストを取得します。
プロジェクト管理	プロジェクト作成	Jira でプロジェクトを作成します。
	プロジェクトを検索	ID またはキーで指定されたプロジェクトの詳細を取得します。
	プロジェクトを検索	すべてのプロジェクトの詳細を取得します。注: このアクションは Jira サーバーでのみ機能します。
	プロジェクトストリームを検索	すべてのプロジェクトの詳細を取得します。注: このアクションはクラウド Jira でのみ機能します。
	プロジェクトにアサイン可能なユーザーを検索	1 つ以上のプロジェクトの問題にアサインできるユーザーのリストを取得します。
スプリント管理	スプリントを作成	Jiraにスプリントを作成します。
	スプリントを削除	Jiraのスプリントを削除します。
	スプリントを検索 (Look up Sprint)	必要なスプリントの詳細を複合オブジェクトとして取得します。
	ボードでスプリントを検索 (Look up Sprints by Board)	必要なボードのすべてのスプリントの詳細を取得します。
	スプリントを更新	Jiraのスプリントの詳細を更新します。
ストーリー管理	ストーリーの作成	Jira Cloud インスタンスでストーリーを作成します。これは、ServiceNow Agile Development プラグインのストーリーに相当します。
	ストーリーストリームを検索	すべてのストーリーの詳細を取得します。
	ストーリーを更新	提供された入力値で Jira Cloud におけるストーリーの一定数のフィールドを更新します。
ユーザー管理	ユーザーを作成	Jira にユーザーを作成します。注: OAuth 2.0 認証を使用する場合、このアクションはサポートされません。
	認証ユーザーを検索	認証されたユーザーアカウントの詳細を取得します。
	ユーザーのグループメンバーシップを検索	Atlassian ユーザーのすべてのグループの詳細を取得します。
	ユーザーストリームを検索	すべての Atlassian Jira ユーザーサブスクリプションの詳細を取得します。注: このアクションは、クラウドサブスクリプションでのみ Jira 使用できます。
	名前でユーザーストリームを検索	検索文字列に一致するユーザーのリストを取得します。注: このアクションは、Jira サーバーサブスクリプションでのみ使用できます。
	ユーザーを削除	Jiraからユーザーを削除します。注: OAuth 2.0 認証を使用する場合、このアクションはサポートされません。
ユーティリティアクション	問題の添付ファイルをレコードにコピー	添付ファイルをJiraからServiceNowインスタンスの任意のレコードにコピーします。サブフローでこのアクションを使用する場合は、[添付ファイル URL] フィールドに [コンテンツ URL] データピルが指定されていることを確認してください。
	フィールドを検索	Jiraの必須フィールドラベルの内部名とその他の詳細を取得します。
	コメントから問題を検索	指定されたコメントのペイロードを解析して、問題の詳細を取得します。このアクションは、Jira 問題に関する詳細なしでコメント関連情報のみが指定されている場合に、Jira オンプレミスサーバーの [Jira Webhook の処理] サブフローで使用できます。たとえば、コメント情報のみが指定されている場合、このアクションはペイロードを解析し、問題の詳細を抽出します。
	問題に関する最新の添付ファイルを検索	指定された問題の最新の添付ファイルを Jira から取得します。このアクションは、検証のためにフローまたはサブフローで使用できます。たとえば、サブフローは、Jira の問題の最新の添付ファイルが指定された添付ファイルと同じではない場合にのみ、追加の添付ファイルを追加します。
	問題に関する最新のコメントを検索	指定された問題の最新のコメントを Jira から取得します。このアクションは、検証のためにフローまたはサブフローで使用できます。たとえば、Jira の問題に関する最新のコメントが、指定されたコメントと同じではない場合のみ、サブフローでさらにコメントが追加されます。
Webhook 管理	Webhook を検索	登録されているすべての Webhook の詳細をJiraインスタンスから取得します。
	Webhook を登録	Webhook をJiraインスタンスに登録します。
	Webhook を登録解除	Jira インスタンスに登録されている Webhook を削除します。
	Webhook を更新	Jira 内の指定された ID の Webhook を更新します。注: OAuth 2.0 認証を使用する場合、このアクションはサポートされません。

Jiraアカウント要件

Jiraでは、Atlassian アカウントを使用してJiraの API トークンを生成する必要があります。

接続および資格情報エイリアスの要件

統合ハブは、エイリアスを使用して、接続および資格情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の資格情報と接続情報プロファイルを構成する必要がなくなります。接続または資格情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。詳細については、「資格情報と接続情報」を参照してください。

このスポークでは、Jiraエイリアスレコードを使用します。これらのアクションを使用するには、接続レコードと資格情報レコードを作成し、それらを Jira エイリアスレコードに関連付ける必要があります。

これらのアクションでは REST 呼び出しを使用します。REST 呼び出しはインスタンスで実行できます。Jira エイリアスに関連付けられた接続レコードを使用して、アクションを実行するエンドポイントを構成します。