Attività di Team Foundation Lab Management

Articolo
08/11/2011

Quando si personalizza un modello di flusso di lavoro di Lab Management (LabDefaultTemplate.xaml), è possibile utilizzare una o più delle attività predefinite di Lab Management. È anche possibile accedere agli oggetti creati tramite la procedura guidata Lab Management. In questo argomento vengono descritti gli oggetti e le attività di Team Foundation Lab Management che sono disponibili quando si personalizza un modello di flusso di lavoro per compilare, distribuire e testare l'applicazione. Per informazioni su come utilizzare queste attività in un flusso di lavoro personalizzato, vedere Personalizzazione del flusso di lavoro di Lab Management.

In questo argomento sono contenute le seguenti sezioni:

Attività di Lab Management

Nella seguente tabella sono descritte le attività relative al flusso di lavoro di Lab Management.

Attività	Descrizione
CreateLabEnvironment	Crea un nuovo ambiente da un modello archiviato e lo distribuisce nel gruppo host specificato.
DeleteLabEnvironment	Elimina un ambiente.
DeleteSnapshot	Elimina uno snapshot di un ambiente.
ExecuteRemoteTestRun	Crea un'esecuzione dei test in un ambiente e attende che l'operazione venga completata.
GenerateEnvironmentViewerFile	Genera un file del Visualizzatore dell'ambiente con l'ID del collegamento allo snapshot. Viene utilizzato per connettersi a uno snapshot dell'ambiente.
GetBuildLocationAndBuildNumber	Restituisce il percorso e il numero della build per uno scenario di compilazione, distribuzione e test.
GetLabEnvironmentInUseMarker	Restituisce il marcatore In uso per un ambiente.
GetLabEnvironmentSnapshotId	Ottiene l'ID di uno snapshot di un ambiente.
GetLabEnvironmentStatus	Ottiene lo stato dell'ambiente.
GetLabEnvironmentUri	Ottiene l'URI dell'ambiente per un nome dell'ambiente e un percorso lab specifici.
InitializeAgentSpecAndEnvironmentVariables	Analizza i dettagli dello script di distribuzione specificati dalla proprietà.
ResetLabEnvironmentInuseMarker	Reimposta il marcatore In uso per un ambiente.
RestoreLabEnvironment	Ripristina lo snapshot specificato dell'ambiente.
RunDeploymentScript	Esegue lo script di distribuzione. In caso di errore, genera o scrive un avviso di compilazione come specificato nella proprietà ThrowOnError.
RunWorkflow	Accoda un nuovo flusso di lavoro in un controller di compilazione di un server di compilazione.
SaveLabEnvironment	Crea un nuovo ambiente e lo archivia in una condivisione di libreria del progetto team.
SetLabEnvironmentInuseMarker	Imposta il marcatore In uso sull'ambiente.
SnapshotLabEnvironment	Crea uno snapshot di un ambiente.
StartLabEnvironment	Avvia l'ambiente.
StopLabEnvironment	Arresta l'ambiente.
WaitForTestCapabilityServices	Attende il tempo massimo specificato per la preparazione della funzionalità di test dell'ambiente. Alla fine del tempo di attesa, se la funzionalità di test non è pronta, viene generata un'eccezione di timeout.
WaitForWorkflow	Tipo di flusso di lavoro.
WaitForWorkflowCapabilityServices	Attende il completamento della compilazione in coda per un specifico tempo massimo di attesa. Se il flusso di lavoro della compilazione non termina nel tempo massimo specificato, viene generata l'eccezione TimeOutException. L'attività controlla periodicamente lo stato della compilazione in coda per determinare quali compilazioni sono terminate. Questo intervallo si configura tramite la proprietà RefreshInterval.
WriteDeploymentInformation	Scrive le informazioni di distribuzione incluse nel riepilogo della compilazione.

CreateLabEnvironment

