新しい Web フォームのロール アウトの管理

TFS 2017

重要

利用可能な機能: 新しいフォームとそれに対応する機能は、web ポータルの TFS 2017 以降のバージョンで使用できます。

  • オンプレミスの TFS 2017 以降のバージョンでは、プロジェクトをコレクションに追加すると、新しいフォームが自動的に使用できるようになります。 既存のプロジェクトの場合は、この記事で説明されているように、管理者が新しいフォームを有効にする必要があります。 (新しいフォームが既存のプロジェクトに対して自動的に有効にならない理由は、既存の作業項目の種類に対して行われたカスタマイズが上書きされないようにするためです)。
  • TFS 2015 以前のバージョンでは、新しいフォームは使用できません。 新しいフォームにアクセスするには、 TFS 2017 以降のバージョンにアップグレード する必要があります。

新しいフォームを有効にすると、プロジェクトコレクションで定義されているすべての作業項目の種類 (Wit) のフォーム定義の変換が開始されます。

ロールアウトプロセスを開始するには、最初に新しいフォームを有効にします。 その後、変換された web フォームのレイアウトを確認し、必要に応じて調整したり、カスタマイズを追加したりすることができます。

新しいフォームをロールアウトする準備ができたら、ユーザーが新しいフォームの使用を開始できるようにするオプトインモデルを選択します。 最後に、古い web フォームに戻す必要がある場合は、それを行うことができます。

新しいフォームを有効にする

新しいフォームは、[プロジェクトコレクションの管理] ページから有効にします。

  1. 開始するには、歯車設定アイコンをクリックして、 プロジェクトコレクションの管理コンテキストを開きます。

    TFS 2017, Web portal, Open project collection admin context
  2. コレクション管理ページで、[ 新しい作業項目フォームを有効にする] をクリックします。

    TFS 2017, Web portal, Project collection admin context, Enable new form

    有効にするオプションが表示されない場合は、Project コレクション管理者グループのメンバーではありません。 1つとして追加するには、「 管理者の追加」を参照してください。

  3. [ 新しいレイアウトの作成 ] をクリックして、WIT 定義の変換プロセスを開始します。

    Enable the new work item form layout dialog

新しい web フォームを確認する

既定のオプトインモデルでは、すべてのプロジェクトの Project Administrators グループのメンバーに対して新しいフォームが有効になります。 オプトインモデルを変更する前に、web フォームをレビューして、必要なフィールドと関数が表示されていることを確認します。

各種類の作業項目を開いて、新しいフォームレイアウトを確認します。 ここでは、ユーザーストーリーを開きます。 新しいフォームを表示するように切り替えます。

ユーザーストーリー、新しいフォームへの切り替え

切り替えを行うと、このプロジェクトのすべての作業項目の種類が新しいフォームに表示されます ( 元に戻す場合を除きます)。

新しいフォーム、ユーザーストーリー

作業項目が既に開いている場合は、ブラウザーを更新して変更を確認します。

レイアウトをカスタマイズするには、「 新しいフォームをカスタマイズする」を参照してください。

ロールアウトに使用するオプトインモデルを選択する

新しいフォームレイアウトが予想どおりにプレビューされると、ロールアウトを開始できます。

ニーズをサポートするオプトインモデルを選択します。

  • オプトイン機能を有効にし、ユーザーが古いフォームに切り替えることができるようにする場合は、[ すべてのユーザーに対してオプトインを有効 にする] を選択します。
  • すべてのユーザーが新しいフォームの使用をすぐに開始するようにする場合は、[ 新しいフォームのみ ] オプションを選択します。
Choose the opt-in mode for the new form dialog

[ すべてのユーザーに対してオプトインを有効 にする] を選択した場合、ユーザーは新しいフォームビューに変換するタイミングを選択できます。

古い web フォーム、ユーザーストーリー、[新しいフォームを試す] オプション

このスイッチはユーザーごとに設定されるため、他のアカウントユーザーは、切り替えを選択するまで古いフォームを引き続き表示します。 スイッチを作成した後は、スイッチを戻すことができます。

新しい web フォーム、ユーザーストーリー、[古いフォームに戻る] メニューオプション

新しい web フォームレイアウトを使用して、すべての作業項目が自動的に表示されます。

新しい 作業項目エクスペリエンス トピックをユーザーと共有して、使用可能な新しいコントロールとレイアウトをよりよく理解できるようにします。

新しいフォームを無効にする

古い WIT フォームに戻す必要があることがわかった場合は、これを行うことができます。

Disable new form dialog

新しいフォームを無効にすると、コレクション内のすべてのプロジェクト内で定義されているすべての Wit の XML 定義ファイルから WebLayout セクションが削除されます。

ベストエフォート変換

カスタマイズした WIT 定義のフィールドのグループ化とレイアウトを維持するために、ベストエフォート変換が行われます。 次の種類の変換が行われます。

変換または追加された要素

  • レイアウトがである場合は Target=WebWebLayout定義に変換されます。
  • レイアウトセクションが1つだけの場合は、 WebLayout定義を含む新しいセクションが追加されます。
  • すべての親タブページに変換されます
  • タブ内の入れ子になっていないすべてのグループグループに変換されます。これらのグループが4つ以上ある場合は、一部が1つのグループに結合されます。
  • グループ内の入れ子になったグループはすべてグループのままです
  • すべてのHtmlfieldcontrol要素とwebpagecontrol要素は、ページ内の最初のセクションに移動されます。

削除された要素と属性

  • すべての スプリッター 要素が削除されます
  • 次の型指定を使用して、フォームヘッダーおよび コントロール 要素内のすべての要素が、 WebLayout セクションから削除されます。

    • AttachmentsControl
    • LinksControl
    • WorkItemClassificationControl
    • WorkItemLogControl

    これらの要素はシステムで管理されるようになり、各作業項目フォーム内のヘッダーセクション領域に自動的に追加されるため、'必要ありません。

  • 次の属性は、各 コントロール 要素および グループ 要素から削除されます。
    • ControlSpacing
    • FixedWidth
    • LabelSpacing
    • Margin
    • MinimumSize
    • Padding
    • PercentWidth

プロセスを元に戻す

プロセスを元に戻すと、すべての Wit の XML 定義が元の定義に戻ります。 すべてのユーザーは、古いフォームレイアウトのみを表示できます。