Microsoft Azure DevOps Boards スポーク
ServiceNow インスタンスから Azure DevOps ボード の作業アイテムを管理するプロセスを自動化します。
ストアでアプリを要求する
ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。
スポークバージョン
Azure DevOps ボード スポーク v3.1.0 が最新バージョンです。
サポート対象のバージョン
このスポークは Azure DevOps ボード REST API バージョン 4.1 と TFS 2018 Update 3 用にビルドされていますが、それ以降のバージョンと互換性がある可能性があります。
スポークの依存関係
- ServiceNow 統合ハブアクションステップ：REST (com.glide.hub.action_step.rest)
- ServiceNow フローデザイナー：動的入力 (com.glide.hub.dynamic_inputs)
- ServiceNow IntegrationHub ランタイム (com.glide.hub.integration.runtime)
- ServiceNow 統合ハブアクションテンプレート - Data Stream (com.glide.hub.action_type.datastream)
- iHUB スポークユーティリティパック (com.snc.ihub_spoke_util_pack)
スポークの要件
- Azure DevOps インスタンス
- Azure DevOps を認証するための個人用アクセストークン (PAT)
スポークのアクション
Azure DevOps ボード スポーク では、ServiceNow でイベントが発生したときに作業アイテムを管理するアクションが提供されます。使用可能なアクションは次のとおりです。
| カテゴリ | アクション | 説明 |
|---|---|---|
| コアプロセス管理 | 反復を作成 | Azure DevOps 反復を作成します。 |
| 反復を削除 | パスによって Azure DevOps 反復を削除します。 | |
| チームの反復を削除 | チームから反復のリンクを解除または削除します。 | |
| 作成可能フィールドを検索 | 必要な Azure DevOps プロジェクトですべてのフィールドのリストを取得します。 | |
| エリアパスを検索 | プロジェクト内のすべてのエリアパスを取得します。 | |
| 編集可能フィールドを検索 | 必要な作業アイテムのすべてのフィールドのリストを編集用に取得します。 | |
| チームのエリアパスを検索 | チームのすべてのエリアパスを取得します。 | |
| パスで反復を検索 | パスで反復を取得します。 | |
| 反復パスを検索 | プロジェクトのすべての反復パスを取得します。 | |
| チームの反復パスを検索 | チームのすべての反復パスを取得します。 | |
| プロセスを検索 | すべての Azure DevOps プロセスのリストを取得します。 | |
| プロジェクトストリームを検索 | すべての Azure DevOps プロジェクトの詳細を取得します。 | |
| 作業アイテムリビジョンストリームを検索 | バッチ処理のレポート作業アイテムのリビジョンを取得します。 | |
| 作業アイテムリンクストリームを検索 | バッチ処理のレポート作業アイテムリンクを取得します。 | |
| Wiql でクエリを検索 | Wiql を指定してクエリの結果を取得します。 | |
| チーム設定を検索 | チームのバックログとデフォルトの反復設定を取得します。 | |
| チームを検索 | プロジェクトのすべてのチームを取得します。 | |
| 作業アイテムデータを ID で検索 | 作業アイテムのすべてのデータを取得します。 | |
| 作業アイテム関係を ID で検索 | 作業アイテムのすべての関係を取得します。 | |
| 作業アイテムタイプを検索 | 必要な Azure DevOps プロジェクトのすべての作業アイテムタイプのリストを取得します。 | |
| プロセス別の作業アイテムタイプフィールドを検索 | Azure DevOps からのプロセス別に作業アイテムタイプのすべてのフィールドのリストを取得します。 | |
| チームに反復を投稿 | Azure DevOps 反復を Azure DevOps チームに追加します。 | |
| レポート作業アイテムのリビジョン (Reporting Work Items Revisions) | バッチ処理用のレポート作業アイテムのリビジョンを追加します。 | |
| 反復を更新 | Azure DevOps 反復を更新します。 | |
| プロジェクトストリームを検索 | すべての Azure DevOps プロジェクトのリストを取得します。 | |
| プロセス別の作業アイテムタイプを取得 | 必要な Azure DevOps プロセスのすべての作業アイテムタイプのリストを取得します。 | |
| 作業アイテムタイプを取得 | 必要な Azure DevOps プロジェクトのすべての作業アイテムタイプのリストを取得します。 | |
| パスでエリアを検索 | プロジェクトのエリアをそのパスで取得します。 | |
| チームのエリアパスを検索 | チームのすべてのエリアパスを取得します。 | |
| エリアパスを検索 | プロジェクト内のすべてのエリアパスを取得します。 | |
| 作成可能フィールドを検索 | 必要な Azure DevOps プロジェクトのすべてのフィールドのリストを取得します。 | |
| 編集可能フィールドを検索 | 必要な作業アイテムのすべてのフィールドのリストを編集用に取得します。 | |
| パスで反復を検索 | パスで反復を取得します。 | |
| 反復パスを検索 | プロジェクトのすべての反復パスを取得します。 | |
| チームの反復パスを検索 | チームのすべての反復パスを取得します。 | |
| プロセスを検索 | すべての Azure DevOps プロセスのリストを取得します。 | |
| 作業アイテムを検索 | 作業アイテムのリストを取得します。 | |
| チーム設定を検索 | チームのバックログとデフォルトの反復設定を取得します。 | |
| チームを検索 | プロジェクト内のすべてのチームを取得します。 | |
| 作業アイテムデータを ID で検索 | 作業アイテムのすべてのデータを取得します。 | |
| 作業アイテム関係を ID で検索 | 作業アイテムのすべての関係を取得します。 | |
| プロセス別の作業アイテムタイプフィールドを検索 | Azure DevOps からプロセス別の作業アイテムタイプのすべてのフィールドのリストを取得します。 | |
| 作業アイテムタイプを検索 | 必要な Azure DevOps プロジェクトのすべての作業アイテムタイプのリストを取得します。 | |
| プロセス別の作業アイテムタイプを検索 | Azure DevOps からプロセス別のすべての作業アイテムタイプのリストを取得します。 | |
| Wiql でクエリを検索 | Wiql を指定してクエリの結果を取得します。 | |
| 作業アイテム管理 | 作業アイテム間のリンクを作成 | 作業アイテム間に親子関係を作成します。 |
| 作業アイテムを作成 | Azure DevOps クラウドのインスタンスに新しい作業アイテムを作成します。作業アイテムは、組織での Azure DevOps のカスタマイズ方法に応じて、特定の作業アイテムタイプまたはカスタム作業アイテムタイプにすることができます。 | |
| サービスフックを作成 | Azure DevOps サービスフックの新しいサブスクリプションを作成します。 | |
| 作業アイテムを削除 | Azure DevOps インスタンスの必要な作業アイテムを削除します。 | |
| 作業アイテム間のリンクを削除 | 作業アイテム間のリンクを削除します。 | |
| 作業アイテムを更新 | Azure DevOps クラウドのインスタンス内の作業アイテムを更新します。 | |
| 作業アイテムプロジェクトの詳細を更新 | 同じ組織内のプロジェクト間を移動します。 | |
| 添付ファイルの追加 | ServiceNow レコードに関連付けられた添付ファイルを、Azure DevOps インスタンスの必要な作業アイテムに追加します。 |
スポークのトリガー
ServiceNow は、トリガーを作成する Azure DevOps インスタンスの特定のイベントをサポートしています。最初に、サポートされているトリガー定義を含むフローを構成する必要があります。作業アイテムにコメントが追加されるなどのイベントが Azure DevOps で発生すると、Webhook を介してペイロードが ServiceNow インスタンスに送信されます。その後、ワークフローを自動化するために構成したフローが ServiceNow インスタンスでトリガーされます。サポートされているイベントは次のとおりです。
| カテゴリ | トリガー | 定義 |
|---|---|---|
| 作業アイテム管理 | コメントされた作業アイテム | 作業アイテムにコメントが追加されると、トリガーが開始されます。 |
| 作業アイテムが作成されました | 新しい作業アイテムが作成されると、トリガーが開始されます。 | |
| 作業アイテムが削除されました | 作業アイテムが削除されると、トリガーが開始されます。 | |
| 作業アイテムが復元されました | 作業アイテムが新しく復元されると、トリガーが開始されます。 | |
| 作業アイテムが更新されました | 作業アイテムが変更されると、トリガーが開始されます。 |
利用可能な AI エージェント
Now Assist for スポークをインストールし、利用可能な AI エージェントの使用を開始します。詳細については、「Now Assist for スポーク」を参照してください。
- ServiceNowエージェントシステムでは、目標を実行するために、一連の大規模言語モデル (LLM) 命令と 1 つ以上のスタンドアロン AI エージェントで構成されるエージェントワークフローを作成できます。AI エージェントを追加して要件に従ってエージェントワークフローを作成し、必要なトリガーを提供する方法については、 Create an agentic workflow を参照してください。
他の利用可能な AI エージェントを検索して、エージェントワークフローに追加することもできます。詳細については、「Find AI agents」を参照してください。
- 必要なスポーク AI エージェントのクローンを作成し、要件に応じてカスタマイズできます。クローンの作成の詳細については、 Duplicate an AI agent を参照してください。
- AI エージェントの詳細については、 Now Assist AI agents を参照してください。
| AI エージェント | 説明 |
|---|---|
| Microsoft Azure DevOps ボードコアプロセス管理 AI エージェント | コア プロセス管理タスク (つまり、プロジェクト ストリームの検索、エリア パスの検索、チームのエリア パスの検索、プロセス別の作業項目の種類の検索、チーム設定の検索、パスによるイテレーションの検索、ID による作業項目データの検索、作成可能なフィールドの検索、作業項目の種類の検索、 チームのイテレーション パスの検索、プロセスの検索、編集可能なフィールドの検索、パスによるエリアの検索、チーム イテレーションの削除、ID による作業項目関係の検索、Wiql によるクエリの検索、イテレーションの作成、プロセスによる作業項目の種類フィールドの検索、チームの検索、チームへのイテレーションの投稿、 Microsoft Azure DevOps ボードで反復パスの検索、反復の更新、反復の削除) を行います。 |
| Microsoft Azure DevOps ボード作業アイテム管理 AI エージェント | ボードで作業アイテム管理タスク (添付ファイルの追加、作業項目の削除、作業項目間のリンクの作成、サービス フックの作成、作業項目間のリンクの削除、作業項目プロジェクトの詳細の更新) を管理しますMicrosoft Azure DevOps 。 |
- Now Assistアプリケーションとともにインストールされた AI エージェントが、エージェント型ワークフローで使用されていない可能性があります。インスタンスで利用可能なすべてのエージェントを表示する方法については、「 AI エージェントの検索」を参照してください。
- インスタンスにインストールされていない可能性のあるエージェントを見つけるには、ServiceNow Store の AI エージェントマーケットプレイスにアクセスしてください。
接続および資格情報エイリアスの要件
統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。
フロー、サブフロー、およびアクションで異なる接続を使用する場合は、子エイリアスを作成し、デフォルトのエイリアスレコードをその親として選択します。子エイリアスを設定するには、親エイリアスの設定に必要な同じ手順を実行します。要件と設定に応じて、フロー、サブフロー、およびアクションで親エイリアスまたは子エイリアスのいずれかを選択できます。
複数の Azure DevOps アカウントを使用することもできます。この場合、認証情報レコードを構成するときにそれぞれのパスワードを指定し、接続レコードを構成するときに関連する接続 URL を指定する必要があります。
- OAuth を使用して Microsoft Azure DevOps Boards スポークを設定する場合は、「OAuth を使用した Microsoft Azure DevOps Boards スポークの設定」を参照してください。
- 個人用アクセストークンを使用して Microsoft Azure DevOps Boards スポークを設定する場合は、「個人用アクセストークンを使用した Microsoft Azure DevOps Boards スポークの設定」を参照してください。