Compartilhar via

Definir e personalizar objetos para controlar os itens de trabalho usando o plug-in de WorkItems

  • Artigo

Usando o plug-in para controlar os itens de trabalho, você pode definir objetos de acompanhamento do item de trabalho inicial do projeto de equipe, consultar as permissões atribuídas a grupos e a estrutura de pastas de consulta de equipe. Itens opcionais que você pode definir incluem objetos de item de trabalho, como, por exemplo, um conjunto de tarefas ou problemas que você deseja que cada equipe de projeto para o endereço. Depois de criar um projeto de equipe, você pode modificar o item de trabalho, controle de objetos usando o witadmin ferramenta de linha de comando.

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

Observação importanteImportante

Você deve especificar as tarefas de carregar arquivos e definir as consultas em uma seqüência específica: tipos de link, em seguida, trabalham primeiro tipos de item e, em seguida, consultas. Cada arquivo de definição para esses objetos de rastreamento de item de trabalho depende das definições que são especificadas nas tarefas que precedem-los. Em geral, você deve manter a seqüência de tarefas é definida no modelo de processo Microsoft Solutions Framework (MSF) que está personalizando.

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

Nome do arquivo:

Arquivo WorkItems. XML

Local do arquivo:

Pasta de rastreamento de item de trabalho

Nome do 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 Servernão inclui um mecanismo de implantação do lado do cliente plug-ins, políticas ou outras modificações. Se você desejar implantar esse tipo de funcionalidade, você deve usar seu próprio programa de instalação e distribuição.

Neste tópico

  • Especificando os tipos de Link a ser carregado.

  • Especificando os tipos de Item de trabalho a ser carregado

  • Definir permissões de consulta

  • Criando pastas de consulta

  • Especificando as categorias a serem carregados

  • Especificando os objetos de itens de trabalho a ser criado.

Você pode usar o LinkTypes e LinkType elementos para definir os arquivos de definição para vincular tipos a serem carregados quando um projeto de equipe é criado. Após o projeto é criado, você pode adicionar, modificar, ativar, desativar e excluir tipos de link. Para obter mais informações, consulte Personalização e gerenciamento de tipos de Link [witadmin].

Você deve encapsular o LinkType elemento no elemento contêiner correspondente: LinkTypes. Você usa a seguinte estrutura de sintaxe para o LinkType elemento.

<LINKTYPES>
   <LINKTYPE fileName="PathName\LinkTypeName.xml" />
   . . . 
</LINKTYPES>

A tabela a seguir descreve o atributo para o LinkType elemento.

Atributo

Descrição

nome do arquivo

Especifica o local, caminhoe o nome do arquivo, LinkTypeName, para ser carregado.

Para modelos de processo do MSF, os arquivos de definição de tipos de link são armazenados na pasta Tracking\LinkTypes do item de trabalho.

Para o modelo de processo do MSF Agile Software Development, o seguinte task é definido para especificar o carregamento dos dois tipos de link que correspondem a SharedStep e TestedBy definição arquivos.

  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedStep.xml" />
        <LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
      </LINKTYPES>
    </taskXml>
  </task>

Especificando os tipos de Item de trabalho a ser carregado

Você pode usar o WorkItemTypes e WorkItemType tipos a serem carregados quando um projeto de equipe é criado de item de elementos para definir os arquivos de definição do trabalho. Após o projeto é criado, você pode adicionar, modificar e excluir tipos de itens de trabalho. Para obter mais informações, consulte Personalizando e tipos de Item de trabalho Gerenciando [witadmin].

Você deve encapsular o WorkItemType elemento no elemento contêiner correspondente: WorkItemTypes. Você usa a seguinte estrutura de sintaxe para o WorkItemType elemento.

<WORKITEMTYPES>
   <WORKITEMTYPE fileName="PathName\WorkItemTypeName.xml" />
   . . . 
</WORKITEMTYPES>

A tabela a seguir descreve o atributo para o WorkItemType elemento.

