Compartilhar via


Todas as referências de elementos XML WORKFLOW

Você pode usar as informações deste tópico como uma referência rápida para todos os elementos e atributos principais que controlam o fluxo de trabalho para um tipo de item de trabalho. Você especifica esses elementos no WORKFLOW contêiner do elemento, que é a segunda seção principal da definição de um tipo de item de trabalho. Você usa o STATES e TRANSITIONS elementos filho para definir os estados diferentes que um usuário pode especificar um tipo de trabalho item e é permitida que faz a transição entre estados. Para obter mais informações sobre como definir esses elementos, consulteAlterar o fluxo de trabalho de um tipo de item de trabalho

Para modificar o fluxo de trabalho, você deve modificar a definição de um tipo de item de trabalho. Consulte Modificar ou adicionar um WIT (tipo de item de trabalho) personalizado.

Exemplo de fluxo de trabalho

O exemplo a seguir mostra a estrutura geral do WORKFLOW elemento. Especifique todos os estados no qual um usuário pode primeiro atribuir um tipo de item de trabalho dentro de um STATES contêiner. Em seguida, você pode especificar todas as transições permitidas de um estado para outro. Cada estado corresponde a um STATE elemento e cada transição corresponde a um TRANSITION elemento. Dentro de cada STATES e TRANSITIONS elemento contêiner, você pode definir os estados e transições em qualquer seqüência que você deseja.

Para cada transição, você especifica um conjunto de motivos para alterar o estado do item de trabalho, incluindo um motivo padrão. Você pode atribuir valores para cada estado, transição ou motivo e você pode colocar condições nos valores de um ou mais campos usando o FIELD elemento (fluxo de trabalho). Além disso, você pode disparar uma ação ocorra durante a transição, especificando o ACTION elemento.

<WORKFLOW>
<STATES>
  <STATE value="Active">
    <FIELDS> . . . </FIELDS>
  </STATE>
  <STATE value="Resolved">
    <FIELDS> . . . </FIELDS>
  </STATE>
  <STATE value="Closed" />
</STATES>
<TRANSITIONS>
  <TRANSITION from="" to="Active">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
    <FIELDS> . . . </FIELDS>
  </TRANSITION>
  <TRANSITION from="Active" to="Resolved">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
    <ACTIONS > . . . </ACTIONS >
</TRANSITION>
<TRANSITION from="Resolved" to="Closed">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
    <ACTIONS > . . . </ACTIONS >
</TRANSITION>
<TRANSITION from="Resolved" to="Active">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
<TRANSITION from="Active" to="Closed ">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
<TRANSITION from="Closed" to="Active">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
</TRANSITIONS>
</WORKFLOW>

Estrutura da sintaxe

Usando a tabela a seguir descreve os elementos, você pode especificar a quais estados de um membro da equipe pode definir um item de trabalho de um tipo específico. No WORKFLOW seção da definição, você define estados primeiro e, em seguida, definir transições. Para obter mais informações, consulte Alterar o fluxo de trabalho de um tipo de item de trabalho.

Elemento

Descrição e sintaxe

Obrigatório?

ACTION

Define uma cadeia de caracteres de texto que corresponde a uma ação a ser executada quando o sistema para acompanhar o trabalho itens chama o WorkItem.GetNextState método para obter o estado posterior à ação do item de trabalho.

<ACTION value="NameOfAction" />

Para obter mais informações, consulte Automatizar atribuições de campo com base em estado, transição ou motivo

Opcional

ACTIONS

Define uma coleção de ACTION elementos.

<ACTIONS>
   <ACTION>. . . </ACTION>
</ACTIONS>

Opcional

DEFAULTREASON

Define a causa mais comum de um membro da equipe alterar um item de trabalho de um determinado estado para outro estado específico.

<DEFAULTREASON value="ValueOfDefaultReason">
   <FIELDS>. . . </FIELDS>
</DEFAULTREASON>

Obrigatório

FIELD

Especifica um campo de um tipo de item de trabalho e as regras e condições que serão aplicadas a esse campo quando altera o estado de um item de trabalho desse tipo de um membro da equipe e especifica um motivo para a alteração.

<FIELD refname="FieldReferenceName">
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
<FIELD>

Para obter mais informações, consulte Elemento FIELD (fluxo de trabalho).

Opcional

FIELDS

Especifica uma coleção de elementos FIELD.

<FIELDS>
   <FIELD . . . </FIELD>
</FIELDS>

Opcional

REASON

Define uma explicação adicional sobre por que um membro da equipe alterou o estado de um item de trabalho.

<REASON value="NameOfReason">
   <FIELDS>. . . </FIELDS>
</REASON>

Opcional

REASONS

Uma coleção de um DEFAULTREASON e opcionais REASON elementos que explicam por que um membro da equipe alterou o estado de um item de trabalho.

<REASONS>
   <DEFAULTREASON>. . . </DEFAULTREASON>
   <REASON>. . . </REASON>
</REASONS>

STATE

Define um estado válido para o tipo de item de trabalho. Esse elemento pode conter um FIELDS elemento, que faz referência a regras e condições que será aplicado a um campo específico quando um membro da equipe altera o estado de um item de trabalho desse tipo.

<STATE value="NameOfState">
  <FIELDS>. . . </FIELDS>
</STATE>

Obrigatório

STATES

Especifica uma coleção de STATE elementos que definem os estados válidos para o qual um usuário pode atribuir um item de trabalho desse tipo.

<STATES>
   <STATE>. . . </STATE>
</STATES>

Obrigatório

TRANSITION

Especifica uma progressão válido ou regressão de um estado para outro para itens de trabalho de um tipo específico.

<TRANSITION from="NameOfStartingState" 
   to="NameOfEndingState" 
   for="UserOrGroupName"
   not="UserOrGroupName">
   <ACTIONS>. . . </ACTIONS>
   <REASONS>. . . </REASONS>
   <FIELDS>. . . </FIELDS>
</TRANSITION>

Para obter mais informações, consulte elemento TRANSITION.

Obrigatório

TRANSITIONS

Especifica uma coleção de elementos TRANSITION.

<TRANSITIONS>
    <TRANSITION>. . . </TRANSITION>
</TRANSITIONS>

Obrigatório

WORKFLOW

Especifica a coleção de STATES e TRANSITIONS elementos de contêiner que juntas definem o fluxo de trabalho para o tipo de item de trabalho.

<WORKFLOW>
   <STATES>. . . </STATES>
   <TRANSITIONS>. . . </TRANSITIONS>
</WORKFLOW>

Obrigatório

Consulte também

Referência

Elemento FIELD (fluxo de trabalho)

Conceitos

Alterar o fluxo de trabalho de um tipo de item de trabalho