Definir e personalizar objetos para acompanhar itens de trabalho usando o plug-in de acompanhamento de item de trabalho

Usando o plug-in para acompanhar itens de trabalho, você define os objetos inicial de um projeto de equipe para controlar o trabalho.Esses objetos incluem tipos de itens de trabalho, consultas de item de trabalho, de categorias, de tipos de link, e de instâncias de itens de trabalho.Depois de criar um projeto de equipe, você pode alterar esses objetos usando a ferramenta de linha de comando witadmin .

No arquivo plug-in, você especifica uma ou mais tarefas e suas dependências.Geralmente, você especifica uma tarefa para cada atividade do carregamento, como tipos de link, tipos de item de trabalho, consultas, e categorias.

Observação importanteImportante

Você deve especificar as tarefas carregar arquivos e definir consultas em uma sequência específica: tipos de link primeiro, funcionam em tipos de item, e então consultas.Cada arquivo de definição para esses objetos depende das tarefas que são especificadas em que a precede.Em geral, você deve manter a sequência de tarefa que é definida no modelo de processo que você está personalizando.Para obter mais informações, consulte Definir dependências para grupos de tarefas e tarefas em arquivos de plug-in.

Neste tópico

  • Nome e localização do plug-in de acompanhamento de item de trabalho

  • Estrutura da sintaxe de acompanhamento de item de trabalho

  • Referência do elemento para o plug-in WorkItemTracking

Para obter informações específicas sobre cada tipo de objeto que você pode definir um, consulte os seguintes tópicos:

Nome e localização do plug-in de acompanhamento de item de trabalho

A tabela a seguir resume o nome e o local do arquivo para os modelos de processo para soluções Framework (MSF) da Microsoft, bem como o nome do plug-in.

Nome de arquivo:

WorkItems.xml

Local de Arquivo:

Pasta de controle de WorkItem

Nome de plug-in:

Microsoft.ProjectCreationWizard.WorkItemTracking

ObservaçãoObservação

Você pode alterar o nome e o local do arquivo XML mas não o nome do plug-in.Visual Studio Team Foundation Server não inclui um mecanismo para a implantação de plug-ins do lado do cliente, das diretivas, ou outras alterações.Se você deseja implantar esse tipo de funcionalidade, você deve usar seu próprio programa de distribuição e de instalação.

De volta ao topo

Estrutura da sintaxe de acompanhamento de item de trabalho

O arquivo de encaixe para o acompanhamento de item de trabalho devem estar de acordo com a definição de esquema que é definida no arquivo de WorkItemMethodology.xsd, e o plug-in deve ser especificado no seu próprio arquivo.Você pode baixar os arquivos de esquema para modelos de processo de seguinte página no site da Microsoft: Esquemas de item de modelo e de trabalho do processo para o Visual Studio team foundation.

A sintaxe a seguir mostra a estrutura de alto nível do plug-in WorkItemTracking.Quatro tarefas são especificadas, cada uma carregar as definições para tipos de link, tipos de itens de trabalho, consultas, e categorias.Se você fosse adicione definições funcionam instâncias do item, você especificariam uma tarefa extra para cada um.

Para obter uma descrição de cada elemento, consulte Referência do elemento para o plug-in WorkItemTracking posteriormente neste tópico.

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE />
   . . . 
      </LINKTYPES>
    </taskXml>
  </task>
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE />
   . . . 
      </WORKITEMTYPES>
    </taskXml>
  </task>
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission />
   . . . 
        <QueryFolder >
          <Query />
   . . . 
        </QueryFolder>
   . . . 
      </QUERIES>
    </taskXml>
  </task>
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
    </taskXml>
  </task>
</tasks>

De volta ao topo

Referência do elemento para o plug-in WorkItemTracking

A tabela a seguir descreve os elementos que você usa para carregar objetos de acompanhamento de item de trabalho.Você especifica esses elementos dentro de um elemento contêiner de taskXml no arquivo plug-in de WorkItemTracking.Para obter informações sobre a tarefa, a dependência, e os elementos de taskXml, consulte Definir as tarefas para processar um plug-in.

Elemento

Sintaxe

Descrição

CATEGORIES

<CATEGORIES fileName="CategoriesFilePathName" />

Opcional elemento filho do elemento de taskXml para o plug-in WorkItemTracking.

Especifica o caminho e o nome do arquivo que contém as definições de categoria a ser carregadas quando a tarefa de encaixe de WorkItemTracking é processada.

FIELD

<FIELD refname="FieldReferenceName" value="Value" />

Elemento filho de WInecessário.

Define um valor para um campo na instância de item de trabalho.

HYPERLINK

<HYPERLINK URL="URL" relativePath="false" />

Elemento filho opcional de WI.

Define um hyperlink para a instância do item de trabalho.

LINKTYPE

<LINKTYPE fileName="LinkTypeFilePathName" />

Elemento filho de LINKTYPESnecessário.

Especifica o caminho e o nome de um arquivo que contém uma definição de tipo de link para carregar.

LINKTYPES

<LINKTYPES>
     <LINKTYPE />
 . . .
</LINKTYPES>

Opcional elemento filho do elemento de taskXml para o plug-in WorkItemTracking.

Contém uma coleção de elementos de LINKTYPE que cada especifica um arquivo de definição para carregar.

Permission

<permission allow="ListOfPermissions" identity="GroupName" />

Elemento filho opcional de Query.

Especifica as permissões padrão atribuídas às consultas de equipe.Para obter mais informações, consulte Assigning Permissions for Work Item Queries.

Query

<Query name="QueryName" fileName="QueryFilePathName" />

Elemento filho de QUERIESnecessário.

Especifica o nome e caminho do arquivo .wiq de que define uma consulta para carregar.

QueryFolder

<QueryFolder name="
FolderName
">

Elemento filho opcional de QUERIES.

Especifica o nome da pasta de consulta.

QUERIES

<QUERIES>
   . . . 
</QUERIES>

Opcional elemento filho do elemento de taskXml para o plug-in WorkItemTracking.

Especifica que arquivos de definição de consulta a usar para criar consultas de opção.

WI

<WI type="WorkItemType">
   <FIELD> . . .</FIELD>
   <HYPERLINK> . . .</HYPERLINK>
</WI>

Elemento filho de WORKITEMSnecessário.

Define um tipo de item de trabalho para criar e atribuir valores aos campos específicos.

WORKITEMS

WORKITEMS>
   <WI>
      <FIELD> . . .</FIELD>
      <HYPERLINK> . . .</HYPERLINK>
   </WI>
</WORKITEMS >

Opcional elemento filho do elemento de taskXml para o plug-in WorkItemTracking.

Contém uma coleção de elementos de WI que cada um define uma instância de item de trabalho.

WORKITEMTYPE

<WORKITEMTYPE fileName="WITFilePathName" />

Elemento filho de WORKITEMTYPESnecessário.

Especifica o caminho e o nome do arquivo que contém uma definição de tipo para carregar.

WORKITEMTYPES

<WORKITEMTYPES> 
    <WORKITEMTYPE />
 . . .
</WORKITEMTYPES>

Elemento filho necessário o plug-in de WorkItemTracking.

Contém uma coleção de elementos de WORKITEMTYPE que cada especifica um arquivo de definição para carregar.

De volta ao topo

Consulte também

Conceitos

Personalizar modelos de processo

Processo de personalização passo a passo

Personalizar dados de acompanhamento de projeto, formulários, fluxo de trabalho e outros objetos

Trabalhando com arquivos de modelo de processo

Personalizar as áreas funcionais em um modelo de processo