Actividades de Team Foundation LabManagement

Artículo
08/10/2011

Cuando personaliza una plantilla de flujo de trabajo de Lab Management (LabDefaultTemplate.xaml), puede utilizar una o varias de las actividades predefinidas de Lab Management. También puede tener acceso a los objetos creados por el asistente de Lab Management. En este tema se describen las actividades y objetos de Team Foundation Lab Management que están disponibles cuando personalice una plantilla de flujo de trabajo para compilar, implementar y probar una aplicación. Para obtener información sobre cómo utilizar estas actividades en un flujo de trabajo personalizado, vea Personalizar flujos de trabajo de Lab Management.

Este tema contiene las siguientes secciones:

Actividades de Lab Management

En la tabla siguiente se describen las actividades individuales del flujo de trabajo de Lab Management.

Actividad	Descripción
CreateLabEnvironment	Crea un nuevo entorno a partir de una plantilla almacenada y la implementa en el grupo host especificado.
DeleteLabEnvironment	Elimina un entorno.
DeleteSnapshot	Elimina una instantánea de un entorno.
ExecuteRemoteTestRun	Crea una ejecución de pruebas en un entorno y espera a que finalice.
GenerateEnvironmentViewerFile	Genera un archivo de visor de entorno que tiene el identificador del vínculo de instantánea. Se utiliza para conectar con una instantánea del entorno.
GetBuildLocationAndBuildNumber	Devuelve el número y la ubicación de la compilación para un escenario de compilación, implementación y pruebas.
GetLabEnvironmentInUseMarker	Devuelve el marcador "en uso" para un entorno.
GetLabEnvironmentSnapshotId	Obtiene el identificador de una instantánea de un entorno.
GetLabEnvironmentStatus	Obtiene el estado del entorno.
GetLabEnvironmentUri	Obtiene el identificador URI del entorno para un nombre del entorno y de la ubicación de laboratorio específicos.
InitializeAgentSpecAndEnvironmentVariables	Analiza los detalles del script de implementación especificados por la propiedad.
ResetLabEnvironmentInuseMarker	Restablece el marcador "en uso" para un entorno.
RestoreLabEnvironment	Restaura el entorno de laboratorio a la instantánea especificada.
RunDeploymentScript	Ejecuta el script de implementación. Si se produce error, produce o escribe una advertencia de compilación tal como se especifica en la propiedad ThrowOnError.
RunWorkflow	Pone en cola un nuevo flujo de trabajo en un controlador de compilación de un servidor de compilación.
SaveLabEnvironment	Crea un nuevo entorno y lo almacena en un recurso compartido de biblioteca de proyectos de equipo.
SetLabEnvironmentInuseMarker	Establece el marcador "en uso" en el entorno.
SnapshotLabEnvironment	Toma una instantánea de un entorno.
StartLabEnvironment	Inicia el entorno.
StopLabEnvironment	Detiene el entorno.
WaitForTestCapabilityServices	Espera el tiempo máximo especificado para que la funcionalidad de pruebas del entorno esté lista. Al final del tiempo de espera, si la capacidad de prueba no está lista, se produce una excepción de tiempo de espera.
WaitForWorkflow	Tipo de flujo de trabajo.
WaitForWorkflowCapabilityServices	Espera a que la compilación puesta en cola se complete durante un período de tiempo de espera máximo especificado. Si el flujo de trabajo de compilación no finaliza en el tiempo máximo especificado, se produce una excepción TimeOutException. La actividad comprueba el estado de la compilación en cola periódicamente para determinar qué compilaciones terminan. Este intervalo se configura mediante la propiedad RefreshInterval.
WriteDeploymentInformation	Escribe la información de implementación que se incluye en el resumen de la compilación.

CreateLabEnvironment

Crea un nuevo entorno a partir de una plantilla almacenada y la implementa en el grupo host especificado. Se trata de una actividad de ejecución prolongada y esperará hasta que se cree el nuevo entorno. Si el nuevo entorno de laboratorio no se puede crear esta actividad, produce una excepción LabDeploymentProcessException.

Propiedades

LabEnvironmentName	Nombre del nuevo entorno de laboratorio. Si esta propiedad es null o está vacía, se utilizará el nombre de la plantilla del entorno.
LabEnvironmentTemplateUri	URI de una plantilla de entorno almacenado. El identificador URI de la plantilla del entorno de laboratorio se puede obtener utilizando la actividad GetLabEnvironmentUri. Obligatorio.
TeamProjectHostGroupName	Grupo host donde se va a implementar el nuevo entorno. Si el grupo especificado no se encuentra, se produce una excepción NoTeamProjectHostGroupFoundException. Obligatorio.

