Activités Lab Management Team Foundation

Article
08/10/2011

Lorsque vous personnalisez un modèle de flux de travail Lab Management (LabDefaultTemplate.xaml), vous pouvez utiliser une ou plusieurs des activités Lab Management prédéfinies. Vous pouvez également accéder aux objets qui sont créés par l'Assistant Lab Management. Cette rubrique décrit les activités et les objets Team Foundation Lab Management qui sont disponibles lorsque vous personnalisez un modèle de flux de travail pour générer, déployer et tester votre application. Pour plus d'informations sur l'utilisation de ces activités dans un flux de travail personnalisé, consultez Personnalisation du workflow Lab Management.

Cette rubrique contient les sections suivantes :

Activités Lab Management

Le tableau suivant décrit les différentes activités de flux de travail Lab Management.

Activité	Description
CreateLabEnvironment	Crée un nouvel environnement à partir d'un modèle stocké et déploie ce nouvel environnement sur le groupe hôte spécifié.
DeleteLabEnvironment	Supprime un environnement.
DeleteSnapshot	Supprime un instantané d'un environnement.
ExecuteRemoteTestRun	Crée une série de tests sur un environnement et attend la fin de son exécution.
GenerateEnvironmentViewerFile	Génère un fichier de visionneuse d'environnement qui contient un ID de lien d'instantané. Permet de se connecter à un instantané de l'environnement.
GetBuildLocationAndBuildNumber	Retourne l'emplacement et le numéro de build pour un scénario de génération, de déploiement et de test.
GetLabEnvironmentInUseMarker	Retourne le marqueur En cours d'utilisation pour un environnement.
GetLabEnvironmentSnapshotId	Obtient l'ID d'un instantané d'un environnement.
GetLabEnvironmentStatus	Obtient l'état d'un environnement.
GetLabEnvironmentUri	Obtient l'URI d'environnement pour un nom d'environnement et un nom d'emplacement lab donnés.
InitializeAgentSpecAndEnvironmentVariables	Analyse les détails de script de déploiement spécifiés par la propriété.
ResetLabEnvironmentInuseMarker	Réinitialise le marqueur En cours d'utilisation pour un environnement.
RestoreLabEnvironment	Restaure l'environnement à l'aide de l'instantané spécifié.
RunDeploymentScript	Exécute le script de déploiement. En cas d'échec, lève ou écrit un avertissement de build, tel que spécifié dans la propriété ThrowOnError.
RunWorkflow	Met en file d'attente un nouveau flux de travail sur un contrôleur de build d'un serveur de builds.
SaveLabEnvironment	Crée un nouvel environnement et le stocke dans un partage de bibliothèque de projet d'équipe.
SetLabEnvironmentInuseMarker	Définit le marqueur En cours d'utilisation sur l'environnement.
SnapshotLabEnvironment	Réalise un instantané d'un environnement.
StartLabEnvironment	Démarre l'environnement.
StopLabEnvironment	Arrête l'environnement.
WaitForTestCapabilityServices	Attend pendant la durée maximale spécifiée que la fonctionnalité de test de l'environnement soit prête. À la fin du délai d'attente, si la fonctionnalité de test n'est pas prête, une exception de délai d'expiration est levée.
WaitForWorkflow	Type de flux de travail.
WaitForWorkflowCapabilityServices	Attend pendant une durée maximale donnée que la build mise en file d'attente soit terminée. Si le flux de travail de build ne se termine pas dans la durée maximale impartie, l'exception TimeOutException est levée. L'activité vérifie périodiquement l'état des builds mises en file d'attente afin d'identifier celles qui sont terminées. Cet intervalle est configuré à l'aide de la propriété RefreshInterval.
WriteDeploymentInformation	Écrit les informations de déploiement qui sont incluses dans le résumé de la build.

CreateLabEnvironment

Crée un nouvel environnement à partir d'un modèle stocké et déploie ce nouvel environnement sur le groupe hôte spécifié. Il s'agit d'une activité de longue durée qui attend que le nouvel environnement soit créé. Si le nouvel environnement lab ne peut pas être créé, cette activité lève une exception LabDeploymentProcessException.

Propriétés

LabEnvironmentName	Nom du nouvel environnement. Si cette propriété est null ou vide, le nom de modèle d'environnement est utilisé.
LabEnvironmentTemplateUri	URI d'un modèle d'environnement stocké. L'URI du modèle d'environnement lab peut être obtenu à l'aide de l'activité GetLabEnvironmentUri. Obligatoire.
TeamProjectHostGroupName	Groupe hôte où le nouvel environnement sera déployé. Si le groupe hôte spécifié est introuvable, une exception NoTeamProjectHostGroupFoundException est levée. Obligatoire.

