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

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

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

  2. Connection フィールドの横にある「Add」をクリックします。

  3. 「Connection Type」フィールドで「Azure DevOps」を選択します。

    note important
    IMPORTANT
    Azure DevOps (Request All Scopes) 接続タイプは、近い将来に非推奨となる予定です。 したがって、使用はお勧めしません。
  4. 次のフィールドに入力します。

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name 作成する接続の名前を入力します。
    Organization Azure DevOps アプリケーションを作成した組織の名前を入力します。
  5. Azure DevOps アプリ ID またはクライアントシークレットを入力するには、「 詳細設定を表示 」をクリックし、開いたフィールドに入力します。

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

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

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

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

マップ切り替え

トリガー

Watch for work items

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

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

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

Webhook

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

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

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

アクション

Create a record

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

モジュールは、新しく作成された作業アイテムのオブジェクト 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:これらのフィールドで、指定したプロパティに作業項目に設定する値を入力します。 使用可能なフィールドは、作業アイテムのタイプによって異なります。

Custom API Call

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

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

Connection
Azure DevOps アカウントを Workfront Fusion に接続する方法については、この記事のAzure DevOps を Workfront Fusion に接続を参照してください。
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 で使用する場合は、条件文を引用符で囲みます。

Download an attachment

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

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

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

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

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

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

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

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

Read record

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

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

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

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

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

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

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

  • Work item:読み取る作業項目が含まれているプロジェクトを選択してから、作業項目のタイプを選択します。

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

Update a work item

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

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

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

Upload an attachment

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

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

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

検索

List work items

このアクションモジュールは、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
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3