LabEnvironmentUri	Identificador URI del entorno de laboratorio cuya instantánea se eliminará. El identificador URI del entorno de laboratorio se puede obtener utilizando la actividad GetLabEnvironmentUri. Obligatorio.
SnapshotId	Identificador de la instantánea que se va a eliminar. El identificador de la instantánea se puede obtener utilizando la actividad GetLabEnvironmentSnapshotId. Obligatorio.

BuildNumber	Número de compilación en el que se ejecutan las pruebas.
LabEnvironmentUri	Identificador URI del entorno en el que se van a ejecutar los casos de prueba. El identificador URI del entorno se puede obtener utilizando la actividad GetLabEnvironmentUri.
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	Número máximo de errores consecutivos que deben omitirse mientras la actividad espera a que las pruebas se ejecuten. El valor predeterminado de esta propiedad es 3.
MaxWaitTime	TimeSpan que especifica el tiempo máximo de espera para que finalice la ejecución de pruebas. Una excepción de tiempo de espera se produce al finalizar la duración especificada del tiempo. El valor predeterminado es 0 (cero), lo que significa que la actividad espera indefinidamente.
RefreshInterval	TimeSpan que especifica el intervalo después del cual se actualiza el estado de la ejecución de pruebas. El valor predeterminado de este intervalo es de 60 segundos.
TestDirectory	Ruta de acceso a los archivos ejecutables de pruebas.
TestEnvironment	Nombre del entorno de prueba en el que los casos de prueba se van a ejecutar.
TestParameters	Un objeto RunTestDetails que especifica los parámetros de prueba, como el plan de pruebas, el conjunto de pruebas y la configuraciones de pruebas. Obligatorio.
Título	Nombre de la ejecución de pruebas. Obligatorio.

FilePath	Ruta de acceso UNC para almacenar el archivo del visor de entorno. La cuenta de servicio de compilación debe tener permisos de escritura para la ruta de acceso. Obligatorio.
LabEnvironmentUri	URI del entorno. El identificador URI del entorno se puede obtener utilizando la actividad GetLabEnvironmentUri. Obligatorio.
SnapshotId	Identificador de la instantánea. El identificador de la instantánea se puede obtener utilizando la actividad GetLabEnvironmentSnapshotId. Si la instantánea no es válida, se produce una excepción InvalidSnapshotException. Obligatorio.

BuildDetails	Un objeto Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails que contiene información relacionada con la compilación en un escenario de compilación, implementación y pruebas.
BuildNumber	Número de compilación de la compilación seleccionada. Se trata de un outArgument. Es null para las compilaciones que no son "team build".
SelectedBuild	Información de compilación sobre el servidor de compilación. Se trata de un outArgument. Es null para las compilaciones que no son "team build".

LabEnvironmentUri	URI del entorno. Utilice la actividad GetLabEnvironmentUri para obtener el identificador URI del entorno. Obligatorio.
SnapshotName	Nombre de la instantánea. Obligatorio.

LabEnvironmentName	Nombre del entorno. Obligatorio.
ProjectName	Nombre del proyecto de equipo. Si el valor de esta propiedad es null o no se especifica, se utiliza el proyecto de compilación actual.
TeamProjectLabLocationName	Nombre de la ubicación de laboratorio. Puede ser un nombre de grupo host o un nombre de recurso compartido de biblioteca. Si la ubicación de laboratorio no se encuentra, se produce una excepción NoLabLocationFoundException. Obligatorio.

BuildLocation	Ruta de acceso a la ubicación de compilación. Se utiliza para expandir la macro $ (BuildLocation). Obligatorio.
DeploymentScriptDetails	Detalles de implementación en formato "labsystemname \| argumentos de script \| directorio de trabajo". Obligatorio.
LabEnvironmentUri	URI del entorno. Utilice la actividad GetLabEnvironmentUri para obtener el identificador URI del entorno. Obligatorio.

MaximumAttemptsForNetUse	Número máximo de intentos para agregar el uso de Net.
ScriptDetails	Objeto de detalles de script para un sistema de laboratorio. Obligatorio.
SharedLocationForNetUse	Ubicación que debe estar accesible para la cuenta de servicio de laboratorio.
ThrowOnError	Marca que indica si se produce la excepción para el error. El valor predeterminado es True.

BuildController	Nombre del controlador de compilación. Si esta propiedad y el valor de la propiedad LabEnvironmentUri son null o no se especifican, el controlador de compilación actual se utiliza para poner en cola la compilación.
BuildDefinition	Definición de la compilación que se pondrá en la cola. Obligatorio.
LabEnvironmentUri	Identificador URI del entorno con funciones de flujo de trabajo. Utilice la actividad GetLabEnvironmentUri para obtener el identificador URI del entorno. Obligatorio.
ProjectName	Nombre del proyecto de equipo. Si esta propiedad es null o no se especifica, se utiliza el proyecto de compilación actual.

