Impostazione di condizioni su un campo elemento di lavoro

Articolo
08/11/2011

È possibile impedire che vengano apportate modifiche a un campo impostando una regola specifica, come gli elementi CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY e REQUIRED. Ad esempio, è possibile utilizzare la regola NOTSAMEAS per impedire che a due campi venga assegnato lo stesso valore o che tali campi vengano cancellati contemporaneamente. Inoltre, è possibile utilizzare tale regola per impedire che al campo "Revisore codice" venga assegnato lo stesso valore del campo "Assegnato a".

È possibile specificare queste regole come elementi figlio degli elementi FIELD (definizione), FIELD (flusso di lavoro) o FIELD (flusso di lavoro globale). È possibile applicare o ignorare queste regole in base a chi modifica l'elemento di lavoro, specificando un utente o un gruppo per gli attributi for o not, rispettivamente.

Nota

Prima di poter definire un flusso di lavoro globale, è necessario che la funzionalità sia abilitata sul server a livello applicazione. Il server deve pertanto eseguire una versione di Visual Studio Team Foundation Server, ad esempio Team Foundation Server 2010 con Service Pack 1 (SP1), che supporta tale funzione. È possibile scaricare il Service Pack dalla pagina del sito Web Microsoft relativa al Service Pack 1 di Visual Studio Team Foundation Server 2010, Beta. Per ulteriori informazioni, vedere Personalizzazione del flusso di lavoro globale.

Struttura della sintassi degli elementi di regola per i valori del campo

È possibile specificare la regola CANNOTLOSEVALUE per evitare la cancellazione di un valore da un campo dopo averlo specificato. Se si applica questa regola a un campo, quel campo deve contenere sempre un valore diverso da Null dopo che un utente ha impostato il campo su qualsiasi valore.
```
<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />
```
Specificare la regola EMPTY per cancellare qualsiasi valore contenuto in un campo. Questa regola inoltre rende un campo di sola lettura e l'utente non deve utilizzarlo insieme alla regola READONLY. Il valore del campo viene deselezionato quando si salva l'elemento di lavoro e non è possibile specificare alcun valore. Questa regola viene utilizzata principalmente durante la transizione dello stato per deselezionare i campi che si applicano allo stato nel quale si sta eseguendo la transizione dell'elemento di lavoro.
```
<EMPTY for="userGroupName"not="userGroupName" />
```
La regola FROZEN viene specificata per impedire l'impostazione del campo su un valore diverso da NULL dopo aver salvato l'elemento di lavoro. Quando un campo dispone di un valore definito nel database, il valore non può più essere modificato.
```
<FROZEN for="userGroupName" not="userGroupName" />
```
La regola NOTSAMEAS viene specificata per evitare l'assegnazione a un campo dello stesso valore di un altro campo. L'attributo field deve essere un nome di riferimento valido del campo.
```
<NOTSAMEAS for="userGroupName" not="userGroupName" field="fieldReferenceName"/>
```
Ad esempio, nell'estratto riportato di seguito viene impedito che un campo abbia lo stesso valore specificato per il campo MyCorp.Reviewer:
```
<NOTSAMEAS field="MyCorp.Reviewer" />
```
Utilizzare questa regola per campi che sono di un tipo simile. Non è possibile utilizzarla per campi in testo non crittografato o HTML.
La regola READONLY viene specificata per impedire le modifiche al valore di un campo.

Non utilizzare questo elemento con l'elemento EMPTY perché anche EMPTY rende un campo di sola lettura. L'utilizzo congiunto di entrambi gli elementi potrebbe produrre risultati incoerenti.
```
<READONLY for="userGroupName" not="userGroupName" />
```
La regola REQUIRED viene specificata per richiedere che un utente specifichi un valore per il campo. I campi obbligatori non possono essere vuoti. Gli utenti non possono salvare un elemento di lavoro fino a che non avranno definito tutti i campi obbligatori.
```
<REQUIRED for="userGroupName" not="userGroupName" />
```

Torna all'inizio

Attributi

È possibile limitare il campo di applicazione delle regole specifiche. Nella tabella riportata di seguito vengono descritti gli attributi a cui fanno riferimento questi elementi:

Attributo	Descrizione
for	Facoltativo. Specifica il nome di un utente o un gruppo Team Foundation a cui si applica la regola. I nomi validi sono costituiti da una stringa di testo di lunghezza compresa tra 1 e 255 caratteri. Valore di schema: ^[^\\]+\\[^\\]+$ Esempio di valore del modello: Dominio\IDutente
not	Facoltativo. Specifica il nome di un utente o un gruppo Team Foundation a cui non si applica la regola. I nomi validi sono costituiti da una stringa di testo di lunghezza compresa tra 1 e 255 caratteri. Valore di schema: ^[^\\]+\\[^\\]+$ Esempio di valore del modello: Dominio\IDutente
field	Obbligatorio per l'elemento NOTSAMEAS. Specifica il nome di riferimento del campo il cui valore non può essere contenuto nel campo corrente. Il nome di riferimento deve corrispondere a quello definito dall'elemento FIELD (definizione). Per ulteriori informazioni, vedere Elemento FIELD (Definizione). Valore di schema:^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Esempio di valore del modello: Company.Division.IssueType

for

Facoltativo. Specifica il nome di un utente o un gruppo Team Foundation a cui si applica la regola. I nomi validi sono costituiti da una stringa di testo di lunghezza compresa tra 1 e 255 caratteri.

Valore di schema: ^[^\\]+\\[^\\]+$

Esempio di valore del modello: Dominio\IDutente

not

Facoltativo. Specifica il nome di un utente o un gruppo Team Foundation a cui non si applica la regola. I nomi validi sono costituiti da una stringa di testo di lunghezza compresa tra 1 e 255 caratteri.

Valore di schema: ^[^\\]+\\[^\\]+$

Esempio di valore del modello: Dominio\IDutente

field

Obbligatorio per l'elemento NOTSAMEAS. Specifica il nome di riferimento del campo il cui valore non può essere contenuto nel campo corrente.

Il nome di riferimento deve corrispondere a quello definito dall'elemento FIELD (definizione). Per ulteriori informazioni, vedere Elemento FIELD (Definizione).

Valore di schema:^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

Esempio di valore del modello: Company.Division.IssueType

Torna all'inizio