Azure DevOps モジュール

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

シナリオの作成手順が必要な場合は、 Adobe Workfront Fusion でのシナリオの作成を参照してください。

モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。

アクセス要件

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

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

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

または

従来のライセンス要件: Workfront Fusion for Work Automation and Integration

製品

現在の製品要件:Select または Prime Adobe Workfront プランをご利用の場合、この記事で説明されている機能を使用するには、Adobe Workfront に加えて Adobe Workfront Fusion も組織で購入する必要があります。Workfront Fusion は Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明されている機能を使用するには、Adobe Workfront に加えて Adobe Workfront Fusion も組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

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

前提条件

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

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

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

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

  3. 「接続タイプ」フィールドで、「Azure DevOps」を選択します。

    note important
    IMPORTANT
    「Azure DevOps (すべてのスコープをリクエスト)」接続タイプは、近い将来廃止される予定です。したがって、使用はお勧めしません。
  4. 次のフィールドに入力します。

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name 作成する接続の名前を入力します。
    Organization Azure DevOps アプリケーションを作成した組織の名前を入力します。
  5. 続行」をクリックして接続の設定を終了し、シナリオの作成を続けます。

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

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

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

トリガー

作業項目の監視

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

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

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

Webhook

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

トリガーモジュールの web フックについて詳しくは、インスタントトリガー(web フック):Adobe Workfront Fusionを参照してください。

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

アクション

カスタム API 呼び出し

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

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

Connection
Azure DevOps アカウントを Workfront Fusion に接続する手順については、この記事の 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 リクエストメソッド:Adobe Workfront Fusion を参照してください。
Headers

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

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

Query String

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

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

Body

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

メモ:

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

レコードの読み取り

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

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

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

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

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

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

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

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

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

レコードを作成

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

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

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

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

  • Project

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

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

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

    • 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:これらのフィールドには、特定のプロパティに対して作業アイテムに含める値を入力します。使用可能なフィールドは、作業アイテムのタイプによって異なります。](https://docs.microsoft.com/en-us/azure/devops/boards/work-items/guidance/choose-process?view=azure-devops&tabs=basic-process)

作業アイテムを更新

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

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

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

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

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

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

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

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

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

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

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

作業アイテムをリンク

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

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

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

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

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

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

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

検索

作業アイテムのリスト

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

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

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

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