LabEnvironmentName	Nombre del entorno guardado. Si esta propiedad es null o está vacía, se utilizará el nombre del entorno.
LabEnvironmentUri	Identificador URI del entorno que se guardará. Utilice la actividad GetLabEnvironmentUri para obtener el identificador URI del entorno. Obligatorio.
TeamProjectLibraryShareName	Recurso compartido de biblioteca donde está guardado el entorno. Si el recurso compartido de biblioteca especificado no se encuentra, se produce una excepción NoTeamProjectLibraryShareFoundException. Obligatorio.

Usuario	String que especifica el usuario que marcó el entorno.
Marca de tiempo	DateTime que especifica cuándo el usuario marcó el entorno.
Comment	String especificado por el usuario que marcó el entorno.

Comentario	Comentario escrito cuando se establece el marcador.
LabEnvironmentUri	URI del entorno. Utilice la actividad GetLabEnvironmentUri para obtener el identificador URI del entorno. Obligatorio.

LabEnvironmentUri	Identificador URI del entorno cuya instantánea tiene que ser tomada. Utilice la actividad GetLabEnvironmentUri para obtener el identificador URI del entorno. Obligatorio.
SnapshotChainId	Devuelve el identificador de la cadena de instantáneas.
SnapshotName	Nombre de la instantánea que se tomará. Si esta propiedad es null, el valor de fecha y hora se usa como nombre de la instantánea.

AllowPartiallySucceededBuild	Si es true, una finalización parcial se trata como correcta.
BuildDetails	Un objeto Microsoft.TeamFoundation.Build.Client.IBuildDetail que contiene detalles en la cola de compilación en el servidor de compilación. Se trata de un argumento de salida.
LabWorkflowType	El tipo del flujo de trabajo.
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	Número máximo de errores consecutivos que deben pasarse por alto mientras se espera a que finalice el flujo de trabajo. El valor predeterminado es de 3. Esta propiedad se puede usar para aumentar la solidez del flujo de trabajo.
MaxWaitTime	Un objeto System.TimeSpan que especifica el tiempo de espera máximo para que el flujo de trabajo esté listo. Se produce una excepción de tiempo de espera al finalizar la duración especificada de tiempo. El valor predeterminado es 0 (cero), lo que significa que se esperará indefinidamente.
QueueBuildId	Identificador de la compilación en cola. Obligatorio.
RefreshInterval	Objeto System.TimeSpan que especifica el intervalo después del cual se actualiza el estado del flujo de trabajo. El valor predeterminado de este intervalo es de 60 segundos.
ThrowOnError	Si es true, se produce una excepción si la compilación da error.

Objeto	Descripción
LabWorkflowDetails	La clase LabWorkflowDetails contiene datos de configuración del asistente para parámetros de flujo de trabajo de laboratorio. Objetos LabWorkflowDetails contiene objetos BuildDetails, RunTestDetails y ScriptDetails.
BuildDetails	Almacena los detalles de compilación de un escenario de compilación, implementación y prueba.
DeploymentDetails	Almacena los detalles de los parámetros de prueba necesarios para crear la ejecución de pruebas automatizada en el flujo de trabajo de compilación, implementación y prueba.
LabEnvironmentDetails	Almacena la información necesaria para identificar el entorno de laboratorio en un escenario de compilación, implementación y prueba.
LabEnvironmentInUseMarker	Almacena los detalles del marcador "en uso" de un entorno.
LabEnvironmentState	Especifica el estado actual del entorno.
RunTestDetails	Almacena los detalles del parámetro de la prueba necesarios para crear la ejecución de pruebas automatizadas.
ScriptDetails	Almacena los detalles del script de implementación necesarios para un escenario de compilación, implementación y prueba.
ScriptDetails	Almacena los detalles de una ejecución de pruebas.

BuildDetails	Un objeto BuildDetails creado por el asistente de flujo de trabajo y que almacena los detalles de compilación para un escenario de compilación, implementación y prueba.
DeploymentDetails	Un objeto LabEnvironmentDetails creado por el asistente de flujo de trabajo que almacena la información necesaria para la implementación de una compilación en un escenario de compilación, implementación y prueba.
EnvironmentDetails	Un objeto LabEnvironmentDetails creado por el asistente de flujo de trabajo que almacena información que identifica el entorno que se usará en un escenario de compilación, implementación y prueba.
TestParameters	Un objeto RunTestDetails creado por el asistente de flujo de trabajo que almacena los detalles de los parámetros de prueba necesarios para crear la ejecución de pruebas automatizadas.