LabEnvironmentUri	URI de l'environnement lab dont l'instantané sera supprimé. L'URI de l'environnement lab peut être obtenu à l'aide de l'activité GetLabEnvironmentUri. Obligatoire.
SnapshotId	ID de l'instantané à supprimer. L'ID d'instantané peut être obtenu à l'aide de l'activité GetLabEnvironmentSnapshotId. Obligatoire.

BuildNumber	Numéro de la build sur laquelle des tests sont exécutés.
LabEnvironmentUri	URI de l'environnement sur lequel des cas de test seront exécutés. L'URI de l'environnement peut être obtenu à l'aide de l'activité GetLabEnvironmentUri.
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	Nombre maximal d'échecs consécutifs qui doivent être ignorés pendant que l'activité attend que les tests s'exécutent. La valeur par défaut de cette propriété est 3.
MaxWaitTime	Objet TimeSpan qui spécifie le temps d'attente maximal à observer avant la fin de l'exécution de la série de tests. Une exception de délai d'expiration est levée à la fin de la durée spécifiée. La valeur par défaut est 0 (zéro), ce qui signifie que l'activité attend indéfiniment.
RefreshInterval	Objet TimeSpan qui spécifie l'intervalle au terme duquel l'état de la série de tests est actualisé. La valeur par défaut de cet intervalle est 60 secondes.
TestDirectory	Chemin d'accès aux exécutables du test.
TestEnvironment	Nom de l'environnement de test sur lequel des cas de test seront exécutés.
TestParameters	Objet RunTestDetails qui spécifie des paramètres de test tels que le plan de test, la suite de tests, les paramètres de test et la configuration de test. Obligatoire.
Titre	Nom de la série de tests. Obligatoire.

FilePath	Chemin d'accès UNC de l'emplacement de stockage du fichier de visionneuse d'environnement. Le compte de service de build doit disposer d'une autorisation en écriture pour le chemin d'accès. Obligatoire.
LabEnvironmentUri	URI de l'environnement. L'URI de l'environnement peut être obtenu à l'aide de l'activité GetLabEnvironmentUri. Obligatoire.
SnapshotId	ID de l'instantané. L'ID d'instantané peut être obtenu à l'aide de l'activité GetLabEnvironmentSnapshotId. Si l'instantané n'est pas valide, une exception InvalidSnapshotException est levée. Obligatoire.

BuildDetails	Objet Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails qui contient les informations relatives à la build dans un scénario de génération, de déploiement et de test.
BuildNumber	Numéro de la build sélectionnée. Il s'agit d'un argument de sortie. Cette valeur est null pour les builds qui ne sont pas de type « Team Build ».
SelectedBuild	Informations de build relatives au serveur de builds. Il s'agit d'un argument de sortie. Cette valeur est null pour les builds qui ne sont pas de type « Team Build ».

LabEnvironmentUri	URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI d'environnement. Obligatoire.
SnapshotName	Nom d'instantané. Obligatoire.

LabEnvironmentName	Nom d'environnement. Obligatoire.
NomProjet	Nom du projet d'équipe. Si cette propriété est null ou vide, le projet actuel de la build est utilisé.
TeamProjectLabLocationName	Nom d'emplacement lab. Il peut s'agir d'un nom de groupe hôte ou d'un nom de partage de bibliothèque. Si l'emplacement lab est introuvable, une exception NoLabLocationFoundException est levée. Obligatoire.

BuildLocation	Chemin d'accès de build. Utilisé pour développer la macro $(BuildLocation). Obligatoire.
DeploymentScriptDetails	Détails de déploiement au format « labsystemname \| arguments de script \| répertoire de travail ». Obligatoire.
LabEnvironmentUri	URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI d'environnement. Obligatoire.

MaximumAttemptsForNetUse	Nombre maximal de tentatives d'ajout d'utilisation réseau.
ScriptDetails	Objet de détails de script pour un système lab. Obligatoire.
SharedLocationForNetUse	Emplacement qui doit être accessible par le compte de service lab.
ThrowOnError	Balise permettant d'indiquer si une exception doit être levée pour une erreur. La valeur par défaut est True.

BuildController	Nom de contrôleur de build. Si cette propriété et la propriété LabEnvironmentUri sont null ou vides, le contrôleur de build actuel est utilisé pour mettre la build en file d'attente.
BuildDefinition	Définition de build à mettre en file d'attente. Obligatoire.
LabEnvironmentUri	URI d'environnement comportant des fonctionnalités de flux de travail. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI d'environnement. Obligatoire.
NomProjet	Nom du projet d'équipe. Si cette propriété est null ou vide, le projet actuel de la build est utilisé.

