Partager via

Activités de flux de travail Lab Management

  • Article

 

Lorsque vous personnalisez un modèle de flux de travail Lab Management (LabDefaultTemplate.11.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é, voir Personnalisation du workflow Lab Management.

Spécifications

  • Visual Studio Enterprise, Visual Studio Test Professional

Cette rubrique contient les sections suivantes :

  • Activités Lab Management

  • Classes Lab Management

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 build, 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 de l'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é de l'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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

DeleteLabEnvironment

Supprime un environnement. Il s'agit d'une activité de longue durée qui attend que l'environnement soit supprimé. Si la suppression de l'environnement échoue, cette activité lève une exception LabDeploymentProcessException.

Propriétés

LabEnvironmentUri

URI de l'environnement à supprimer. L'URI de l'environnement lab peut être obtenu à l'aide de l'activité GetLabEnvironmentUri. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

DeleteSnapshot

Supprime un instantané d'un environnement. Il s'agit d'une activité de longue durée qui attend que l'instantané soit supprimé. Si la suppression de l'instantané échoue, cette activité lève une exception LabDeploymentProcessException.

Propriétés

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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

ExecuteRemoteTestRun

Crée une série de tests sur un environnement et attend la fin de son exécution. Il s'agit d'une activité de longue durée qui attend que l'exécution de la série de tests soit terminée ou qu'un dépassement de délai d'attente se produise. Vous pouvez définir le délai d'expiration à l'aide de la propriété MaxWaitTime. Cette activité vérifie périodiquement l'état des séries de tests afin d'identifier celles qui sont terminées. Cet intervalle peut être configuré à l'aide de la propriété RefreshInterval. La propriété MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion peut être utilisée pour spécifier le nombre de fois consécutives que des erreurs Team Foundation Server doivent être ignorées lors de la vérification de l'état des séries de tests.

Valeur de retour

Objet TestRunStatistics qui stocke les détails de la série de tests.

Propriétés

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

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

GenerateEnvironmentViewerFile

Génère un fichier de visionneuse d'environnement qui contient l'ID du lien d'instantané. Cette activité permet de se connecter à un instantané de l'environnement. Le nom du fichier de visionneuse d'environnement est le nom de l'instantané sans les caractères spéciaux suivants : @"\[\`~\!@\#$%^&\*()+=\[{\\\]}|\\\\;:',/?\]" + "\"".

Propriétés

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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

GetBuildLocationAndBuildNumber

Retourne l'emplacement et le numéro de build pour un scénario de build, de déploiement et de test. Si « Team Build » est sélectionné et que l'URI de build est null, la build correcte la plus récente est sélectionnée et les détails correspondants sont retournés. Si la build correcte la plus récente est introuvable, une exception System.ArgumentException est levée. Si « Team Build » n'est pas sélectionné, seul l'emplacement de build spécifié par l'utilisateur est retourné.

Valeur de retour

Objet String qui spécifie l'emplacement de build.

Propriétés

BuildDetails

Objet Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails qui contient les informations relatives à la build dans un scénario de build, 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 ».

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

GetLabEnvironmentInUseMarker

Obtient le marqueur En cours d'utilisation pour un environnement.

Valeur de retour

Marqueur LabEnvironmentInUseMarker qui spécifie les détails du marqueur d'environnement

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

GetLabEnvironmentSnapshotId

Obtient l'ID d'instantané d'un instantané d'un environnement. Si l'instantané portant le nom spécifié est introuvable, cette activité lève une exception NoSnapshotFoundException.

Valeur de retour

Objet Int64 qui spécifie l'identificateur de l'instantané.

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

SnapshotName

Nom d'instantané. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

GetLabEnvironmentStatus

Obtient l'état de l'environnement.

Valeur de retour

Valeur énumérée LabEnvironmentState qui indique l'état actuel de l'environnement.

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

GetLabEnvironmentUri

Obtient l'URI d'environnement pour un nom d'environnement et un nom d'emplacement lab donnés. L'emplacement lab peut être un groupe hôte ou un partage de bibliothèque. Si l'environnement est introuvable, cette activité lève une exception LabEnvironmentNotFoundException.

Valeur de retour

Objet String qui spécifie l'URI de l'environnement.

Propriétés

LabEnvironmentName

Nom de l'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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

InitializeAgentSpecAndEnvironmentVariables

Initialise les arguments requis pour l'activité RunDeploymentScript. InitializeAgentSpecAndEnvironmentVariables extrait les propriétés des ordinateurs virtuels dans l'environnement, qui sont requises pour cibler le script de déploiement sur les ordinateurs.

Valeur de retour

Objet ScriptDetails qui stocke les détails de script requis pour le déploiement.

Propriétés

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 de l'environnement. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

ResetLabEnvironmentInuseMarker

Réinitialise le marqueur En cours d'utilisation pour un environnement.

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

RestoreLabEnvironment

Restaure l'environnement à l'aide de l'instantané spécifié. Si l'instantané n'est pas valide, l'activité lève une exception InvalidSnapshotException.

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

SnapshotId

ID de l'instantané à l'aide duquel restaurer l'environnement. L'ID d'instantané peut être obtenu à l'aide de l'activité GetLabEnvironmentSnapshotId. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

RunDeploymentScript

Exécute le script de déploiement. Si le script échoue, lève ou écrit un avertissement de build, tel que spécifié dans la propriété ThrowOnError.

Valeur de retour

Valeur énumérée BuildStatus qui spécifie l'état de l'opération de déploiement.

Propriétés

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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

RunWorkflow

Met en file d'attente un nouveau flux de travail sur un contrôleur de build d'un serveur de builds. Il existe deux manières de spécifier le contrôleur de build sur lequel la build doit être mise en file d'attente :

  1. Utilisez la propriété LabEnvironmentUri. Si cet environnement est configuré pour l'intégration du flux de travail, il utilise son contrôleur de build pour mettre en file d'attente le flux de travail. Sinon, une exception LabDeploymentProcessException est levée.

  2. Utilisez la propriété BuildControler pour spécifier le contrôleur de build.

Valeur de retour

Objet Int32 qui spécifie l'ID de la build mise en file d'attente.

Propriétés

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 de l'environnement. Obligatoire.

NomProjet

Nom du projet d'équipe. Si cette propriété est null ou vide, le projet actuel de la build est utilisé.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

SaveLabEnvironment

Crée un nouvel environnement et le stocke dans un partage de bibliothèque de projet d'équipe. Il s'agit d'une activité de longue durée qui attend que l'environnement soit enregistré. Si la création de l'environnement échoue, cette activité lève une exception LabDeploymentProcessException.

Valeur de retour

Objet String qui spécifie l'URL du nouvel environnement.

Propriétés

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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

SetLabEnvironmentInuseMarker

Définit le marqueur En cours d'utilisation sur l'environnement.

Propriétés

Commentaire

Commentaire écrit lorsque le marqueur est défini.

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

SnapshotLabEnvironment

Réalise un instantané de l'environnement. Il s'agit d'une activité de longue durée qui attend que l'instantané d'environnement soit créé. Si la création de l'instantané échoue, cette activité lève une exception LabDeploymentProcessException.

Valeur de retour

Objet Int64 qui spécifie l'ID de l'instantané.

Propriétés

LabEnvironmentUri

URI de l'environnement dont l'instantané doit être réalisé. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'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é.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

StartLabEnvironment

Démarre l'environnement. Il s'agit d'une activité de longue durée qui attend que l'environnement démarre. Si le démarrage de l'environnement échoue, l'activité lève une exception LabDeploymentProcessException.

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

StopLabEnvironment

Arrête l'environnement. Il s'agit d'une activité de longue durée qui attend que l'environnement s'arrête. Si l'arrêt de l'environnement échoue, l'activité lève une exception LabDeploymentProcessException.

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

WaitForTestCapabilityServices

Attend pendant la durée maximale spécifiée que la fonctionnalité de test de l'environnement soit prête. Si la fonctionnalité de test n'est pas prête au terme du délai d'attente, une exception de délai d'expiration est levée. Si la propriété RepairCapabilityBeforeWaitBegins est définie, la fonctionnalité de réparation est appelée avant que ne débute le délai visant à attendre que la fonctionnalité soit prête. Le délai d'attente maximal peut être configuré à l'aide de la propriété MaxWaitTime.

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

MaxWaitTime

Objet System.TimeSpan qui spécifie le délai d'attente maximal à observer avant que la fonctionnalité soit prête. 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.

RepairCapabilityBeforeWaitBegins

Si la valeur de cette propriété est True, une tentative de réparation de la fonctionnalité est effectuée avant que ne débute le délai d'attente.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

WaitForWorkflow

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, une 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.

Valeur de retour

Valeur énumérée T: Microsoft.TeamFoundation.Build.Client.BuildStatus qui indique l'état du flux de travail.

Propriétés

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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

WaitForWorkflowCapabilityServices

Attend pendant la durée spécifiée que la fonctionnalité de flux de travail de l'environnement soit prête. Si la fonctionnalité de flux de travail n'est pas prête au terme du délai d'attente, une exception de délai d'expiration est levée. Si la propriété RepairCapabilityBeforeWaitBegins est définie, la fonctionnalité de réparation est appelée avant que ne débute le délai visant à attendre que la fonctionnalité soit prête. Le délai d'attente maximal peut être configuré à l'aide de la propriété MaxWaitTime.

Propriétés

LabEnvironmentUri

URI de l'environnement. Utilisez l'activité GetLabEnvironmentUri pour obtenir l'URI de l'environnement. Obligatoire.

MaxWaitTime

Objet System.TimeSpan qui spécifie le délai d'attente maximal à observer avant que la fonctionnalité soit prête. 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.

RepairCapabilityBeforeWaitBegins

Si la valeur de cette propriété est True, une tentative de réparation de la fonctionnalité est effectuée avant que ne débute le délai d'attente.

WaitForComputerNames

Si la valeur de cette propriété est True, l'activité attend que les noms d'ordinateurs de tous les ordinateurs virtuels de l'environnement soient disponibles.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

WriteDeploymentInformation

Écrit les informations de déploiement qui sont incluses dans le résumé de la build. La section sur les informations de déploiement comporte trois sous-sections : Build, Déploiement et Test. Vous pouvez ajouter des informations de déploiement dans une sous-section à l'aide de la propriété DeploymentInformationType. Des liens peuvent être ajoutés aux informations de déploiement à l'aide de la propriété Url.

Propriétés

Message

Message à afficher dans le résumé. Obligatoire.

URL

URL ou lien facultatif à ajouter au message.

DeploymentInformationType

Spécifie la sous-section des informations de déploiement pour ce message d'information. Utilisez l'une des valeurs suivantes :

  • Build

  • Déploiement

  • Test

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

Classes Lab Management

Le tableau suivant récapitule les classes Lab Management que vous pouvez utiliser dans Workflow Designer pour personnaliser un processus de génération, de déploiement et de test. Le classes font partie de l'espace de noms Microsoft.TeamFoundation.Lab.Workflow.Activities.

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 build, 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 build, de déploiement et de test.

LabEnvironmentDetails

Stocke les informations requises pour identifier l'environnement lab dans le scénario de build, 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 build, de déploiement et de test.

ScriptDetails

Stocke les détails d'une série de tests.

LabWorkflowDetails

La classe LabWorkflowDetails contient les données de configuration de l'Assistant Paramètres de flux de travail lab. Dans le modèle LabDefaultTemplate, l'objet LabWorkflowDetails d'un flux de travail est contenu dans l'argument LabWorkflowParameters. La classe LabWorkflowDetails contient les propriétés suivantes :

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 build, 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 build, de déploiement et de test.

EnvironmentDetails

Objet LabEnvironmentDetails qui est créé par l'Assistant Flux de travail et qui stocke les informations qui permettent d'identifier l'environnement à utiliser pour un scénario de build, de déploiement et de test.

TestParameters

Objet RunTestDetails qui est créé par l'Assistant Flux de travail et qui stocke les détails du paramètre de test requis pour créer la série de tests automatisés.

BuildDetails

BuildDetails stocke les détails de build pour un scénario de build, de déploiement et de test.

Propriété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

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

DeploymentDetails

DeploymentDetails stocke les détails de paramètre de test qui sont requis pour créer la série de tests automatisés dans le flux de travail de build, de déploiement et de test. Vous pouvez accéder à l'objet DeploymentDetails qui est créé par l'Assistant Lab Management à l'aide de la propriété DeploymentDetails de l'argument LabWorkflowParameters.

Propriétés

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

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

LabEnvironmentDetails

Un objet LabEnvironmentDetails stocke les informations requises pour identifier l'environnement lab dans un scénario de build, de déploiement et de test. Vous pouvez accéder à l'objet LabEnvironmentDetails qui est créé par l'Assistant Lab Management à l'aide de la propriété EnvironmentDetails de l'argument LabWorkflowParameters.

Propriétés

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

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

RunTestDetails

L'objet RunTestDetails stocke les détails de paramètre de test qui sont requis pour créer la série de tests automatisés dans le flux de travail de build, de déploiement et de test. Vous pouvez accéder à l'objet RunTestDetails qui est créé par l'Assistant Lab Management à l'aide de la propriété TestParameters de l'argument LabWorkflowParameters.

Propriétés

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

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

ScriptDetails

Fournit des détails pour les scripts de déploiement. Un objet ScriptDetails est requis lorsque vous ajoutez une activité RunDeploymentScript au concepteur de flux de travail. InitializeAgentSpecAndEnvironmentVariables retourne un objet ScriptDetails.

Propriétés

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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

TestRunStatistics

Stocke les détails d'une série de tests. Un objet TestRunStatistics est retourné par l'activité ExecuteRemoteTestRun.

Propriétés

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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

LabEnvironmentInUseMarker

Stocke les détails du marqueur En cours d'utilisation d'un environnement. Utilisez l'activité GetLabEnvironmentInUseMarker pour retourner un objet LabEnvironmentInUseMarker.

Propriétés

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.

No text is specified for bookmark or legacy link 'b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top'.

LabEnvironmentState

Énumération qui spécifie l'état actuel de l'environnement. L'état d'un environnement lab est principalement déterminé par les états des ordinateurs virtuels qu'il contient. Si tous les ordinateurs virtuels sont dans un état stable cohérent, la valeur de LabEnvironmentState correspond à cet état. Sinon, la valeur est Mixte ou Échec. Lorsqu'une opération est en cours sur l'environnement, l'environnement lab est dans un état de transition, ce qui indique qu'une opération est en cours.

Les valeurs possibles pour LabEnvironmentState sont les suivantes :

Inconnu

Création

Échec de la création

CreateCancelling

Mise à jour

Stocké

Démarrage en cours

En cours d'exécution

Suspension en cours

Suspendu

Arrêt en cours

Arrêté

Création de l'instantané

Suppression de l'instantané

Restauration de l'instantané

Suppression

Échec de la suppression

Supprimé

Mixte

Échec

Migration en cours

Voir aussi

Activités de flux de travail LabDefaultTemplate