Tarefa CreateNewWorkItem
[Observação: Este tópico é pré-versão documentação e está sujeitas a alterações em versões futuras. Tópicos em branco são incluídos sistema autônomo espaços reservados.]
Por padrão, Team Foundation Build cria um novo item de trabalho se detectar um erro de compilação ou falha de análise estática. The CreateNewWorkItem tarefa cria um novo item de trabalho do tipo especificado e com o título especificado e a descrição. The Microsoft.VSTS.Build.FoundIn campo é definido sistema autônomo o valor de BuildId propriedade e quaisquer valores de campo personalizado especificados na WorkItemFieldValues propriedade estiver definida sistema autônomo especificado.
Parâmetros
Propriedade |
Descrição |
|---|---|
TeamFoundationServerUrl |
Especifica o Team Foundation Server URL. Por exemplo, http://MyServer:8080. |
BuildNumber |
Especifica o Team Foundation Build número da versão. |
BuildURI |
Especifica a compilação do URI. |
Description |
Especifica a descrição do item de trabalho.O valor padrão desta propriedade é especificado no arquivo TFSBuild.proj da definição de compilação sistema autônomo segue: |
TeamProject |
Especifica o nome do projeto da equipe. |
Title |
Especifica o título do item de trabalho. |
WorkItemFieldValues |
Especifica uma lista de valores e nomes de campo para o item de trabalho criado. Especifique esses valores sistema autônomo uma lista separada por ponto-e-vírgula de nome, pares de valor.Por exemplo, se você quiser conjunto prioridade = 1, gravidade = 2 e ordem = 0, defina o MSBuild propriedade da seguinte maneira no XML mostrado aqui: |
WorkItemType |
Especifica o tipo de item de trabalho.Por exemplo, "bug". Esse deve ser um tipo de item de trabalho válido.Se esta propriedade não estiver definida, o tipo de item de trabalho padrão é bug. |
Comentários
The CreateNewWorkItem tarefa é definida na Microsoft.TeamFoundation.compilação.Tasks.VersionControl.dll. O arquivo Microsoft.TeamFoundation.compilação.targets contém uma instância do CreateNewWorkItem tarefas que Team Foundation Build usa sistema autônomo uma implementação padrão para o CreateWorkItem destino. Você também pode personalizar o processo de compilação definindo uma instância diferente do CreateNewWorkItem tarefa de uma definição de compilação no arquivo TfsBuild.proj.
O <raiz>: Pasta \programa Files\MSBuild\Microsoft\VisualStudio\v9.0\TeamBuild o Team Foundation Build o computador contém o arquivo Microsoft.TeamFoundation.compilação.targets.
Tipos válidos item de trabalho
Cada projeto da equipe é criado com uma metodologia específica.In Team Foundation, define o MSF for desenvolvimento de software Agile metodologia bug, qualidade de serviço, riscos, cenário, e tarefa tipos de item de trabalho. CMMI para a metodologia de melhoria do processo define tipos de itens de trabalho bug, solicitação de alterar, issue, requisitos, revisão, riscos, cenário e tarefas.Você também pode definir seu próprio tipo de item de trabalho personalizando uma definição de tipo de item de trabalho existente.Para obter mais informações, consulte Personalizando tipos de itens de trabalho.
Um tipo de item de trabalho definido para o CreateNewWorkItem tarefa deve ser válida para a integração de compilação e deve definir um FoundIn campo. Para obter mais informações, consulte Adicionando campos de integração em item de trabalho tipos.
Comportamento padrão
Se você deixar o WorkItemType propriedade não definida, o CreateNewWorkItem tarefa usa o tipo de item de trabalho bug.
Observações sobre propriedade WorkItemFieldValues
The WorkItemFieldValues é usado para especificar sistema autônomo valores dos campos do item de trabalho sistema autônomo uma lista separada por ponto-e-vírgula de nome, pares de valor. Se você especificar um nome de campo não existir, o correspondente < nome, valor > emparelhar será ignorado.Por exemplo, se você deseja conjunto o campo de gravidade 1, mas gravidade não está definida no tipo de item de trabalho, a entrada será ignorada.
Se o item de trabalho que você define exigiu campos sem valores padrão, você deve fornecer valores na propriedade WorkItemFieldValues.Por exemplo, o tipo de item de trabalho falha tem um campo obrigatório é chamado Priority.Os valores de prioridade são 0, 1, 2 ou 3 e nenhuma configuração padrão é especificada.A tarefa falhar se você especificar um valor inválido para um campo obrigatório.Por exemplo, se você conjunto a prioridade para 5, a tarefa CreateNewWorkItem falhar.
Não é possível especificar os campos CreatedBy e estado do item de trabalho.O campo CreatedBy é somente leitura.Ela é definida pelo modelo de objetos (OM) de acompanhamento do item de trabalho.O campo estado não pode ser especificado porque o OM de acompanhamento do item de trabalho não pode ter vários estados de início.
Exemplo
O exemplo a seguir define o WorkItemFieldValues no arquivo TfsBuild.proj para o item de trabalho criada em falha de compilação.
<WorkItemFieldValues>Area Path=$(AreaPath);Iteration Path=$(IterationPath);Severity=1;Priority=0;Symptom=build break;Steps To Reproduce=Start the build using Team Build;Source=Development;How Found=Build Break;Assigned To=Jim Wilson</WorkItemFieldValues>
O exemplo a seguir utiliza o CreateNewWorkItem tarefa no arquivo TfsBuild.proj, para criar um item de trabalho personalizados no caso de falha de compilação.
<!-- Add the UsingTask to the top of the TFsBuild.proj file after the schema definition-->
<UsingTask TaskName="Microsoft.TeamFounadtion.Build.Tasks.CreateNewWorkItem" AssemblyFile="$(TeamBuildRefPath)\Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll" />
<!-- Add the following XML after the closing </ItemGroup>-->
<!-- and before the closing </Project>-->
</ItemGroup>
<PropertyGroup> <BuildNumber>BuildType_Date.1</BuildNumber> <WorkItemFieldValues>Priority=1:Severity=2</WorkItemFieldValues> <WorkItemType>Bug</WorkItemType> </PropertyGroup> <TargetName="CreateWorkItem"> <CreateNewWorkItem BuildNumber="$(BuildNumber)" BuildURi="$(BuildURI)" Description="The CreateNewWorkItem task created this bug." TeamProject"MyTeamProject" TeamFoundationServerUrl="http://MyTFServer.8080" Title="Bug in $(BuildNumber)" WorkItemFieldValues="$(WorkItemFieldValues)" WorkItemType="$(WorkItemType)" /> </Target>
</Project>
O exemplo a seguir mostra a instância padrão do CreateNewWorkItem tsistema autônomok sistema autônomo definido no arquivo Microsoft.TeamFoundation.compilação.targets.
<CreateNewWorkItem
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildURI)"
BuildNumber="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
Title="$(WorkItemTitle)"
WorkItemFieldValues="$(WorkItemFieldValues)"
WorkItemType="$(WorkItemType)"
ContinueOnError="true" />
Consulte também
Tarefas
Como: Personalizar os números de compilação
Conceitos
Noções básicas sobre Arquivos de Configuração de Compilação do Team Foundation
Equipe Foundation compilação tarefas
Outros recursos
Personalização do Team Foundation compilação