Atributo

Descrição

nome do arquivo

Especifica o local, caminhoe o nome do arquivo, WorkItemTypeName, para ser carregado.

Para modelos de processo do MSF, os arquivos de definição de tipos de item de trabalho são armazenados na pasta Tracking\TypeDefinitions do item de trabalho.

Para o modelo de processo do MSF agile software development, o seguinte task é definido para especificar o carregamento dos seis tipos de itens de trabalho que correspondem ao Bug, problema, SharedStep, tarefa, no caso de teste e UserStory definição arquivos. Para obter mais informações, consulte Adicionar um tipo de Item de trabalho a um modelo de processo.

  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
      </WORKITEMTYPES>
    </taskXml>
  </task>

Definir permissões de consulta

Você usa a funcional permission o elemento atribuir permissões para grupos. Especificando permissões, você define quais grupos de segurança de ações e indivíduos podem executar em consultas e pastas que são adicionadas ao nó de consultas da equipe para um projeto. Para obter mais informações, consulte Controlando o acesso a áreas funcionais.

Para o modelo de processo do MSF Agile Software Development, o seguinte task é usado para configurar a consultas de equipe inicial.

<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission allow="Read, Contribute, Delete, ManagePermissions, FullControl" identity="[SERVER]\$$PROJECTCOLLECTIONADMINGROUP$$" />
        <Permission allow="Read, Contribute, Delete, ManagePermissions, FullControl" identity="[$$PROJECTNAME$$]\$$PROJECTADMINGROUP$$" />
        <Permission allow="Read, Contribute, Delete, ManagePermissions, FullControl" identity="$$CREATOR_OWNER$$" />
        <Permission allow="Read" identity="[$$PROJECTNAME$$]\Readers" />
        <Permission allow="Read" identity="[$$PROJECTNAME$$]\Contributors" />
        <Permission allow="Read" identity="[$$PROJECTNAME$$]\Builders" />
   . . . 
</QUERIES>

A definição de pastas de consulta

Você pode usar o Queries, QueryFolder e Query elementos para definir as pastas e consultas que aparecem sob o Consultas da equipe nó de um projeto de equipe. Após o projeto é criado, você pode adicionar, modificar e excluir pastas e consultas, e você pode definir permissões em pastas e consultas. Para obter mais informações, consulte Organizar e definir permissões em consultas de itens de trabalho.

Você deve encapsular o QueryFolder elemento no elemento contêiner correspondente: Queries. Você usa a seguinte estrutura de sintaxe para o QueryFolder elemento.

<QUERIES>
   <QueryFolder name="FolderName">
   . . . 
   </QueryFolder>
   . . . 
</QUERIES>

A tabela a seguir descreve os atributos para o QueryFolder elemento.

Atributo

Descrição

Nomedapasta

Especifica o nome da pasta de consulta.

Você também pode aninhar subpastas em pastas usando a seguinte estrutura de sintaxe.

<QUERIES>
   . . . 
   <QueryFolder name="FolderName">
   . . . 
      <QueryFolder name="SubfolderName">
      . . . 
      </QueryFolder>
   . . . 
   </QueryFolder>
   . . . 
</QUERIES>

O exemplo a seguir ilustra a definição de uma pasta rotulada "Iteração 1" e que contém três consultas: Bugs ativos, tarefas ativas e lista de pendências de iteração. Para obter mais informações sobre como salvar uma consulta como um arquivo de .wiq, consulte Adicionar um tipo de Item de trabalho a um modelo de processo.

<QueryFolder name="Iteration 1">
          <Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />
          <Query name="Active Tasks" fileName="WorkItem Tracking\Queries\ActiveTasks.wiq" />
          <Query name="Iteration Backlog" fileName="WorkItem Tracking\Queries\Iteration1Backlog.wiq" />
   . . . 
   </QueryFolder>

Especificando as categorias a serem carregados

