Restrizioni di denominazione per Team Foundation Server

Aggiornamento: novembre 2007

Molti componenti di Team Foundation Server rispettano alcune restrizioni di denominazione. In questo modo, vengono garantite un'esperienza utente coerente e la compatibilità con altri programmi. Tra le restrizioni, sono incluse lunghezza, caratteri speciali, univocità o altri attributi.

In questo argomento sono contenute le seguenti sottosezioni:

Considerazioni comuni

Restrizioni per i nomi di account del gruppo Team Foundation Server

Restrizioni per i nomi di computer

Restrizioni per i nomi di progetto di Team Foundation Server

Restrizioni per gli elementi di lavoro

Restrizioni per le personalizzazioni degli elementi di lavoro

Restrizioni per i modelli di processo

Restrizioni per Team Foundation Build

Restrizioni per il controllo del codice sorgente

Vedere anche

Considerazioni comuni

Le restrizioni della lunghezza riportate in questo argomento sono misurate in base al numero di caratteri Unicode consentiti. Per ulteriori informazioni su Unicode, vedere l'articolo "About Unicode and Character Sets" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=76837 (informazioni in lingua inglese). I caratteri surrogati sono composti da due caratteri Unicode e vengono conteggiati come due caratteri per la restrizione della lunghezza.

Per informazioni generali sulle restrizioni del sistema operativo applicate ai nomi file, vedere "Naming a File" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=76838 (informazioni in lingua inglese).

Restrizioni per i nomi di account del gruppo Team Foundation Server

Gli account del gruppo Team Foundation consentono di applicare alcuni diritti o autorizzazioni a un gruppo di utenti. Questo gruppo Team Foundation può essere costituito da account utente di Windows, account del gruppo Windows, account del gruppo Active Directory, account del gruppo Team Foundation o una qualsiasi combinazione di questi tipi.

Se si desidera creare un gruppo con autorizzazioni per più progetti, vedere Procedura: creare un gruppo a livello di server. Se si desidera creare un gruppo di sicurezza per il progetto team, vedere Procedura: creare un gruppo di progetto Team. Se si desidera aggiungere un nuovo membro a uno dei gruppi predefiniti da Team Foundation Server, vedere Procedura: aggiungere utenti a un gruppo predefinito.

Quando un account del gruppo Team Foundation viene creato o modificato, deve soddisfare certe restrizioni di Team Foundation Server. Queste restrizioni vengono descritte nella seguente tabella.

Tipo di restrizione	Restrizione
Lunghezza del nome dell'account di gruppo	Non deve superare 256 caratteri Unicode
Univocità (account di gruppo a livello server)	Non devono essere identici a un altro nome di account di gruppo a livello server
Univocità (account di gruppo di progetto)	Non devono essere identici a un altro nome di gruppo nello stesso progetto
Nomi di gruppo riservati	Non devono essere denominati $NAMESPACE né a livello progetto né a livello server
Restrizioni relative ai caratteri speciali	Non devono includere i caratteri stampabili seguenti: "/ [ ] : | < > + = ; ? * Non devono includere i caratteri non stampabili nell'intervallo di valori ASCII 1-31 Non devono terminare con un punto (.) Non devono contenere virgole (,)

Nota:
Gli account utente non vengono creati in Team Foundation Server. In alcuni casi, è possibile aggiungere un utente specifico di Windows a un gruppo Team Foundation o direttamente a Team Foundation Server. Per ulteriori informazioni, vedere Procedura: aggiungere un utente.

Restrizioni per i nomi di computer

Durante il processo di installazione di Team Foundation Server, il nome del computer è associato al nome del server di Team Foundation. Per rinominare un server di Team Foundation, è necessario seguire le procedure descritte in Procedura: rinominare un server a livello applicazione o Procedura: rinominare un server a livello dati.

