Jira スポーク
Jira で問題、ユーザー、ストーリー、グループを管理します。フローで使用する Jira データを取得します。双方向 webhooks を使用して、ServiceNow コールバック URL で Jira に登録します。
ストアでアプリを要求する
ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。
スポークバージョン
Jira スポーク v5.3.0 が最新バージョンです。
スポークの依存関係
アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
- ServiceNow 統合ハブアクションテンプレート：データストリーム (com.glide.hub.action_type.datastream)
- Complex Object (com.glide.cobject)
- ServiceNow 統合ハブアクションステップ - 接続情報の取得 (com.glide.hub.action_step.get_connection_info)
- ServiceNow 統合ハブランタイム (com.glide.hub.integration.runtime)
- ServiceNow 統合ハブアクションステップ - REST (com.glide.hub.action_step.rest)
- ServiceNow フローデザイナー - 動的入力 (com.glide.hub.dynamic_inputs)
- 統合 - 外部認証フレームワーク (com.glide.external.app)
注:
これらのプラグインの一部はライセンス可能な機能であり、スポーク実装以外で使用する場合は適切なライセンスが必要です。ライセンスの詳細については、アカウントマネージャーにお問い合わせください。
サポートされているバージョン
このスポークは API version v2 用にビルドされていますが、それ以降のバージョンと互換性がある可能性があります。
注:
- Jira インスタンスが別の API バージョンをサポートしている場合は、属性関連リストの [API バージョン] で API バージョンを指定します。デフォルトでは、API バージョン は 2 です。接続レコードの作成については、「Jira スポークの接続の設定」を参照してください。
- Jira サービスデスクはスポークではサポートされていません。
Jira Webhook モジュール
双方向 Webhook をセットアップして、必須イベントに関する通知を受けることができます。ルーティングポリシーでは、 ServiceNow インスタンスに通知するために満たすべき条件が定義されます。これらの条件は、通知を希望するJiraのイベントに基づいています。条件が満たされると、ルーティングポリシーが関連するサブフローをトリガーし、Jira タスクを自動化します。
双方向 Webhook には別途セットアップが必要で、スポークアクションを使用しないで単独で使用できます。デフォルトでは、Jira Webhooks アプリケーションが Jira で利用可能で、次のモジュールがあります。
- Jira Webhook レジストリ
- Jira WebHook ルーティングポリシー
Jira Webhook レジストリモジュールを使用してトークンを割り当て、API パスを指定します。コールバック URL を生成し、URL を Jira アカウントに入力する必要があります。デフォルトのルーティングポリシーは、Jira WebHook ルーティングポリシーモジュールで提供されます。デフォルトのルーティングポリシーは、次のフィールドをサポートしています。
| カテゴリ | フィールド |
|---|---|
| 問題 |
|
| コメント |
|
| 作業ログ |
|
| 添付ファイル |
|
| プロジェクト |
|
| バージョン |
|
ルーティングポリシーの他の条件を使用するには、Jira WebHook ルーティングポリシーモジュールにルーティングポリシーを作成し、要件に従って条件を指定します。Webhook の設定と構成の詳細については、Jira スポーク用双方向 Webhook の設定を参照してください。
スポークのサブフロー
Jiraでは、さまざまな JiraWebhook イベントを処理するためのサンプルサブフローが提供されます。利用可能なサンプルサブフローは、[Jira Webhook の処理] です。[Jira Webhook の処理] サブフローは、次のフィールドをサポートしています。
デフォルトのサブフローをカスタマイズするには、サンプルサブフローのコピーを作成し、ペイロードを解析して、要件に従ってサブフローをカスタマイズする必要があります。ペイロードは、サブフローへの入力の 1 つです。
| カテゴリ | フィールド |
|---|---|
| 問題 |
|
| コメント |
|
| 作業ログ | 作業ログ |
| 添付ファイル | 添付ファイル |
| プロジェクト | プロジェクト |
| バージョン | バージョン |
| Webhook イベント | |
| タイムスタンプ | |
| ペイロード 注: これは Jira ペイロード全体です。 |
|
サブフローをカスタマイズするときは、サブフローが無限ループを回避するように構成されていることを確認する必要があります。
注:
- スポークサブフローを使用するように Webhook を設定する必要があります。Webhook の設定と構成の詳細については、Jira スポーク用双方向 Webhook の設定を参照してください。
- デフォルトで、サンプルサブフローはユーザーとして実行されます。サブフローは、システムとして実行するように設定できます。
スポークのトリガー
Jira スポークのトリガーを使用して、必要なイベントに登録します。エンドポイントにより、Webhook が ServiceNow インスタンスに接続できるようになります。指定したトリガー条件が満たされた場合にのみ実行されるようにフローを設定できます。サポートされているイベントは次のとおりです。
| カテゴリ | トリガー | 説明 |
|---|---|---|
| ボード管理 | ボードの削除完了 | ボードが削除されると、トリガーが開始されます。 |
| ボードの更新完了 | ボードが更新されると、トリガーが開始されます。 | |
| ボードの作成完了 | ボードが作成されると、トリガーが開始されます。 | |
| コメント管理 | コメントの削除完了 | コメントが削除されると、トリガーが開始されます。 |
| コメントの更新完了 | コメントが更新されると、トリガーが開始されます。 | |
| コメントの作成完了 | コメントが作成されると、トリガーが開始されます。 | |
| 問題管理 | 問題の更新完了 | 問題が更新されると、トリガーが開始されます。問題のアサイン、問題の解決、問題のクローズ、問題の再オープン、問題の移動などのイベント、および問題の更新に関連するその他のイベントが、この Webhook イベントに該当します。 |
| 問題のアサイン完了 | 問題がアサインされると、トリガーが開始されます。 | |
| 問題の削除完了 | 問題が削除されると、トリガーが開始されます。 | |
| 問題の作成完了 | 問題が作成されると、トリガーが開始されます。 | |
| スプリント管理 | スプリントの更新完了 | スプリントが更新されると、トリガーが開始されます。 |
| スプリントの削除完了 | スプリントが削除されると、トリガーが開始されます。 | |
| スプリントの作成完了 | スプリントが作成されると、トリガーが開始されます。 | |
| スプリントのクローズ完了 | スプリントがクローズされると、トリガーが開始されます。 | |
| スプリントの開始完了 | スプリントが開始されると、トリガーが開始されます。 |
Jira スポークのトリガーの設定については、「Jira スポークのトリガーの設定」を参照してください。インバウンド統合の詳細については、「条件付きおよびイベント駆動型のインバウンド統合」を参照してください。
スポークのアクション
ワークフロースタジオでJira スポークのアクションを使用して、ServiceNow AI Platformでイベントが発生したときにJiraタスクを自動化します。使用可能なアクションは次のとおりです。
注:
- このリリース以降の一部のスポークアクションに、接続エイリアスの入力はありません。
以前のバージョンのアクションを使用するインスタンス内の既存のフローは、引き続き機能します。ただし、こうした以前のアクションは、廃止されたサフィックスを追加すると名前が変更され、このバージョン以降は使用できなくなります。
- 一部のスポークアクションでは、エラー評価機能が提供されています。
| カテゴリ | アクション | 説明 |
|---|---|---|
| Audit Management | 監査ログストリームを検索 | Atlassian Jira ユーザーサブスクリプションのログインアクティビティを取得します。 注: このアクションは、 Jira Server 9 以前のバージョンと Jira Cloud でサポートされています。 |
| 監査ログストリームを検索 (Server 10 以降) | 指定された日付範囲内の監査ログレコードを Jira インスタンスから取得します。 注: このアクションは Jira サーバー 9 以降のバージョンでサポートされています。 |
|
| グループ管理 | グループにユーザーを追加 | Jiraのグループに指定されたユーザーを追加します。 |
| グループを作成 | Jiraにグループを作成します。 | |
| グループストリームを検索 | デフォルトグループを含む、Atlassian アカウント内のすべてのグループを取得します。 注: このアクションは、Jira Cloud サブスクリプションでのみ使用できます。 |
|
| グループ名ストリームでユーザーを検索 | Atlassian グループ内のすべてのメンバーの詳細を取得します。 | |
| グループを削除 | 指定されたグループをJiraから削除します。 | |
| グループからユーザーを削除 | Jiraのグループから指定されたユーザーを削除します。 | |
| 問題管理 | コメントを追加 | Jiraで指定した問題にコメントを追加します。 |
| ウォッチャーを追加 | 指定された問題のウォッチャーとして、指定されたユーザーを追加します。 | |
| 問題を割り当て | Jiraの問題をユーザーに割り当てます。 | |
| 添付ファイルをコピー | ServiceNow レコードに関連付けられている必要な添付ファイルを、Jira の必要な問題にコピーします。 | |
| 問題を作成 | Jiraに問題を作成します。組織がJiraをどのように使用しているかに応じて、ソフトウェアのバグ、プロジェクトタスク、ヘルプデスクチケットなど、様々な形で問題が現れます。Jiraの問題は、ServiceNow AI Platformのタスクを表します。 | |
| 添付ファイルを削除 | Jiraの必要な添付ファイルを削除します。 | |
| 問題を削除 | Jiraの問題を削除します。 | |
| 監視を削除 | 指定された問題のウォッチャーとして、ユーザーを削除します。 | |
| 移行を実行 | Jiraの問題をある状態から別の状態に移行します。 | |
| プロジェクトで問題タイプステータスを検索 (Look up Issue Type Statuses by Project) | プロジェクトのステータスの詳細を取得します。 | |
| 問題を検索 | 問題の詳細を取得します。 | |
| 問題の優先度を検索 | 問題の優先度のリストと個々の問題の優先度の詳細を取得します。 | |
| 問題ストリームを検索 | JQL クエリ文字列に一致する問題のリストを取得します。 | |
| Sprint 問題ストリームを検索 | 指定されたスプリントのすべての問題の詳細を取得します。 | |
| 移行を検索 | 指定された問題 ID のすべての移行に関する情報を取得します。 | |
| ウォッチャーを検索 | 指定された問題のウォッチャーのリストを取得します。 | |
| 問題を更新 | 入力として渡された値でJiraの問題の一連のフィールドを更新します。 | |
| メタデータの取得 | 作成可能なフィールド (メタデータ) を取得 (Get Creatable Fields (Metadata)) | 必要な Jira プロジェクトのすべてのフィールドのリストを取得します。 |
| 編集可能なフィールド (メタデータ) を取得 (Get Editable Fields (Metadata)) | 必要なJira問題のすべての編集可能なフィールドのリストを取得します。 | |
| 問題タイプ (メタデータ) を取得 (Get Issue Types (Metadata)) | 必要なJiraプロジェクト内のすべての問題タイプのリストを取得します。 | |
| プロジェクト管理 (PM) | プロジェクト作成 | 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 の問題に関する最新のコメントが、指定されたコメントと同じではない場合のみ、サブフローでさらにコメントが追加されます。 | |
| サーバーを検索 | 現在の Jira インスタンスに関する一般的な情報を取得します。 | |
| Webhook 管理 | Webhook を検索 | 登録されているすべての Webhook の詳細をJiraインスタンスから取得します。 |
| Webhook を登録 | Webhook をJiraインスタンスに登録します。 | |
| Webhook を登録解除 | Jira インスタンスに登録されている Webhook を削除します。 | |
| Webhook を更新 | Jira 内の指定された ID の Webhook を更新します。 注: OAuth 2.0 認証を使用する場合、このアクションはサポートされません。 |
利用可能な AI エージェント
Now Assist for スポークをインストールし、利用可能な AI エージェントの使用を開始します。詳細については、「Now Assist for スポーク」を参照してください。
このスポークは、人間のような知能を模倣して ServiceNow インスタンスでタスクを実行するスタンドアロンの AI エージェントを提供します。
- ServiceNowエージェントシステムでは、目標を実行するために、一連の大規模言語モデル (LLM) 命令と 1 つ以上のスタンドアロン AI エージェントで構成されるエージェントワークフローを作成できます。AI エージェントを追加して要件に従ってエージェントワークフローを作成し、必要なトリガーを提供する方法については、 Create an agentic workflow を参照してください。
他の利用可能な AI エージェントを検索して、エージェントワークフローに追加することもできます。詳細については、「Find AI agents」を参照してください。
- 必要なスポーク AI エージェントのクローンを作成し、要件に応じてカスタマイズできます。クローンの作成の詳細については、 Duplicate an AI agent を参照してください。
- AI エージェントの詳細については、 Now Assist AI agents を参照してください。
利用可能な AI エージェントは次のとおりです。
| AI エージェント | 説明 |
|---|---|
| Jira ストーリー管理 AI エージェント | ストリーム内のストーリーに関する情報を取得し、新しいストーリーを作成し、既存のストーリーを更新します。 |
| Jira ユーティリティ管理 AI エージェント | 問題の添付ファイルをレコードにコピーし、Jira の問題に関する最新の添付ファイルとコメントを取得し、ラベルを使用してフィールドの詳細を取得できるユーティリティアクションを提供します。正確なデータ取得を保証します。 |
| Jira ユーザー管理 AI エージェント | 必要なユーザーを作成および削除します。ユーザー、グループメンバーシップ、および認証済みユーザーアカウントに関する情報を取得します。 |
| Jira 監査管理 AI エージェント | 監査ログを管理し、反復的なタスクを自動化することで実用的なインサイトを提供します。 |
| Jira スプリント管理 AI エージェント | スプリントを削除し、スプリントの詳細を更新し、特定のスプリント情報を取得します。 |
| Jira プロジェクト管理 AI エージェント | プロジェクトの詳細を取得し、新しいプロジェクトを作成し、プロジェクトストリームを取得し、プロジェクトにアサイン可能なユーザーの識別を行います。 |
| Jira グループ管理 AI エージェント | グループの作成と削除、ユーザーの追加と削除、グループの詳細の取得、データと更新の取得、グループメンバーの取得などのアクションを実行して、グループを管理します。 |
| Jira 課題管理 AI エージェント | 問題の削除、移行の管理、ウォッチャーの処理、添付ファイルの操作などのアクションを実行して、問題を管理します。また、移行、コメント、添付ファイル、およびウォッチャーも管理します。 |
AI エージェントをお探しですか?
- Now Assistアプリケーションとともにインストールされた AI エージェントが、エージェント型ワークフローで使用されていない可能性があります。インスタンスで利用可能なすべてのエージェントを表示する方法については、「 AI エージェントの検索」を参照してください。
- インスタンスにインストールされていない可能性のあるエージェントを見つけるには、ServiceNow Store の AI エージェントマーケットプレイスにアクセスしてください。
注:
AI エージェントを実行しているユーザーに、AI エージェントに関連付けられたテーブル内のデータにアクセスしたり、データに対して操作を実行したりするために必要なロールと権限があることを確認します。
Jiraアカウント要件
Jiraでは、Atlassian アカウントを使用してJiraの API トークンを生成する必要があります。
接続および資格情報エイリアスの要件
統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。
このスポークでは、Jiraエイリアス レコードを使用します。これらのアクションを使用するには、接続レコードと認証情報レコードを作成し、それらを Jira エイリアスレコードに関連付ける必要があります。
これらのアクションでは REST 呼び出しを使用します。REST 呼び出しはインスタンスで実行できます。Jira エイリアスに関連付けられた接続レコードを使用して、アクションを実行するエンドポイントを構成します。