Condividi tramite

Gestire i tipi di collegamento [witadmin]

  • Articolo

Analogamente ai tipi di elemento di lavoro, è possibile definire e modificare i tipi di collegamento personalizzati. Non è tuttavia possibile modificare i tipi di collegamento definiti dal sistema. Prima di aggiungere un nuovo tipo di collegamento all'insieme di progetti team, verificare i tipi di collegamento disponibili per l'utilizzo. Vedere Collegare elementi di lavoro per supportare la tracciabilità.

Per gestire i tipi di collegamento definiti per un insieme di progetti team, usare i comandi witadmin seguenti:

  • deactivatelinktype: disattiva il tipo di collegamento specificato. Gli utenti non potranno più creare collegamenti di questo tipo. I collegamenti esistenti di questo tipo continueranno a funzionare correttamente.

  • deletelinktype: elimina in modo permanente il tipo di collegamento specificato dal database. Verranno rimossi anche tutti i collegamenti definiti con questo tipo di collegamento.

  • exportlinktype: esporta le definizioni dei tipi di collegamento. È possibile esportare la definizione di un singolo tipo di collegamento o di tutti i tipi di collegamento definiti per il server.

  • importlinktype: importa le definizioni dei tipi di collegamento da un file XML. Se esiste già un tipo di collegamento con lo stesso nome di riferimento, verrà aggiornato in modo da corrispondere al tipo di collegamento importato. Se il tipo di collegamento non esiste già, verrà creato un nuovo tipo di collegamento.

  • listlinktypes: elenca il set di tipi di collegamento disponibile nel server.

  • reactivatelinktype: riattiva il tipo di collegamento specificato e, facoltativamente, assegna un nuovo nome al tipo di collegamento.

Per eseguire lo strumento da riga di comando witadmin, aprire una finestra del prompt dei comandi in cui è installato Visual Studio o Team Explorer e immettere:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

In una versione a 32 bit di Windows sostituire %programfiles(x86)% con %programfiles%.

Requisiti

Per gli insiemi di progetti team in cui sono definiti i tipi di collegamento, devono essere disponibili i set di autorizzazioni seguenti:

  • Per esportare i tipi di collegamento, è necessario che l'autorizzazione Visualizza informazioni a livello di progetto per il 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 che l'autorizzazione Gestisci tipi di collegamento elemento di lavoro sia impostata su Consenti.

Per altre informazioni, vedere Riferimento alle autorizzazioni per 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 in 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 per Prompt dei comandi, quindi scegliere Esegui come amministratore.Per altre informazioni, vedere 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 dell'insieme di progetti team. Il formato dell'URI è il seguente: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeRaccolta

Ad esempio:

http://ServerName:8080/tfs/Collection0

Se non viene usata alcuna directory virtuale, il formato dell'URI sarà il seguente:

http://NomeServer:Porta/NomeRaccolta

/n:LinkName

Nome o nome di riferimento del tipo di collegamento da disattivare o eliminare.

/f:FileName

File XML dei tipi di collegamento. Obbligatorio per l'importazione, facoltativo per l'esportazione. Se si omette questo parametro, verrà visualizzato sullo schermo l'output del comando.

/e:encoding

Nome di un formato di codifica .NET Framework 2.0. La codifica specificata verrà usata per esportare o importare i dati XML. Ad esempio, /e:utf-7 specifica la codifica Unicode (UTF-7). Se si omette questo parametro, verrà tentato da parte di witadmin di rilevare la codifica. Se il rilevamento non riesce, verrà usata da witadmin la codifica UTF-8.

/v

Convalida il tipo di collegamento XML senza importarlo.

/noprompt

Disabilita il prompt di conferma.

/? oppure help

Visualizza il testo della Guida relativo al comando nella finestra del prompt dei comandi.

Note

Per informazioni sulla struttura dello schema di definizione del tipo di collegamento, vedere Riferimento all'elemento tipo di collegamento.

Per informazioni su come limitare i tipi di relazioni tra collegamenti che i membri del team possono creare, vedere Riferimenti a controlli dei collegamenti, restrizioni e campi e Elementi LinksControlOptions.

Esempi

Se non diversamente specificato, in ciascun esempio vengono applicati i valori seguenti:

  • URI per l'insieme di progetti team: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Nome server: AdventureWorksServer

  • Nome del file di input o di output: myLinkTypes.xml

  • Nome del tipo di collegamento: mylinktype

  • Codifica predefinita: UTF-8

Elencare i tipi di collegamento

Il comando seguente visualizza i tipi di collegamento personalizzati definiti per Team Foundation AdventureWorksServer.

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Elencare la definizione di un tipo di collegamento

Nell'esempio seguente viene visualizzata la definizione del tipo di collegamento nella finestra del prompt dei comandi:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Disattivare e quindi riattivare un tipo di collegamento

Gli esempi seguenti disattivano il tipo di collegamento, mylinktype, quindi lo riattivano:

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Esportare la definizione di un tipo di collegamento

Il comando seguente esporta la definizione di tutti i tipi di collegamento nel file, mylinktype.xml:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Importare la definizione dei tipi di collegamento

L'esempio seguente importa la definizione dei tipi di collegamento definiti nel file XML:

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Vedere anche

Concetti

Riferimento all'elemento tipo di collegamento

Riferimenti a controlli dei collegamenti, restrizioni e campi

Altre risorse

Collegare elementi di lavoro per supportare la tracciabilità

witAdmin: personalizzare e gestire oggetti per gestire il lavoro