Associar vários itens de trabalho a uma confirmação em DevOps

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Vários itens de trabalho para uma confirmação são compatíveis com DevOps para Azure DevOps, Bitbucket, GitHub e 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 Definição do sistema > Inclusões de script módulo.

    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 oferece suporte aos 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, adicione uma lógica personalizada no DevopsCommitMessageParser inclusão de script navegando até Definição do sistema > Inclusões de script módulo. DevopsCommitMessageParser a inclusão de script se estende de DevopsCommitMessageParserSNC . . DevopsCommitMessageParserSNC Tem três expressões regulares definidas para identificar IDs nativos do 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 personalizada 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'
    });

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

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