Crea un nuovo ambiente da un modello archiviato e lo distribuisce nel gruppo host specificato. Si tratta di un'attività a esecuzione prolungata che attende il completamento della creazione del nuovo ambiente. Se il nuovo ambiente lab non può essere creato, viene generata l'eccezione LabDeploymentProcessException dall'attività.

Proprietà

LabEnvironmentName	Nome del nuovo ambiente. Se la proprietà è null o vuota, verrà utilizzato il nome del modello di ambiente.
LabEnvironmentTemplateUri	URI di un modello di ambiente archiviato. È possibile ottenere l'URI del modello di ambiente lab tramite l'attività GetLabEnvironmentUri. Obbligatoria.
TeamProjectHostGroupName	Gruppo host in cui verrà distribuito il nuovo ambiente. Se il gruppo host specificato non viene trovato, viene generata un'eccezione NoTeamProjectHostGroupFoundException. Obbligatoria.

LabEnvironmentUri	URI dell'ambiente lab con lo snapshot che verrà eliminato. È possibile ottenere l'URI dell'ambiente lab tramite l'attività GetLabEnvironmentUri. Obbligatoria.
SnapshotId	ID dello snapshot da eliminare. È possibile ottenere l'ID dello snapshot tramite l'attività GetLabEnvironmentSnapshotId. Obbligatoria.

BuildNumber	Numero della build su cui vengono eseguiti i test.
LabEnvironmentUri	URI dell'ambiente su cui vengono eseguiti i test case. È possibile ottenere l'URI dell'ambiente tramite l'attività GetLabEnvironmentUri.
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	Numero massimo di errori consecutivi che devono essere ignorati durante l'attesa dell'attività per l'esecuzione dei test. Il valore predefinito di questa proprietà è 3.
MaxWaitTime	Valore TimeSpan che specifica il tempo massimo di attesa per il completamento dell'esecuzione dei test. Alla fine del tempo di attesa specificato viene generata un'eccezione di timeout. Il valore predefinito è 0 (zero) in modo che l'attività attenda all'infinito.
RefreshInterval	Valore TimeSpan che specifica l'intervallo di aggiornamento dello stato dell'esecuzione dei test. Il valore predefinito dell'intervallo è di 60 secondi.
TestDirectory	Percorso degli eseguibili di test.
TestEnvironment	Nome dell'ambiente di test su cui vengono eseguiti i test case.
TestParameters	Oggetto RunTestDetails che specifica i parametri di test, ad esempio il piano di test, il gruppo di test, le impostazioni di test e la configurazione di test. Obbligatoria.
Titolo	Nome dell'esecuzione dei test. Obbligatoria.

FilePath	Percorso UNC in cui archiviare il file del Visualizzatore dell'ambiente. L'account del servizio di compilazione deve disporre dell'autorizzazione in scrittura per il percorso. Obbligatoria.
LabEnvironmentUri	URI dell'ambiente. È possibile ottenere l'URI dell'ambiente tramite l'attività GetLabEnvironmentUri. Obbligatoria.
SnapshotId	ID dello snapshot. È possibile ottenere l'ID dello snapshot tramite l'attività GetLabEnvironmentSnapshotId. Se lo snapshot non è valido, viene generata un'eccezione InvalidSnapshotException. Obbligatoria.

BuildDetails	Oggetto Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails contenente le informazioni relative alla compilazione in uno scenario di compilazione, distribuzione e test.
BuildNumber	Numero della build selezionata. È un outArgument. È null per le compilazioni non "Team Build".
SelectedBuild	Informazioni di compilazione sul server di compilazione. È un outArgument. È null per le compilazioni non "Team Build".

LabEnvironmentUri	URI dell'ambiente. Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente. Obbligatoria.
SnapshotName	Nome dello snapshot. Obbligatoria.

LabEnvironmentName	Nome dell'ambiente. Obbligatoria.
ProjectName	Nome del progetto Team. Se questo valore di proprietà è null o non specificato, viene utilizzato il progetto corrente della compilazione.
TeamProjectLabLocationName	Nome del percorso lab. Può essere il nome di un gruppo host o di una condivisione di libreria. Se il percorso lab non viene trovato, viene generata un'eccezione NoLabLocationFoundException. Obbligatoria.