Você pode usar o Categories elemento para definir as categorias a serem carregados quando um projeto de equipe é criado. Após o projeto é criado, você pode adicionar categorias. Para obter mais informações, consulte Personalizando as categorias de tipos de Item de trabalho [witadmin].

Você deve encapsular o Categories elemento no elemento contêiner correspondente: taskXml. Você usa a seguinte estrutura de sintaxe para o Categories elemento.

<taskXml>
   <CATEGORIES fileName="PathName\CategoriesFileName.xml " />
   . . . 
</taskXml>

A tabela a seguir descreve o atributo para o Categories elemento.

Atributo

Descrição

nome do arquivo

Especifica o local, caminhoe o nome do arquivo, CategoriesFileName, para ser carregado.

Para modelos de processo do MSF, o arquivo de definição de categorias é na pasta de rastreamento de item de trabalho. O nome do arquivo é Categories.xml.

Para o modelo de processo do MSF Agile Software Development, o seguinte task é definido para especificar o upload do arquivo Categories.xml.

  <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>

Especificando os objetos de itens de trabalho a ser criado.

Você pode usar o WorkItems, WI, e Field elementos para definir item funcionam objetos a serem criados quando um projeto de equipe é criado. Opcionalmente, você pode especificar uma URL para incluir no objeto de item de trabalho usando o HyperLink elemento.

Você deve encapsular o WI elemento no elemento contêiner correspondente: WorkItems. Você usa a seguinte estrutura de sintaxe para o WI elemento.

<WORKITEMS>
   <WI type="WorkItemTypeName" />
      <FIELD refname="FieldReferenceName" value="Value" />
   . . . 
      <HYPERLINK URL="URL" relativePath="true | false" />
   </WI>
   . . . 
</WORKITEMS>

A tabela a seguir descreve os atributos para o WI, Field, e HyperLink elementos.

Elemento

Atributo

Descrição

WI

type

Especifica o nome de referência de um tipo de item de trabalho. O tipo de item de trabalho deve ser definido anteriormente no arquivo de plug-in de itens de trabalho.

Field

refname

Especifica o nome de referência de um campo que está definido para o tipo de item de trabalho.

Field

value

Especifica o valor a ser atribuído ao campo quando o objeto de item de trabalho é criado.

HyperLink

URL

A URL para incluir na instância do item de trabalho.

HyperLink

relativePath

Indica se o hiperlink é um caminho relativo. O valor padrão é false.

Nenhum objeto de item de trabalho é definido nos modelos de processo do MSF. O exemplo a seguir ilustra a sintaxe para adicionar um item de trabalho única tarefa e especificar os valores dos campos de título, caminho de iteração, estado, motivo e descrição. Para obter mais informações, consulte Adicionar uma tarefa do Item de trabalho ou a instância a um modelo de processo.

<task id="WIT_Instances" name="Work Item tasks definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item instances created"> 
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>
   <taskXml>
       <WORKITEMS>
       <WI type="Task">
          <FIELD refname="System.Title" value="Setup: Set Permissions" />
          <FIELD refname="System.IterationPath" value="$$PROJECTNAME$$\Iteration 1" />
          <FIELD refname="System.State" value="Active" />
          <FIELD refname="System.Reason" value="New" />
          <FIELD refname="System.Description" value="Using the admin UI in Visual Studio adds users to one of the 3 groups: Project administrators, Contributors, or Readers." />
         </WI>
      </WORKITEMS>

Consulte também

Tarefas

Verificar alterações de definição de tipo de Item de trabalho

Conceitos

Processo de personalização passo a passo

Personalizando o controle de dados, formulários, fluxo de trabalho e outros objetos do projeto

Trabalhando com arquivos de modelo de processo

Personalizando as áreas funcionais dentro de um modelo de processo

Outros recursos

Elementos (esquema de definição do tipo de Item de trabalho)

Elementos (esquema de metodologia de Item de trabalho)

Personalizando modelos de processo