Azure DevOps モジュール

Adobe Workfront Fusion のシナリオでは、Azure DevOps を使用するワークフローを自動化したり、複数のサードパーティのアプリケーションやサービスに接続したりできます。

シナリオの作成方法については、 シナリオの作成:記事のインデックスの記事を参照してください。

モジュールについて詳しくは、「 モジュール:記事インデックス」の記事を参照してください。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ 任意
Adobe Workfront プラン

新規:標準

または

現在:仕事以上

Adobe Workfront Fusion ライセンス**

現在:Workfront Fusion ライセンス要件なし

または

従来のバージョン:作業の自動化と統合のためのWorkfront Fusion

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Azure DevOps モジュールを使用するには、Azure DevOps アカウントが必要です。

Azure DevOps API 情報

Azure DevOps コネクタでは、次を使用します。

API バージョン
v5.1
API タグ
v1.29.33

Azure DevOps を Workfront Fusion に接続 connect-azure-devops-to-workfront-fusion

  1. Azure DevOps モジュールをシナリオに追加します。

  2. 「接続」フィールドの横にある「追加」をクリックします。

  3. ​ 接続タイプ ​ フィールドで、使用する接続のタイプを選択します。

    note note
    NOTE
    Azure DevOps (EntraApp)を使用すると ​ 接続のすべてのスコープをリクエストできます。
  4. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
    Connection name 作成する接続の名前を入力します。
    Organization Azure DevOps アプリケーションを作成した組織の名前を入力します。
    App ID 接続先の DevOps アプリケーションの ID を入力します。
    Client Secret 接続先の DevOps アプリケーションのクライアント秘密鍵を入力します。
    すべてのスコープを要求 ​ Azure DevOps (EntraApp)接続タイプを使用している場合、このオプションを有効にして接続用のすべてのスコープをリクエストします。
  5. Azure DevOps アプリ ID またはクライアントシークレットを入力するには、「 詳細設定を表示 」をクリックし、開いたフィールドに入力します。

  6. 続行」をクリックして接続の設定を終了し、シナリオの作成を続けます。

Azure DevOps モジュールとそのフィールド

Azure DevOps モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Azure DevOps」フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。

マップ切り替え

トリガー

作業項目の監視

このインスタントトリガーモジュールは、Azure DevOps でレコードが追加、更新または削除されたときにシナリオを実行します。

このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Webhook

モジュールの web フックを選択または追加します。

トリガーモジュールの Webhook について詳しくは、 インスタントトリガー(Webhook)を参照してください。

Web フックの作成方法については、Web フックを参照してください。

アクション

レコードを作成

このアクションモジュールは、新しいプロジェクトまたは作業アイテムを作成します。

モジュールは、新しく作成された作業アイテムのオブジェクト ID、または新しく作成されたプロジェクトの URL とステータスコードを出力します。

Connection
Azure DevOps アカウントをWorkfront Fusion に接続する手順については、この記事の UICONTROL Workfront Fusion への Azure DevOps の接続 ] を参照してください。
Record type

作業アイテムを作成するか、プロジェクトを作成するかを選択します。

  • Project

    次のフィールドに入力します。

    • 名 ​:新しいプロジェクトの名前を入力またはマッピングします。

    • 説明 ​:新しいプロジェクトの説明を入力またはマッピングします。

    • Visibility:プロジェクトを公開または非公開にするかを選択します。ユーザーが非公開プロジェクトとやり取りするには、組織にサインインし、プロジェクトへのアクセス権を付与されている必要があります。公開プロジェクトは、組織にサインインしていないユーザーに表示されます。

    • Version control:プロジェクトでバージョン管理にGitまたはTeam Foundation Version Control (TFCV)を使用するかどうかを選択します。

    • Work item process:プロジェクトに使用する作業プロセスを選択します。Basic、Scrum、Capability Maturity Model Integration (CMMI)、Agileを選択できます。

      Azure DevOps のプロセスについて詳しくは、 ドキュメントのデフォルトのプロセスとプロセステンプレート Azure DevOps を参照してください。

  • Work item

    次のフィールドに入力します。

    • Project:作業アイテムを作成するプロジェクトを選択します。

    • Work item type:作成する作業アイテムのタイプを選択します。

    • Other fields:これらのフィールドには、作業項目に設定する特定のプロパティの値を入力します。 使用可能なフィールドは、作業アイテムのタイプによって異なります。

カスタム API 呼び出し

このアクションモジュールは、Azure DevOps API に対して認証済みのカスタム呼び出しを実行します。これにより、他の Azure DevOps モジュールでは不可能なデータフロー自動処理を作成できます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Azure DevOps アカウントをWorkfront Fusion に接続する手順については、この記事の UICONTROL Workfront Fusion への Azure DevOps の接続 ] を参照してください。
Base URL
Azure DevOps アカウントへの接続に使用するベース URL を選択またはマッピングします。
Relative URL

