Personalizar um processo XML hospedado
Azure DevOps Services
O Azure DevOps Services dá suporte ao acréscimo e atualização de processos por meio de uma experiência administrativa que é um processo de importação baseado na web. Após adicionar um processo, você pode criar um ou mais projetos a partir dele. Você pode atualizar o processo a qualquer momento importando-o novamente. As alterações feitas no modelo do processo são, a seguir, aplicadas a todos os projetos que usam o processo.
Importante
Com o modelo de processo XML hospedado, você personaliza o acompanhamento de trabalho atualizando arquivos de definição XML selecionados de um modelo de processo. Esse recurso só está disponível quando os dados são migrados para Azure DevOps Services usando o Serviço de Importação de Banco de Dados do Team Foundation Server.
Para saber mais sobre personalização e modelos de processo, confira Personalizar o acompanhamento de trabalho.
Um processo é um arquivo zip que contém um conjunto de arquivos interdependentes. Esses arquivos definem os blocos de construção do sistema de acompanhamento de item de trabalho e outros subsistemas no Azure DevOps Services. Alguns blocos de construção atualizam projetos existentes, enquanto outros se aplicam apenas a novos projetos. Consulte a tabela a seguir para obter a lista completa de blocos de construção.
Usado ao importar/atualizar um processo
Usado ao criar um novo projeto
Substituído por padrões do sistema
Ignored
Acompanhamento de Item de Trabalho
Juízo
Categorias
Configuração do processo
Áreas e Iterações
Gerenciamento de testes
Itens de trabalho
Consultas de item de trabalho
Build
Lab Management
Controle de versão
Mapeamentos de projetos da Microsoft
Relatórios
Portal (Produtos do SharePoint)
Há diferenças entre o que Azure DevOps Services dá suporte e o que o Team Foundation Server local dá suporte. Para obter um resumo dessas diferenças, consulte Diferenças de personalizações de modelo de processo.
Como personalizar um processo
Quando você personaliza um processo, começar com um processo bem definido é mais fácil do que criar um novo.
Se você atualizar um processo existente usado com o Team Foundation Server local, verifique se ele está em conformidade com as restrições colocadas em modelos para importação.
Abra Configurações>Processo
Você cria, gerencia e faz personalizações para processos em Configurações da organização>Processo.
Escolha o
logotipo do Azure DevOps para abrir Projetos. Escolha Configurações da organização.
Em seguida, escolha Processar.
Importante
Se você não vir o Processo, estará trabalhando no TFS-2018 ou na versão anterior. Não há suporte para a página Processo. Você deve usar os recursos com suporte para o modelo de processo XML local.
Exportar e importar um processo
Na guia Processos , selecione as reticências (...) para abrir o menu de atalho do processo XML Hospedado que você deseja exportar. Você pode exportar somente processos XML hospedados.
Salve o arquivo zip e extraia todos os arquivos dele.
Renomeie o processo no arquivo ProcessTemplate.xml localizado no diretório raiz.
Nomeie o processo para distingui-lo dos existentes.
<name>MyCompany Agile Process </name>
Altere o tipo de versão e altere os números principal e secundário. Forneça um GUID distinto para o tipo como neste exemplo:
<version type="F50EFC58-C2FC-4C66-9814-E395D90778A3" major="1" minor="1"/>
Aplicar personalizações com suporte.
Crie um arquivo zip de todos os arquivos e pastas no diretório raiz.
Personalizações com suporte
Você pode aplicar as seguintes personalizações ao processo:
- Adicionar, remover ou modificar um WIT.
- Adicionar ou modificar um campo.
- Adicione até cinco listas de pendências de portfólio.
- Adicione categorias que você usará na configuração do processo.
- Modificar a configuração do processo.
- Adicionar listas globais.
A seção a seguir lista as limitações impostas pelo sistema.
Restrições
Você pode importar até 32 processos para o Azure DevOps Services. Seus processos personalizados devem estar em conformidade com todas as regras resumidas a seguir. Caso contrário, as mensagens de erro de validação poderão aparecer após a importação.
Modelo do processo
Seu arquivo ProcessTemplate.xml deve estar em conformidade com a sintaxe e as regras descritas na referência de elemento XML ProcessTemplate. Além disso, ele deve atender às seguintes condições:
- Limita o número de WITs definidos a 64
- Contém apenas um arquivo de definição de Categories.xml
- Contém apenas um arquivo de definição de ProcessConfiguration.xml
- Usa nomes amigáveis exclusivos em todos os campos e definições wit
Além disso, seu processo deve passar nas seguintes verificações de validação:
- Os nomes de processo são exclusivos e contêm no máximo 155 caracteres Unicode.
- Um modelo com o mesmo nome e GUID de versão que um processo existente substitui esse processo.
- Um modelo com o mesmo nome, mas um GUID de versão diferente gera um erro.
- Os nomes de processo não podem conter os seguintes caracteres especiais:
. , ; ' ` : / \ * | ? " & % $ ! + = ( ) [ ] { } < >
.
Consulte Restrições de nomenclatura para restrições adicionais.
- As pastas de processo não contêm arquivos .exe. Mesmo que você possa importar um processo que contenha um arquivo .exe, a criação do projeto falhará.
- O tamanho total do processo é de no máximo 2 GB. Caso contrário, a criação do projeto falhará.
Configuração do processo
O arquivo de definição ProcessConfiguration.xml deve estar em conformidade com a sintaxe e as regras descritas na referência do elemento XML ProcessConfiguration. Além disso, ele deve atender às seguintes condições:
- Especifica todos os elementos TypeFields
- É limitado a cinco listas de pendências de portfólio
- Contém apenas uma lista de pendências de portfólio não solicitada
- Especifica apenas uma lista de pendências de portfólio pai para cada lista de pendências de portfólio subordinado
- Contém mapeamentos de estado para metaestado de fluxo de trabalho necessários e não faz referência a metaestados sem suporte
Categorias
O arquivo de definição Categories.xml deve estar em conformidade com a sintaxe e as regras descritas em Referência de elemento XML de Categorias. Além disso, ele deve atender às seguintes condições:
- É limitado a 32 categorias
- Define todas as categorias referenciadas no arquivo ProcessConfiguration.xml
Tipos de item de trabalho
Um elemento WITD e seus elementos filho devem estar em conformidade com a sintaxe e as regras descritas na referência de elemento XML WITD. Além disso, ele deve atender às seguintes condições:
- Há no máximo 512 campos dentro de um único wit e 512 campos em todos os WITs.
- O nome amigável e o atributo de nome necessário atribuídos a um WIT são exclusivos dentro do conjunto de arquivos de definição WIT.
- O valor do atributo refname necessário não contém caracteres não permitidos nem usa o sistema de namespaces não permitido. Nome e Microsoft. Nome.
- Os nomes de referência contêm pelo menos um período (.) e todos os outros caracteres são letras sem espaços.
- O elemento WITD contém um elemento FORM que define um elemento WebLayout em conformidade com a sintaxe especificada nos elementos WebLayout e Control.
Campos de item de trabalho
Um elemento FIELDS e seus elementos filho devem estar em conformidade com a sintaxe e as regras descritas na referência do elemento FIELD XML. Além disso, ele deve atender às seguintes condições:
- O nome amigável e o atributo de nome necessário atribuídos a um WIT são exclusivos dentro do conjunto de arquivos de definição WIT.
- O valor do atributo refname necessário não contém caracteres não permitidos nem usa o sistema de namespaces não permitido. Nome e Microsoft. Nome.
- Os nomes de referência contêm pelo menos um período (.) e todos os outros caracteres são letras sem espaços.
Um elemento FIELD e seus elementos filho podem conter um elemento GLOBALLIST .
Restrições de limite
- Um elemento FIELDS é limitado a 512 campos.
- Um tipo de item de trabalho é limitado a 64 campos de nome de pessoa. Um campo de nome de pessoa é aquele com o atributo e o valor
syncnamechanges=true
. - Um elemento ALLOWEDVALUES ou SUGGESTEDVALUES é limitado a 512 elementos LISTITEM .
- Um campo é limitado a 1.024 regras.
Campos obrigatórios
Os seguintes campos são especificados no arquivo ProcessConfiguration.xml:
- Para todos os WITs em uma categoria que define uma lista de pendências de configuração de processo, especifique os campos usados para os atributos
type=Team
e valores etype=Order
. - Para todos os WITs em uma categoria que define uma lista de pendências regular ou lista de pendências de portfólio, especifique o campo usado para
type=Effort
. - Para todos os WITs na categoria que define o elemento TaskBacklog , especifique:
- O campo usado para
type=RemainingWork
. - O campo usado para
type=Activity
. - A regra ALLOWEDVALUES para o campo usado para
type=Activity
.
- O campo usado para
Restrições de regra
Além das restrições de regra de campo padrão, as seguintes restrições são impostas:
- Os elementos de regra de campo não podem especificar os atributos para e não .
- Os elementos FIELD não podem conter os elementos de regra filho CANNOTLOSEVALUE, NOTSAMEAS, MATCH e PROHIBITEDVALUES.
- Exceto para os campos a seguir, definições FIELD para System. Os campos de nome não podem conter regras de campo.
- System.Title pode conter as regras REQUIRED e DEFAULT.
- System.Description pode conter as regras REQUIRED e DEFAULT.
- System.AssignedTo pode conter as regras REQUIRED, DEFAULT, ALLOWEXISTINGVALUE e VALIDUSER.
- System.ChangedBy pode conter as regras REQUIRED, DEFAULT, ALLOWEXISTINGVALUE e VALIDUSER.
Nomes e atributos consistentes
Dentro de um processo ou de uma coleção de projetos, nome, tipo e outros atributos que um elemento FIELD define devem ser os mesmos em todas as definições wit.
Campos de identidade
Os campos de identidade correspondem aos campos usados para conter nomes de conta, usuário ou grupo. Os seguintes campos principais do sistema são codificados como campos de identidade:
- Atribuído a (AssignedTo)
- Autorizado como (System. authorizedas)
- Alterado por (changedby)
- Criado por (CreatedBy)
- Ativado por (Microsoft.VSTS.Common.ActivatedBy)
- Fechado por (Microsoft.VSTS.Common.ClosedBy)
- Resolvido por (Microsoft.VSTS.Common.ResolvedBy)
Adicionar um campo de identidade personalizado
Um campo de cadeia de caracteres é reconhecido como um campo de identidade quando você especifica o atributo syncnamechanges como True.
Restrições de regra em campos de identidade
Para a versão atual da importação do processo, não especifique nenhuma das regras a seguir em uma definição FIELD .
- SUGGESTEDVALUES
- Regras que contêm valores de não entidade.
Exemplo correto
Para limitar os nomes de conta válidos em um campo de identidade, especifique o VALIDUSER
elemento com um atributo de nome de grupo.
<FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
<ALLOWEXISTINGVALUE />
<VALIDUSER group="[PROJECT]\Program Manager Group" />
<HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
</FIELD>
Antes de importar o processo, verifique se você criou o grupo nos projetos que o processo atualiza.
Exemplo incorreto
O exemplo a seguir não é válido porque especifica:
- Um
ALLOWEDVALUES
elemento . - Um
DEFAULT
elemento que especifica a cadeia de caracteres não entidadevalue="Not Assigned"
.
<FIELD name="Project Manager" refname="Fabrikam.ProgramManager" type="String" reportable="dimension" syncnamechanges="true">
<ALLOWEXISTINGVALUE />
<ALLOWEDVALUES>
<LISTITEM value="[PROJECT]\Program Manager Group" />
<LISTITEM value="Not Assigned" />
</ALLOWEDVALUES>
<DEFAULT from="value" value="Not Assigned" />
<VALIDUSER />
<HELPTEXT>The program manager responsible for signing off on the user story.</HELPTEXT>
</FIELD>
Fluxo de trabalho
Um elemento WORKFLOW e seus elementos filho devem estar em conformidade com a sintaxe e as regras descritas na referência de elemento XML WORKFLOW. Além disso, ele deve atender às seguintes condições:
- Limita cada WIT a 16 estados de fluxo de trabalho
- Define todos os estados de fluxo de trabalho mapeados para metaestados no arquivo de definição ProcessConfiguration
- Define uma transição entre todos os estados de fluxo de trabalho mapeados para a categoria de estado "Proposta" e os estados de fluxo de trabalho mapeados para a categoria de estado "InProgress"
- Define uma transição entre todos os estados de fluxo de trabalho mapeados para a categoria de estado "InProgress" e os estados de fluxo de trabalho mapeados para a categoria de estado "Concluído".
Para obter uma descrição da categoria de estado e dos mapeamentos, consulte Estados de fluxo de trabalho e categorias de estado.
Listas globais
Para o modelo de processo XML hospedado, os seguintes limites são colocados na importação de lista global:
- Há no máximo 64 listas globais.
- Há no máximo 512 itens por lista.
- Aproximadamente 10.000 itens podem ser definidos no total entre todas as listas globais especificadas em todos os WITs.
Layout de formulários
Um elemento FORM e seus elementos filho devem estar em conformidade com a sintaxe e as regras descritas na referência do elemento FORM XML.
Um elemento Control não pode especificar um controle personalizado. Não há suporte para controles personalizados.
Artigos relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de