Restrizioni e convenzioni di denominazione
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
La maggior parte dei componenti in Azure DevOps deve seguire le restrizioni e le convenzioni di denominazione. Le restrizioni garantiscono un'esperienza utente coerente e garantiscono la compatibilità con altre applicazioni.
Le restrizioni comuni includono non superare la lunghezza del carattere per un nome, non contenere caratteri speciali e mantenere l'univocità dei nomi all'interno di un set di oggetti.
Importante
Quando si usa l'API, anziché l'interfaccia utente, l'API consente di specificare direttamente un nome, che include caratteri che potrebbero essere limitati nell'interfaccia utente.
Procedure consigliate:
- Seguire le restrizioni dell'interfaccia utente per mantenere la coerenza e prevenire problemi imprevisti.
- Convalidare i nomi a livello di codice e gestire i caratteri speciali in modo appropriato.
Considerazioni generali
Le restrizioni di lunghezza in questo articolo vengono misurate in base al numero di caratteri Unicode consentiti. I caratteri surrogati sono costituiti da due caratteri Unicode, che vengono conteggiati come due caratteri rispetto alla restrizione di lunghezza. Per altre informazioni, vedere Informazioni sui set di caratteri e Unicode.
Come per altri file del sistema operativo, non sono consentiti anche caratteri di controllo ASCII (ASCII 1-31) e combinazioni di surrogati. Per informazioni generali sulle restrizioni del sistema operativo applicate ai nomi di file, vedere Denominazione di file, percorsi e spazi dei nomi.
Nota
- Per i limiti relativi al numero di elementi che è possibile definire, vedere Rilevamento del lavoro, processo e limiti dei progetti.
Nomi riservati del sistema
Evitare di usare nomi riservati del sistema, come negli esempi seguenti:
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- CON
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- Web o WEB
Per altre informazioni sui nomi riservati, vedere Nomi, percorsi e spazi dei nomi file.
Azure Artifacts
I pacchetti universali devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Nome pacchetto | - Deve essere minuscolo. - Deve iniziare e terminare con lettere o numeri. - Deve contenere solo lettere, numeri e trattini nonconsecutivi, caratteri di sottolineatura o punti. |
| Versione pacchetto | Deve essere minuscolo senza metadati di compilazione. |
Azure Boards
Gli elementi di lavoro vengono usati per acquisire informazioni per pianificare e tenere traccia dei progetti di sviluppo software. Con gli elementi di lavoro, è possibile descrivere il lavoro da eseguire, assegnare lavoro, tenere traccia dello stato e coordinare le attività all'interno del team. Tipi diversi di elementi di lavoro, ad esempio storie utente, attività, bug e problemi, tengono traccia di diversi tipi di informazioni. Per altre informazioni, vedere la documentazione di Azure Boards.
Tutti gli oggetti di rilevamento degli elementi di lavoro sono associati a uno o più nomi. La maggior parte dei nomi visualizzati descrittivi, ad eccezione dei tipi di elementi di lavoro e degli elenchi globali, associati ai nomi di riferimento. Un nome descrittivo è un identificatore univoco visibile dall'utente per un campo. L'uso di nomi descrittivi garantisce la coerenza tra progetti e tipi di elementi di lavoro in una raccolta di progetti. Il sistema usa internamente il nome del riferimento e non è possibile modificarlo una volta definito.
Esistono restrizioni per diversi elementi associati agli elementi di lavoro, inclusi nomi descrittivi e di riferimento, nomi di campo e dimensioni degli allegati.
Percorsi di iterazione e area
Due campi dell'elemento di lavoro, Percorso area e Percorso iterazione, forniscono una gerarchia della struttura ad albero per il lavoro di raggruppamento. I percorsi di area raggruppano gli elementi di lavoro per prodotto, funzionale o area di funzionalità. I percorsi di iterazione raggruppano gli elementi di lavoro in sprint, attività cardine o periodi di tempo per l'indirizzamento di tali elementi di lavoro.
Questi campi multinodo usano i caratteri barra rovesciata \ per indicare la gerarchia dei nodi all'interno della struttura ad albero.
I nomi assegnati ai nodi figlio a questi campi devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Lunghezza nodo | Non deve contenere più di 255 caratteri. |
| Nomi riservati | - Non deve essere costituito solo da un punto . o due punti ...- Non deve essere un nome riservato dal sistema, 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 altre informazioni sui nomi riservati, vedere Nomi file, percorsi e spazi dei nomi. |
| Caratteri speciali per i nodi | - Non deve contenere caratteri di controllo Unicode. - Non deve contenere uno dei caratteri seguenti: \ / : * ? " < > | # $ & * +.- Non deve contenere caratteri non consentiti dal file system locale. Per altre informazioni sulle restrizioni dei caratteri di Windows, vedere Denominazione di file, percorsi e spazi dei nomi. |
| Lunghezza dei percorsi | Non deve contenere più di 4.000 caratteri Unicode. |
| Profondità gerarchia percorso | Deve essere inferiore a 14 livelli profondi. |
Allegati
I file allegati agli elementi di lavoro devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Dimensioni file | Non deve superare le dimensioni massime: - Dimensioni massime predefinite: 4.096 kilobyte. - Dimensioni massime assolute: 2 gigabyte. |
| Tipo di restrizione | Restrizione |
|---|---|
| Dimensioni file | Non deve superare le dimensioni massime: - Dimensioni massime predefinite: 4.096 kilobyte. - Dimensioni massime assolute: 2 gigabyte. Per altre informazioni, vedere Modificare le dimensioni massime degli allegati per gli elementi di lavoro. |
Nomi di colonna a bordo e corsia
La scheda trasforma il backlog in un pannello di accesso interattivo, fornendo un flusso visivo di lavoro. Man mano che il lavoro avanza dall'idea al completamento, si aggiornano gli elementi nella scheda. Ogni colonna rappresenta una fase di lavoro e ogni scheda rappresenta una storia utente (schede blu) o un bug (schede rosse) in tale fase di lavoro.
Personalizzare la lavagna aggiungendo, rimuovendo o ridenominando colonne e corsie. Le colonne supportano il flusso di lavoro in tutta la scheda. Le corsie consentono di gestire diverse classi di lavoro come corsie orizzontali sulla tavola.
I nomi di colonna e corsia devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 256 caratteri Unicode. |
| Univocità | - I nomi delle colonne non devono essere uguali a qualsiasi altro nome di colonna nella scheda. - I nomi delle corsie non devono essere uguali a qualsiasi altro nome di corsia sulla tavola. |
| Caratteri speciali | Non deve contenere caratteri di controllo Unicode o caratteri surrogati. |
Nomi dei campi
Ogni tipo di elemento di lavoro contiene uno o più campi dell'elemento di lavoro. Questi campi definiscono le informazioni archiviate per gli elementi di lavoro in base al tipo di elemento di lavoro. Ogni campo dell'elemento di lavoro ha un nome di riferimento di campo associato. Il nome del riferimento al campo identifica in modo univoco ogni campo e non può essere modificato una volta assegnato. Per altre informazioni sui campi degli elementi di lavoro predefiniti, vedere Indice dei campi elemento di lavoro.
I nomi dei campi dell'elemento di lavoro devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 128 caratteri Unicode. |
| Univocità | - I nomi dei campi devono contenere almeno un carattere alfabetico. - Non deve contenere uno dei caratteri seguenti: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.- Non deve contenere spazi iniziali o finali. - Non deve contenere due o più spazi consecutivi. |
| Caratteri speciali | Deve essere univoco all'interno dell'organizzazione o della raccolta di progetti. I nomi dei campi dell'elemento di lavoro hanno come ambito la raccolta di progetti. Se si rinomina un nome di campo, modificarlo per tutti gli elementi di lavoro e le connessioni WIT definite all'interno di tutti i progetti della raccolta. |
Nomi di riferimento dei campi e portabilità
Il linguaggio di definizione del tipo di elemento di lavoro include il concetto di nome di riferimento di campo. I nomi dei riferimenti ai campi consentono di convertire le definizioni tra le raccolte di progetti di Team Foundation e di consentire alle integrazioni non Microsoft di trovare e fare riferimento a campi specifici. Questi nomi sono globalmente univoci, proprio come uno spazio dei nomi nell'applicazione .NET Framework è globalmente univoco.
Lo spazio dei nomi System viene usato solo per definire tutti i campi di sistema di base obbligatori per le funzioni di sistema di Team Foundation. Non è possibile creare il proprio campo System.X perché potrebbe impedire la funzionalità.
Lo spazio dei nomi Microsoft viene usato per definire i campi di rilevamento degli elementi di lavoro. Questi campi vengono definiti in una definizione del tipo di elemento di lavoro dei modelli di processo.
I clienti e i partner possono creare spazi dei nomi dei campi personalizzati per i tipi di elementi di lavoro personalizzati. Per le descrizioni dei campi di sistema e dei campi definiti nei modelli di processo predefiniti, vedere Indice dei campi dell'elemento di lavoro.
Importante
- I nomi dei riferimenti ai campi non possono essere rinominati. Se ad esempio è stato modificato il nome del campo "Titolo" in "Intestazione", il nome di riferimento del campo di tale campo rimane invariato. Le integrazioni e le rappresentazioni interne dei campi devono usare il nome di riferimento del campo anziché in base al nome del campo stesso.
- Sebbene sia possibile creare un campo Microsoft.X personalizzato, non è consigliabile farlo, in quanto potrebbe impedire la funzionalità o la possibilità di aggiornare correttamente un progetto dopo un aggiornamento.
Esempi di nomi di riferimento dei campi
Gli esempi seguenti mostrano nomi di riferimento di campo validi, in vari spazi dei nomi. I clienti e i partner possono anche definire spazi dei nomi personalizzati per supportare i tipi di elemento di lavoro personalizzati.
| Esempi di spazio dei nomi di sistema | Esempi di spazi dei nomi Microsoft | Altri esempi di spazio dei nomi |
|---|---|---|
| System.Id, System.Title, System.CreatedBy, System.CreatedDate, System.ChangedBy, System.ChangedDate, System.State, System.Reason | Microsoft.VSTS.Build.FoundIn, Microsoft.VSTS.Common.Activity, Microsoft.VSTS.Common.Discipline, Microsoft.VSTS.Common.Priority, Microsoft.VSTS.CMMI.TaskType, Microsoft.VSTS.TCM.AutomationStatus, Microsoft.VSTS.TCM.TestSuiteType | La società fittizia, Fabrikam Fiber, potrebbe definire i campi dell'elemento di lavoro personalizzati seguenti: FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution La società fittizia di software Contoso Corporation potrebbe definire i campi seguenti dell'elemento di lavoro: Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase |
Testo della Guida del campo
Il sistema visualizza il testo della Guida in fase di esecuzione per aiutare gli utenti a sapere cosa immettere nel campo. Il testo della Guida ha come ambito un tipo di elemento di lavoro specifico in un progetto specifico.
Per il processo di ereditarietà, specificare il testo della Guida per un campo tramite la finestra di dialogo Modifica campo , scheda Definizione , Descrizione. Vedere Aggiungere un campo personalizzato a un tipo di elemento di lavoro. Per il processo XML locale, specificare il testo della Guida usando l'elemento HELPTEXT . Vedere Aggiungere o modificare un campo per il rilevamento del lavoro.
Il testo della Guida aggiunto deve essere conforme alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 255 caratteri Unicode. |
Elenchi globali
Un elenco globale è un set di valori di elementi di elenco che è possibile usare a livello globale in tutte le raccolte di progetti all'interno di un'istanza di Azure DevOps Server locale. Quando si definiscono i tipi di elemento di lavoro, è possibile che alcuni campi dell'elemento di lavoro condividono lo stesso set di valori consentiti o suggeriti. Gli elenchi globali consentono di definire questi valori una volta e condividerli tra più tipi e progetti di elementi di lavoro. Per informazioni dettagliate, vedere Definire elenchi globali.
Un elenco globale, definito utilizzando l'elemento GLOBALLIST contiene una o più voci di elenco, specificate utilizzando l'elemento LISTITEM .
LISTITEM i nomi devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | - Non deve contenere più di 254 caratteri Unicode. - Non deve essere vuoto. |
| Caratteri speciali | - Non deve contenere spazi vuoti iniziali o finali. - Non deve contenere due spazi consecutivi. - Non deve contenere caratteri barra \ rovesciata. |
| 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 specifiche del progetto. |
Gli elenchi globali devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Numero di articoli | Non può essere vuoto. L'elenco globale deve contenere almeno un LISTITEM elemento. |
| Univocità | Non può essere vuoto. L'elenco globale deve contenere almeno un LISTITEM elemento. |
Tipi di collegamento e nomi di riferimento di categoria
Definire un nome di riferimento ogni volta che si aggiunge o si crea un tipo di collegamento o una categoria. Tutti i nomi di riferimento possono contenere fino a 70 caratteri Unicode.
Definire un nome di riferimento usando caratteri alfanumerici, caratteri di sottolineatura e trattini. Ogni nome di riferimento deve contenere almeno un punto ., ma nessun punto può essere visualizzato all'inizio o alla fine di un nome. Un nome di riferimento non deve iniziare con un numero o un carattere di sottolineatura e non può avere più trattini consecutivi, ad esempio --.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 70 caratteri Unicode. |
| Univocità | - Non deve essere identico a qualsiasi altro nome di riferimento di campo all'interno della raccolta di progetti. - Non deve essere identico a qualsiasi altro nome di riferimento di campo dopo che tali nomi vengono elaborati dal computer per sostituire tutti i punti . con caratteri di _sottolineatura . Ad esempio, i nomi di riferimento dei campi My.*Field* e My.Field elaborano entrambi lo stesso nome: My__Field |
| Caratteri speciali | - Non deve contenere trattini -.- Deve contenere almeno un punto ..- Non deve iniziare o terminare con un punto ..- Non deve iniziare con un numeroMust non iniziare con un carattere di sottolineatura _. |
Tag dell'elemento di lavoro
I tag degli elementi di lavoro corrispondono a una o due frasi chiave per filtrare gli strumenti di rilevamento del lavoro, ad esempio backlog, bacheche e query o definire query. Per altre informazioni, vedere Aggiungere tag di elemento di lavoro per classificare e filtrare elenchi e bacheche.
I nomi dei tag devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | - Non deve contenere più di 400 caratteri Unicode. - Non deve essere null o vuoto. |
| Caratteri speciali | - Non deve contenere caratteri separatori: , o ;.- Non deve contenere caratteri di formato o controllo Unicode, ad esempio un feed di riga, un separatore di paragrafo, un ritorno a capo o altri caratteri surrogati non corrispondenti. |
| 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 specifiche del progetto. |
Azure Pipelines
Le definizioni di Azure Pipeline devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Nome processo | - Deve contenere solo caratteri alfanumerici e '_'.- Non deve iniziare con un numero. - Deve avere un nome univoco. - Non deve contenere parole chiave, ad esempio: "distribuzione". |
| Nome della fase | - Deve contenere solo caratteri alfanumerici e '_'.- Non deve iniziare con un numero. - Non deve contenere parole chiave, ad esempio: "distribuzione". |
| Espressioni | Deve iniziare con a-Z o _AND, seguito da a-Z, 0-9o _. |
Per altre informazioni, vedere la documentazione di Azure Pipelines.
Azure Repos (Git)
Ogni progetto Azure DevOps può contenere più repository Git. I nomi assegnati ai repository Git devono essere conformi alle restrizioni seguenti. Per altre informazioni, vedere la documentazione di Azure Repos Git. Per altre informazioni sulle restrizioni di denominazione per altri elementi Git, ad esempio rami e tag, vedere git check-ref-format.
Importante
Anche se è possibile includere spazi all'interno dei nomi dei repository, non è consigliabile farlo.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 64 caratteri Unicode. |
| Univocità | Non deve essere identico a qualsiasi altro nome di repository Git nel progetto. |
| Caratteri speciali | - Non devono contenere caratteri di controllo Unicode o caratteri surrogati. - Non deve contenere i caratteri stampabili seguenti: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Non deve iniziare con un carattere di sottolineatura _.- Non deve iniziare o terminare con un punto ..- Non deve essere un nome riservato di sistema. |
Azure Repos (Controllo della versione di Team Foundation)
Il controllo della versione di Team Foundation (TFVC) fornisce un repository centrale per i file e i comandi necessari per gestire tali file in un team. Fornisce anche criteri di archiviazione personalizzabili, diramazione, unione, sviamento e molte altre funzionalità. Per altre informazioni, vedere la documentazione di Azure Repos TFVC
I percorsi di controllo della versione devono essere conformi alle restrizioni seguenti. Vedere anche Ottimizzare l'area di lavoro.
| Tipo di restrizione | Restrizione |
|---|---|
| Lunghezza del percorso della cartella del controllo del codice sorgente del server | - Non deve contenere più di 259 caratteri Unicode per una singola cartella o nome file. - Non deve contenere più di 388 caratteri Unicode per una directory. - Non deve contenere più di 399 caratteri Unicode per una directory combinata e un nome di file. |
| Lunghezza percorso cartella locale | - Non deve contenere più di 248 caratteri Unicode per una directory. - Non deve contenere più di 260 caratteri Unicode per una directory combinata e un nome di file. |
| Restrizioni relative alla lunghezza specifica del portale Web e del rest | Non deve contenere più di 215 caratteri Unicode per un nome di progetto, una directory e un nome di file combinati. |
Nel portale Web e nell'API REST alcune operazioni hanno una lunghezza del percorso più restrittiva rispetto ai client di Visual Studio e TF.exe. Queste operazioni includono Modifica, Ridenominazione ed Eliminazione e si verificano perché il portale Web/REST usa un'area di lavoro generata in modo casuale per la concorrenza quando le modifiche sono in sospeso.
File TFVC
Il sistema di controllo della versione archivia molti tipi diversi di file. Configurare il controllo della versione di Team Foundation nel computer di sviluppo fornisce informazioni dettagliate su come aggiungere progetti o soluzioni di Visual Studio esistenti.
I file e le cartelle aggiunti al controllo della versione di Team Foundation devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| File e cartelle | - I nomi non devono contenere i caratteri stampabili seguenti: \ / : * ? " < > ;.- Le cartelle non devono essere esterne alla directory mappata per l'area di lavoro attiva. |
| Nomi file | - Non deve iniziare con un oggetto $.- Non deve contenere i caratteri stampabili seguenti: \ / : * ? " < > ; |. |
Etichette TFVC
Nel controllo della versione di Team Foundation (TFVC), un'etichetta è un nome applicato a un set specifico di revisioni. È possibile allegare etichette a un set di file non correlati nel controllo della versione, che consente di recuperare i file o agire su di essi come gruppo. Nella tabella seguente vengono descritte le restrizioni applicate ai nomi delle etichette.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 64 caratteri Unicode. |
| Caratteri speciali | - Non può terminare con uno spazio ( ) o un punto ..- Non deve contenere i caratteri stampabili seguenti: \ / : * ? " < > ; @ |. |
Scaffali TFVC
Gli scaffali consentono di riservare temporaneamente un batch di modifiche in sospeso e quindi, come opzione, rimuovere le modifiche in sospeso dall'area di lavoro. Successivamente, è possibile ripristinare le modifiche in un insieme di scaffali nell'area di lavoro o inserirle nell'area di lavoro di un altro utente.
I nomi degli scaffali devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 64 caratteri Unicode. |
| Caratteri speciali | Non deve contenere i caratteri stampabili seguenti: \ / : * ? " < > & ; |. |
Aree di lavoro TFVC
Un'area di lavoro è una copia lato client dei file e delle cartelle nel controllo della versione di Team Foundation (TFVC). Quando si creano più aree di lavoro, è possibile avere versioni diverse della stessa cartella del controllo della versione in un computer client. La creazione e l'uso delle aree di lavoro forniscono altri dettagli.
I nomi delle aree di lavoro devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 64 caratteri Unicode. |
| Caratteri speciali | - Non deve terminare con uno spazio ( ).- Non deve contenere i caratteri stampabili seguenti: \ / : * ? " < > ; |. |
Nomi computer
Il nome del computer in cui si installa Azure DevOps è associato al nome del server. Sia il sistema operativo che Active Directory impongono determinate restrizioni ai nomi dei computer, come descritto in questi articoli:
Nomi dell'organizzazione
Importante
Quando si crea un nome di organizzazione, attenersi alle linee guida seguenti.
- Usare solo lettere dell'alfabeto inglese
- Avviare il nome dell'organizzazione con una lettera o un numero
- Usare lettere, numeri o trattini dopo il carattere iniziale
- Assicurarsi che l'organizzazione non superi i 50 caratteri Unicode
- Terminare con una lettera o un numero
Se si utilizza uno dei caratteri non consentiti, viene visualizzato il messaggio di errore seguente: VS850015: Il nome specificato non può essere usato: {Nome organizzazione}.
Elaborare ed elaborare modelli
Un processo definisce i blocchi predefiniti del sistema di rilevamento degli elementi di lavoro e di altri sottosistemi a cui si ha accesso dopo la connessione a un progetto.
Nota
Terminologia: sia "process" che "process template" fanno riferimento a un set interdependent di file usati per creare un progetto. Per altre informazioni, vedere Informazioni sui processi e sui modelli di processo, che descrive le differenze tra i tre processi predefiniti disponibili.
I processi definiti o personalizzati devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 256 caratteri Unicode. |
| Univocità | - Deve essere univoco in Azure DevOps. - Se si carica un modello con lo stesso nome di un modello esistente, il modello esistente viene sovrascritto. |
| Dimensioni del file modello di processo | Non deve superare 2 GB (gigabyte). |
Raccolte di progetti
Una raccolta di progetti identifica un gruppo di progetti e le risorse associate a tali progetti. Fornisce una struttura organizzativa che è possibile usare per definire e controllare un gruppo di progetti definiti per un server Azure DevOps.
Inoltre, il nome della raccolta fa parte del stringa di connessione usato per connettere i membri del team ai progetti. Il valore predefinito assegnato corrisponde a DefaultCollection. Gestire le raccolte di progetti fornisce altre informazioni.
I nomi assegnati alle raccolte di progetti devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 64 caratteri Unicode. |
| Univocità | - Non deve essere identico a qualsiasi altro nome di raccolta nella distribuzione locale. - Se la distribuzione include Prodotti SharePoint o SQL Server Reporting Services, non può essere identica al nome e al percorso completo di un sito di SharePoint esistente, un server di report o un sito Web di Reporting Services. |
| Nomi riservati | Non deve essere un nome riservato del sistema. |
| Caratteri speciali | - Non devono contenere caratteri di controllo Unicode o caratteri surrogati. - Non deve contenere i caratteri stampabili seguenti: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Non deve contenere puntini di sospensione ... o un punto ..doppio.- Non deve iniziare con un carattere di sottolineatura _.- Non deve iniziare o terminare con un punto .. |
Nomi dei progetti
Un progetto stabilisce un repository per il codice sorgente e un luogo in cui i team possono pianificare, tenere traccia dello stato di avanzamento e collaborare. Il nome del progetto fa parte del stringa di connessione usato per connettere i membri del team ai progetti.
I nomi assegnati ai progetti creati devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 64 caratteri Unicode. |
| Univocità | Non deve essere identico a qualsiasi altro nome nella raccolta di progetti, nell'applicazione Web di SharePoint che supporta la raccolta o nell'istanza di SQL Server Reporting Services che supporta la raccolta. |
| Riserva nomi | - Non deve essere un nome riservato di sistema. - Non deve essere uno dei segmenti nascosti usati per i filtri delle richieste IIS, ad esempio App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin o web.config. |
| Caratteri speciali | - Non devono contenere caratteri di controllo Unicode o caratteri surrogati. - Non deve contenere i caratteri stampabili seguenti: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Non deve iniziare con un carattere di sottolineatura _.- Non deve iniziare o terminare con un punto .. |
Gruppi di sicurezza
Con i gruppi di sicurezza di Azure DevOps è possibile applicare determinati diritti o autorizzazioni a un gruppo di utenti.
I gruppi locali possono essere costituiti da account di gruppo di Active Directory, gruppi di sicurezza di Azure DevOps, account utente di Windows, account di gruppo di Windows o qualsiasi combinazione di questi tipi. Per altre informazioni, vedere Aggiungere utenti o gruppi di Active Directory/Microsoft Entra a un gruppo di sicurezza predefinito.
I gruppi di sicurezza devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Lunghezza del nome dell'account del gruppo di sicurezza | Non deve contenere più di 256 caratteri Unicode. |
| Univocità | - Gli account di gruppo a livello di progetto non devono corrispondere ad altri nomi di gruppo nello stesso progetto. - Gli account di gruppo a livello di raccolta non devono corrispondere ad alcun altro nome di un account di gruppo nella raccolta di progetti. |
| Nomi dei gruppi riservati | Non deve essere denominato con un $NAMESPACE a livello di progetto o di server. |
| Caratteri speciali | - Non devono contenere caratteri di controllo Unicode o caratteri surrogati. - Non deve contenere i caratteri stampabili seguenti: / \ [ ] : < > + = ; ? * |. - Non deve includere caratteri non stampabili nell'intervallo di valori ASCII compreso tra 1 e 31. - Non deve terminare in un punto ..- Non deve includere virgole ,. |
Team Foundation Build
Team Foundation Build consente di gestire tutti gli aspetti del processo di compilazione in un singolo computer. Usando Team Foundation Build, è possibile sincronizzare le origini, compilare l'applicazione, eseguire unit test associati, eseguire analisi del codice, rilasciare build in un file server e pubblicare report di compilazione.
Compilare un computer
Team Foundation Build è un'installazione separata dal livello applicazione Azure DevOps Server, dal livello dati o dal client di Visual Studio. È possibile scegliere un computer separato. In caso contrario, è possibile installare la compilazione side-by-side nel computer client o nei server.
Il computer di compilazione locale deve essere conforme alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Spazio su disco | Deve contenere spazio sufficiente per la compilazione (spazio insufficiente porta a compilazioni non riuscite). |
| Directory di compilazione | Deve essere un percorso locale , ad esempio C:\BuildDirectory. |
| Drop location directory (Directory percorso di rilascio) | Deve essere un percorso UNC (ad esempio, \server\share). |
| Autorizzazioni per l'eliminazione della posizione | Ogni compilazione generata viene inserita in una nuova directory nella cartella di rilascio. - L'account del servizio Team Foundation Server (ad esempio, Domain\TFSSERVICE) deve disporre dell'autorizzazione Controllo completo per l'accesso al percorso di rilascio UNC.- Il percorso di eliminazione UNC deve essere una cartella condivisa. |
| Account del servizio Team Foundation Build | Se si modifica l'account del servizio TFS dopo l'installazione iniziale, è necessario assicurarsi che le condizioni seguenti siano vere: - L'account è membro del gruppo Build Services. - L'account dispone di autorizzazioni di lettura/scrittura per le cartelle temporanee e la ASP.NET cartella temporanea. - L'account dispone dell'autorizzazione Controllo completo per la directory di compilazione e il percorso di rilascio. |
| Problemi del firewall | Se il computer di compilazione è abilitato per il firewall, assicurarsi che il programma tfsbuildservice sia incluso nell'elenco delle eccezioni. |
Tipi di compilazione
I tipi di compilazione configurano le condizioni in cui viene compilata una singola soluzione o un set di soluzioni in un progetto. Per eseguire una compilazione, è necessario creare un nuovo tipo di compilazione o usare un tipo di compilazione esistente.
I nomi dei tipi di compilazione devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Univocità | Non deve essere uguale a qualsiasi altro nome del tipo di compilazione nel progetto. |
| Caratteri speciali | Non deve contenere il carattere stampabile seguente: $. |
Qualità della compilazione
La qualità della compilazione consente di collegare uno stato di qualità o di completamento a una compilazione completata. Team Foundation Build consente anche di creare nuovi valori per il tipo di qualità di compilazione. Per un elenco dei valori predefiniti di qualità della compilazione, vedere Valutare la qualità di una compilazione completata.
I nomi di qualità della compilazione devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 256 caratteri Unicode. |
| Univocità | Non deve essere uguale a qualsiasi altro nome di qualità di compilazione nel computer Team Foundation Build. |
Nomi dei team
I nomi dei team identificano un gruppo di singoli o gruppi che interagiscono collettivamente come team in un progetto. I membri del team usano questo nome per connettersi al team o per eseguire query sui membri definiti per un team.
I nomi dei team devono essere conformi alle convenzioni che consentono di eseguirne il rendering come parte di un URL valido. Ogni nome del team deve essere univoco all'interno di un singolo progetto. Tuttavia, non esistono restrizioni sull'uso dello stesso nome del team in progetti diversi all'interno di una raccolta di progetti. Per altre informazioni, vedere Aggiungere un altro team o una gerarchia di team.
I nomi dei team devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Durata | Non deve contenere più di 64 caratteri Unicode. |
| Univocità | Non deve essere identico ad alcun altro nome nel progetto. |
| Nomi riservati | Non deve essere un nome riservato del sistema. |
| Caratteri speciali | - Non devono contenere caratteri di controllo Unicode o caratteri surrogati. - Non deve contenere i caratteri stampabili seguenti: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Non deve contenere puntini di sospensione ... o un punto ..doppio.- Non deve iniziare con un carattere di sottolineatura _.- Non deve iniziare o terminare con un punto .. |
Nomi di account utente
Gli account utente identificano le persone aggiunte a un progetto o a una raccolta di progetti. Gli account utente possono corrispondere alle voci all'interno di Active Directory, Microsoft Entra ID, gruppo di server Windows.
Gli account utente aggiunti a un'organizzazione o a una raccolta devono essere conformi alle restrizioni seguenti. Per aggiungere account utente a un progetto, vedere Aggiungere utenti a un progetto o a un team.
| Tipo di restrizione | Restrizione |
|---|---|
| Lunghezza del nome dell'account | Non deve contenere più di 256 caratteri Unicode. |
| Univocità | Non deve corrispondere ad altri account utente aggiunti alla raccolta di progetti. |
| Nomi dei gruppi riservati | Non deve essere denominato con un $NAMESPACE oggetto a livello di progetto o server. |
| Caratteri speciali | - Non deve includere i caratteri stampabili seguenti: "/ \ [ ] : < > + = ; ? * |.- Non deve includere caratteri non stampabili nell'intervallo di valori ASCII compreso tra 1 e 31. - Non deve terminare in un periodo . o un segno $di dollaro .- Non deve includere virgole ,.- Non deve includere le categorie Unicode seguenti: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Nomi di file e pagine wiki
Ogni pagina di wiki corrisponde a un file all'interno del repository Git di wiki. I nomi assegnati a un titolo di pagina di wiki devono essere conformi alle restrizioni seguenti.
| Tipo di restrizione | Restrizione |
|---|---|
| Nome file | Il percorso completo della pagina non deve superare 235 caratteri. |
| Univocità | I titoli delle pagine fanno distinzione tra maiuscole e minuscole e devono essere univoci all'interno della gerarchia di wiki. |
| Caratteri speciali | - Non devono contenere caratteri di controllo Unicode o caratteri surrogati. - Non deve contenere i caratteri stampabili seguenti: / \ #.- Non deve iniziare o terminare con un punto .. |
| Dimensione del file | Non deve superare il massimo di 18 MB. |
| Dimensione dei file allegati | Non deve superare il massimo di 19 MB. |
Caratteri speciali nei titoli delle pagine wiki
È possibile specificare i titoli di pagina che contengono uno o più di questi caratteri : < > * ? | -speciali. Ad esempio, è possibile denominare un file Markdown come "Domande frequenti?" o "Guida di configurazione". I caratteri hanno le stringhe con codifica URI seguenti:
| Carattere | Stringa codificata |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22% |