この API 呼び出しの接続先となる相対 URL を入力します。

例:{organization}/_apis[/{area}]/{resource}

API Version
この API 呼び出しの接続先となる Azure DevOps API のバージョンを選択またはマッピングします。バージョンを選択していない場合、Workfront Fusion は Azure DevOps API バージョン 5.1 に接続します。
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Query String

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

例: {"name":"something-urgent"}

Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

添付ファイルのダウンロード

このアクションモジュールは、添付ファイルをダウンロードします。

このモジュールは、添付ファイルのファイルコンテンツを返します。

Connection
Azure DevOps アカウントをWorkfront Fusion に接続する手順については、この記事の UICONTROL Workfront Fusion への Azure DevOps の接続 ] を参照してください。
Attachment URL
ダウンロードする添付ファイルの URL を入力またはマッピングします。

作業アイテムをリンク

このアクションモジュールは、2 つの作業アイテムをリンクし、それらの間の関係を定義します。

Connection
Azure DevOps アカウントをWorkfront Fusion に接続する手順については、この記事の UICONTROL Workfront Fusion への Azure DevOps の接続 ] を参照してください。
Work item ID
別の作業アイテムをリンクするメイン作業アイテムの ID を入力またはマッピングします。
Linked work item ID
メインの作業アイテムにリンクする作業アイテムの ID を入力またはマッピングします。
Link Type

リンクする作業アイテム間の関係を定義します。

詳しくは、Azure DevOps ドキュメントの リンクタイプのリファレンスガイドを参照してください。

Comment
コメントのテキストを入力またはマッピングします。これは、リンクの根拠や意図を説明するのに役立ちます。

レコードの読み取り

このアクションモジュールは、Azure DevOps の単一レコードからデータを読み取ります。

レコードの ID を指定します。

このモジュールは、レコードの ID および関連するフィールドと共に、接続を介してアクセスされるカスタムフィールドとその値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Azure DevOps アカウントをWorkfront Fusion に接続する手順については、この記事の UICONTROL Workfront Fusion への Azure DevOps の接続 ] を参照してください。
Record type

プロジェクトを読み取るか作業アイテムを読み取るかを選択

  • プロジェクト ​:読み取るプロジェクトを選択します。

  • Work item:読み取る作業アイテムを含むプロジェクトを選択し、作業アイテムのタイプを選択します。

Outputs
このモジュールの出力バンドルに含める情報を選択します。使用可能なフィールドは、作業アイテムのタイプによって異なります。
ID
読み取るレコードの ID を入力またはマッピングします。

作業アイテムを更新

このアクションモジュールは、ID を使用して既存の作業アイテムを更新します。

このモジュールは、更新された作業アイテムの ID を返します。

Connection
Azure DevOps アカウントをWorkfront Fusion に接続する手順については、この記事の UICONTROL Workfront Fusion への Azure DevOps の接続 ] を参照してください。
Project
更新する作業アイテムを含むプロジェクトを選択します。
Work Item Type
更新する作業アイテムのタイプを選択します。
Other Fields
これらの各フィールドに、特定のプロパティに対して作業アイテムに与える値を入力します。使用可能なフィールドは、作業アイテムのタイプによって異なります。
Work item ID
更新する作業アイテムの ID を入力またはマッピングします。

添付ファイルをアップロード

このアクションモジュールは、ファイルをアップロードし、作業アイテムに添付します。

モジュールは、添付ファイルの添付ファイル ID とダウンロード URL を返します。

Connection
Azure DevOps アカウントをWorkfront Fusion に接続する手順については、この記事の UICONTROL Workfront Fusion への Azure DevOps の接続 ] を参照してください。
Project
添付ファイルをアップロードするプロジェクトを選択します。
Work item ID
添付ファイルをアップロードする作業アイテムの ID を入力またはマッピングします。
Comment
アップロードされた添付ファイルに追加するコメントのテキストを入力します。
Source file
前のモジュールからソースファイルを選択するか、ソースファイルの名前と内容を入力またはマッピングします。

検索

作業アイテムのリスト

このアクションモジュールは、Azure DevOps プロジェクトの特定のタイプのすべての作業アイテムを取得します。

このモジュールは、主な作業アイテムの ID と関連するフィールドのほか、接続でアクセスするカスタムフィールドと値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Azure DevOps アカウントをWorkfront Fusion に接続する手順については、この記事の UICONTROL Workfront Fusion への Azure DevOps の接続 ] を参照してください。
Project
作業アイテムを取得するプロジェクトを選択します。
Work item type
取得する作業アイテムのタイプを選択します。
Outputs
モジュールの出力に表示するプロパティを選択します。使用可能なフィールドは、取得する作業アイテムのタイプによって異なります。1 つ以上のプロパティを選択する必要があります。
Limit
Workfront Fusion が 1 つの実行サイクルで返す作業項目の最大数を入力またはマッピングします。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3