Como associar vários itens de trabalho a uma confirmação no DevOps

Vários itens de trabalho para uma confirmação são compatíveis em DevOps para Azure DevOps, Bitbucket, GitHube GitLab.

A sintaxe do item de trabalho na mensagem de confirmação pode ser personalizada para refletir os processos em sua organização usando a inclusão de script DevOpsCommitMessageParserSNC no módulo Definição do sistema > Inclusões de script.

Para vincular as confirmações aos itens de trabalho, o ID nativo do item de trabalho é extraído da mensagem de confirmação. No sistema de base, o DevOps é compatível com os seguintes formatos de mensagem de confirmação:

/**
     * 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
     */

Se você quiser adicionar suporte a formatos de mensagem adicionais para atender aos processos em sua organização, poderá adicionar uma lógica personalizada na inclusão de script DevOpsCommitMessageParser navegando até o módulo Definição do sistema > Inclusões de script. A inclusão de scriptDevOpsCommitMessageParser se estende de DevOpsCommitMessageParserSNC. O DevOpsCommitMessageParserSNC tem três expressões regulares definidas para identificar IDs nativos de item de trabalho para formatos de mensagem compatíveis no sistema de base. Consulte o exemplo a seguir para incluir um novo formato de mensagem personalizado que tenha IDs nativos de item de trabalho entre colchetes.

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'
});

A vinculação de itens de trabalho a uma confirmação usando a interface do usuário do Azure DevOps também é compatível com o DevOps.

Você pode exibir a lista de itens de trabalho associados no registro de confirmação do DevOps e na IU do pipeline.