Hinzufügen von Check-In-Richtlinien

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

Visual Studio 2019 | Visual Studio 2022

Administratoren der Team Foundation-Versionskontrolle können Anforderungen für Eincheckrichtlinien hinzufügen. Diese Eincheckrichtlinien schreiben vor, dass Benutzer Maßnahmen ergreifen, wenn sie einen Eincheckvorgang in der Quellcodeverwaltung durchführen. Beispielsweise kann ein Benutzer dazu aufgefordert werden, ein Arbeitselement einem Changeset zuzuordnen. Weitere Informationen zu Eincheckvorgängen finden Sie unter Entwickeln von Code und Verwalten ausstehender Änderungen.

Hinweis

Sie können Visual Studio-Eincheckrichtlinien über Team Explorer (siehe Beschreibung in diesem Artikel), über den configure-Befehl von tf.exe oder über Registrierungsschlüssel, die in der Paketdefinition einer Visual Studio-Erweiterung deklariert sind. Richtlinien gelten nur für eine einzelne Installation von Visual Studio auf Ihrem Computer. Wenn Sie über mehrere Installationen von Visual Studio verfügen, müssen Sie die Eincheckrichtlinie für jede Installation festlegen.

Erstellen einer Eincheckrichtlinie

  1. Wählen Sie in Visual Studio Team Explorer Einstellungen und dann Quellcodeverwaltung unter Teamprojekt aus.

  2. Wählen Sie im Dialogfeld Einstellungen für Quellcodeverwaltung die Registerkarte Eincheckrichtlinie und dann Hinzufügen aus.

  3. Wählen Sie im Dialogfeld Eincheckrichtlinie hinzufügen die gewünschten Richtlinientypen und dann OK aus.

    Sie können die folgenden Richtlinien auswählen:

    • Builds: Der letzte Build muss erfolgreich durchgeführt worden sein, damit neue Änderungen eingecheckt werden können.
    • Changeset-Kommentarrichtlinie: Benutzer müssen Eincheckkommentare angeben.
    • Codeanalyse: Damit Code eingecheckt werden kann, muss eine Codeanalyse ausgeführt werden.
    • Benutzerdefinierte Pfadrichtlinie: Legt den Bereich für andere Richtlinien auf bestimmte Ordner oder Dateitypen fest.
    • Richtlinie für unzulässige Muster: Verhindert Eincheckvorgänge mit Dateien mit unzulässigen Mustern für Dateinamen.
    • Richtlinie für die Arbeitselementabfrage: Gibt eine Arbeitselementabfrage an, deren Ergebnisse die einzigen zulässigen Arbeitselemente für einen Eincheckvorgang sind.
    • Arbeitselemente: Dem Eincheckvorgang muss mindestens ein Arbeitselement zugeordnet sein.
  4. Aktivieren Sie bei Auswahl von Codeanalyse im Codeanalyserichtlinien-Editor die Kontrollkästchen für die gewünschten Codeanalysetypen, und wählen Sie dann OK aus.

    Folgende Optionen stehen zur Verfügung:

    • Check-In von Dateien erzwingen, sodass nur Dateien enthalten sind, die Teil der aktuellen Projektmappe sind
    • C/C++ Code Analysis erzwingen (/analyze):
    • Code Analysis für verwalteten Code erzwingen Wählen Sie bei Auswahl dieser Option unter Regeleinstellungen für die Analyse von verwaltetem Code den gewünschten Regelsatz aus.

    Weitere Informationen zur Verwendung von Codeanalysetools finden Sie unter Erstellen oder Aktualisieren von Standardeincheckrichtlinien für die Codeanalyse.

  5. Wählen Sie bei Auswahl von Benutzerdefinierte Pfadrichtlinie im Dialogfeld Benutzerdefinierte Pfadrichtlinie eine untergeordnete Richtlinie aus, die ausgeführt werden soll, und geben Sie mindestens einen Wert im Filter für Quellcodeverwaltungspfad (RegEx) ein, um zulässige Pfade anzugeben. Wählen Sie für jeden Wert Hinzufügen und dann OK aus.

    Wenden Sie eine separate benutzerdefinierte Pfadrichtlinie für jede untergeordnete Richtlinie an, die benutzerdefinierte Pfade verwenden soll.

    Hinweis

    Wenn Sie diese Richtlinie auf eine aktivierte untergeordnete Richtlinie anwenden, erhalten Sie die Meldung Die ausgewählte Richtlinie ist zurzeit aktiviert. Sie muss deaktiviert werden, weil sie ansonsten zweimal ausgeführt wird. Sie können die ursprüngliche Richtlinie im Bildschirm Eincheckrichtlinie entfernen oder deaktivieren.

  6. Geben Sie bei Auswahl von Richtlinie für unzulässige Muster im Dialogfeld Verbotene Muster die unzulässigen Muster an, und wählen Sie dann OK aus.

  7. Navigieren Sie bei Auswahl von Richtlinie für die Arbeitselementabfrage im Dialogfeld Abfragerichtlinie zu einer gespeicherten freigegebenen Arbeitselementabfrage, und wählen Sie diese sowie dann OK aus.

  8. Wenn Sie mit den Einstellungen für die Eincheckrichtlinien zufrieden sind, wählen Sie OK aus. Die neue Eincheckrichtlinie wird bei zukünftigen Eincheckvorgängen angezeigt.