作業追跡 Web フォームをカスタマイズする

Azure DevOps Server |Azure DevOps Server 2022

この記事は、オンプレミスの Azure DevOps Server に対して Hosted XML プロセスモデルまたはオンプレミス Xml プロセスモデルを使用するときに行うことができるカスタマイズに適用されます。継承プロセスモデルについては、「プロセスのカスタマイズ」を参照してください。プロセスモデルの概要については、「作業追跡エクスペリエンスのカスタマイズ」を参照してください。

XML 定義ファイルのインポートとエクスポート

このシーケンスは、オンプレミスの XML プロセスモデルを使用し、個々の XML 定義ファイルをインポートして作業追跡のカスタマイズを管理する場合に使用します。

の更新と変更の確認

プロセス zip ファイルのインポートとエクスポート

このシーケンスは、Hosted XML プロセスモデルを使用し、プロセスまたはプロセステンプレートをインポートして作業追跡のカスタマイズを管理する場合に使用します。

の更新と変更の確認

FORM セクション

主な違いは、 FORM ノードに 2 つのメインレイアウトセクションがあるということです。 Layout 要素に含まれる最初のセクションでは、Visual Studio などのクライアントを使用してフォームレイアウトを表示するときにフォームレイアウトを定義します。 WebLayout 要素内に含まれる 2 番目のセクションでは、Web ブラウザーでフォームレイアウトを表示するときにフォームレイアウトを定義します。

<FORM>
   <Layout HideReadOnlyEmptyFields="true" HideControlBorders="true">
       . . .  
   </Layout>
   <WebLayout>
       . . .  
   </WebLayout>
</FORM>

指定されたカスタマイズを行うには、次のトピックを参照してください。

Web ポータル (WebLayout ノード) のフォームをカスタマイズするには、「 WebLayout」および「XML 要素を制御する」を参照してください。
Web ポータル (LinksControlOptions) のフォームにスコープ付きリンクコントロールを追加するには、「 LinksControlOptions XML 要素」を参照してください。
クライアントフォーム ([レイアウト ] ノード) をカスタマイズするには、「レイアウト XML 要素」を参照してください。

定義ファイルのインポートとエクスポート (オンプレミスの XML プロセス)

プロジェクトの管理アクセス許可がない場合は、それらを取得します。

「witAdmin: 作業を追跡するためのオブジェクトをカスタマイズおよび管理する」の手順に従って、コマンドプロンプトウィンドウを開きます。

例えば次が挙げられます。
```
%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer 
```
フィールドを変更または追加する WIT 定義ファイルをエクスポートします。 WIT の名前とファイルの名前を指定します。
```
witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"  
```
組織の CollectionURL の例として、 https://dev.azure.com/OrganizationName があります。
ファイルを編集します。詳細については、 WebLayout XML 要素を参照してください。

WIT 定義ファイルをインポートします。

witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

Web ポータルを開いて変更を表示します。クライアントが既に開いている場合は、ページを更新します。

最新の更新プログラムは、インポートした変更を含め、サーバーからダウンロードされます。更新が完了するまで数秒待ちます。

witadmin の使用の詳細については、「作業項目の種類のインポート、エクスポート、管理」を参照してください。

ヒント

witadmin を使用すると、定義ファイルをインポートおよびエクスポートできます。使用できるその他のツールには、プロセスエディターがあります (Visual Studio のバージョンをインストールしている必要があります)。 Visual Studio Marketplace からプロセステンプレートエディターをインストールします。

レイアウトとサイズ変更

Web フォームは、使用可能な幅と定義されているセクションの数に応じてサイズが変更されます。ほとんどの Web ブラウザーでは、ページ内の各セクションが最大幅で、独自の列内に表示されます。表示幅が小さくなると、各セクションは次のように比例してサイズが変更されます。

4 つのセクションの場合: 40%、20%、20%、20%
3 つのセクション: 50%、25%、25%
2 つのセクションの場合: 66% と 33%
1 つのセクション: 100%

表示幅が各セクションの縦棒表示に対応できない場合、フォームは列内のセクションをスタックします。

グローバルリスト

ホストされる XML は、Azure DevOps Server とは異なる方法でグローバルリストを管理します。 witadmin コマンドまたは別のグローバルリストファイルはサポートされていません。 Hosted XML では、次のコードスニペットに示すように、グローバルリストを既存の作業項目の種類にアタッチします。

<?xml version="1.0" encoding="utf-8"?>
<witd:WITD xmlns:witd="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef" application="Work item type editor" version="1.0">
  <WORKITEMTYPE name="Shared Steps" refname="Custom.SharedSteps">
    <DESCRIPTION>Server-side data for reusable set of test steps. Version: B.02</DESCRIPTION>
    <GLOBALLISTS>
      <GLOBALLIST name="Foo">
        <LISTITEM value="No" />
        <LISTITEM value="Yes" />
        <LISTITEM value="Maybe" />
        <LISTITEM value="Not Sure" />
      </GLOBALLIST>
      <GLOBALLIST name="Bar">
        <LISTITEM value="Open" />
        <LISTITEM value="Closed" />
      </GLOBALLIST>
     </GLOBALLISTS>  
     ...

既定では、グローバルリストは共有ステップの作業項目の種類にアタッチされます。

警告とエラーをインポートする

WebLayout ノードまたは Layout ノードにのみ必須フィールドの Control 要素を追加し、もう一方のフィールドには追加しない場合、変更された WIT 定義をインポートすると警告が表示されます。

新しいフォームを有効にした後、 WebLayout ノードを削除する WIT 定義を変更すると、エラーが発生します。

WIT の追加と変更

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-27