Entidades controladoras e vinculadas

Editar online

Uma entidade no Targetprocess pode ter várias entidades pai e vinculadas. As fórmulas personalizadas suportam referências a essas entidades e suas propriedades. Acesse propriedades aninhadas usando pontos.

EntityState.Name
Project.ID

O tipo de entidade mais comum é a História do Usuário. Aqui, descreveremos como fazer referência a entidades pai e vinculadas em métricas de fórmula personalizadas usadas em campos personalizados no nível de Histórias de Usuário.

Veja como acessar as propriedades básicas das entidades pai e vinculadas no nível da história do usuário. Algumas das fórmulas são válidas para outros tipos de entidades, como Bugs, Tarefas, etc.

Tipos de Entidades	Fórmulas personalizadas	Tipos de resultados	Resultado
Bug na história do usuário	Feature.Name Feature.ID	Número do texto	Campos da característica pai
Bug na história do usuário	Feature.Epic.Name Feature.Epic.ID	Número do texto	Campos da Epic pai
Entidades Project.Name atribuíveis Project.ID	Número do texto	Campos do projeto pai
Entidades atribuíveis	Project.Program.Name Project.Program.ID	Número do texto	Campos do programa pai
História do usuário Bug Recurso Épico Release.Name Release.ID	Número do texto	Campos da versão pai
História do usuário Bug Tarefa	Iteration.Name Iteration.ID	Número do texto	Campos da Sprint pai (Iteração)
História do usuário Bug Tarefa	TeamIteration Nome TeamIteration.ID	Número do texto	Campos da equipe pai Iteração
Entidades atribuíveis	LinkedTestPlan.Nome LinkedTestPlan.ID	Número do texto	Campos do Plano de Teste vinculado

Use a fórmula abaixo para herdar os valores e propriedades mais comumente usados das entidades pai: Recursos e Epics.

Tipos de Entidades	Fórmulas personalizadas	Tipos de resultados	Resultado
Bug na história do usuário	Feature.ID	Número	ID do recurso pai
Bug na história do usuário	Feature.Name	Texto	Nome da característica pai
Bug na história do usuário	Feature.FieldName Feature.CustomValues.Texto("Nome do campo")	Texto*	Valor do campo de texto personalizado denominado “Nome do campo” da característica pai
Bug na história do usuário	Feature.FieldName Feature.CustomValues.Número("Nome do campo")	Número*	Valor do campo personalizado numérico denominado “Nome do campo” do recurso pai
Bug na história do usuário	Feature.BusinessValue.Nome Feature.Priority.Name	Texto	Valor comercial do recurso pai
Bug na história do usuário	Feature.BusinessValue Importância Feature.Priority.Importance	Número	Importância numérica do valor comercial da característica principal
Bug na história do usuário	Feature.Epic.ID	Número	ID do Epic pai
Bug na história do usuário	Feature.Epic.Name	Texto	Nome da empresa-mãe Epic
Bug na história do usuário	Feature.Release.ID	Número	ID da versão do recurso pai

Aviso: o acesso aos valores dos campos personalizados é diferente para métricas e campos personalizados calculados. Nas fórmulas dos campos personalizados calculados, para obter o valor do campo personalizado “Nome do campo”, use: FieldName Nas fórmulas das métricas, para obter o valor do campo personalizado “Nome do campo”, use: CustomValues.Texto("Nome do campo") CustomValues.Número("Nome do campo") CustomValues.Data("Nome do campo") CustomValues.Booleano("Nome do campo")

Veja como referir entidades pai em diferentes níveis da hierarquia: de Tarefa a Programa.

Observação: todos os campos e propriedades das entidades pai são suportados. Os exemplos abaixo utilizam a propriedade.Name como a mais utilizada. Outros campos, propriedades e coleções também são totalmente suportados nas fórmulas.

Tipos de Entidades	Fórmulas personalizadas
Bug na história do usuário	Feature.Name
Bug na história do usuário	Feature.Epic.Name
Bug de tarefa	UserStory.Nome
Bug de tarefa	UserStory.Feature.Name
Bug de tarefa	UserStory.Feature.Epic.Name
Funcionalidade	Epic.Name
História do usuário Bug Tarefa Recurso Epic Solicitação	Project.Name
História do usuário Bug Tarefa Recurso Epic Solicitação	Project.Program.Name