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 Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ Workfront Ultimate Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 Work またはそれ以上 |
| Adobe Workfront Fusion ライセンス |
オペレーションベース：オペレーションベースのライセンスを持つ組織で使用できます コネクターベース（レガシー）：Workfront Fusion for Work Automation および Integration |
| 製品 | 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
Azure DevOps モジュールを使用するには、Azure DevOps アカウントが必要です。
Azure DevOps API情報
Azure DevOps コネクタでは、次の機能が使用されます。
Azure DevOps を Workfront Fusion に接続 connect-azure-devops-to-workfront-fusion
EntraAppを使用してAzure DevOpsをWorkfront Fusionに接続する
-
Azure DevOps モジュールをシナリオに追加します。
-
「接続」フィールドの横にある「追加」をクリックします。
-
「接続タイプ 」フィールドで、使用する接続タイプを選択します。
note NOTE Azure DevOps （EntraApp） を使用すると、接続のすべてのスコープをリクエストできます。 -
次のフィールドに入力します。
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）接続タイプを使用している場合は、このオプションを有効にして、接続のすべてのスコープを要求します。 -
Azure DevOps アプリ IDまたはクライアントシークレットを入力するには、詳細設定を表示をクリックし、開いているフィールドに入力します。
-
「続行」をクリックして接続の設定を終了し、シナリオの作成を続けます。
サービスプリンシパルを使用してAzure DevOpsをWorkfront Fusionに接続する
個人アカウントの代わりにサービスプリンシパル（アプリケーション API接続）を使用する接続を作成できます。 これは、接続を特定のユーザーではなく、アプリケーションまたはサービス IDとして実行する場合に便利です。 これは、例えば、その人が会社を辞めたり、パスワードを変更したりしても、統合が壊れないことで役立つ可能性があります。
この接続タイプは、すべてのAzure DevOps モジュールで使用できます。
サービスプリンシパルを使用してAzure DevOpsをWorkfront Fusionに接続するための前提条件
この接続を作成するには、次のものが必要です。
- グローバル管理者または アプリケーション管理者 がMicrosoft Entra IDでアクセスし、アプリを登録します。 このアクセス権をお持ちでない場合は、IT チームまたはID チームの誰かにその手順を完了するように依頼してください。
- Project Collection Administratorは、Azure DevOps組織でアクセスし、サービスプリンシパルをメンバーとして追加します。 これは、多くの場合、Microsoft Entra IDを管理する人とは異なる人物です。
- Azure DevOps組織の名前。 AzureのDevOps URL:
dev.azure.com/<your organization name>で確認できます。
Microsoft Entra IDでアプリ登録を作成する
- Microsoft Entra管理センターにログインします。
- アプリ登録 > 新規登録に移動します。
- アプリに明確で認識可能な名前を付けます。 例：
Workfront Fusion Azure DevOps Integration - リダイレクト URIを空白のままにします。 この接続には、ブラウザーを介したログインは含まれません。
- 登録を選択します。
- 引き続き クライアントシークレットの作成を続行します。
クライアントシークレットの作成
- 新しいアプリの登録で、証明書とシークレットに移動します。
- 新しいクライアントシークレットを選択し、説明を追加して、有効期限を選択します。
- 「追加」を選択します。
- 秘密鍵の 値 をすぐにコピーします。 1回だけ表示されます。 コピーする前に移動する場合は、新しいコピーを作成する必要があります。
- 引き続き接続の詳細を収集してください。
接続の詳細を収集
-
アプリ登録の概要 ページから、次の値に注意してください。 モジュールで接続を作成する際に、これらの項目を入力します。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header テナント ID 概要ページで、 ディレクトリ （テナント） IDというラベルが付いています。 Client ID 概要ページに「 アプリケーション （クライアント） ID」というラベルが付いています。 Client Secret でコピーした値は、クライアントシークレットを作成します。 Organization Azure DevOps組織名。 例えば、URLが dev.azure.com/yourorgの場合は、yourorgと入力します。note NOTE アプリ登録の API権限 領域をスキップできます。 そこにAzure DevOpsを追加した場合、委任された権限のみが使用できます。 アプリケーション権限がグレー表示されます。 Azure DevOpsでは、この方法でのアクセス許可はサポートされていないため、これは予想されます。 代わりに、次のパートでAzure DevOps内で直接アクセスが許可されます。
Azure DevOps組織にサービスプリンシパルを追加します
Microsoft Entra IDにアプリを登録すると、そのIDのみが作成されます。 Azure DevOps データへのアクセス権はまだアプリに付与されません。 この手順により、そのアクセス権が付与されます。
-
Azure DevOps組織（
dev.azure.com/<your organization name>）にログインします。 -
左下の「組織の設定」を選択し、「ユーザー」を選択します。
-
「ユーザーを追加」を選択します。
-
検索ボックスで、アプリの表示名（アプリ登録時に指定した名前）で検索します。 クライアント IDで検索しないでください。
-
アクセスレベルを選択します。
- Basicは、通常、作業項目、ボード、リポジトリの読み取りと書き込みに十分です。
- ワークフローで、セットアップの一環としてアジャイル、スクラム、カスタムテンプレートなどの利用可能なプロセスを参照する必要がある場合は、代わりにプロジェクトコレクション管理者 グループにサービスプリンシパルを追加します。 より幅広いレベルのアクセス権を持つため、その機能が必要な場合にのみ許可してください。
-
組織の通常のアクセス方法に従って、必要な特定のプロジェクトまたはプロジェクトにサービスプリンシパルを割り当てます。
-
「追加」を選択します。
-
引き続き接続を作成します。
接続の作成
-
モジュールの接続設定画面で、サービスプリンシパル接続タイプを選択します。
-
以下の情報を入力します。
- テナント ID
- クライアント ID
- クライアント秘密鍵
- 組織
-
接続を保存します。
すべてが正しく設定されていれば、接続は正常に検証されます。
Azure DevOps モジュールとそのフィールド
Azure DevOps モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。 これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Azure DevOps」フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、モジュール間での情報のマッピングを参照してください。
トリガー
作業項目の監視
このインスタントトリガーモジュールは、Azure DevOps でレコードが追加、更新または削除されたときにシナリオを実行します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
アクション
レコードの作成
このアクションモジュールは、新しいプロジェクトまたは作業アイテムを作成します。
モジュールは、新しく作成された作業アイテムのオブジェクト ID、または新しく作成されたプロジェクトの URL とステータスコードを出力します。
カスタム API 呼び出し
このアクションモジュールは、Azure DevOps API に対して認証済みのカスタム呼び出しを実行します。 これにより、他の Azure DevOps モジュールでは不可能なデータフロー自動処理を作成できます。
このモジュールを設定する際には、次のフィールドが表示されます。
この API 呼び出しの接続先となる相対 URL を入力します。
例：{organization}/_apis[/{area}]/{resource}
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。
例： {"Content-type":"application/json"}
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
例： {"name":"something-urgent"}
標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。
メモ：
if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。
添付ファイルのダウンロード
このアクションモジュールは、添付ファイルをダウンロードします。
このモジュールは、添付ファイルのファイルコンテンツを返します。
作業アイテムをリンク
このアクションモジュールは、2 つの作業アイテムをリンクし、それらの間の関係を定義します。
レコードの読み取り
このアクションモジュールは、Azure DevOps の単一レコードからデータを読み取ります。
レコードの ID を指定します。
このモジュールは、レコードの ID および関連するフィールドと共に、接続を介してアクセスされるカスタムフィールドとその値を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
作業アイテムを更新
このアクションモジュールは、ID を使用して既存の作業アイテムを更新します。
このモジュールは、更新された作業アイテムの ID を返します。
添付ファイルをアップロード
このアクションモジュールは、ファイルをアップロードし、作業アイテムに添付します。
モジュールは、添付ファイルの添付ファイル ID とダウンロード URL を返します。
検索
作業アイテムのリスト
このアクションモジュールは、Azure DevOps プロジェクトの特定のタイプのすべての作業アイテムを取得します。
このモジュールは、主な作業アイテムの ID と関連するフィールドのほか、接続でアクセスするカスタムフィールドと値を返します。 この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。