Personalizzare e gestire i tipi di collegamento
Analogamente ai tipi di elemento di lavoro, è possibile definire e modificare i tipi di collegamento personalizzati.Tuttavia, non è possibile apportare modifiche ai tipi di collegamento definiti dal sistema.Prima di aggiungere un nuovo tipo di collegamento alla raccolta di progetti team, rivedere i tipi di collegamento disponibili per l'utilizzo.Vedere Collegare elementi di lavoro e oggetti per supportare la tracciabilità.
Gestire i tipi di collegamento definiti per una raccolta di progetti team tramite i seguenti comandi witadmin:
deactivatelinktype: disattiva il tipo di collegamento specificato.Gli utenti non saranno più in grado di creare collegamenti di questo tipo.I collegamenti esistenti di questo tipo continueranno a funzionare correttamente.
deletelinktype: rimuovere in modo permanente il tipo di collegamento specificato dal database.Anche i collegamenti definiti con questo tipo di collegamento vengono rimossi.
exportlinktype: esporta le definizioni dei tipi di collegamento.È possibile esportare la definizione di un solo tipo di collegamento o di tutti i tipi di collegamento definiti per il server.
importlinktype: importa le definizioni di tipi di collegamento da un file XML.Se un tipo di collegamento con lo stesso nome di riferimento già esiste, verrà aggiornato per corrispondere al tipo di collegamento importato.Se il tipo di collegamento non è già esistente, ne verrà creato uno nuovo.
listlinktypes: elenca il set disponibile di tipi di collegamento su un server.
reactivatelinktype: Riattiva il tipo di collegamento specificato e facoltativamente gli assegna un nuovo nome.
Per eseguire lo strumento della riga di comando witadmin, aprire una finestra Prompt dei comandi in cui è installato Visual Studio o Team Explorer e immettere:
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
In una versione a 64 bit di Windows sostituire %programfiles% con %programfiles(x86)%.
Requisiti
Per la raccolta di progetti team in cui sono definiti i tipi di collegamento, è necessario disporre del set di autorizzazioni seguente:
Per elencare o esportare i tipi di collegamento, è necessario che l'autorizzazione Visualizza informazioni a livello di progetto per un progetto team nella raccolta sia impostata su Consenti.
Per eliminare, importare o riattivare i tipi di collegamento, è necessario essere un membro del gruppo di sicurezza Project Collection Administrators o disporre dell'autorizzazione Gestisci tipi di collegamento elemento di lavoro impostata su Consenti.
Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server e Gruppi predefiniti, autorizzazioni e ruoli di Team Foundation Server.
[!NOTA]
Anche se si accede con autorizzazioni amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione su un server che esegue Windows Server 2008.Per aprire una finestra del prompt dei comandi con privilegi elevati, scegliere Start, aprire il menu di scelta rapida Prompt dei comandi, quindi scegliere Esegui come amministratore.Per ulteriori informazioni, visitare il sito Web Microsoft Controllo dell'account utente.
witadmin deactivatelinktype /collection:CollectionURL /n:LinkName
witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]
witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding]
witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]
witadmin listlinktypes /collection:CollectionURL
witadmin reactivatelinktype /collection:CollectionURL /n:LinkName
Parametri
Parametro |
Descrizione |
|---|---|
/collection:CollectionURL |
Specifica l'URI della raccolta di progetti team.Il formato per l'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme Ad esempio: http://ServerName:8080/tfs/Collection0 Se non viene utilizzata una directory virtuale, il formato dell'URI sarà il seguente: http://NomeServer:Porta/NomeInsieme |
/n:LinkName |
Il nome o il nome di riferimento del tipo di collegamento da disattivare o eliminare. |
/f:FileName |
Nome del file XML dei tipi di collegamento.Richiesto per importazione, facoltativo per esportazione.Se si omette questo parametro, l'output dei comandi viene visualizzato sul display. |
/e:encoding |
Il nome di un formato di codifica .NET Framework 2.0.La codifica specificata verrà utilizzata per esportare o importare i dati XML.Ad esempio, /e:utf-7 specifica la codifica Unicode (UTF-7).Se si omette questo parametro, witadmin tenta di rilevare la codifica e se il rilevamento non riesce, witadmin utilizza UTF-8. |
/v |
Convalida il codice XML del tipo di collegamento senza importarlo. |
/noprompt |
Disabilita la richiesta di conferma. |
/? o help |
Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi. |
Note
Per la struttura dello schema di definizione del tipo di collegamento, vedere Riferimento all'elemento tipo di collegamento.
Per informazioni su come è possibile limitare i tipi di relazioni di collegamento che i membri del team possono eseguire, vedere Collegamento di elementi di lavoro e restrizioni e controlli dei collegamenti e Elementi LinksControlOptions.
Esempi
Se non diversamente specificato, i valori seguenti vengono applicati in ogni esempio:
URI per la raccolta di progetti team: http://AdventureWorksServer:8080/tfs/DefaultCollection
Nome del server: AdventureWorksServer
Nome del file di input o di output: myLinkTypes.xml
Nome del tipo di collegamento: mylinktype
Codifica predefinita: UTF-8
.gif "Dd273716.collapse_all(it-it,VS.110).gif")
Elencare i tipi di collegamento
Nel comando seguente vengono visualizzati i tipi di collegamento personalizzati definiti per AdventureWorksServer di Team Foundation.
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Elencare le definizioni di un tipo di collegamento
Nell'esempio seguente viene visualizzata la definizione del tipo di collegamento nella finestra Prompt dei comandi:
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Disattivare e riattivare un tipo di collegamento
Negli esempi seguenti viene prima disattivato il tipo di collegamento, mylinktype, e poi riattivato:
witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
Esportare le definizioni di un tipo di collegamento
Il comando seguente consente di esportare la definizione di tutti i tipi di collegamento al file mylinktype.xml:
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
Importare la definizione di tipi di collegamento
Nell'esempio seguente viene importata la definizione dei tipi di collegamento definita nel file XML:
witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
Vedere anche
Concetti
Riferimento all'elemento tipo di collegamento
Collegamento di elementi di lavoro e restrizioni e controlli dei collegamenti
Altre risorse
Collegare elementi di lavoro e oggetti per supportare la tracciabilità
witAdmin: personalizzare e gestire oggetti per il rilevamento degli elementi di lavoro