LabEnvironmentName	Nom de l'environnement enregistré. Si cette propriété est null ou est vide, le nom de l'environnement sera utilisé.
LabEnvironmentUri	URI de l'environnement à enregistrer. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.
TeamProjectLibraryShareName	Partage de bibliothèque où l'environnement est stocké. Si le partage de bibliothèque spécifié est introuvable, une exception NoTeamProjectLibraryShareFoundException est levée. Obligatoire.

Utilisateur	Objet String qui spécifie l'utilisateur ayant marqué l'environnement.
Horodateur	Objet DateTime qui spécifie à quel moment l'utilisateur a marqué l'environnement.
Commentaire	Objet String qui est spécifié par l'utilisateur ayant marqué l'environnement.

Commentaire	Commentaire écrit lorsque le marqueur est défini.
LabEnvironmentUri	URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI d'environnement. Obligatoire.

LabEnvironmentUri	URI de l'environnement dont l'instantané doit être réalisé. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI d'environnement. Obligatoire.
SnapshotChainId	Retourne l'ID de chaîne d'instantanés.
SnapshotName	Nom de l'instantané à réaliser. Si cette propriété est null, la valeur DateHeure actuelle est utilisée comme nom d'instantané.

AllowPartiallySucceededBuild	Si la valeur de cette propriété est True, les builds partiellement réussies sont traitées comme des builds réussies.
BuildDetails	Objet Microsoft.TeamFoundation.Build.Client.IBuildDetail qui contient les détails des builds mises en file d'attente sur le serveur de builds. Il s'agit d'un argument de sortie.
LabWorkflowType	Type de flux de travail.
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	Nombre maximal d'échecs consécutifs qui doivent être ignorés pendant que l'activité attend que l'exécution du flux de travail soit terminée. La valeur par défaut est 3. Cette propriété peut être utilisée pour augmenter la robustesse du flux de travail.
MaxWaitTime	Objet System.TimeSpan qui spécifie le délai d'attente maximal à observer avant que l'exécution du flux de travail se termine. Une exception de délai d'expiration est levée au terme du délai d'attente spécifié. La valeur par défaut est 0 (zéro), ce qui signifie que l'attente dure indéfiniment.
QueueBuildId	ID de la build mise en file d'attente. Obligatoire.
RefreshInterval	Objet System.TimeSpan qui spécifie l'intervalle au terme duquel l'état du flux de travail est actualisé. La valeur par défaut de cet intervalle est 60 secondes.
ThrowOnError	Si la valeur est True, une exception est levée en cas d'échec de la build.

Objet	Description
LabWorkflowDetails	La classe LabWorkflowDetails contient les données de configuration de l'Assistant Paramètres de flux de travail lab. L'objet LabWorkflowDetails contient les objets BuildDetails, RunTestDetails et ScriptDetails.
BuildDetails	Stocke les détails de build pour un scénario de génération, de déploiement et de test.
DeploymentDetails	Stocke les détails de paramètre de test qui sont requis pour créer une série de tests automatisés dans le flux de travail de génération, de déploiement et de test.
LabEnvironmentDetails	Stocke les informations requises pour identifier l'environnement lab dans le scénario de génération, de déploiement et de test.
LabEnvironmentInUseMarker	Stocke les détails du marqueur En cours d'utilisation d'un environnement.
LabEnvironmentState	Spécifie l'état actuel de l'environnement.
RunTestDetails	Stocke les détails de paramètre de test qui sont requis pour créer la série de tests automatisés.
ScriptDetails	Stocke les détails de script de déploiement qui sont requis pour un scénario de génération, de déploiement et de test.
ScriptDetails	Stocke les détails d'une série de tests.

BuildDetails	Objet BuildDetails qui est créé par l'Assistant Flux de travail et qui stocke les détails de build d'un scénario de génération, de déploiement et de test.
DeploymentDetails	Objet LabEnvironmentDetails qui est créé par l'Assistant Flux de travail et qui stocke les informations requises pour le déploiement d'une build dans un scénario de génération, de déploiement et de test.
EnvironmentDetails	Objet LabEnvironmentDetails qui est créé par l'Assistant Flux de travail et qui stocke les informations permettant d'identifier l'environnement à utiliser pour un scénario de génération, de déploiement et de test.
TestParameters	Objet RunTestDetails qui est créé par l'Assistant Flux de travail et qui stocke les détails de paramètre de test requis pour créer la série de tests automatisés.

IsTeamSystemBuild	Objet Boolean qui indique si la build utilisée est de type Team Build.
BuildDefinitionUri	Objet Uri qui spécifie l'URI de la définition de build.
BuildDefinitionName	Objet String qui spécifie le nom de la définition de build.
QueueNewBuild	Objet Boolean qui indique si la nouvelle build doit être mise en file d'attente.
BuildUri	Objet Uri qui spécifie l'URI de la build, si la build est de type Team Build.
CustomBuildPath	Objet String qui spécifie le chemin d'accès à la build, si la build n'est pas de type Team Build.
Configuration

