チェックイン ポリシーの追加

  • [アーティクル]

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Team Foundation バージョン管理の管理者は、チェックイン ポリシーの要件を追加できます。 これらのチェックイン ポリシーは、ソース管理へのチェックインを実行するときにアクションを実行することをユーザーに求めます。 たとえば、ユーザーは作業項目を変更セットに関連付けることが求められる可能性があります。 チェックインの詳細については、「コードの開発と保留中の変更の管理」を参照してください。

注意

Visual Studio のチェックイン ポリシーは、この記事に記載されている Team Explorer、tf.exe configure コマンド、または Visual Studio 拡張機能の pkgdef で宣言されたレジストリ キー経由で設定できます。 ポリシーは、コンピューター上の Visual Studio の 1 つのインストールにのみ適用されます。 Visual Studio のインストールが複数ある場合は、インストールごとにチェックイン ポリシーを設定する必要があります。

チェックイン ポリシーを作成する

  1. Visual Studio Team Explorer で、[設定] を選択し、[チーム プロジェクト] の下にある [ソース管理] を選択します。

  2. [ソース管理の設定] ダイアログ ボックスで、[チェックイン ポリシー] タブを選択し、[追加] を選択します。

  3. [チェックイン ポリシーの追加] ダイアログ ボックスで、目的のポリシーの種類を選択し、[OK] を選択します。

    次のポリシーから選択できます。

    • [ビルド] 新しい変更をチェックインするには、最後のビルドが成功していた必要があります。
    • [変更セットのコメント ポリシー] ユーザーがチェックコメントを指定する必要があります。
    • [Code Analysis] コードをチェックインする前にコード分析を実行する必要があります。
    • [カスタム パスのポリシー] 他のポリシーのスコープを特定のフォルダーまたはファイルの種類に設定します。
    • [禁止されたパターンのポリシー] ファイル名パターンが禁止されているファイルを含むチェックインを防止します。
    • [作業項目クエリ ポリシー] 結果がチェックインに関連付ける唯一の有効な作業項目である作業項目クエリを指定します。
    • [作業項目] 1 つ以上の作業項目をチェックインに関連付ける必要があります。

  4. [Code Analysis] を選択した場合は、Code Analysis ポリシー エディターで、目的のコード分析の種類のチェック ボックスをオンにし、[OK] を選択します。

    オプションは次のとおりです。

    • 現在のソリューションの一部であるファイルのみのチェックインを強制
    • C/C++ コード分析 (/analyze) を強制
    • マネージド コードのコード分析を強制。 このオプションを選択した場合は、[マネージド コード分析の規則設定] で目的のルール セットを選択します。

    コード分析ツールの使用方法の詳細については、コード分析のチェックイン ポリシーの作成に関する記事を参照してください。

  5. [カスタム パスのポリシー] を選択した場合、[カスタム パスのポリシー] ダイアログ ボックスで、操作する子ポリシーを選択し、[ソース管理パス フィルター (RegEx)] に 1 つ以上の値を入力して、許可するパスを指定します。 値ごとに [追加] を選択し、[OK] を選択します。

    カスタム パスを使用する子ポリシーごとに別個の [カスタム パスのポリシー] を適用します。

    注意

    このポリシーを有効になっている子ポリシーに適用すると、"選択したポリシーは現在有効です。無効にしないと、ポリシーを 2 回実行することになります。" というメッセージが表示されます。[チェックイン ポリシー] 画面で元のポリシーを削除または無効にできます。

  6. [禁止されたパターンのポリシー] を選択した場合、[禁止されたパターン] ダイアログ ボックスに禁止するパターンの一覧を入力し、[OK] を選択します。

  7. [作業項目クエリ ポリシー] を選択した場合は、[クエリ ポリシー] ダイアログ ボックスで、保存した共有作業項目クエリを参照して選択し、[OK] を選択します。

  8. チェックイン ポリシーの設定に問題がなければ、[OK] を選択します。 今後のチェックインの新しいチェックイン ポリシーが表示されます。