BuildLocation	Percorso di compilazione. Si utilizza per espandere la macro $(BuildLocation). Obbligatoria.
DeploymentScriptDetails	Dettagli di distribuzione nel formato " nomesistemalab \| argomenti script \| directory di lavoro". Obbligatoria.
LabEnvironmentUri	URI dell'ambiente. Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente. Obbligatoria.

MaximumAttemptsForNetUse	Numero massimo di tentativi per aggiungere l'utilizzo netto.
ScriptDetails	Oggetto ScriptDetails per un sistema lab. Obbligatoria.
SharedLocationForNetUse	Percorso che deve essere accessibile dall'account del servizio lab.
ThrowOnError	Flag per indicare se viene generata un'eccezione in caso di errore. Il valore predefinito è True.

BuildController	Nome del controller di compilazione. Se questa proprietà e il valore della proprietà LabEnvironmentUri sono null o non specificati, per accodare la compilazione viene utilizzato il controller di compilazione corrente.
BuildDefinition	Definizione della compilazione da accodare. Obbligatoria.
LabEnvironmentUri	URI dell'ambiente con le funzionalità del flusso di lavoro. Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente. Obbligatoria.
ProjectName	Nome del progetto Team. Se questa proprietà è null o non specificata, viene utilizzato il progetto corrente della compilazione.

LabEnvironmentName	Nome per l'ambiente salvato. Se la proprietà è null o vuota, verrà utilizzato il nome dell'ambiente.
LabEnvironmentUri	URI dell'ambiente da salvare. Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente. Obbligatoria.
TeamProjectLibraryShareName	Condivisione di libreria in cui viene archiviato l'ambiente. Se la condivisione di libreria specificata non viene trovata, viene generata un'eccezione NoTeamProjectLibraryShareFoundException. Obbligatoria.

Commento	Commento scritto quando il marcatore viene impostato.
LabEnvironmentUri	URI dell'ambiente. Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente. Obbligatoria.

LabEnvironmentUri	URI dell'ambiente con lo snapshot da eseguire. Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente. Obbligatoria.
SnapshotChainId	Restituisce l'ID della catena di snapshot.
SnapshotName	Nome dello snapshot da eseguire. Se questa proprietà è null, come nome dello snapshot viene utilizzato il valore corrente di DateTime.

AllowPartiallySucceededBuild	Se true, una compilazione parzialmente completata viene considerata come completata.
BuildDetails	Oggetto Microsoft.TeamFoundation.Build.Client.IBuildDetail contenente i dettagli della compilazione in coda nel server di compilazione. È un argomento Out.
LabWorkflowType	Il tipo di flusso di lavoro.
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	Numero massimo di errori consecutivi che devono essere ignorati durante l'attesa del completamento del flusso di lavoro. Il valore predefinito è 3. Questa proprietà può essere utilizzata per aumentare l'affidabilità del flusso di lavoro.
MaxWaitTime	Oggetto System.TimeSpan che specifica il tempo massimo di attesa per il completamento del flusso di lavoro. Alla fine del tempo di timeout specificato viene generata un'eccezione di timeout. Il valore predefinito è 0 (zero) e indica che il tempo di attesa è illimitato.
QueueBuildId	ID della compilazione in coda. Obbligatoria.
RefreshInterval	Oggetto System.TimeSpan che specifica l'intervallo di aggiornamento dello stato del flusso di lavoro. Il valore predefinito dell'intervallo è di 60 secondi.
ThrowOnError	Se true, viene generata un'eccezione se la compilazione non riesce.