IsTeamSystemBuild	Boolean que indica si la compilación utilizada es de tipo Team Build.
BuildDefinitionUri	Uri que especifica el identificador URI de la definición de compilación.
BuildDefinitionName	String que especifica el nombre de la definición de compilación.
QueueNewBuild	Boolean que indica si la nueva compilación tiene que ponerse en cola.
BuildUri	Uri que especifica el URI de la compilación, si la compilación es un tipo de Team Build.
CustomBuildPath	String que especifica la ruta de acceso a la compilación, si la compilación no es un tipo de Team Build.
Configuración

PostDeploymentSnapshotPath	String que contiene la ruta de acceso para almacenar la instantánea posterior a la implementación.
PostDeploymentSnapshotName	String que especifica el nombre de la instantánea tomada después de la implementación.
TakePostDeploymentSnapshot	Boolean que especifica si es necesaria una instantánea de la implementación posterior.
Scripts	Un objeto StringList que contiene una lista de máquinas virtuales correspondientes a los scripts de implementación.
DeploymentNeeded	Boolean que especifica si debe hacerse la implementación.

ProjectName	String que especifica el nombre del proyecto de equipo
LabEnvironmentName	String que especifica el nombre del entorno de laboratorio
NewLabEnvironmentName	String que especifica el nombre del entorno de laboratorio que se va a crear.
HostGroupName	String que especifica el nombre del grupo host donde se implementa el entorno.
LabLibraryShareName	String que especifica el nombre del recurso compartido de biblioteca que contiene la plantilla almacenada del entorno de laboratorio.
RevertToSnapshot	Boolean que indica si el entorno debe revertirse a una instantánea.
SnapshotName	String que especifica el nombre de la instantánea a la que se revierte el entorno.
TfsUrl	String que especifica la dirección URL de Team Foundation Server.
LabEnvironmentUri	Uri que especifica el identificador URI del entorno seleccionado.
Disposición	Valor enumerado de LabEnvironmentDisposition que indica el estado del entorno. Los valores son: Unknown: no se conoce el estado del entorno. Active: el entorno se implementa en un host y se puede iniciar y ejecutar. Stored: el entorno se almacena en un recurso compartido de biblioteca y no se puede usar hasta que se implemente.

TfsUrl	String que especifica la dirección URL de Team Foundation Server.
Nombre del proyecto	String que especifica el nombre del proyecto de equipo.
TestConfigurationId	Int32 que especifica el identificador de la configuración de pruebas para la ejecución de pruebas.
TestPlanId	Int32 que especifica el identificador del plan de pruebas
TestSuiteIdList	Systems.Collections.Generic.List<int> que contiene los identificadores numéricos de los conjuntos de pruebas que se ejecutan
TestSettingsId	Int32 que especifica el identificador de la configuración de la ejecución de pruebas.
RunTest	Boolean que especifica si se va a ejecutar la prueba.

LabSystemName	String que especifica el nombre del entorno de laboratorio.
AgentSpec	Un objeto AgentReservationSpec que contiene las etiquetas asociadas a un agente de compilación en el sistema de laboratorio.
FileName	String que especifica el nombre del archivo de script de implementación.
Argumentos	String que especifica los argumentos que se van a pasar al script de implementación.
WorkingDirectory	String que especifica el directorio de trabajo para el script de implementación en el sistema de laboratorio.
EnvironmentVariables	System.Collection.Generic.IDictionary<String,String> que contiene los pares nombre/valor de las variables de entorno.

Compartir a través de

Actividades de Team Foundation LabManagement

Actividades de 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

Clases de Lab Management

LabWorkflowDetails

BuildDetails

DeploymentDetails

LabEnvironmentDetails

RunTestDetails

ScriptDetails

TestRunStatistics

LabEnvironmentInUseMarker

LabEnvironmentState

Vea también

Otros recursos

Historial de cambios

Recursos adicionales

TotalTests	Int32 que especifica el número total de pruebas de la ejecución de pruebas.
PassedTests	Int32 que especifica el número total de pruebas que pasaron la ejecución de pruebas.
FailedTests	Int32 que especifica el número total de pruebas que dieron error en la ejecución de pruebas.
InconclusiveTests	Int32 que especifica el número de pruebas que no finalizaron la ejecución de pruebas.
PendingTests	Int32 que especifica el número de pruebas que aún no se han ejecutado en la ejecución de pruebas.
AbortedTests	Int32 que especifica el número de pruebas anuladas en la ejecución de pruebas.
InProgressTests	Int32 que especifica el número de pruebas que se están ejecutando actualmente.
TestRunStatus	Valor enumerado de TestRunState que especifica el estado de la ejecución de pruebas.
TestRunId	Int32 que especifica el identificador de la ejecución de pruebas.