Zuordnen mehrerer Arbeitselemente zu einem Commit in DevOps

Mehrere Arbeitselemente für einen Commit werden in unterstützt DevOps Für Azure DevOps, Bitbucket, GitHub, Und GitLab.

Die Arbeitselementsyntax in der Commit-Nachricht kann mithilfe der DevopsCommitMessageParserSNC-Skripteinbindung in angepasst werden, um die Prozesse in Ihrer Organisation widerzuspiegeln Systemdefinition > Skripteinbindungen Modul.

Um die Commits mit Arbeitselementen zu verknüpfen, wird die native ID des Arbeitselements aus der Commit-Nachricht extrahiert. Im Basissystem unterstützt DevOps die folgenden Commit-Nachrichtenformate:

/**
     * Supported patterns
     * Colon pattern 
         * Sample supported formats: 
             *   1. STRY1,STRY2: Additional bug fixes
             *   2. STRY1 , STRY2 : Additional bug fixes
             *   3. STRY1, STRY2 : Additional bug fixes
     * Hash pattern 
         * Sample supported formats: 
             *   1. Fixes for #STRY1, #STRY2, #STRY3
             *   2. Fixes @$#3 and #1 work item
             *   3. Fixes for #STRY1 #STRY2 #STRY3
             *   4. Fixes for AB#123
     * Jira pattern
         * Sample supported formats: 
             *   1. JRA-123 fixed
             *   2. JRA-123 JRA-234 JRA-345 resolved
     */

Wenn Sie Unterstützung für zusätzliche Nachrichtenformate hinzufügen möchten, um die Prozesse in Ihrer Organisation zu erfüllen, können Sie im eine anwenderdefinierte Logik hinzufügen DevopsCommitMessageParser Skripteinbindung, indem Sie zu navigieren Systemdefinition > Skripteinbindungen Modul. DevopsCommitMessageParser Skripteinbindung erweitert aus DevopsCommitMessageParserSNC . Die DevopsCommitMessageParserSNC Verfügt über drei reguläre Ausdrücke, die zum Identifizieren nativer Arbeitselement-IDs für unterstützte Nachrichtenformate im Basissystem definiert sind. Im folgenden Beispiel finden Sie ein neues anwenderdefiniertes Nachrichtenformat mit nativen Arbeitselementen-IDs in eckigen Klammern.

var DevopsCommitMessageParser = Class.create();
DevopsCommitMessageParser.prototype = Object.extendsObject(DevopsCommitMessageParserSNC, {
    initialize: function() {
        DevopsCommitMessageParserSNC.prototype.initialize.call(this);
        this._customPattern = /\[(.*?)\]/g; // The regex pattern to match the words written inside square brackets.
        // Example commits message to match this custom pattern is : "[STRY1], [STRY2] Additional bug fixes"
    },
    getWorkitemsFromCommitMessage: function(message, branchName) {
        var workitems = [];
        // We first call the getWorkitemsFromCommitMessage method from the parent class to get the matching workitems ids for OOB formats
        var defaultWI = DevopsCommitMessageParserSNC.prototype.getWorkitemsFromCommitMessage.call(this, message, branchName);
        if (!gs.nil(defaultWI) && defaultWI.length > 0) {
            workitems = workitems.concat(defaultWI);
        }
        // Now call your custom method that returns an array of workitem native IDs matching custom pattern
        var customWI = this.getWIFromCustomPattern(message);
        if (!gs.nil(customWI) && customWI.length > 0) {
            workitems = workitems.concat(customWI);
        }
        // getUniqueWorkItems method from parent class removes duplicates from the workitems array
        workitems = this.getUniqueWorkItems(workitems);
        // return the final list
        return workitems;
    },
    getWIFromCustomPattern: function(message) {
        var wi = [];
        var l;
        var match;
        var matches = message.match(this._customPattern);
        if (gs.nil(matches))
            return wi;
        for (var i = 0; i < matches.length; i++) {
            l = matches[i].length;
            match = matches[i].substring(1, l - 1); // trim the brackets
            wi.push(match);
        }
        return wi;
    },
    type: 'DevopsCommitMessageParser'
});

Das Verknüpfen von Arbeitselementen mit einem Commit über die Azure DevOps-Anwenderoberfläche wird auch in DevOps unterstützt.

Sie können die Liste der zugeordneten Arbeitselemente im DevOps-Commit-Datensatz und in der Pipeline-UI anzeigen.