Share via

Riferimento a tutti gli elementi XML WORKFLOW

  • Articolo

È possibile utilizzare le informazioni fornite in questo argomento come riferimento rapido relativo a tutti gli elementi e gli attributi principali che controllano il flusso di lavoro per un tipo di elemento di lavoro. Questi elementi vengono specificati nel contenitore dell'elemento WORKFLOW, che rappresenta la seconda sezione principale della definizione di un tipo di elemento di lavoro. Gli elementi figlio STATES e TRANSITIONS vengono utilizzati per definire gli stati diversi che un utente può specificare per un tipo di elemento di lavoro e quali transizioni sono consentite tra gli stati. Per ulteriori informazioni su come definire questi elementi, vedere Progettazione del flusso di lavoro.

In questo argomento

  • Esempio di WORKFLOW

  • Struttura della sintassi per gli elementi WORKFLOW

Esempio di WORKFLOW

Nell'esempio seguente viene mostrata la struttura generale dell'elemento WORKFLOW. Vengono specificati tutti gli stati ai quali un utente può assegnare a un tipo di elemento di lavoro all'interno di un contenitore STATES. Poi si specificano tutte le transizioni consentite da uno di stato all'altro. Ogni stato corrisponde a un elemento STATE ed ogni transizione corrisponde a un elemento TRANSITION. All'interno di ognuno degli elementi contenitore STATES e TRANSITIONS è possibile definire gli stati e le transizioni in qualsiasi sequenza desiderata.

Per ogni transizione, si specifica un set dei motivi per la modifica dello stato dell'elemento di lavoro, includendo un motivo predefinito. Per ogni stato, transizione o motivo, è possibile assegnare valori e porre condizioni sui valori di uno o più campi tramite l'elemento FIELD (flusso di lavoro). Inoltre, è possibile attivare un'azione in modo che avvenga durante una transazione specificando l'elemento ACTION.

<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>

Torna all'inizio

Struttura della sintassi per gli elementi WORKFLOW

Utilizzando gli elementi che vengono descritti nella tabella riportata di seguito, è possibile specificare su quali stati un membro del team può impostare un elemento di lavoro di un particolare tipo. Nella sezione WORKFLOW della definizione, prima si definiscono gli stati, quindi si definiscono transizioni. Per ulteriori informazioni, vedere Progettazione del flusso di lavoro.

Elemento

Descrizione e sintassi

Obbligatorio?

ACTION

Definisce una stringa di testo corrispondente a un'azione da eseguire quando il sistema per il rilevamento degli elementi di lavoro chiama il metodo WorkItem.GetNextState per ottenere lo stato dell'elemento di lavoro successivo all'esecuzione dell'azione.

<ACTION value="NameOfAction" />

Per ulteriori informazioni, vedere Automazione delle assegnazioni dei campi in base a stato, transizione o causa.

Facoltativo

ACTIONS

Definisce un insieme di elementi ACTION.

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

Facoltativo

DEFAULTREASON

Definisce la causa più comune per cui un membro del team modifica l'impostazione di un elemento di lavoro da un particolare stato a un altro particolare stato.

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

Obbligatorio

FIELD

Specifica un campo per un tipo di elemento di lavoro e regole e condizioni che verranno applicate a tale campo quando un membro del team modifica lo stato di un elemento di lavoro di quel tipo e specifica un motivo per la modifica.

<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>

Per ulteriori informazioni, vedere Elemento FIELD (Flusso di lavoro).

Facoltativo

FIELDS

Specifica un insieme di elementi FIELD.

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

Facoltativo

REASON

Definisce una spiegazione aggiuntiva per il motivo per cui un membro del team ha modificato lo stato di un elemento di lavoro.

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

Facoltativo

REASONS

Insieme costituito da un elemento DEFAULTREASON e da elementi REASON facoltativi che spiegano perché un membro del team ha modificato lo stato di un elemento di lavoro.

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

STATE

Definisce uno stato valido per il tipo di elemento di lavoro. Questo elemento può contenere un elemento FIELDS che fa riferimento alle regole e alle condizioni che verranno applicate a un campo specifico quando un membro del team modifica lo stato di un elemento di lavoro di quel tipo.

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

Obbligatorio

STATES

Specifica un insieme di elementi STATE che definiscono gli stati validi che un utente può assegnare a un elemento di lavoro di quel tipo.

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

Obbligatorio

TRANSITION

Specifica una progressione o regressione valida da uno stato a un altro gli elementi di lavoro di un tipo particolare.

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

Per ulteriori informazioni, vedere l'elemento TRANSITION.

Obbligatorio

TRANSITIONS

Specifica un insieme di elementi TRANSITION.

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

Obbligatorio

WORKFLOW

Specifica l'insieme di elementi contenitore STATES e TRANSITIONS che definiscono il flusso di lavoro per il tipo di elemento di lavoro.

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

Obbligatorio

Torna all'inizio

Vedere anche

Riferimenti

Elemento FIELD (Flusso di lavoro)

Concetti

Progettazione del flusso di lavoro

Altre risorse

Definizione e personalizzazione del flusso di lavoro degli elementi di lavoro