Compartilhar via


Todas as referências de elementos XML WITD

Você pode personalizar um tipo de item de trabalho (WIT) existente ou criar um WIT para atender aos seus requisitos de acompanhamento de projetos. Um WIT define os campos, regras e estados e transições para um item de trabalho será controlado para um projeto de equipe, como um bug, requisito ou risco. Criar uma equipe de projeto em Visual Studio Online ou em um Team Foundation Server (TFS) local.

É o elemento raiz em cada definição de um WIT de WITD elemento, que deve ter apenas um WORKITEMTYPE elemento definido. O nome de cada WIT deve ser exclusivo em um projeto de equipe e cada nome de tipo deve ser no máximo 128 caracteres Unicode.

Para personalizar ou criar uma definição de WIT, você deve modificar o arquivo de XML de definição de tipo. WITs limitam-se a um projeto de equipe dentro de uma coleção de projetos.

Estrutura de sintaxe WITD

O exemplo a seguir mostra a estrutura geral de uma definição de WIT.

<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
    <WORKITEMTYPE name="bug" refname="Microsoft.VSTS.WorkItemTypes.Bug">
        <DESCRIPTION> Describes a divergence between required and actual behavior, and tracks the work done to correct the defect and verify the correction.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</witd:WITD>

Elementos filho do WITD

Os elementos estruturais usados no exemplo anterior são descritos na tabela a seguir:

Elemento

Descrição

WITD

A definição de WIT completa é encapsulada pela marca WITD. Você pode usar qualquer nome para o nome do aplicativo. A versão identifica o esquema WIT que pode ser alteradas de uma versão para outra. Use "1.0".

<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
   <WORKITEMTYPE> . . .</WORKITEMTYPE>
</witd:WITD>

WORKITEMTYPE

Nomes de WITs devem ser exclusivos em um projeto de equipe específico. Em tempo de execução, você deve usar o nome especificado por este elemento. Por exemplo, o nome pode aparecer como uma opção de menu. Nesse caso, um usuário poderia escolher Bug sobre o Novo Item de trabalho menu.

<WORKITEMTYPE name="WorkItemTypeName" refname="WITReferenceName" >
    <DESCRIPTION>Text</DESCRIPTION>
    <GLOBALLISTS> . . .</</GLOBALLISTS>
    <FIELDS> . . . </FIELDS>
    <WORKFLOW> . . . </WORKFLOW>
    <FORM> . . .</</FORM>
</WORKITEMTYPE>

Nome amigável: esse nome é exibido nos menus suspensos das consultas de item de trabalho. O nome amigável deve ser exclusivo entre todos os nomes WIT que são definidos em um projeto de equipe. Especifique um nome não mais que 128 caracteres Unicode que usa alfanuméricos, sublinhados e hífens.

Nome de referência: Especifique um nome não mais de 70 caracteres alfanuméricos usa o Unicode, sublinhado e hífens. O nome de referência deve conter pelo menos um ponto (.), mas nenhum período pode aparecer no início ou no final de um nome. Além disso, o nome de referência não pode começar com um número ou um sublinhado e não pode ter vários hifens consecutivos, como (-).

Não especifique um nome que se sobrepõe com o sistema reservado. XXX e Microsoft. XXX namespaces. Consulte As convenções de nomenclatura para objetos de rastreamento de Item de trabalho.

DESCRIÇÃO

Especifica uma cadeia de caracteres que descreve o tipo de item de trabalho que você está definindo. A descrição deve ajudar a qualquer usuário que está personalizando o WIT.

Dica

Você pode exibir a descrição somente na definição XML.Você não pode exibir a descrição em qualquer lugar na interface do usuário, e ele não tem relação para o campo System.Definition.

<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>

Especifique uma cadeia de caracteres de texto que descreve o tipo de item de trabalho que você está definindo.

GLOBALLISTS

Contém as definições de lista global que são usadas por um WIT. Você pode usar listas globais para compartilhar listas de opções entre vários WITs definidos para uma coleção de projetos de equipe. Usando listas globais oferece suporte à colaboração entre grupos e facilidade de manutenção.

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

CAMPOS

Define os campos usados para acompanhar os dados para o WITWithin o FIELDS elemento, você definir todos os campos que você deseja usar para rastrear dados. Isso inclui os campos que você usará para executar consultas e gerar relatórios.

<FIELDS>
   <FIELD> . . . </FIELD>
</FIELDS>

WORKFLOW

Define os elementos de fluxo de trabalho que ajudam a controlar o status do item de trabalho conforme ela se move de um novo estado para fechado ou feito. Esse elemento contém o conjunto de STATE e TRANSITION elementos que definem o fluxo de trabalho. O fluxo de trabalho é um conjunto de transições válidas de um estado para outro e as condições específicas associadas a cada transição.

<WORKFLOW>
   <STATES> . . . </STATES>
   <TRANSITIONS> . . . </TRANSITIONS>
</WORKFLOW>

FORMULÁRIO

Especifica o design do formulário de item de trabalho definindo os campos e os controles que aparecem no formulário e em qual ordem. Ele contém LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER, e outros elementos.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Tipos de item de trabalho do modelo de processo

Ao instalar ou atualizar uma instância do TFS, o modelos de processo padrão são baixadas no seguinte diretório:

%ProgramFiles%/Microsoft team Foundation Server 14.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

Arquivos de definição de WIT são armazenados na pasta WorkItem Tracking\TypeDefinitions.

Para saber como criar ou personalizar um WIT, consulte Personalizar objetos de acompanhamento de trabalho para dar suporte aos processos da sua equipe. Para adicionar um novo WIT ao seu modelo de processo. consulte Adicionar definições de tipo para itens de trabalho a um modelo de processo.

Consulte também

Conceitos

Personalizar objetos de acompanhamento de trabalho para dar suporte aos processos da sua equipe

Outros recursos

witAdmin: personalizar e gerenciar objetos para acompanhar trabalho