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

Artigo
06/09/2015

Ao usar o plug-in para acompanhar itens de trabalho, você deve definir objetos inicial de um projeto de equipe para acompanhar o trabalho. Esses objetos incluem tipos de itens de trabalho, consultas de itens de trabalho, categorias, os tipos de link e instâncias de itens de trabalho. Depois de criar um projeto de equipe, você pode modificar esses objetos usando o witadmin ferramenta de linha de comando.

No arquivo de plug-in, você pode especificar uma ou mais tarefas e suas dependências. Em geral, você pode especificar uma tarefa para cada atividade de carregamento principais, como tipos de link, tipos de item de trabalho, consultas e categorias.

Importante

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

Local e o nome do plug-in

A tabela a seguir resume o nome e local do arquivo para os modelos de processo para o Microsoft Solutions Framework (MSF), além do nome do plug-in.

Nome do arquivo:	WorkItems.xml
Local do arquivo:	Pasta de controle de item de trabalho
Nome do plug-in:	Microsoft.ProjectCreationWizard.WorkItemTracking

Dica

Você pode alterar o nome e o local do arquivo XML, mas não o nome do plug-in.O Visual Studio Team Foundation Server não inclui um mecanismo para a implantação de plug-ins do lado do cliente, políticas ou outras modificações.Para implantar esse tipo de funcionalidade você tem que usar seu próprio programa de instalação e distribuição.

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

Estrutura de sintaxe de plug-in de rastreamento de item de trabalho

O arquivo de plug-in para acompanhamento de item de trabalho deve estar de acordo com a definição de esquema é definida no arquivo WorkItemMethodology.xsd e o plug-in deve ser especificado em seu próprio arquivo. Você pode baixar os arquivos de esquema para modelos de processos nesta página do site da Microsoft: Modelo de processos e esquemas de itens de trabalho para Visual Studio Team Foundation.

A sintaxe a seguir mostra a estrutura geral do WorkItemTracking plug-in. Quatro tarefas são especificadas, um de cada para carregar as definições de link de tipos, tipos de itens de trabalho, consultas e categorias. Se você adicionar instâncias de item de trabalho de definições, você especificaria uma tarefa adicional para cada um.

Para obter uma descrição de cada elemento, consulte referência de elemento mais adiante 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>

Referência de elemento

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 taskXml elemento contêiner no arquivo de plug-in WorkItemTracking. Para obter informações sobre a tarefa, dependência e taskXml elementos, consulte Definir as tarefas para processar um plug-in.

Elemento	Sintaxe	Descrição
CATEGORIES	`<CATEGORIES fileName="CategoriesFilePathName" />`	Elemento filho opcional do taskXml elemento para o plug-in WorkItemTracking. Especifica o caminho e o nome do arquivo que contém as definições de categoria a ser carregado quando a tarefa de plug-in WorkItemTracking é processada.
FIELD	`<FIELD refname="FieldReferenceName" value="Value" />`	Elemento filho de WI obrigató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 hiperlink para a instância de item de trabalho.
LINKTYPE	`<LINKTYPE fileName="LinkTypeFilePathName" />`	Elemento filho de LINKTYPES obrigató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>`	Elemento filho opcional do taskXml elemento para o plug-in WorkItemTracking. Contém uma coleção de LINKTYPE elementos que especificam uma definição de arquivo para carregar.
Permission	`<permission allow="ListOfPermissions" identity="GroupName" />`	Elemento filho opcional de Query. Especifica as permissões padrão que são atribuídas a consultas de equipe. Para obter mais informações, consulte atribuir permissões para consultas de itens de trabalho.
Query	`<Query name="QueryName" fileName="QueryFilePathName" />`	Elemento filho de QUERIES obrigatório. Especifica o nome e o caminho do arquivo. wiq que define uma consulta para carregar.
QueryFolder	`<QueryFolder name=" FolderName ">`	Elemento filho opcional de QUERIES. Especifica o nome de uma pasta de consulta.
QUERIES	`<QUERIES> . . . </QUERIES>`	Elemento filho opcional do taskXml elemento para o plug-in WorkItemTracking. Especifica quais arquivos de definição de consulta usar para criar consultas padrão.
WI	`<WI type="WorkItemType"> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI>`	Elemento filho de WORKITEMS obrigatório. Define um tipo de item de trabalho a ser criado e os valores para atribuir a campos específicos.
WORKITEMS	`WORKITEMS> <WI> <FIELD> . . .</FIELD> <HYPERLINK> . . .</HYPERLINK> </WI> </WORKITEMS >`	Elemento filho opcional do taskXml elemento para o plug-in WorkItemTracking. Contém uma coleção de WI instância de item de elementos que define um trabalho.
WORKITEMTYPE	`<WORKITEMTYPE fileName="WITFilePathName" />`	Elemento filho de WORKITEMTYPES obrigató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 obrigatório do plug-in WorkItemTracking. Contém uma coleção de WORKITEMTYPE elementos que especificam uma definição de arquivo para carregar.

Consulte também

Conceitos

Personalizar um modelo de processo

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

Visão geral de arquivos de modelo de processo

Compartilhar via