Jira スポーク

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：15分

    • Jira で問題、ユーザー、ストーリー、グループを管理します。フローで使用する Jira データを取得します。双方向 webhooks を使用して、ServiceNow コールバック URL で Jira に登録します。

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

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

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

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

    スポークバージョン

    Jira スポーク v5.0.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 インスタンス URL
    • Webhook イベント
    • 問題の説明
    • 作成日時
    • 更新日時
    • 問題の解決
    • 以前の問題の解決
    • 問題サマリー
    • 問題タイプ
    • 以前の問題タイプ
    • 問題の優先度
    • 以前の問題の優先度
    • 問題のステータス
    • 以前の問題ステータス
    • 問題ステータスカテゴリ
    • 以前の問題ステータスカテゴリ
    • プロジェクト
    コメント
    • Jira インスタンス URL
    • Webhook イベント
    • コメント
    • 作成日時
    • 更新日時
    • 問題サマリー
    • 問題タイプ
    • 問題の優先度
    • 問題のステータス
    • 問題ステータスカテゴリ
    • プロジェクト
    作業ログ
    • Jira インスタンス URL
    • Webhook イベント
    • 作業ログの所要時間
    • 作成日時
    • 更新日時
    添付ファイル
    • Jira インスタンス URL
    • Webhook イベント
    • 作成日時
    • 添付ファイル名
    • 添付ファイルサイズ
    • 添付 MIME タイプ
    プロジェクト
    • Jira インスタンス URL
    • Webhook イベント
    • プロジェクト
    バージョン
    • Jira インスタンス URL
    • Webhook イベント
    • バージョン
    • バージョン説明
    • バージョンに結合
    • バージョン説明に結合

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

    スポークのサブフロー

    Jiraでは、さまざまな JiraWebhook イベントを処理するためのサンプルサブフローが提供されます。利用可能なサンプルサブフローは、[Jira Webhook の処理] です。[Jira Webhook の処理] サブフローは、次のフィールドをサポートしています。
    カテゴリ フィールド
    問題
    • ユーザー
    • 問題
    • 添付ファイル
    • 問題変更ログ
    • プロジェクト
    コメント
    • 問題
    • プロジェクト
    • コメント
    作業ログ 作業ログ
    添付ファイル 添付ファイル
    プロジェクト プロジェクト
    バージョン バージョン
    Webhook イベント
    タイムスタンプ
    ペイロード
    注:
    これは Jira ペイロード全体です。
    デフォルトのサブフローをカスタマイズするには、サンプルサブフローのコピーを作成し、ペイロードを解析して、要件に従ってサブフローをカスタマイズする必要があります。ペイロードは、サブフローへの入力の 1 つです。

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

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

    スポークのトリガー

    Jira スポークのトリガーを使用して、必要なイベントに登録します。エンドポイントにより、Webhook が ServiceNow インスタンスに接続できるようになります。指定したトリガー条件が満たされた場合にのみ実行されるようにフローを設定できます。サポートされているイベントは次のとおりです。

    カテゴリ トリガー 説明
    ボード管理 ボードの削除完了 ボードが削除されると、トリガーが開始されます。
    ボードの更新完了 ボードが更新されると、トリガーが開始されます。
    ボードの作成完了 ボードが作成されると、トリガーが開始されます。
    コメント管理 コメントの削除完了 コメントが削除されると、トリガーが開始されます。
    コメントの更新完了 コメントが更新されると、トリガーが開始されます。
    コメントの作成完了 コメントが作成されると、トリガーが開始されます。
    問題管理 問題の更新完了 問題が更新されると、トリガーが開始されます。問題のアサイン、問題の解決、問題のクローズ、問題の再オープン、問題の移動などのイベント、および問題の更新に関連するその他のイベントが、この Webhook イベントに該当します。
    問題のアサイン完了 問題がアサインされると、トリガーが開始されます。
    問題の削除完了 問題が削除されると、トリガーが開始されます。
    問題の作成完了 問題が作成されると、トリガーが開始されます。
    スプリント管理 スプリントの更新完了 スプリントが更新されると、トリガーが開始されます。
    スプリントの削除完了 スプリントが削除されると、トリガーが開始されます。
    スプリントの作成完了 スプリントが作成されると、トリガーが開始されます。
    スプリントのクローズ完了 スプリントがクローズされると、トリガーが開始されます。
    スプリントの開始完了 スプリントが開始されると、トリガーが開始されます。

    Jira スポークのトリガーの設定については、「Jira スポークのトリガーの設定」を参照してください。インバウンド統合の詳細については、「条件付きおよびイベント駆動型のインバウンド統合」を参照してください。

    スポークのアクション

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

    注:
    • このリリース以降の一部のスポークアクションに、接続エイリアスの入力はありません。

      以前のバージョンのアクションを使用するインスタンス内の既存のフローは、引き続き機能します。ただし、こうした以前のアクションは、廃止されたサフィックスを追加すると名前が変更され、このバージョン以降は使用できなくなります。

    • 一部のスポークアクションでは、エラー評価機能が提供されています。
    カテゴリ アクション 説明
    Audit Management 監査ログストリームを検索 Atlassian Jira ユーザーサブスクリプションのログインアクティビティを取得します。
    グループ管理 グループにユーザーを追加 Jiraのグループに指定されたユーザーを追加します。
    グループを作成 Jiraにグループを作成します。
    グループストリームを検索 デフォルトグループを含む、Atlassian アカウント内のすべてのグループを取得します。
    注:
    このアクションは、Jira Cloud サブスクリプションでのみ使用できます。
    グループ名ストリームでユーザーを検索 Atlassian グループ内のすべてのメンバーの詳細を取得します。
    グループを削除 指定されたグループをJiraから削除します。
    グループからユーザーを削除 Jiraのグループから指定されたユーザーを削除します。
    問題管理 コメントを追加 Jiraで指定した問題にコメントを追加します。
    ウォッチャーを追加 指定された問題のウォッチャーとして、指定されたユーザーを追加します。
    問題を割り当て Jiraの問題をユーザーに割り当てます。
    添付ファイルをコピー ServiceNow レコードに関連付けられている必要な添付ファイルを、Jira の必要な問題にコピーします。
    問題を作成 Jiraに問題を作成します。組織がJiraをどのように使用しているかに応じて、ソフトウェアのバグ、プロジェクトタスク、ヘルプデスクチケットなど、様々な形で問題が現れます。Jiraの問題は、Now Platformのタスクを表します。
    問題を作成 最大 50 件の問題を一括で作成します。アクションによって作成される問題のタイプは、Jira セットアップによって異なります。
    添付ファイルを削除 Jiraの必要な添付ファイルを削除します。
    問題を削除 Jiraの問題を削除します。
    監視を削除 指定された問題のウォッチャーとして、ユーザーを削除します。
    移行を実行 Jiraの問題をある状態から別の状態に移行します。
    プロジェクトで問題タイプステータスを検索 (Look up Issue Type Statuses by Project) プロジェクトのステータスの詳細を取得します。
    問題を検索 問題の詳細を取得します。
    問題の優先度を検索 問題の優先度のリストと個々の問題の優先度の詳細を取得します。
    問題ストリームを検索 JQL クエリ文字列に一致する問題のリストを取得します。
    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 プロジェクトのリストを取得します。
    プロジェクト管理 (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 の問題に関する最新のコメントが、指定されたコメントと同じではない場合のみ、サブフローでさらにコメントが追加されます。
    Webhook 管理 Webhook を検索 登録されているすべての Webhook の詳細をJiraインスタンスから取得します。
    Webhook を登録 Webhook をJiraインスタンスに登録します。
    Webhook を登録解除 Jira インスタンスに登録されている Webhook を削除します。
    Webhook を更新 Jira 内の指定された ID の Webhook を更新します。
    注:
    OAuth 2.0 認証を使用する場合、このアクションはサポートされません。

    Jiraアカウント要件

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

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

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

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

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