Todas as referências de elementos do fluxo de trabalho XML

  • Artigo

Você pode usar as informações neste 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 itemde trabalho.Esses elementos em você especifica o WORKFLOW elemento contêiner, que é a segunda seção principal da definição de um tipo de item de trabalho.Você pode usar o STATES e TRANSITIONStrabalham de elementos filho para definir os diferentes estados que um usuário pode especificar um tipo de item e quais as transições são permitidas entre os estados. Para obter mais informações sobre como definir esses elementos, consulteCriar o fluxo de trabalho

Neste tópico

  • Exemplo de fluxo de trabalho

  • Estrutura de sintaxe para elementos de fluxo de trabalho

Exemplo de fluxo de trabalho

O exemplo a seguir mostra a estrutura geral do WORKFLOW elemento.Você especifica todos os estados para o qual um usuário pode primeiro atribuir um item de trabalho, digite dentro de um STATES contêiner. Em seguida, você pode especificar as transições que têm permissão 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 TRANSITIONSo elemento de contêiner , você pode definir os estados e transições em qualquer sequência que você deseja.

Para cada transição, você pode especificar um conjunto de motivos para alterar o estado do trabalho item, 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, é possível que o disparar uma ação ocorra durante uma transição, especificando a 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>

De volta ao topo

Estrutura de sintaxe para elementos de fluxo de trabalho

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, você pode definir transições.Para mais informações, consulte Criar o fluxo de trabalho.

Elemento

Descrição e sintaxe

Necessário?

ACTION

Define uma seqüência de texto que corresponde a uma ação a ser executada quando o sistema para o trabalho de acompanhamento chamadas de itens a WorkItem.GetNextState método para obter o estado post-action do itemtrabalho.

<ACTION value="NameOfAction" />

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

Optional

ACTIONS

Define uma coleção de ACTION elementos.

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

Optional

DEFAULTREASON

Define a causa mais comum de um membro da equipe a alteração de um item de trabalho de um estado particular para outro estado particular.

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

Necessário

FIELD

Especifica um campo para um tipo de item de trabalho e as regras e condições que serão aplicadas a esse campo quando um membro da equipe altera o estado de um item de trabalho desse tipo e especifica um motivo para que 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).

Optional

FIELDS

Especifica uma coleção de FIELD elementos.

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

Optional

REASON

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

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

Optional

REASONS

Uma coleção de uma DEFAULTREASON e opcionais REASON elementos que explicam por que um membro da equipe alterou o estado de um itemde 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 quando um membro da equipe altera o estado de um item de trabalho desse tipo.

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

Necessário

STATES

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

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

Necessário

TRANSITION

Especifica uma progressão válido ou uma 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 o elemento de transição.

Necessário

TRANSITIONS

Especifica uma coleção de TRANSITION elementos.

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

Necessário

WORKFLOW

Especifica a coleção de STATES e TRANSITIONSelementos de contêiner que juntas definirão o fluxo de trabalho para o tipo de itemde trabalho.

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

Necessário

De volta ao topo

Consulte também

Referência

Elemento FIELD (fluxo de trabalho)

Conceitos

Criar o fluxo de trabalho

Outros recursos

Definir e personalizar o fluxo de trabalho do item de trabalho