TRANSITION (elemento XML)

Articolo
06/09/2015

Si usa l'elemento TRANSITION per specificare una progressione o regressione valida da uno stato a un altro per un tipo di elemento di lavoro. L'elemento TRANSITION è un elemento figlio obbligatorio dell'elemento TRANSITIONS.

Per modificare il flusso di lavoro, modificare la definizione per un tipo di elemento di lavoro. Vedere Modificare o aggiungere un tipo di elemento di lavoro personalizzato (WIT).

Gerarchia dello schema

TRANSITION

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
from	Obbligatorio. Nome dello stato da cui l'elemento di lavoro effettua la transizione.
to	Obbligatorio. Nome dello stato a cui l'elemento di lavoro effettua la transizione.
for	Attributo Transition. Facoltativo. Nome di un utente o di un gruppo a cui è consentito eseguire la transizione.
not	Attributo Transition. Facoltativo. Nome di un utente o di un gruppo a cui non è consentito eseguire la transizione.

Elementi figlio

Elemento	Descrizione
ACTIONS	Facoltativo. Definisce una raccolta di elementi ACTION ognuno dei quali definisce una stringa dell'azione che può essere usata in caso di chiamata al metodo WorkItem.GetNextState per ottenere lo stato post-azione dell'elemento di lavoro.
REASONS	Obbligatorio. Raccolta di elementi DEFAULTREASON e REASON che definiscono i motivi validi per cui l'elemento di lavoro può completare la transizione.
FIELDS (flusso di lavoro)	Facoltativo. Raccolta di elementi FIELD (Flusso di lavoro) che fanno riferimento alle definizioni del campi che sono definiti per il tipo di elemento di lavoro.

Elementi padre

Elemento	Descrizione
TRANSITIONS	Obbligatorio. Raccolta di elementi TRANSITION che definiscono le transizioni di stato valide per il tipo di elemento di lavoro.

Note

TRANSITION è un elemento figlio obbligatorio di TRANSITIONS.

È necessario definire precisamente una transizione per spostare l'elemento di lavoro da uno stato vuoto (from) a uno stato denominato, ad esempio Attivo. Questa transizione identifica lo stato predefinito per un nuovo elemento di lavoro.

minOccurs="1"

maxOccurs="unbounded"

È necessario specificare tutte le transizioni valide tra due stati. Se non viene specificata alcuna transizione, quindi per impostazione predefinita non è consentita alcuna transizione.

È anche possibile usare gli attributi for e not nell'elemento di transizione del flusso di lavoro per limitare l'esecuzione di una transizione a determinati utenti. Così facendo, denies ha la precedenza su allows. Se nessuno di questi attributi viene specificato, chiunque potrà modificare l'elemento di lavoro.

Sono supportati più gruppi solo creando un gruppo padre e specificandolo nell'elemento TRANSITION. Per altre informazioni sugli attributi for e not, vedere Applicare una regola a un campo elemento di lavoro.

Esempio

Nell'esempio seguente sono definiti i motivi per la transizione dallo stato Attivo allo stato Risolto del flusso di lavoro.

<TRANSITION from="Active" to="Resolved">
   . . .
   <REASONS>
      <DEFAULTREASON value="Fixed"/>
      <REASON value="Deferred"/>
      <REASON value="Duplicate"/>
      <REASON value="As Designed"/>
      <REASON value="Unable to Reproduce"/>
      <REASON value="Obsolete"/>
   </REASONS>
   . . .
</TRANSITION>

Nella regola seguente, la possibilità di eseguire la transizione di un elemento di lavoro dallo stato Risolto allo stato Completato è limitato a tutti i tester del progetto, ad eccezione dei nuovi tester che sono appena entrati a far parte del team.

<TRANSITION from="Resolved" to="Complete" for="[project]\AllTesters" not="[project]\NewTesters">
</TRANSITION>

Vedere anche

Concetti

Modificare il flusso di lavoro per un tipo di elemento di lavoro

Condividi tramite