Condividi tramite

Attività del flusso di lavoro di Lab Management

  • Articolo

Quando si personalizza un modello di flusso di lavoro di Lab Management (LabDefaultTemplate.11.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.

Requisiti

  • Visual Studio Ultimate, Visual Studio Premium, Visual Studio Test Professional

Di seguito sono elencate le diverse sezioni di questo argomento:

  1. Lab Management Activities

  2. Lab Management Classes

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 snapshot dell'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.

Ff934562.collapse_all(it-it,VS.110).gifCreateLabEnvironment

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.Necessario.

TeamProjectHostGroupName

Gruppo host in cui verrà distribuito il nuovo ambiente.Se il gruppo host specificato non viene trovato, viene generata un'eccezione NoTeamProjectHostGroupFoundException.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifDeleteLabEnvironment

Elimina un ambiente.Si tratta di un'attività a esecuzione prolungata che attende il completamento dell'eliminazione dell'ambiente.Se l'eliminazione dell'ambiente non riesce, viene generata l'eccezione LabDeploymentProcessException dall'attività.

Proprietà

LabEnvironmentUri

URI dell'ambiente da eliminare.È possibile ottenere l'URI dell'ambiente lab tramite l'attività GetLabEnvironmentUri.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifDeleteSnapshot

Elimina uno snapshot di un ambiente.Si tratta di un'attività a esecuzione prolungata che attende il completamento dell'eliminazione dello snapshot.Se l'eliminazione dello snapshot non riesce, viene generata l'eccezione LabDeploymentProcessException dall'attività.

Proprietà

LabEnvironmentUri

URI dell'ambiente lab con lo snapshot che verrà eliminato.È possibile ottenere l'URI dell'ambiente lab tramite l'attività GetLabEnvironmentUri.Necessario.

SnapshotId

ID dello snapshot da eliminare.È possibile ottenere l'ID dello snapshot tramite l'attività GetLabEnvironmentSnapshotId.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifExecuteRemoteTestRun

Crea un'esecuzione dei test in un ambiente e attende che l'operazione venga completata.Si tratta di un'attività a esecuzione prolungata che attende la fine dell'esecuzione dei test o la scadenza del timeout.È possibile impostare il timeout tramite la proprietà MaxWaitTime.Questa attività controlla periodicamente lo stato dell'esecuzione dei test per determinare quali esecuzioni dei test sono terminate.Questo intervallo si configura tramite la proprietà RefreshInterval.È possibile utilizzare la proprietà MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion per specificare per quante volte gli errori di Team Foundation Server possono consecutivamente ignorati durante il controllo dello stato dell'esecuzione dei test.

Valore restituito

Oggetto TestRunStatistics che archivia i dettagli dell'esecuzione dei test.

Proprietà

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 di tale intervallo è 60 secondi.

TestDirectory

Percorso degli eseguibili di test.

TestEnvironment

Nome dell'ambiente di test su cui vengono eseguiti i test case.

TestParameters

Oggetto Microsoft.TeamFoundation.Lab.Workflow.Activities.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.Necessario.

Titolo

Nome dell'esecuzione dei test.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifGenerateEnvironmentViewerFile

Genera un file del Visualizzatore dell'ambiente contenente l'ID del collegamento allo snapshot.Questa attività viene utilizzata per connettersi a uno snapshot dell'ambiente.Il nome del file del Visualizzatore dell'ambiente è il nome dello snapshot senza i seguenti caratteri speciali: @"\[\`~\!@\#$%^&\*()+=\[{\\\]}|\\\\;:',/?\]" + "\"".

Proprietà

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.Necessario.

LabEnvironmentUri

URI dell'ambiente.È possibile ottenere l'URI dell'ambiente tramite l'attività GetLabEnvironmentUri.Necessario.

SnapshotId

ID dello snapshot.È possibile ottenere l'ID dello snapshot tramite l'attività GetLabEnvironmentSnapshotId.Se lo snapshot non è valido, viene generata un'eccezione InvalidSnapshotException.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifGetBuildLocationAndBuildNumber

Restituisce il percorso e il numero della build per uno scenario di compilazione, distribuzione e test.Se si seleziona "Team Build" e l'URI di compilazione è null, viene selezionata l'ultima compilazione valida e vengono restituiti i dettagli.Se non viene trovata l'ultima compilazione valida, viene generata un'eccezione System.ArgumentException.Se "Team Build" non è selezionato, viene restituito solo il percorso della compilazione specificato dall'utente.

Valore restituito

Valore String che specifica il percorso di compilazione.

Proprietà

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".

Back to top

Ff934562.collapse_all(it-it,VS.110).gifGetLabEnvironmentInUseMarker

Ottiene il marcatore In uso per un ambiente.

Valore restituito

LabEnvironmentInUseMarker che specifica i dettagli del marcatore dell'ambiente.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifGetLabEnvironmentSnapshotId

Ottiene l'ID di uno snapshot di un ambiente.Se non viene trovato alcuno snapshot con il nome specificato, viene generata un'eccezione NoSnapshotFoundException dall'attività.

Valore restituito

Valore Int64 che specifica l'identificatore dello snapshot.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

SnapshotName

Nome dello snapshot.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifGetLabEnvironmentStatus

Ottiene lo stato dell'ambiente.

Valore restituito

Valore enumerato di LabEnvironmentState che indica lo stato corrente dell'ambiente.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifGetLabEnvironmentUri

Ottiene l'URI dell'ambiente per un nome dell'ambiente e un percorso lab specifici.Il percorso lab può essere un gruppo host o una condivisione di libreria.Se l'ambiente non viene trovato, viene generata l'eccezione LabEnvironmentNotFoundException dall'attività.

Valore restituito

Valore String che specifica l'URI dell'ambiente.

Proprietà

LabEnvironmentName

Nome dell'ambiente.Necessario.

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.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifInitializeAgentSpecAndEnvironmentVariables

Inizializza gli argomenti richiesti per l'attività RunDeploymentScript.InitializeAgentSpecAndEnvironmentVariables estrae le proprietà delle macchine virtuali dell'ambiente, le quali vengono richieste per utilizzare lo script di distribuzione nei computer.

Valore restituito

Oggetto ScriptDetails che archivia i dettagli dello script richiesti per la distribuzione.

Proprietà

BuildLocation

Percorso di compilazione.Si utilizza per espandere la macro $(BuildLocation).Necessario.

DeploymentScriptDetails

Dettagli di distribuzione nel formato " nomesistemalab | argomenti script | directory di lavoro".Necessario.

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifResetLabEnvironmentInuseMarker

Reimposta il marcatore In uso per un ambiente.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifRestoreLabEnvironment

Ripristina lo snapshot specificato dell'ambiente.Se lo snapshot non è valido, viene generata un'eccezione InvalidSnapshotException dall'attività.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

SnapshotId

ID dello snapshot a cui ripristinare l'ambiente.È possibile ottenere l'ID dello snapshot tramite l'attività GetLabEnvironmentSnapshotId.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifRunDeploymentScript

Esegue lo script di distribuzione.Se lo script non riesce, genera o scrive un avviso di compilazione come specificato nella proprietà ThrowOnError.

Valore restituito

Valore enumerato di BuildStatus che specifica lo stato dell'operazione di distribuzione.

Proprietà

MaximumAttemptsForNetUse

Numero massimo di tentativi per aggiungere l'utilizzo netto.

ScriptDetails

Oggetto ScriptDetails per un sistema lab.Necessario.

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.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifRunWorkflow

Accoda un nuovo flusso di lavoro in un controller di compilazione di un server di compilazione.Sono disponibili due modi per specificare in quale controller di compilazione deve essere accodata la compilazione:

  1. Utilizzare la proprietà LabEnvironmentUri.Se l'ambiente è configurato per l'integrazione del flusso di lavoro, si utilizzerà il controller di compilazione dell'ambiente per accodare il flusso di lavoro.In caso contrario, viene generata l'eccezione LabDeploymentProcessException.

  2. Utilizzare la proprietà BuildControler per specificare il controller di compilazione.

Valore restituito

Valore Int32 che specifica l'ID della compilazione in coda.

Proprietà

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.Necessario.

LabEnvironmentUri

URI dell'ambiente con le funzionalità del flusso di lavoro.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

ProjectName

Nome del progetto Team.Se questa proprietà è null o non specificata, viene utilizzato il progetto corrente della compilazione.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifSaveLabEnvironment

Crea un nuovo ambiente e lo archivia in una condivisione di libreria del progetto team.Si tratta di un'attività a esecuzione prolungata che attende il completamento del salvataggio dell'ambiente.Se la creazione del nuovo ambiente non riesce, viene generata l'eccezione LabDeploymentProcessException dall'attività.

Valore restituito

Valore String che specifica l'URL del nuovo ambiente.

Proprietà

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.Necessario.

TeamProjectLibraryShareName

Condivisione di libreria in cui viene archiviato l'ambiente.Se la condivisione di libreria specificata non viene trovata, viene generata un'eccezione NoTeamProjectLibraryShareFoundException.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifSetLabEnvironmentInuseMarker

Imposta il marcatore In uso sull'ambiente.

Proprietà

Commento

Commento scritto quando il marcatore viene impostato.

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifSnapshotLabEnvironment

Crea snapshot dell'ambiente.Si tratta di un'attività a esecuzione prolungata che attende il completamento della creazione dell'ambiente.Se la creazione dello snapshot non riesce, viene generata l'eccezione LabDeploymentProcessException dall'attività.

Valore restituito

Valore Int64 che specifica l'ID dello snapshot.

Proprietà

LabEnvironmentUri

URI dell'ambiente con lo snapshot da eseguire.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

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.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifStartLabEnvironment

Avvia l'ambiente.Si tratta di un'attività a esecuzione prolungata che attende il completamento dell'avvio dell'ambiente.Se l'avvio dell'ambiente non riesce, viene generata l'eccezione LabDeploymentProcessException dall'attività.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifStopLabEnvironment

Arresta l'ambiente.Si tratta di un'attività a esecuzione prolungata che attende il completamento dell'arresto dell'ambiente.Se l'arresto dell'ambiente non riesce, viene generata l'eccezione LabDeploymentProcessException dall'attività.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifWaitForTestCapabilityServices

Attende il tempo massimo specificato per la preparazione della funzionalità di test dell'ambiente.Se alla fine del tempo di attesa la funzionalità di test non è pronta, viene generata un'eccezione di timeout.Se la proprietà RepairCapabilityBeforeWaitBegins è impostata, la funzionalità di ripristino viene richiamata prima di iniziare ad attendere che la funzionalità sia pronta.Il tempo massimo di attesa può essere configurato tramite la proprietà MaxWaitTime.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

MaxWaitTime

Oggetto System.TimeSpan che specifica il tempo massimo di attesa per la preparazione della funzionalità.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.

RepairCapabilityBeforeWaitBegins

Se questo valore è impostato su true, un tentativo di ripristinare la funzionalità verrà eseguito prima dell'attesa.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifWaitForWorkflow

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 un'eccezione di time out.L'attività controlla periodicamente lo stato della compilazione in coda per determinare quali compilazioni sono terminate.Questo intervallo si configura tramite la proprietà RefreshInterval.

Valore restituito

Valore enumerato di BuildStatus che indica lo stato del flusso di lavoro.

Proprietà

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.Necessario.

RefreshInterval

Oggetto System.TimeSpan che specifica l'intervallo di aggiornamento dello stato del flusso di lavoro.Il valore predefinito di tale intervallo è 60 secondi.

ThrowOnError

Se true, viene generata un'eccezione se la compilazione non riesce.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifWaitForWorkflowCapabilityServices

Attende per il tempo specificato per la preparazione della funzionalità di flusso di lavoro dell'ambiente.Se alla fine del tempo di attesa la funzionalità di flusso di lavoro non è pronta, viene generata un'eccezione di timeout.Se la proprietà RepairCapabilityBeforeWaitBegins è impostata, la funzionalità di ripristino viene richiamata prima di iniziare ad attendere che la funzionalità sia pronta.Il tempo massimo di attesa può essere configurato tramite la proprietà MaxWaitTime.

Proprietà

LabEnvironmentUri

URI dell'ambiente.Utilizzare l'attività GetLabEnvironmentUri per ottenere l'URI dell'ambiente.Necessario.

MaxWaitTime

Oggetto System.TimeSpan che specifica il tempo massimo di attesa per la preparazione della funzionalità.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.

RepairCapabilityBeforeWaitBegins

Se questo valore è impostato su true, un tentativo di ripristinare la funzionalità verrà eseguito prima dell'attesa.

WaitForComputerNames

Se questo valore è true, attende che i nomi dei computer di tutte le macchine virtuali dell'ambiente siano disponibili.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifWriteDeploymentInformation

Scrive le informazioni di distribuzione incluse nel riepilogo della compilazione.La sezione delle informazioni di distribuzione è divisa in tre sottosezioni relative rispettivamente a compilazione, distribuzione e test.È possibile aggiungere informazioni di distribuzione a una sottosezione specifica utilizzando la proprietà DeploymentInformationType.I collegamenti possono essere aggiunti alle informazioni di distribuzione tramite la proprietà URL.

Proprietà

Messaggio

Messaggio da visualizzare nel riepilogo.Necessario.

Url

URL facoltativo o collegamento da aggiungere al messaggio.

DeploymentInformationType

Specifica la sottosezione delle informazioni di distribuzione per questo messaggio informativo.Utilizzare uno dei valori indicati di seguito.

  • Compila

  • Distribuzione

  • Test

Back to top

Classi di Lab Management

Nella tabella seguente vengono riepilogate le classi di Lab Management che è possibile utilizzare in Progettazione flussi di lavoro per personalizzare un processo di compilazione, distribuzione e test.Le classi fanno parte dello spazio dei nomi Microsoft.TeamFoundation.Lab.Workflow.Activities.

Object

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.

TestRunStatistics

Archivia i dettagli di un'esecuzione dei test.

Ff934562.collapse_all(it-it,VS.110).gifLabWorkflowDetails

La classe LabWorkflowDetails contiene i dati di configurazione della Configurazione guidata Parametri flusso di lavoro lab.In LabDefaultTemplate, l'oggetto LabWorkflowDetails di un flusso di lavoro è contenuto nell'argomentoLabWorkflowParameters.La classe LabWorkflowDetails contiene le proprietà indicate di seguito.

BuildDetails

Oggetto Microsoft.TeamFoundation.Lab.Workflow.Activities.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 Microsoft.TeamFoundation.Lab.Workflow.Activities.DeploymentDetails 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 Microsoft.TeamFoundation.Lab.Workflow.Activities.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 Microsoft.TeamFoundation.Lab.Workflow.Activities.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.

Ff934562.collapse_all(it-it,VS.110).gifBuildDetails

BuildDetails archivia i dettagli di compilazione per uno scenario di compilazione, distribuzione e test.

Proprietà

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

Back to top

Ff934562.collapse_all(it-it,VS.110).gifDeploymentDetails

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.È possibile accedere all'oggetto DeploymentDetails creato dalla procedura guidata Lab Management utilizzando la proprietà DeploymentDetails dell'argomento LabWorkflowParameters Argument.

Proprietà

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.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifLabEnvironmentDetails

LabEnvironmentDetails archivia le informazioni necessarie per identificare l'ambiente lab nello scenario di compilazione, distribuzione e test.È possibile accedere all'oggetto LabEnvironmentDetails creato dalla procedura guidata del flusso di lavoro di Lab Management utilizzando la proprietà EnvironmentDetails dell'argomento LabWorkflowParameters Argument.

Proprietà

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

Un 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.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifRunTestDetails

RunTestDetails archivia i dettagli del parametro di test richiesti per creare l'esecuzione dei test automatizzati nel flusso di lavoro di compilazione, distribuzione e test.È possibile accedere all'oggetto RunTestDetails creato dalla procedura guidata Lab Management utilizzando la proprietà TestParameters dell'argomento LabWorkflowParameters Argument.

Proprietà

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.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifScriptDetails

Fornisce i dettagli per gli script di distribuzione.L'oggetto ScriptDetails è obbligatorio quando si aggiunge un'attività RunDeploymentScript alla progettazione flussi di lavoro.L'attività InitializeAgentSpecAndEnvironmentVariables restituisce un oggetto ScriptDetails.

Proprietà

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.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifTestRunStatistics

Archivia i dettagli di un'esecuzione dei test.L'oggetto TestRunStatistics viene restituito dall'attività ExecuteRemoteTestRun.

Proprietà

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

Un valore Int32 che specifica il numero dei test non superati nell'esecuzione dei test.

InconclusiveTests

Un 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

Un 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.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifLabEnvironmentInUseMarker

Archivia i dettagli del marcatore In uso di un ambiente.Utilizzare l'attività GetLabEnvironmentInUseMarker per restituire un oggetto LabEnvironmentInUseMarker.

Proprietà

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.

Back to top

Ff934562.collapse_all(it-it,VS.110).gifLabEnvironmentState

Enumerazione che specifica lo stato corrente dell'ambiente.Lo stato di un ambiente lab è principalmente determinato dagli stati delle macchine virtuali che contiene.Se tutte le macchine virtuali sono in uno stato stabile coerente, il valore di LabEnvironmentState corrisponde a tale stato.In caso contrario, il valore è Misto o Non riuscito.Quando un'operazione è in corso sull'ambiente, l'ambiente lab è in uno stato di transizione, il quale indica l'operazione in corso.

I valori di LabEnvironmentState sono indicati di seguito.

Sconosciuto

Creazione

Creazione non riuscita

Annullamento in corso

Aggiornamento

Archiviato

Starting

Running

Sospensione in corso

Sospeso

Spegnimento in corso

Stopped

Creazione snapshot

Eliminazione snapshot

Ripristino dello snapshot in corso

Eliminazione

Eliminazione non riuscita

Eliminato

Misto

Non superato

Migrazione in corso

Vedere anche

Concetti

Attività del flusso di lavoro LabDefaultTemplate