---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications
Release :
- yokohama
ft:locale :
- ja-JP
ft:publication_title :
- Yokohama データと自動化
ft:clusterId :
- crint
bundleId :
- crint
workflow :
- Creator
---
# Jira スポーク
# Jira スポーク {#ariaid-title1}
* リリースバージョン: Yokohama
*
* 更新日 2026年03月12日
*
*  所要時間：15分
問題、ユーザー、ストーリー、グループ、プロジェクト、スプリント、および Webhook を管理し、 Jiraで監査ログを検索します。フローで使用する Jira データを取得します。双方向 Webhook を使用し、ServiceNowコールバック URL でJiraに登録します。統合ハブ向け Now Assist をインストールし、利用可能な AI エージェントを使用して ServiceNow インスタンスでタスクの実行を開始します。必要なイベントのトリガーを設定して、Webhook が ServiceNow インスタンスに接続できるようにします。
## ストアでアプリを要求する {#jira-spoke-v3-0-2__section_e1f_jvb_x3b}
[ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「[ServiceNow Storeバージョン履歴のリリースノート](https://docs.servicenow.com/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html)」を参照してください。{#jira-spoke-v3-0-2__inline-send-to-store}
## 統合ハブサブスクリプション {#jira-spoke-v3-0-2__section_rsf_yvb_l3b}
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「[法務スケジュール - 統合ハブの概要](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf)」を参照てください。
## スポークバージョン {#jira-spoke-v3-0-2__section_llr_psv_bsb}
Jira スポークv 6.0.0 が最新バージョンです。{#jira-spoke-v3-0-2__jira-ver}
## スポークの依存関係 {#jira-spoke-v3-0-2__section_h3x_pxb_glb}
アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
* 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)
{#jira-spoke-v3-0-2__ul_u5k_czb_glb}
注:
これらのプラグインの一部はライセンス可能な機能であり、スポーク実装以外で使用する場合は適切なライセンスが必要です。ライセンスの詳細については、アカウントマネージャーにお問い合わせください。
## サポートされているバージョン {#jira-spoke-v3-0-2__section_vm3_334_zgb}
このスポークは API version v2 用にビルドされていますが、それ以降のバージョンと互換性がある可能性があります。
注:
* Jira インスタンスが別の API バージョンをサポートしている場合は、\[属性\] 関連リストのそれぞれの接続レコードの API バージョンで API バージョンを指定します。デフォルトでは、API バージョン は 2 です。
* Jira サービスデスクは Jira スポークではサポートされていません。ServiceNow では、Jira Service Desk の新しいバージョンである Jira Service Management と統合するための [Jira サービス管理スポーク](https://servicenow-prod.fluidtopics.net/N1b7ZtbzwrfVVBbzO_hpTA "ServiceNow インスタンスから Jira Service Management のサービス管理タスクを自動化します。") を提供しています。
{#jira-spoke-v3-0-2__ul_skg_2n2_rmb}
## Jira Webhook モジュール {#jira-spoke-v3-0-2__section_ak4_xwn_z3b}
双方向 Webhook をセットアップして、必須イベントに関する通知を受けることができます。ルーティングポリシーでは、 ServiceNow インスタンスに通知するために満たすべき条件が定義されます。これらの条件は、通知を希望するJiraのイベントに基づいています。条件が満たされると、ルーティングポリシーが関連するサブフローをトリガーし、Jira タスクを自動化します。
双方向 Webhook には別途セットアップが必要で、スポークアクションを使用しないで単独で使用できます。デフォルトでは、Jira Webhooks アプリケーションが Jira で利用可能で、次のモジュールがあります。
* Jira Webhook レジストリ
* Jira WebHook ルーティングポリシー
{#jira-spoke-v3-0-2__ul_qzt_2h4_z3b}
Jira Webhook レジストリモジュールを使用してトークンを割り当て、API パスを指定します。コールバック URL を生成し、URL を Jira アカウントに入力する必要があります。デフォルトのルーティングポリシーは、Jira WebHook ルーティングポリシーモジュールで提供されます。デフォルトのルーティングポリシーは、次のフィールドをサポートしています。{#jira-spoke-v3-0-2__table_routing_policy__entry__2}
| カテゴリ | フィールド |
|-|-|
| 問題 | * Jira インスタンス URL * Webhook イベント * 問題の説明 * 作成日時 * 更新日時 * 問題の解決 * 以前の問題の解決 * 問題サマリー * 問題タイプ * 以前の問題タイプ * 問題の優先度 * 以前の問題の優先度 * 問題のステータス * 以前の問題ステータス * 問題ステータスカテゴリ * 以前の問題ステータスカテゴリ * プロジェクト {#jira-spoke-v3-0-2__ul_tny_fv1_1jb} |
| コメント | * Jira インスタンス URL * Webhook イベント * コメント * 作成日時 * 更新日時 * 問題サマリー * 問題タイプ * 問題の優先度 * 問題のステータス * 問題ステータスカテゴリ * プロジェクト {#jira-spoke-v3-0-2__ul_bqk_mv1_1jb} |
| 作業ログ | * Jira インスタンス URL * Webhook イベント * 作業ログの所要時間 * 作成日時 * 更新日時 {#jira-spoke-v3-0-2__ul_off_rv1_1jb} |
| 添付ファイル | * Jira インスタンス URL * Webhook イベント * 作成日時 * 添付ファイル名 * 添付ファイルサイズ * 添付 MIME タイプ {#jira-spoke-v3-0-2__ul_bkt_tv1_1jb} |
| プロジェクト | * Jira インスタンス URL * Webhook イベント * プロジェクト {#jira-spoke-v3-0-2__ul_r3q_wv1_1jb} |
| バージョン | * Jira インスタンス URL * Webhook イベント * バージョン * バージョン説明 * バージョンに結合 * バージョン説明に結合 {#jira-spoke-v3-0-2__ul_mqx_xv1_1jb} |
[ ]
{#jira-spoke-v3-0-2__table_routing_policy}
ルーティングポリシーの他の条件を使用するには、Jira WebHook ルーティングポリシーモジュールにルーティングポリシーを作成し、要件に従って条件を指定します。Webhook の設定と構成の詳細については、「[Jira スポーク用双方向 Webhook の設定](https://servicenow-prod.fluidtopics.net/F2FNKB4GWQA6YB1bM~AcPQ#setup-jira302-webhooks "ServiceNow コールバック URL で Jira を登録するための Webhook を設定します。")」を参照してください。
ヒント:
Webhook を設定して使用するには、Webhook レジストリ、ディシジョンテーブルを構成し、サブフローを作成する必要があります。より少ない構成のローコードの代替手段として、 [スポークのトリガー](https://servicenow-prod.fluidtopics.net/VFjRk1XDs~JkXwq92w1Ufg#jira-spoke-v3-0-2__section_cpg_rpm_ccc) を使用できます。
## スポークのサブフロー {#jira-spoke-v3-0-2__section_gj2_3q4_z3b}
Jira スポークでは、さまざまなJira Webhook イベントを処理するサンプルサブフローが提供されます。利用可能なサンプルサブフローは、\[Jira Webhook の処理\] です。\[Jira Webhook の処理\] サブフローは、次のフィールドをサポートしています。{#jira-spoke-v3-0-2__table_ydf_st1_1jb__entry__2}
| カテゴリ | フィールド |
|-|-|
| 問題 | * ユーザー * 問題 * 添付ファイル * 問題変更ログ * プロジェクト {#jira-spoke-v3-0-2__ul_afn_vt1_1jb} |
| コメント | * 問題 * プロジェクト * コメント {#jira-spoke-v3-0-2__ul_vsh_xt1_1jb} |
| 作業ログ | 作業ログ |
| 添付ファイル | 添付ファイル |
| プロジェクト | プロジェクト |
| バージョン | バージョン |
| Webhook イベント ||
| タイムスタンプ ||
| ペイロード 注: これは Jira ペイロード全体です。 ||
[ ]
{#jira-spoke-v3-0-2__table_ydf_st1_1jb}デフォルトのサブフローをカスタマイズするには、サンプルサブフローのコピーを作成し、ペイロードを解析して、要件に従ってサブフローをカスタマイズする必要があります。ペイロードは、サブフローへの入力の 1 つです。
サブフローをカスタマイズするときは、サブフローが無限ループを回避するように構成されていることを確認する必要があります。
注:
* スポークサブフローを使用するように Webhook を設定する必要があります。Webhook の設定と構成の詳細については、[Jira スポーク用双方向 Webhook の設定](https://servicenow-prod.fluidtopics.net/F2FNKB4GWQA6YB1bM~AcPQ#setup-jira302-webhooks "ServiceNow コールバック URL で Jira を登録するための Webhook を設定します。")を参照してください。
* デフォルトで、サンプルサブフローはユーザーとして実行されます。サブフローは、システムとして実行するように設定できます。
{#jira-spoke-v3-0-2__ul_js3_r4w_qjb}
## スポークのトリガー {#jira-spoke-v3-0-2__section_cpg_rpm_ccc}
Jira スポークのトリガーを使用して、必要なイベントに登録します。エンドポイントにより、Webhook が ServiceNow インスタンスに接続できるようになります。指定したトリガー条件が満たされた場合にのみ実行されるようにフローを設定できます。サポートされているイベントは次のとおりです。
{#jira-spoke-v3-0-2__table_usl_cqm_ccc__entry__3}
| カテゴリ | トリガー | 説明 |
|-|-|-|
| ボード管理 | ボードの削除完了 | ボードが削除されると、トリガーが開始されます。 |
| ボード管理 | ボードの更新完了 | ボードが更新されると、トリガーが開始されます。 |
| ボード管理 | ボードの作成完了 | ボードが作成されると、トリガーが開始されます。 |
| コメント管理 | コメントの削除完了 | コメントが削除されると、トリガーが開始されます。 |
| コメント管理 | コメントの更新完了 | コメントが更新されると、トリガーが開始されます。 |
| コメント管理 | コメントの作成完了 | コメントが作成されると、トリガーが開始されます。 |
| 問題管理 | 問題の更新完了 | 問題が更新されると、トリガーが開始されます。問題のアサイン、問題の解決、問題のクローズ、問題の再オープン、問題の移動などのイベント、および問題の更新に関連するその他のイベントが、この Webhook イベントに該当します。 |
| 問題管理 | 問題のアサイン完了 | 問題がアサインされると、トリガーが開始されます。 |
| 問題管理 | 問題の削除完了 | 問題が削除されると、トリガーが開始されます。 |
| 問題管理 | 問題の作成完了 | 問題が作成されると、トリガーが開始されます。 |
| スプリント管理 | スプリントの更新完了 | スプリントが更新されると、トリガーが開始されます。 |
| スプリント管理 | スプリントの削除完了 | スプリントが削除されると、トリガーが開始されます。 |
| スプリント管理 | スプリントの作成完了 | スプリントが作成されると、トリガーが開始されます。 |
| スプリント管理 | スプリントのクローズ完了 | スプリントがクローズされると、トリガーが開始されます。 |
| スプリント管理 | スプリントの開始完了 | スプリントが開始されると、トリガーが開始されます。 |
[ ]
{#jira-spoke-v3-0-2__table_usl_cqm_ccc}
Jira スポークのトリガーの設定については、「[Jira スポークのトリガーの設定](https://servicenow-prod.fluidtopics.net/fKOxj5uLlcR4fzlHI6nxPw#jira-ext-trigger "必要なイベントについて、Jira スポークのトリガーを設定します。エンドポイントにより、Webhook が ServiceNow インスタンスに接続できるようになります。")」を参照してください。インバウンド統合の詳細については、「[条件付きおよびイベント駆動型のインバウンド統合](https://servicenow-prod.fluidtopics.net/3P3izYcM1QEA~a~cEi5EsQ "統合ハブ では、サードパーティアプリケーションとの条件付きおよびイベント駆動型の両方のインバウンド統合が可能です。")」を参照してください。
## スポークのアクション {#jira-spoke-v3-0-2__section_r2m_j1d_mfb}
ワークフロースタジオでJira スポークのアクションを使用して、Now Platformでイベントが発生したときにJiraタスクを自動化します。使用可能なアクションは次のとおりです。
注:
* このリリース以降の一部のスポークアクションに、接続エイリアスの入力はありません。
以前のバージョンのアクションを使用するインスタンス内の既存のフローは、引き続き機能します。ただし、こうした以前のアクションは、廃止されたサフィックスを追加すると名前が変更され、このバージョン以降は使用できなくなります。
* 一部のスポークアクションでは、エラー評価機能が提供されています。
{#jira-spoke-v3-0-2__ul_kgt_hwj_jvb}
{#jira-spoke-v3-0-2__table_ntl_nhn_ngc__entry__3}
| カテゴリ | アクション | 説明 |
|-|-|-|
| 監査管理 | 監査ログストリームを検索 | Jiraユーザーサブスクリプションのログインアクティビティを取得します。 注: このアクションは、 Jira Server 9 以前のバージョンと Jira Cloud でサポートされています。 |
| 監査管理 | 監査ログストリームを検索 (Server 10+) | 指定された日付範囲内の監査ログレコードを Jira インスタンスから取得します。 注: このアクションは、 Jira Server 10 以降のバージョンでサポートされています。 |
| グループ管理 | グループにユーザーを追加 | Jiraのグループに指定されたユーザーを追加します。 |
| グループ管理 | グループの作成 | Jiraにグループを作成します。 |
| グループ管理 | グループストリームを検索 | デフォルトグループを含む、Jira アカウント内のすべてのグループを取得します。 注: このアクションは、Jira Cloud サブスクリプションでのみ使用できます。 |
| グループ管理 | グループ名ストリームでユーザーを検索 | Jira グループ内のすべてのメンバーの詳細を取得します。 |
| グループ管理 | グループを削除 | 指定されたグループをJiraから削除します。 |
| グループ管理 | グループからユーザーを削除 | Jiraのグループから指定されたユーザーを削除します。 |
| 問題管理 | コメントを追加 | Jiraで指定した問題にコメントを追加します。 |
| 問題管理 | ウォッチャーを追加 | 指定された問題のウォッチャーとして、指定されたユーザーを追加します。 |
| 問題管理 | 問題を割り当て | Jiraの問題をユーザーに割り当てます。 |
| 問題管理 | 添付ファイルをコピー | ServiceNow レコードに関連付けられている必要な添付ファイルを、Jira の必要な問題にコピーします。 |
| 問題管理 | 問題を作成 | Jiraに問題を作成します。組織がJiraをどのように使用しているかに応じて、ソフトウェアのバグ、プロジェクトタスク、ヘルプデスクチケットなど、様々な形で問題が現れます。Jiraの問題は、Now 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プロジェクト内のすべての問題タイプのリストを取得します。 |
| プロジェクト管理 | プロジェクト作成 | Jira でプロジェクトを作成します。 |
| プロジェクト管理 | プロジェクトを検索 | ID またはキーで指定されたプロジェクトの詳細を取得します。 |
| プロジェクト管理 | プロジェクトを検索 | すべてのプロジェクトの詳細を取得します。 注: このアクションは Jira サーバーでのみ機能します。 |
| プロジェクト管理 | プロジェクトストリームを検索 | すべてのプロジェクトの詳細を取得します。 注: このアクションは Jira クラウドでのみ機能します。 |
| プロジェクト管理 | プロジェクトにアサイン可能なユーザーを検索 | 1 つ以上のプロジェクトの問題にアサインできるユーザーのリストを取得します。 |
| スプリント管理 | スプリントを作成 | Jiraにスプリントを作成します。 |
| スプリント管理 | スプリントを削除 | Jiraのスプリントを削除します。 |
| スプリント管理 | スプリントを検索 (Look up Sprint) | 必要なスプリントの詳細を複合オブジェクトとして取得します。 |
| スプリント管理 | ボードでスプリントを検索 | 必要なボードのすべてのスプリントの詳細を取得します。 |
| スプリント管理 | スプリントを更新 | Jiraのスプリントの詳細を更新します。 |
| ストーリー管理 | ストーリーの作成 | Jira Cloud インスタンスでストーリーを作成します。これは、ServiceNow Agile Development プラグインのストーリーに相当します。 |
| ストーリー管理 | ストーリーストリームを検索 | すべてのストーリーの詳細を取得します。 |
| ストーリー管理 | ストーリーを更新 | 提供された入力値で Jira Cloud におけるストーリーの一定数のフィールドを更新します。 |
| ユーザー管理 | ユーザーの作成 | Jira にユーザーを作成します。 |
| ユーザー管理 | 認証ユーザーを検索 | 認証されたユーザーアカウントの詳細を取得します。 |
| ユーザー管理 | ユーザーのグループメンバーシップを検索 | Jira ユーザーのすべてのグループの詳細を取得します。 |
| ユーザー管理 | ユーザーストリームを検索 | すべての Jira ユーザーサブスクリプションの詳細を取得します。 注: このアクションは、Jira クラウドサブスクリプションでのみ使用できます。 |
| ユーザー管理 | 名前でユーザーストリームを検索 | 検索文字列に一致するユーザーのリストを取得します。 注: このアクションは、Jira サーバーサブスクリプションでのみ使用できます。 |
| ユーザー管理 | ユーザーを削除 | Jiraからユーザーを削除します。 |
| ユーティリティアクション | 問題の添付ファイルをレコードにコピー | 添付ファイルをJiraからServiceNowインスタンスの任意のレコードにコピーします。サブフローでこのアクションを使用する場合は、\[添付ファイル URL\] フィールドに \[コンテンツ URL\] データピルが指定されていることを確認してください。 |
| ユーティリティアクション | フィールドを検索 | Jiraの必須フィールドラベルの内部名とその他の詳細を取得します。 |
| ユーティリティアクション | コメントから問題を検索 | 指定されたコメントのペイロードを解析して、問題の詳細を取得します。このアクションは、Jira 問題に関する詳細なしでコメント関連情報のみが指定されている場合に、Jira オンプレミスサーバーの \[Jira Webhook の処理\] サブフローで使用できます。たとえば、コメント情報のみが指定されている場合、このアクションはペイロードを解析し、問題の詳細を抽出します。 |
| ユーティリティアクション | 問題に関する最新の添付ファイルを検索 | 指定された問題の最新の添付ファイルを Jira から取得します。このアクションは、検証のためにフローまたはサブフローで使用できます。たとえば、サブフローは、Jira の問題の最新の添付ファイルが指定された添付ファイルと同じではない場合にのみ、追加の添付ファイルを追加します。 |
| ユーティリティアクション | 問題に関する最新のコメントを検索 | 指定された問題の最新のコメントを Jira から取得します。このアクションは、検証のためにフローまたはサブフローで使用できます。たとえば、Jira の問題に関する最新のコメントが、指定されたコメントと同じではない場合のみ、サブフローでさらにコメントが追加されます。 |
| ユーティリティアクション | サーバーを検索 | 現在の Jira インスタンスに関する一般情報を取得します。 |
| Webhook 管理 | Webhook を検索 | 登録されているすべての Webhook の詳細をJiraインスタンスから取得します。 |
| Webhook 管理 | Webhook を登録 | Webhook をJiraインスタンスに登録します。 |
| Webhook 管理 | Webhook を登録解除 | Jira インスタンスに登録されている Webhook を削除します。 |
| Webhook 管理 | Webhook を更新 | Jira 内の指定された ID の Webhook を更新します。 注: OAuth 2.0 認証を使用する場合、このアクションはサポートされません。 |
[ ]
{#jira-spoke-v3-0-2__table_ntl_nhn_ngc}
## Jiraアカウント要件 {#jira-spoke-v3-0-2__section_vkv_m1d_mfb}
Jiraでは、Jira アカウントを使用してJiraするための API トークンを生成する必要があります。
## 接続および資格情報エイリアスの要件 {#jira-spoke-v3-0-2__section_hdq_dsj_vdb}
統合ハブ は、エイリアスを使用して、接続および認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。
このスポークでは、Jiraエイリアス レコードを使用します。これらのアクションを使用するには、接続レコードと認証情報レコードを作成し、それらを Jira エイリアスレコードに関連付ける必要があります。
これらのアクションでは REST 呼び出しを使用します。REST 呼び出しはインスタンスで実行できます。Jira エイリアスに関連付けられた接続レコードを使用して、アクションを実行するエンドポイントを構成します。