Действия рабочего процесса Lab Management
При настройке шаблона рабочего процесса Lab Management (LabDefaultTemplate.11.xaml) можно использовать одно или несколько предопределенных действий Lab Management. Кроме того, можно использовать объекты, создаваемые мастером Lab Management. В этой теме представлено описание действий и объектов Team Foundation Lab Management, доступных при настройке шаблона рабочего процесса для создания, развертывания и тестирования приложения. Сведения об использовании этих действий в настраиваемом рабочем процессе см. в разделе Настройка рабочего процесса Lab Management.
Требования
- Visual Studio Ultimate, Visual Studio Premium, Visual Studio Test Professional
В этом разделе содержатся следующие подразделы.
Действия Lab Management
В следующей таблице описаны отдельные свойства рабочего процесса Lab Management.
Действие |
Описание |
|---|---|
Создает новую среду из сохраненного шаблона и развертывает ее в заданной группе узлов. |
|
Удаляет среду. |
|
Удаляет снимок среды. |
|
Создает тестовый запуск в среде и ожидает его окончания. |
|
Создает файл средства просмотра среды с идентификатором ссылки на снимок. Он используется для подключения к снимку среды. |
|
Возвращает расположение и номер построения для сценария создания, развертывания и тестирования. |
|
Возвращает для среды маркер использования. |
|
Получает идентификатор снимка среды. |
|
Получает состояние среды. |
|
Получает URI среды для заданного имени среды и имени расположения лаборатории. |
|
Анализирует сведения в скрипте развертывания, заданные свойством |
|
Сбрасывает для среды маркер использования. |
|
Восстанавливает среду из указанного снимка. |
|
Запускает скрипт развертывания. При сбое выдает предупреждение построения в соответствии со свойством ThrowOnError. |
|
Размещает в очереди новый рабочий процесс в контроллере построений на сервере построений. |
|
Создает новую среду и хранит ее в общей папке библиотеки командного проекта. |
|
Задает для среды маркер использования. |
|
Делает снимок среды. |
|
Запускает среду. |
|
Останавливает среду. |
|
Ожидает готовность среды к тестированию в течение заданного максимального времени. Если в конце периода ожидания среда к тестированию не готова, создается исключение истечения времени. |
|
Тип рабочего процесса. |
|
Ожидает завершения построения в очереди в течение заданного максимального времени ожидания. Если рабочий процесс построения не завершается за заданное максимальное время, создается исключение TimeOutException. Действие периодически проверяет состояние построения в очереди с целью определения завершенных построений. Этот интервал задается свойством RefreshInterval. |
|
Записывает сведения о развертывании, входящие в сводку построения. |
CreateLabEnvironment
Создает новую среду из сохраненного шаблона и развертывает ее в заданной группе узлов. Это длительное действие, которое ждет создания новой среды. Если создание новой лабораторной среды невозможно, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentName |
Имя новой среды. Если это свойство имеет значение NULL или оно пустое, будет использоваться имя шаблона среды. |
LabEnvironmentTemplateUri |
URI шаблона хранимой среды. URI шаблона лабораторной среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
TeamProjectHostGroupName |
Группа узлов, в которой будет развернута новая среда. Если указанная группа узлов не найдена, создается исключение NoTeamProjectHostGroupFoundException. Обязательный. |
DeleteLabEnvironment
Удаляет среду. Это длительное действие, которое ждет удаления среды. Если удаление лабораторной среды завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentUri |
URI удаляемой среды. URI лабораторной среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
DeleteSnapshot
Удаляет снимок среды. Это длительное действие, которое ждет удаления снимка. Если удаление снимка завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentUri |
URI лабораторной среды, чей снимок был удален. URI лабораторной среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
SnapshotId |
Идентификатор удаляемого снимка. Идентификатор снимка можно получить с помощью действия GetLabEnvironmentSnapshotId. Обязательный. |
ExecuteRemoteTestRun
Создает тестовый запуск в среде и ожидает его окончания. Это длительное действие, которое ждет окончания тестирования или истечения времени ожидания. Время ожидания задается свойством MaxWaitTime. Это действие периодически проверяет состояние тестового запуска в очереди с целью определения завершенных тестовых запусков. Этот интервал задается свойством RefreshInterval. С помощью свойства MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion можно задавать количество последовательных случаев игнорирования ошибок Team Foundation Server во время проверки состояния тестового запуска.
Возвращаемое значение
Объект TestRunStatistics, хранящий сведения о тестовом запуске.
Свойства
BuildNumber |
Номер построения, для которого выполняются тесты. |
LabEnvironmentUri |
URI среды, в которой будут выполняться тестовые случаи. URI среды можно получить с помощью действия GetLabEnvironmentUri. |
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion |
Максимальное количество последовательных сбоев, которые должны игнорироваться, когда действие ожидает выполнения тестов. Значение этого свойства по умолчанию равно 3. |
MaxWaitTime |
Объект TimeSpan, задающий максимальное время ожидания окончания тестового запуска. В конце заданного периода ожидания создается исключение истечения времени. Значение по умолчанию 0 (нуль), что соответствует бесконечному ожиданию действия. |
RefreshInterval |
Объект TimeSpan, задающий интервал, после которого обновляется состояние тестового запуска. Значение этого интервала по умолчанию равно 60 секундам. |
TestDirectory |
Путь к тестовым исполняемым файлам. |
TestEnvironment |
Имя тестовой среды, в которой будут выполняться тестовые случаи. |
TestParameters |
Объект Microsoft.TeamFoundation.Lab.Workflow.Activities.RunTestDetails, который определяет параметры тестов, например план тестирования, набор тестов, параметры тестирования и конфигурацию тестов. Обязательный. |
Заголовок |
Имя тестового запуска. Обязательный. |
GenerateEnvironmentViewerFile
Создает файл средства просмотра среды, содержащий идентификатор ссылки на снимок. Это действие используется для подключения к снимку среды. Имя файла средства просмотра среды является именем снимка без специальных символов: @"\[\`~\!@\#$%^&\*()+=\[{\\\]}|\\\\;:',/?\]" + "\"".
Свойства
FilePath |
Путь UNC для хранения файла средства просмотра среды. Учетная запись службы построения должна иметь следующие разрешения на запись для пути. Обязательный. |
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
SnapshotId |
Идентификатор снимка. Идентификатор снимка можно получить с помощью действия GetLabEnvironmentSnapshotId. Если снимок является недопустимым, создается исключение InvalidSnapshotException. Обязательный. |
GetBuildLocationAndBuildNumber
Возвращает расположение и номер построения для сценария создания, развертывания и тестирования. Если выбрано "командное построение" и значение URI построения равно NULL, выбирается последнее работоспособное построение, а сведения возвращаются. Если работоспособное построение не найдено, создается исключение System.ArgumentException. Если "командное построение" не выбрано, возвращается только расположение построения, заданное пользователем.
Возвращаемое значение
Объект String, определяющий расположение построения.
Свойства
BuildDetails |
Объект Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails, содержащий связанные с построением сведения в сценарии создания, развертывания и тестирования. |
BuildNumber |
Номер выбранного построения. Это outArgument. Значение NULL для построений, отличных от командных. |
SelectedBuild |
Сведения о построении для сервера построений. Это outArgument. Значение NULL для построений, отличных от командных. |
GetLabEnvironmentInUseMarker
Получает для среды маркер использования.
Возвращаемое значение
Объект LabEnvironmentInUseMarker, задающий сведения маркера среды.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
GetLabEnvironmentSnapshotId
Получает идентификатор снимка среды. Если снимок с указанным именем не найден, это действие создает исключение NoSnapshotFoundException.
Возвращаемое значение
Объект Int64, задающий идентификатор снимка.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
SnapshotName |
Имя снимка. Обязательный. |
GetLabEnvironmentStatus
Получает состояние среды.
Возвращаемое значение
Перечисленное значение LabEnvironmentState, которое указывает на текущее состояние среды.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
GetLabEnvironmentUri
Получает URI среды для заданного имени среды и имени расположения лаборатории. Лаборатория может располагаться в группе узлов или в общей папке библиотеки. Если среда не найдена, это действие создает исключение LabEnvironmentNotFoundException.
Возвращаемое значение
Объект String, задающий URI среды.
Свойства
LabEnvironmentName |
Имя среды. Обязательный. |
Имя_проекта |
Имя командного проекта. Если значение этого свойства равно NULL или не задано, используется текущий проект построения. |
TeamProjectLabLocationName |
Имя расположения лаборатории. Может быть именем группы узлов или именем общей папки библиотеки. Если расположение лаборатории не найдено, создается исключение NoLabLocationFoundException. Обязательный. |
InitializeAgentSpecAndEnvironmentVariables
Инициализирует аргументы, необходимые для действия RunDeploymentScript. InitializeAgentSpecAndEnvironmentVariables извлекает свойства виртуальных машин в среде, необходимые для скрипта развертывания на машинах.
Возвращаемое значение
Объект ScriptDetails, хранящий необходимые для развертывания сведения о скрипте.
Свойства
BuildLocation |
Путь к построению. Используется для расширения макроса $(BuildLocation). Обязательный. |
DeploymentScriptDetails |
Сведения о развертывании в формате "имя лабораторной системы | аргументы скрипта | рабочая папка". Обязательный. |
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
ResetLabEnvironmentInuseMarker
Сбрасывает для среды маркер использования.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
RestoreLabEnvironment
Восстанавливает среду из указанного снимка. Если снимок является недопустимым, действие выдает исключение InvalidSnapshotException.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
SnapshotId |
Идентификатор снимка, из которого восстанавливается среда. Идентификатор снимка можно получить с помощью действия GetLabEnvironmentSnapshotId. Обязательный. |
RunDeploymentScript
Запускает скрипт развертывания. При сбое скрипта выдается предупреждение построения в соответствии со свойством ThrowOnError.
Возвращаемое значение
Перечисленное значение BuildStatus, задающее состояние операции развертывания.
Свойства
MaximumAttemptsForNetUse |
Максимальное количество попыток добавления сетевого использования. |
ScriptDetails |
Объект "Сведения о скрипте" для лабораторной системы. Обязательный. |
SharedLocationForNetUse |
Расположение, к которому должна иметь доступ учетная запись службы лаборатории. |
ThrowOnError |
Флаг, определяющий необходимость создания исключения для ошибки. Значение по умолчанию — true. |
RunWorkflow
Размещает в очереди новый рабочий процесс в контроллере построений на сервере построений. Существует два способа указания контроллера построения, в котором построение должно быть поставлено в очередь.
Используйте свойство LabEnvironmentUri. Если в этой среде предполагается интеграция рабочих процессов, для постановки рабочих процессов в очередь будет использоваться ее контроллер построений. В противном случае создается исключение LabDeploymentProcessException.
Контроллер построений задается с помощью свойства BuildControler.
Возвращаемое значение
Объект Int32, задающий идентификатор построения в очереди.
Свойства
BuildController |
Имя контроллера построений. Если значения этого свойства и свойства LabEnvironmentUri равны NULL или не заданы, для размещения построения в очереди используется текущий контроллер построений. |
BuildDefinition |
Определение построения, размещаемого в очереди. Обязательный. |
LabEnvironmentUri |
URI среды с возможностями рабочих процессов. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
Имя_проекта |
Имя командного проекта. Если значение этого свойства равно NULL или не задано, используется текущий проект построения. |
SaveLabEnvironment
Создает новую среду и хранит ее в общей папке библиотеки командного проекта. Это длительное действие, которое ждет сохранения среды. Если создание новой среды завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Возвращаемое значение
Объект String, задающий URL-адрес новой среды.
Свойства
LabEnvironmentName |
Имя сохраненной среды. Если это свойство имеет значение NULL или оно пустое, будет использоваться имя среды. |
LabEnvironmentUri |
URI сохраняемой среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
TeamProjectLibraryShareName |
Общая папка библиотеки, в которой хранится среда. Если указанная общая папка библиотеки не найдена, создается исключение NoTeamProjectLibraryShareFoundException. Обязательный. |
SetLabEnvironmentInuseMarker
Задает для среды маркер использования.
Свойства
Комментарий |
Комментарий записан при заданном маркере. |
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
SnapshotLabEnvironment
Делает снимок среды. Это длительное действие, которое ждет создания снимка среды. Если создание снимка завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Возвращаемое значение
Значение Int64, задающее идентификатор снимка.
Свойства
LabEnvironmentUri |
URI среды, снимок которой следует сделать. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
SnapshotChainId |
Возвращает идентификатор цепочки снимков. |
SnapshotName |
Имя снимка, который следует сделать. Если значение этого свойства равно NULL, в качестве имени снимка используется текущее значение DateTime. |
StartLabEnvironment
Запускает среду. Это длительное действие, которое ждет запуска среды. Если запуск среды завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
StopLabEnvironment
Останавливает среду. Это длительное действие, которое ждет остановки среды. Если остановка среды завершается сбоем, это действие создает исключение LabDeploymentProcessException.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
WaitForTestCapabilityServices
Ожидает готовность среды к тестированию в течение заданного максимального времени. Если в конце периода ожидания среда к тестированию не готова, создается исключение истечения времени. Если задано свойство RepairCapabilityBeforeWaitBegins, восстановление вызывается перед ожиданием готовности. Максимальное время ожидания задается свойством MaxWaitTime.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
MaxWaitTime |
Объект System.TimeSpan, задающий максимальное время ожидания готовности. В конце заданного периода ожидания создается исключение истечения времени. Значение по умолчанию равно 0 (нулю), что означает неограниченное время ожидания. |
RepairCapabilityBeforeWaitBegins |
Если это значение задано как true, будет сделана попытка восстановления перед ожиданием. |
WaitForWorkflow
Ожидает завершения построения в очереди в течение заданного максимального времени ожидания. Если рабочий процесс построения не завершается за заданное максимальное время, создается исключение TimeOutException. Действие периодически проверяет состояние построения в очереди с целью определения завершенных построений. Этот интервал задается свойством RefreshInterval.
Возвращаемое значение
Значение перечисления BuildStatus, обозначающее состояние рабочего процесса.
Свойства
AllowPartiallySucceededBuild |
Если значение задано как true, частичный успех считается достаточным для успешного завершения действия. |
BuildDetails |
Объект Microsoft.TeamFoundation.Build.Client.IBuildDetail, содержащий сведения о построении в очереди на сервере построений. Это выходной аргумент. |
LabWorkflowType |
Тип рабочего процесса. |
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion |
Максимальное количество последовательных сбоев, которые должны игнорироваться при ожидании завершения рабочего процесса. Значение по умолчанию равно 3. С помощью этого свойства можно повысить надежность рабочего процесса. |
MaxWaitTime |
Объект System.TimeSpan, задающий максимальное время завершения рабочего потока. В конце заданного периода ожидания создается исключение истечения времени. Значение по умолчанию равно 0 (нулю), что означает неограниченное время ожидания. |
QueueBuildId |
Идентификатор построения в очереди. Обязательный. |
RefreshInterval |
Объект System.TimeSpan, задающий интервал, после которого обновляется состояние рабочего процесса. Значение этого интервала по умолчанию равно 60 секундам. |
ThrowOnError |
Если значение задано как true, при сбое построения создается исключение. |
WaitForWorkflowCapabilityServices
Ожидает готовность рабочего процесса к тестированию в течение заданного максимального времени. Если в конце периода ожидания рабочий процесс не готов, создается исключение истечения времени. Если задано свойство RepairCapabilityBeforeWaitBegins, восстановление вызывается перед ожиданием готовности. Максимальное время ожидания задается свойством MaxWaitTime.
Свойства
LabEnvironmentUri |
URI среды. URI среды можно получить с помощью действия GetLabEnvironmentUri. Обязательный. |
MaxWaitTime |
Объект System.TimeSpan, задающий максимальное время ожидания готовности. В конце заданного периода ожидания создается исключение истечения времени. Значение по умолчанию равно 0 (нулю), что означает неограниченное время ожидания. |
RepairCapabilityBeforeWaitBegins |
Если это значение задано как true, будет сделана попытка восстановления перед ожиданием. |
WaitForComputerNames |
Если это значение задано как true, система ожидает, пока не станут доступными имена компьютеров всех виртуальных машин. |
WriteDeploymentInformation
Записывает сведения о развертывании, входящие в сводку построения. В разделе сведений о развертывании имеется три подраздела: построение, развертывание и тестирование. Сведения о развертывании можно добавить в соответствующий подраздел с помощью свойства DeploymentInformationType. Ссылки на сведения о развертывании можно добавить с помощью Url.
Свойства
Сообщение |
Сообщение, отображаемое в сводке. Обязательный. |
Url |
Необязательный URL-адрес или ссылка, добавляемая в сообщение. |
DeploymentInformationType |
Задает подраздел сведений о развертывании для этого информационного сообщения. Необходимо использовать одно из следующих значений.
|
Классы управления лабораторной средой
В следующей таблице представлена сводная информация о классах управления лабораторной средой, которые можно использовать в конструкторе рабочих процессов для настройки создания, развертывания и тестирования. Классы входят в пространство имен Microsoft.TeamFoundation.Lab.Workflow.Activities.
Объект |
Описание |
|---|---|
Класс LabWorkflowDetails содержит данные о конфигурации из мастера "Параметры рабочих процессов лаборатории". Объект LabWorkflowDetails содержит объекты BuildDetails, RunTestDetails и ScriptDetails. |
|
Хранит сведения о построении для сценария создания, развертывания и тестирования. |
|
Хранит сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска в рабочем процессе создания, развертывания и тестирования. |
|
Хранит сведения, необходимые для определения лабораторной среды в сценарии создания, развертывания и тестирования. |
|
Хранит сведения о маркере использования среды. |
|
Задает текущее состояние среды. |
|
Хранит сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска. |
|
Хранит сведения о скрипте развертывания, необходимые для сценария создания, развертывания и тестирования. |
|
Хранит сведения о тестовом запуске. |
LabWorkflowDetails
Класс LabWorkflowDetails содержит данные о конфигурации из мастера "Параметры рабочих процессов лаборатории". В LabDefaultTemplate объект LabWorkflowDetails рабочего процесса находится в аргументеLabWorkflowParameters. Класс LabWorkflowDetails содержит следующие свойства.
BuildDetails |
Объект Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails, создаваемый мастером рабочих процессов и хранящий сведения о сборке для сценария сборки, развертывания и тестирования. |
DeploymentDetails |
Объект Microsoft.TeamFoundation.Lab.Workflow.Activities.DeploymentDetails, создаваемый мастером рабочих процессов и хранящий сведения, необходимые для развертывания сборки в сценарии сборки, развертывания и тестирования. |
EnvironmentDetails |
Объект Microsoft.TeamFoundation.Lab.Workflow.Activities.LabEnvironmentDetails, создаваемый мастером рабочих процессов и содержащий сведения, определяющие среду, которая должна использоваться для сценария сборки, развертывания и тестирования. |
TestParameters |
Объект Microsoft.TeamFoundation.Lab.Workflow.Activities.RunTestDetails, создаваемый мастером рабочих процессов и содержащий сведения о параметрах тестирования, необходимых для создания автоматического тестового запуска. |
BuildDetails
Объект BuildDetails хранит сведения о построении для сценария создания, развертывания и тестирования.
Свойства
IsTeamSystemBuild |
Объект Boolean, определяющий, является ли используемое построение командным. |
BuildDefinitionUri |
Объект Uri, задающий URI определения построения. |
BuildDefinitionName |
Объект String, задающий имя определения построения. |
QueueNewBuild |
Объект Boolean, определяющий необходимость постановки нового построения в очередь. |
BuildUri |
Объект Uri, задающий URI построения, если построение является командным. |
CustomBuildPath |
Объект String, задающий путь к построению, если построение не является командным. |
Конфигурация |
DeploymentDetails
Объект DeploymentDetails хранит сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска в рабочем процессе создания, развертывания и тестирования. Доступ к объекту DeploymentDetails, создаваемому мастером Lab Management, можно получить с помощью свойства DeploymentDetails аргумента LabWorkflowParameters.
Свойства
PostDeploymentSnapshotPath |
Объект String, содержащий путь хранения к снимку после развертывания. |
PostDeploymentSnapshotName |
Объект String, задающий имя снимка, сделанного после развертывания. |
TakePostDeploymentSnapshot |
Объект Boolean, определяющий необходимость снимка после развертывания. |
Скрипты |
Объект StringList, содержащий список виртуальных машин с соответствующими скриптами развертывания. |
DeploymentNeeded |
Объект Boolean, определяющий необходимость развертывания. |
LabEnvironmentDetails
Объект LabEnvironmentDetails хранит сведения, необходимые для определения лабораторной среды в сценарии создания, развертывания и тестирования. Доступ к объекту LabEnvironmentDetails, создаваемому мастером рабочих процессов Lab Management, можно получить с помощью свойства EnvironmentDetails аргумента LabWorkflowParameters.
Свойства
Имя_проекта |
Объект String, задающий имя командного проекта. |
LabEnvironmentName |
Объект String, задающий имя лабораторной среды. |
NewLabEnvironmentName |
Объект String, задающий имя создаваемой лабораторной среды. |
HostGroupName |
Объект String, задающий имя группы узлов, в которой развертывается среда. |
LabLibraryShareName |
Объект String, задающий имя общей папки библиотеки, содержащей шаблон хранимой лабораторной среды. |
RevertToSnapshot |
Объект Boolean, определяющий необходимость отката до снимка. |
SnapshotName |
Объект String, задающий имя снимка среды, до которого выполняется откат. |
TfsUrl |
Объект String, задающий URL-адрес Team Foundation Server. |
LabEnvironmentUri |
Объект Uri, задающий URI выбранной среды. |
Disposition |
Перечисленное значение LabEnvironmentDisposition, определяющее состояние среды. Возможные значения: Unknown — состояние среды неизвестно. Active — среда развернута на узле и может быть запущена. Stored — среда хранится в общей папке библиотеке и не может быть использована до развертывания. |
RunTestDetails
Объект RunTestDetails хранит сведения о параметрах тестирования, необходимые для создания автоматического тестового запуска в рабочем процессе создания, развертывания и тестирования. Доступ к объекту DeploymentDetails, создаваемому мастером Lab Management, можно получить с помощью свойства TestParameters аргумента LabWorkflowParameters.
Свойства
TfsUrl |
Объект String, задающий URL-адрес Team Foundation Server. |
Имя проекта |
Объект String, задающий имя командного проекта. |
TestConfigurationId |
Объект Int32, задающий идентификатор конфигурации теста для тестового запуска. |
TestPlanId |
Объект Int32, задающий идентификатор плана тестирования. |
TestSuiteIdList |
Объект Systems.Collections.Generic.List<int>, содержащий числовые идентификаторы запускаемых наборов тестов. |
TestSettingsId |
Объект Int32, задающий идентификатор параметров тестирования для тестового запуска. |
RunTest |
Объект Boolean, определяющий необходимость запуска теста. |
ScriptDetails
Предоставляет сведения скриптам развертывания. Объект ScriptDetails необходим при добавлении действия RunDeploymentScript в конструктор рабочих процессов. Объект InitializeAgentSpecAndEnvironmentVariables возвращает объект ScriptDetails.
Свойства
LabSystemName |
Объект String, задающий имя лабораторной среды. |
AgentSpec |
Объект AgentReservationSpec, содержащий теги, которые связаны с агентом построения в лабораторной системе. |
FileName |
Объект String, задающий имя файла скрипта развертывания. |
Аргументы |
Объект String, определяющий аргументы, передаваемые скрипту развертывания. |
WorkingDirectory |
Объект String, задающий рабочую папку для скрипта развертывания в лабораторной системе. |
EnvironmentVariables |
Объект System.Collection.Generic.IDictionary<String,String>, содержащий пары "имя-значение" переменных среды. |
TestRunStatistics
Хранит сведения о тестовом запуске. Объект TestRunStatistics возвращается действием ExecuteRemoteTestRun.
Свойства
TotalTests |
Объект Int32, задающий общее количество тестов при тестовом запуске. |
PassedTests |
Объект Int32, задающий количество успешно выполненных тестов при тестовом запуске. |
FailedTests |
Объект Int32, задающий количество тестов, завершившихся ошибкой, при тестовом запуске. |
InconclusiveTests |
Объект Int32, задающий количество тестов с неопределенными результатами при тестовом запуске. |
PendingTests |
Объект Int32, задающий количество еще не выполненных тестов при тестовом запуске. |
AbortedTests |
Объект Int32, задающий количество прерванных тестов при тестовом запуске. |
InProgressTests |
Объект Int32, задающий количество выполняемых в настоящий момент тестов при тестовом запуске. |
TestRunStatus |
Перечисленное значение TestRunState, задающее состояние тестового запуска. |
TestRunId |
Объект Int32, задающий идентификатор тестового запуска. |
LabEnvironmentInUseMarker
Хранит сведения о маркере использования среды. Чтобы вернуть объект LabEnvironmentInUseMarker, следует использовать действие GetLabEnvironmentInUseMarker.
Свойства
Пользователь |
Объект String, определяющий пользователя, пометившего среду. |
Отметка времени |
Объект DateTime, определяющий время, когда пользователь пометил среду. |
Комментарий |
Объект String, заданный пользователем, пометившим среду. |
LabEnvironmentState
Перечисление, определяющее текущее состояние среды. Состояние лабораторной среды, как правило, определяется состоянием находящихся в ней виртуальных машин. Если состояние всех виртуальных машин стабильно, значение LabEnvironmentState соответствует этому состоянию. В противном случае значение равно Mixed или Failed. Когда операция выполняется в среде, лабораторная среда находится в переходном состоянии, что указывает на выполняемую в данный момент операцию.
Для LabEnvironmentState предусмотрены следующие значения:
Неизвестно
Creating
CreateFailed
CreateCancelling
Updating
Stored
Starting
Выполняется
Pausing
Paused
Stopping
Остановлено
CreatingSnapshot
DeletingSnapshot
RestoringSnapshot
Deleting
DeleteFailed
Deleted
Mixed
Сбой
UnderMigration