PostDeploymentSnapshotPath	Objet String qui contient le chemin d'accès à l'emplacement de stockage de l'instantané de post-déploiement.
PostDeploymentSnapshotName	Objet String qui spécifie le nom de l'instantané réalisé après le déploiement.
TakePostDeploymentSnapshot	Objet Boolean qui spécifie si un instantané de post-déploiement est requis.
Scripts	Objet StringList qui contient une liste d'ordinateurs virtuels avec les scripts de déploiement correspondants.
DeploymentNeeded	Objet Boolean qui spécifie si le déploiement doit être effectué.

NomProjet	Objet String qui spécifie le nom du projet d'équipe.
LabEnvironmentName	Objet String qui spécifie le nom de l'environnement lab.
NewLabEnvironmentName	Objet String qui spécifie le nom de l'environnement lab à créer.
HostGroupName	Objet String qui spécifie le nom du groupe hôte où l'environnement est déployé.
LabLibraryShareName	Objet String qui spécifie le nom du partage de bibliothèque contenant le modèle d'environnement lab stocké.
RevertToSnapshot	Objet Boolean qui indique si l'environnement doit être restauré à l'aide d'un instantané.
SnapshotName	Objet String qui indique le nom de l'instantané d'environnement à utiliser pour la restauration.
TfsUrl	Objet String qui spécifie l'URL de Team Foundation Server.
LabEnvironmentUri	Objet Uri qui spécifie l'URI de l'environnement sélectionné.
Disposition	Valeur énumérée LabEnvironmentDisposition qui indique l'état de l'environnement. Les valeurs sont les suivantes : Inconnu - l'état de l'environnement n'est pas connu. Actif - l'environnement est déployé sur un hôte et peut être démarré et exécuté. Stocké - l'environnement est stocké dans un partage de bibliothèque et ne peut pas être utilisé tant qu'il n'est pas déployé.

TfsUrl	Objet String qui spécifie l'URL de Team Foundation Server.
Nom du projet	Objet String qui spécifie le nom du projet d'équipe.
TestConfigurationId	Objet Int32 qui spécifie l'ID de la configuration de test pour la série de tests.
TestPlanId	Objet Int32 qui spécifie l'ID du plan de test.
TestSuiteIdList	Objet Systems.Collections.Generic.List<int> qui contient les ID numériques des suites de tests à exécuter.
TestSettingsId	Objet Int32 qui spécifie l'ID des paramètres de test de la série de tests.
RunTest	Objet Boolean qui spécifie si le test doit être exécuté.

LabSystemName	Objet String qui spécifie le nom de l'environnement lab.
AgentSpec	Objet AgentReservationSpec qui contient les balises associées à un agent de build dans le système lab.
FileName	Objet String qui spécifie le nom du fichier de script de déploiement.
Arguments	Objet String qui spécifie les arguments à passer au script de déploiement.
WorkingDirectory	Objet String qui spécifie le répertoire de travail pour le script de déploiement sur le système lab.
EnvironmentVariables	Objet System.Collection.Generic.IDictionary<String,String> qui contient les paires nom/valeur de variable d'environnement.

Partager via

Activités Lab Management Team Foundation

Activités 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

Classes Lab Management

LabWorkflowDetails

BuildDetails

DeploymentDetails

LabEnvironmentDetails

RunTestDetails

ScriptDetails

TestRunStatistics

LabEnvironmentInUseMarker

LabEnvironmentState

Voir aussi

Autres ressources

Historique des modifications

Ressources supplémentaires

TotalTests	Objet Int32 qui spécifie le nombre total de tests de la série de tests.
PassedTests	Objet Int32 qui spécifie le nombre de tests de la série de tests ayant abouti.
FailedTests	Objet Int32 qui spécifie le nombre de tests de la série de tests ayant échoué.
InconclusiveTests	Objet Int32 qui indique le nombre de tests de la série de tests qui n'ont pas été concluants.
PendingTests	Objet Int32 qui indique le nombre de tests de la série de tests qui n'ont pas encore été exécutés.
AbortedTests	Objet Int32 qui indique le nombre de tests de la série de tests qui ont été abandonnés.
InProgressTests	Objet Int32 qui indique le nombre de tests de la série de tests qui sont en cours d'exécution.
TestRunStatus	Valeur énumérée TestRunState qui spécifie l'état de la série de tests.
TestRunId	Objet Int32 qui spécifie l'ID de la série de tests.