Sia il sistema operativo che Windows Server 2003 Active Directory, impongono alcune restrizioni sui nomi del computer. Per ulteriori informazioni su come rinominare un computer, vedere "Rinominare un computer" all'indirizzo (https://go.microsoft.com/fwlink/?LinkId=76839) (informazioni in lingua inglese). Per ulteriori informazioni su Active Directory, vedere "Windows Server 2003 Active Directory" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=47541) (informazioni in lingua inglese).

Restrizioni per i nomi di progetto di Team Foundation Server

Il nome del progetto di Team Foundation Server identifica un insieme di elementi di lavoro, documenti, report, Team Build e una struttura del controllo del codice sorgente che costituiscono un determinato progetto di Team Foundation. I membri Team utilizzano il nome del progetto per connettersi al progetto in Team Foundation Server.

La tabella riportata di seguito descrive le restrizioni per i nomi di progetto.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 64 caratteri Unicode
Univocità	Non devono essere identici a qualsiasi altro nome in Team Foundation Server, Windows SharePoint Services o SQL Server Reporting Services
Caratteri speciali	Non devono contenere qualsiasi carattere di controllo Unicode o caratteri surrogati1 Non devono contenere i caratteri stampabili seguenti: / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ] Non devono iniziare con un trattino di sottolineatura (_) Non devono iniziare o terminare con un punto (.)
Nomi riservati	Non devono essere nomi di sistema riservati, ad esempio PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON o AUX Per ulteriori informazioni sui nomi riservati, vedere "Naming a File" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=76838 (informazioni in lingua inglese).