Oggetto	Descrizione
LabWorkflowDetails	La classe LabWorkflowDetails contiene i dati di configurazione della Configurazione guidata Parametri flusso di lavoro lab. L'oggetto LabWorkflowDetails contiene gli oggetti BuildDetails, RunTestDetails e ScriptDetails.
BuildDetails	Archivia i dettagli di compilazione per uno scenario di compilazione, distribuzione e test.
DeploymentDetails	Archivia i dettagli del parametro di test richiesti per creare l'esecuzione dei test automatizzati nel flusso di lavoro di compilazione, distribuzione e test.
LabEnvironmentDetails	Archivia le informazioni necessarie per identificare l'ambiente lab nello scenario di compilazione, distribuzione e test.
LabEnvironmentInUseMarker	Archivia i dettagli del marcatore In uso di un ambiente.
LabEnvironmentState	Specifica lo stato corrente dell'ambiente.
RunTestDetails	Archivia i dettagli del parametro di test richiesti per creare l'esecuzione dei test automatizzati.
ScriptDetails	Archivia i dettagli dello script di distribuzione necessari per uno scenario di compilazione, distribuzione e test.
ScriptDetails	Archivia i dettagli di un'esecuzione dei test.

BuildDetails	Oggetto BuildDetails creato dalla procedura guidata del flusso di lavoro, che archivia i dettagli di compilazione per uno scenario di compilazione, distribuzione e test.
DeploymentDetails	Oggetto LabEnvironmentDetails creato dalla procedura guidata del flusso di lavoro, che archivia le informazioni richieste per la distribuzione di uno scenario di compilazione, distribuzione e test.
EnvironmentDetails	Oggetto LabEnvironmentDetails creato dalla procedura guidata del flusso di lavoro, che archivia le informazioni che identificano l'ambiente da utilizzare per uno scenario di compilazione, distribuzione e test.
TestParameters	Oggetto RunTestDetails creato dalla procedura guidata del flusso di lavoro, che archivia i dettagli del parametro di test richiesti per creare l'esecuzione dei test automatizzati.

IsTeamSystemBuild	Valore Boolean che indica se la compilazione utilizzata è di tipo Team Build.
BuildDefinitionUri	Valore Uri che specifica l'URI della definizione della compilazione.
BuildDefinitionName	Valore String che specifica il nome della definizione della compilazione.
QueueNewBuild	Valore Boolean che indica se la nuova compilazione viene accodata.
BuildUri	Valore Uri che specifica l'URI della compilazione, se la compilazione è di tipo Team Build.
CustomBuildPath	Valore String che specifica il percorso della compilazione, se la compilazione non è di tipo Team Build.
Configurazione

PostDeploymentSnapshotPath	Valore String che contiene il percorso per archiviare lo snapshot di post-distribuzione.
PostDeploymentSnapshotName	Valore String che specifica il nome dello snapshot eseguito dopo la distribuzione.
TakePostDeploymentSnapshot	Valore Boolean che specifica se uno snapshot post-distribuzione è necessario.
Script	Oggetto StringList contenente un elenco di macchine virtuali con gli script di distribuzione corrispondenti.
DeploymentNeeded	Valore Boolean che specifica se la distribuzione deve essere eseguita.

ProjectName	Valore String che specifica il nome del progetto team.
LabEnvironmentName	Valore String che specifica il nome dell'ambiente lab.
NewLabEnvironmentName	Valore String che specifica il nome dell'ambiente lab da creare.
HostGroupName	Valore String che specifica il nome del gruppo host in cui viene distribuito l'ambiente.
LabLibraryShareName	Valore String che specifica il nome della condivisione di libreria contenente il modello di ambiente lab archiviato.
RevertToSnapshot	Valore Boolean che indica se per l'ambiente viene eseguito il rollback a uno snapshot.
SnapshotName	Valore String che specifica il nome dello snapshot dell'ambiente a cui eseguire il rollback.
TfsUrl	Valore String che specifica l'URL di Team Foundation Server.
LabEnvironmentUri	Valore Uri che specifica l'URI dell'ambiente selezionato.
Disposition	Valore enumerato LabEnvironmentDisposition che indica lo stato dell'ambiente. Possibili valori: Sconosciuto: lo stato dell'ambiente non è noto. Attivo: l'ambiente è distribuito in un host e può essere avviato ed eseguito. Archiviato: l'ambiente è archiviato in una condivisione di libreria e non può essere utilizzato finché non viene distribuito.