^{1Per ulteriori informazioni sui caratteri surrogati, vedere "Ask Dr. International, Column #18" (informazioni in lingua inglese) all'indirizzo}https://go.microsoft.com/fwlink/?LinkId=76840).

Restrizioni per gli elementi di lavoro

Microsoft Visual Studio Team System tiene traccia dello stato di avanzamento di un progetto utilizzando elementi quali errori, requisiti, attività e rischi. Questi elementi sono indicati genericamente come elementi di lavoro. Questa sezione descrive le restrizioni sui dati archiviati negli elementi di lavoro.

Restrizioni per gli allegati degli elementi di lavoro

È possibile allegare file agli elementi di lavoro. La tabella riportata di seguito descrive le restrizioni relative agli allegati degli elementi di lavoro.

Tipo di restrizione

Restrizione

Dimensione file

Per impostazione predefinita, il limite per le dimensioni dei file allegati agli elementi di lavoro è 4.096 kilobyte. Questo valore può essere modificato dall'amministratore di Team Foundation. La dimensione massima che può essere impostata dall'amministratore è 2 GB. Per ulteriori informazioni, vedere Impostazione di un limite per le dimensioni degli allegati. La dimensione predefinita è 4.096 KB La dimensione massima è 2 GB

Restrizioni per aree e iterazioni degli elementi di lavoro

Gli elementi di lavoro contengono un campo per Area progetto e uno per Iterazione progetto. Questi campi vengono utilizzati per organizzare e visualizzare gli elementi di lavoro in raggruppamenti logici.

Area progetto e Iterazione progetto sono percorsi costituiti da più elementi di nodo separati da caratteri di barra rovesciata (\). I nodi vengono definiti dall'amministratore di Team Foundation Server per riflettere le aree e il ciclo del progetto. Per ulteriori informazioni, vedere Impostazione di iterazioni o aree del progetto iniziali. La tabella riportata di seguito descrive le restrizioni relative a nodi e percorsi.

Tipo di restrizione	Restrizione
Lunghezza del nodo	Non deve superare 255 caratteri
Caratteri speciali per i nodi	Non devono contenere caratteri di controllo Unicode Non devono contenere alcuno dei caratteri seguenti: \ / $ ? * : " & > < # % | Non devono contenere caratteri proibiti dal file system locale. Per ulteriori informazioni sulle restrizioni dei caratteri Windows, vedere "Naming a File" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=76838 (informazioni in lingua inglese).
Nomi riservati	Non devono essere costituiti solo da un punto (.) o da due punti (..) Non devono essere nomi di sistema riservati, ad esempio PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON o AUX Per ulteriori informazioni sui nomi riservati, vedere "Naming a File" all'indirizzo https://go.microsoft.com/fwlink/?LinkId=76838 (informazioni in lingua inglese).
Lunghezza dei percorsi	Non deve superare 4000 caratteri Unicode
Profondità della gerarchia di percorso	Non devono superare 14 livelli di profondità

Restrizioni per le personalizzazioni degli elementi di lavoro

Team Foundation Server tiene traccia dello stato di avanzamento di un progetto utilizzando elementi quali errori, requisiti, attività e rischi. Questi elementi sono indicati genericamente come elementi di lavoro.

Gli amministratori dei progetti Team possono modificare le definizioni del tipo degli elementi di lavoro a livello di progetto o in un modello di processo. Per ulteriori informazioni sulla personalizzazione dei tipi di elementi di lavoro, vedere Personalizzazione dei tipi di elemento di lavoro. In questa sezione vengono descritte le restrizioni da considerare durante la personalizzazione degli elementi di lavoro e degli elementi associati.

Restrizioni per i nomi dei campi degli elementi di lavoro

Ogni tipo di elemento di lavoro contiene uno o più campi. Questi campi definiscono le informazioni archiviate in un tipo di elemento di lavoro. Il nome di un campo di elemento di lavoro identifica in modo univoco tale campo. Per ulteriori informazioni sui nomi dei campi degli elementi di lavoro, vedere Nomi campo.

La tabella riportata di seguito descrive le restrizioni relative ai nomi dei campi degli elementi di lavoro.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 128 caratteri Unicode
Caratteri speciali	Non devono contenere spazi iniziali o finali Non devono contenere due o più spazi consecutivi Non devono contenere punti (.) Non devono contenere parentesi quadre di apertura o chiusura ([])
Ambito	I nomi dei campi degli elementi di lavoro sono definiti per l'ambito dell'intero Team Foundation Server. Se si modifica un nome di campo, la modifica viene applicata a tutti i progetti e i tipi di elementi di lavoro che contengono tale campo.

Restrizioni per i nomi di riferimento dei campi degli elementi di lavoro

Ogni campo di elemento di lavoro ha un nome riferimento associato. Il nome riferimento di un campo identifica in modo univoco tale campo e non può essere modificato dopo l'assegnazione. Per ulteriori informazioni sui nomi riferimento dei campi, vedere Nomi di riferimento di campo. La tabella riportata di seguito descrive le restrizioni applicate ai nomi riferimento dei campi.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 70 caratteri Unicode
Caratteri speciali	Non devono contenere trattini (-) Devono contenere almeno un punto (.) Non devono iniziare o terminare con un punto (.) Non devono iniziare con un numero Non devono iniziare con un trattino di sottolineatura (_)
Univocità	Non devono essere identici a un altro nome riferimento di campo in Team Foundation Server Non devono essere identici a un altro nome riferimento di campo dopo che tali nomi vengono elaborati dal computer per sostituire tutti i punti (.) con trattini di sottolineatura (_) Ad esempio, i nomi riferimento dei campi Mio._Campo e Mio_.Campo verrebbero elaborati dal computer come se fossero lo stesso nome, Mio__Campo

Restrizioni per il testo della Guida dei campi degli elementi di lavoro

Facoltativamente, è possibile associare testo della Guida ai campi degli elementi di lavoro utilizzando il tag <HELPTEXT>. Questo testo viene visualizzato in fase di esecuzione per indicare agli utenti cosa immettere nel campo. Per ulteriori informazioni sul testo della Guida dei campi degli elementi di lavoro, vedere Definizione del testo Guida per i campi.

La tabella riportata di seguito descrive le restrizioni relative al testo della Guida dei campi degli elementi di lavoro.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 255 caratteri Unicode
Ambito	A differenza del nome e del tipo di campo, il testo della Guida inserito nel campo viene definito per l'ambito di un tipo di elemento di lavoro specifico in un determinato progetto team.

Restrizioni per gli elenchi globali

Un elenco globale è un insieme di valori di voci di elenco archiviati e utilizzati globalmente da tutti i Team Foundation Server in un'implementazione di Team Foundation Server . Quando si definiscono i tipi di elementi di lavoro, è possibile che alcuni campi condividano lo stesso insieme di possibili valori. Gli elenchi globali consentono di definire questi valori una volta e di condividerli tra più tipi di elementi di lavoro. Per ulteriori informazioni, vedere Elenchi globali.

Un elenco globale (GLOBALLIST) contiene una o più voci di elenco (elementi LISTITEM).

La tabella riportata di seguito descrive le restrizioni relative alle voci di elenco.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 254 caratteri Unicode Non devono essere vuoti
Caratteri speciali	Non devono contenere spazi vuoti iniziali o finali Non devono contenere due spazi consecutivi Non devono contenere barre rovesciate (\)
Ambito	Poiché gli elenchi globali sono disponibili tra tutti i progetti, non devono contenere elementi definiti a livello di progetto, ad esempio definizioni di account di gruppo specifici del progetto.

La tabella riportata di seguito descrive le restrizioni che si applicano a un elenco globale.

Tipo di restrizione	Restrizione
Numero di voci	L'elenco globale non deve essere vuoto. Deve contenere almeno un elemento LISTITEM.
Univocità	Il nome dell'elenco globale non deve essere identico a un altro nome di elenco globale in Team Foundation Server.

Restrizioni per i modelli di processo

Un modello di processo è un insieme di elementi di lavoro predefiniti, query dell'elemento di lavoro, modelli di prodotto, report, gruppi di sicurezza e linee guida che influenza la struttura di un progetto in Team Foundation. In Team Foundation Server sono disponibili due modelli di processo predefiniti che includono due stili diversi per la gestione del ciclo del software. È possibile personalizzare questi modelli in base alle esigenze univoche di un'organizzazione. Per ulteriori informazioni, vedere Personalizzazione dei modelli di processo.

La tabella riportata di seguito descrive le restrizioni relative ai modelli di processo.

Tipo di restrizione	Restrizione
Lunghezza del nome di modello di processo	Non deve superare 256 caratteri Unicode
Univocità del nome di modello di processo	Deve essere univoco in Team Foundation Server. Se si carica un modello con lo stesso nome di un modello esistente, quest'ultimo viene sovrascritto.
Dimensione file del modello di processo	La dimensione file del modello di processo non deve superare 2 GB (gigabyte).

Restrizioni per Team Foundation Build

Team Foundation Build consente di gestire tutti gli aspetti del processo di generazione in un singolo computer. Con Team Foundation Build, è possibile sincronizzare le origini, compilare l'applicazione, eseguire unit test associati, effettuare l'analisi del codice, rilasciare generazioni in un file server e pubblicare report di generazione. Per ulteriori informazioni, vedere Cenni preliminari su Team Foundation Build.

Restrizioni per il computer di compilazione

Team Foundation Build è un'installazione separata dal client di livello applicazione o di livello dati di Team Foundation Server o dal client di Visual Studio. È possibile definire un computer separato. In alternativa, è possibile installare la generazione affiancata sul computer client o sui server. Per ulteriori informazioni sulle modalità di configurazione di un computer di compilazione, vedere Procedura: configurare e installare Team Foundation Build.

La tabella riportata di seguito descrive le restrizioni per il computer di compilazione.

Tipo di restrizione	Restrizione
Spazio su disco	Deve contenere spazio sufficiente per la generazione, in quanto se lo spazio è insufficiente la generazione avrà esito negativo.
Directory di generazione	Deve essere un percorso locale (ad esempio C: \directorygenerazione).
Directory della destinazione finale	Deve essere un percorso UNC (ad esempio \\server\condivisione).
Autorizzazioni della destinazione finale	Ogni generazione generata viene inserita in una nuova directory nella cartella a sola scrittura. L'account del servizio Team Foundation Server (ad esempio Dominio\TFSSERVICE) deve avere accesso con autorizzazione Controllo completo alla destinazione finale UNC. La destinazione finale UNC deve essere una cartella condivisa.
Account del servizio Team Build	Se si modifica l'account del servizio Team Foundation Server dopo l'installazione iniziale, è necessario assicurarsi che vengano rispettate le condizioni seguenti. L'account è membro del gruppo Build Services. L'account dispone di autorizzazioni di lettura/scrittura per le cartelle temporanee e la cartella temporanea di ASP.NET. L'account dispone di autorizzazioni di Controllo completo per la directory di generazione e la destinazione finale.
Problemi relativi al firewall	Se nel computer di generazione è attivato un firewall, assicurarsi che il programma tfsbuildservice sia presente nell'elenco delle eccezioni.

Nomi dei tipi di generazione

In Team Foundation Build vengono utilizzati i tipi di generazione per configurare le condizioni in base a cui sarà generata una soluzione o un insieme di soluzioni in un progetto team. Per eseguire una generazione, è necessario creare un nuovo tipo di generazione o utilizzarne uno esistente. Per ulteriori informazioni sui tipi di generazione, vedere Utilizzo delle definizioni di compilazione in Team Foundation Build.

La tabella riportata di seguito descrive le restrizioni per i nomi dei tipi di generazione.

Tipo di restrizione	Restrizione
Univocità	Non devono essere identici al nome di un altro tipo di generazione nel progetto
Caratteri speciali	Non devono contenere i caratteri stampabili seguenti: $

Nomi di qualità di generazione

La qualità di generazione consente di associare un livello di qualità o uno stato di completamento a una generazione completata. In Team Foundation Build è inoltre possibile creare valori nuovi per il tipo di qualità della generazione. Per ulteriori informazioni, vedere Procedura: creare una definizione di compilazione. Per un elenco dei valori di qualità di generazione predefiniti, vedere Procedura: impostare la qualità di compilazione.

La tabella riportata di seguito descrive le restrizioni per i nomi di qualità di generazione.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 256 caratteri Unicode
Univocità	Non devono essere identici al nome di un'altra qualità di compilazione nel computer Team Foundation Build.

Restrizioni per il controllo del codice sorgente

Il controllo del codice sorgente di Team Foundation costituisce un repository centrale per i file e per i comandi necessari per gestire tali file in un team. Offre inoltre criteri di archiviazione personalizzabili e funzionalità di diramazione, unione, sospensione e altre ancora.

Per ulteriori informazioni sul controllo del codice sorgente in Team Foundation, vedere Controllo della versione di Team Foundation.

Percorsi del server del controllo del codice sorgente

Il percorso del server del controllo del codice sorgente è il percorso completo di un file archiviato nel controllo del codice sorgente.

La tabella riportata di seguito descrive le restrizioni relative alla lunghezza del percorso del server del controllo del codice sorgente.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 248 caratteri Unicode per una directory. Non deve contenere più di 260 caratteri Unicode per una directory e un nome file combinati.

Aggiunta di file al controllo del codice sorgente

Il sistema di controllo del codice sorgente consente di archiviare molti tipi diversi di file. Per ulteriori informazioni su come aggiungere progetti o soluzioni di Visual Studio esistenti nel controllo del codice sorgente, vedere Aggiunta di progetti e soluzioni al controllo della versione. È inoltre possibile aggiungere file o cartelle che non sono associate a un progetto o una soluzione di Visual Studio. Per ulteriori informazioni, vedere Procedura: aggiungere al controllo della versione file e cartelle non appartenenti al progetto o alla soluzione.

La tabella riportata di seguito descrive le restrizioni applicate a file e cartelle da aggiungere al controllo del codice sorgente.

Tipo di restrizione	Restrizione
Estensioni di file	Non devono contenere i caratteri stampabili seguenti: / \ : * ? " < > |
Cartelle	Non devono essere vuoti Non devono contenere file con modifiche in sospeso Non devono risiedere al di fuori della directory mappata per l'area di lavoro attiva

Nomi di etichetta

Nel controllo del codice sorgente di Team Foundation, l'etichetta è un nome applicato a un insieme di revisioni specifico. È possibile associare etichette a un insieme di file non correlati nel controllo del codice sorgente. In questo modo, è possibile recuperare i file o eseguire operazioni su di essi come gruppo. Per ulteriori informazioni, vedere Utilizzo delle etichette. La tabella riportata di seguito descrive le restrizioni per i nomi delle etichette.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 64 caratteri Unicode
Caratteri speciali	Non possono terminare con uno spazio ( ) o un punto (.) Non devono contenere i caratteri stampabili seguenti: " / : < > \ | * ? @

Aree di sospensione

Le aree di sospensione consentono di accantonare temporaneamente un gruppo di modifiche in sospeso ed eventualmente rimuoverle dall'area di lavoro. In un secondo tempo, sarà possibile ripristinare le modifiche contenute in un'area di sospensione nell'area di lavoro o inserirle nell'area di lavoro di un altro utente. Per ulteriori informazioni, vedere Utilizzo delle aree di sospensione per il controllo della versione.

La tabella riportata di seguito descrive le restrizioni relative ai nomi delle aree di sospensione.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 64 caratteri Unicode
Caratteri speciali	Non devono contenere i caratteri stampabili seguenti: " / : < > \ | * ?

Nomi delle aree di lavoro

Un'area di lavoro è la copia sul lato client dei file e delle cartelle presenti sul server del controllo del codice sorgente. Quando si creano più aree di lavoro, è possibile avere versioni diverse della stessa cartella del controllo del codice sorgente su un computer client. Per ulteriori informazioni sulle aree di lavoro, vedere Utilizzo delle aree di lavoro per il controllo della versione. La tabella riportata di seguito descrive le restrizioni relative ai nomi delle aree di lavoro.

Tipo di restrizione	Restrizione
Lunghezza	Non deve superare 64 caratteri Unicode
Caratteri speciali	Non possono terminare con uno spazio ( ) o un punto (.) Non devono contenere i caratteri stampabili seguenti: " / : < > \ | * ? @

Vedere anche

Attività

Procedura: creare un gruppo a livello di server

Procedura: creare un gruppo di progetto Team

Procedura: aggiungere utenti a un gruppo predefinito

Procedura: aggiungere un utente

Procedura: rinominare un server a livello applicazione

Procedura: rinominare un server a livello dati

Procedura: configurare e installare Team Foundation Build

Procedura: creare una definizione di compilazione

Procedura: impostare la qualità di compilazione

Procedura: aggiungere al controllo della versione file e cartelle non appartenenti al progetto o alla soluzione

Procedura: modificare le aree progetti Team

Procedura: modificare le iterazioni di un progetto Team

Concetti

Amministrazione di Team Foundation Server

Nomi campo

Definizione del testo Guida per i campi

Elenchi globali

Cenni preliminari su Team Foundation Build

Controllo della versione di Team Foundation

Utilizzo delle etichette

Utilizzo delle aree di sospensione per il controllo della versione

Utilizzo delle aree di lavoro per il controllo della versione

Nomi di riferimento di campo

Impostazione di iterazioni o aree del progetto iniziali

Altre risorse

Risoluzione dei problemi relativi a Team Foundation Server

Personalizzazione dei tipi di elemento di lavoro

Personalizzazione dei modelli di processo

Utilizzo delle definizioni di compilazione in Team Foundation Build

Aggiunta di progetti e soluzioni al controllo della versione