TfsUrl	Valore String che specifica l'URL di Team Foundation Server.
Nome progetto	Valore String che specifica il nome del progetto team.
TestConfigurationId	Valore Int32 che specifica l'ID della configurazione di test per l'esecuzione dei test.
TestPlanId	Valore Int32 che specifica l'ID del piano di test.
TestSuiteIdList	Systems.Collections.Generic.List<int> che contiene gli ID numerici dei gruppi di test da eseguire.
TestSettingsId	Valore Int32 che specifica l'ID delle impostazioni test per l'esecuzione dei test.
RunTest	Valore Boolean che specifica se eseguire il test.

LabSystemName	Valore String che specifica il nome dell'ambiente lab.
AgentSpec	Oggetto AgentReservationSpec contenente i tag associati a un agente di compilazione nel sistema lab.
FileName	Valore String che specifica il nome del file script di distribuzione.
Argomenti	Valore String che specifica gli argomenti da passare allo script di distribuzione.
WorkingDirectory	Valore String che specifica la directory di lavoro per lo script di distribuzione nel sistema lab.
EnvironmentVariables	System.Collection.Generic.IDictionary<String, String> che contiene la coppia nome/valore delle variabili di ambiente.

Condividi tramite

Attività di Team Foundation Lab Management

Attività di Lab Management

CreateLabEnvironment

DeleteLabEnvironment

DeleteSnapshot

ExecuteRemoteTestRun

GenerateEnvironmentViewerFile

GetBuildLocationAndBuildNumber

GetLabEnvironmentInUseMarker

GetLabEnvironmentSnapshotId

GetLabEnvironmentStatus

GetLabEnvironmentUri

InitializeAgentSpecAndEnvironmentVariables

ResetLabEnvironmentInuseMarker

RestoreLabEnvironment

RunDeploymentScript

RunWorkflow

SaveLabEnvironment

SetLabEnvironmentInuseMarker

SnapshotLabEnvironment

StartLabEnvironment

StopLabEnvironment

WaitForTestCapabilityServices

WaitForWorkflow

WaitForWorkflowCapabilityServices

WriteDeploymentInformation

Classi di Lab Management

LabWorkflowDetails

BuildDetails

DeploymentDetails

LabEnvironmentDetails

RunTestDetails

ScriptDetails

TestRunStatistics

LabEnvironmentInUseMarker

LabEnvironmentState

Vedere anche

Altre risorse

Cronologia delle modifiche

Risorse aggiuntive

TotalTests	Valore Int32 che specifica il numero totale dei test nell'esecuzione dei test.
PassedTests	Valore Int32 che specifica il numero dei test superati nell'esecuzione dei test.
FailedTests	Valore Int32 che specifica il numero dei test non superati nell'esecuzione dei test.
InconclusiveTests	Valore Int32 che specifica il numero dei test senza risultati nell'esecuzione dei test.
PendingTests	Valore Int32 che specifica il numero dei test non ancora eseguiti nell'esecuzione dei test.
AbortedTests	Valore Int32 che specifica il numero dei test interrotti nell'esecuzione dei test.
InProgressTests	Valore Int32 che specifica il numero dei test attualmente in esecuzione nell'esecuzione dei test.
TestRunStatus	Valore enumerato di TestRunState che specifica lo stato dell'esecuzione dei test.
TestRunId	Valore Int32 che specifica l'identificatore dell'esecuzione dei test.

Utente	Valore String che specifica l'utente che ha contrassegnato l'ambiente.
Timestamp	Valore DateTime che specifica l'ora in cui l'ambiente è stato contrassegnato dall'utente.
Commento	Valore String specificato dall'utente che ha contrassegnato l'ambiente.