Lab-Management-Workflowaktivitäten
Beim Anpassen einer Lab Management-Workflowvorlage (LabDefaultTemplate.11.xaml) können Sie eine oder mehrere der vordefinierten Lab Management-Aktivitäten verwenden. Sie können auch auf Objekte zugreifen, die vom Lab Management-Assistenten erstellt werden. Dieses Thema beschreibt die Team Foundation Lab Management-Aktivitäten und - Objekte, die verfügbar sind, wenn Sie eine Workflowvorlage anpassen, um die Anwendung zu erstellen, bereitzustellen und zu testen. Weitere Informationen zum Ausführen dieser Aktivitäten in einem benutzerdefinierten Workflows finden Sie unter Anpassen des Lab-Management-Workflows.
Anforderungen
- Visual Studio Ultimate, Visual Studio Premium, Visual Studio Test Professional
Dieses Thema enthält folgende Abschnitte:
Lab Management-Aktivitäten
In der folgenden Tabelle werden die einzelnen Lab Management-Workflowaktivitäten beschrieben.
Aktivität |
Beschreibung |
|---|---|
Erstellt eine neue Umgebung mithilfe einer gespeicherten Umgebung und stellt sie in der angegebenen Hostgruppe bereit. |
|
Löscht eine Umgebung. |
|
Löscht eine Momentaufnahme einer Umgebung. |
|
Erstellt einen Testlauf in einer Umgebung und wartet auf dessen Fertigstellung. |
|
Generiert eine Umgebungs-Viewer-Datei, die eine Momentaufnahmenlink-ID besitzt. Mit dieser Aktivität wird eine Verbindung mit einer Momentaufnahme der Umgebung hergestellt. |
|
Gibt den Buildspeicherort und die Buildnummer für ein Build-, Bereitstellungs- und Testszenario zurück. |
|
Gibt die Kennzeichnung "In Gebrauch" für eine Umgebung zurück. |
|
Ruft die ID einer Momentaufnahme einer Umgebung ab. |
|
Ruft den Status der Umgebung ab. |
|
Ruft den Umgebungs-URI für einen angegebenen Umgebungsnamen und den Namen eines Lab-Speicherorts ab. |
|
Analysiert die Bereitstellungsskriptsdetails, die durch die Eigenschaft angegeben werden. |
|
Setzt die Kennzeichnung "In Gebrauch" für eine Umgebung zurück. |
|
Stellt die Umgebung mit der angegebenen Momentaufnahme wieder her. |
|
Führt das Bereitstellungsskript aus. Bei einem Fehler wird eine Buildwarnung ausgelöst oder geschrieben (siehe Angabe in der ThrowOnError-Eigenschaft). |
|
Fügt einen neuen Workflow auf einem Buildcontroller eines Buildservers der Warteschlange hinzu. |
|
Erstellt eine neue Umgebung und speichert sie in einer Teamprojekt-Bibliotheksfreigabe. |
|
Legt die Kennzeichnung "In Gebrauch" für die Umgebung fest. |
|
Erstellt eine Momentaufnahme einer Umgebung. |
|
Startet eine Umgebung. |
|
Beendet eine Umgebung. |
|
Wartet die angegebene maximale Zeit auf die Bereitschaft der Testfunktion der Umgebung. Am Ende der Wartezeit wird bei fehlender Betriebsbereitschaft der Testfunktion eine Timeoutausnahme ausgelöst. |
|
Der Typ des Workflows. |
|
Wartet für eine festgelegte maximale Dauer auf den Abschluss des in der Warteschlange enthaltenen Builds. Wenn der Buildworkflow nicht in der festgelegten maximalen Zeit beendet wird, wird TimeOutException ausgelöst. Mit der Aktivität wird der Status des Builds in der Warteschlange regelmäßig überprüft, um festzustellen, welche Builds fertig gestellt wurden. Dieses Intervall wird mithilfe der RefreshInterval-Eigenschaft konfiguriert. |
|
Schreibt Bereitstellungsinformationen, die in der Buildzusammenfassung enthalten sind. |
CreateLabEnvironment
Erstellt eine neue Umgebung mithilfe einer gespeicherten Umgebung und stellt sie in der angegebenen Hostgruppe bereit. Dies ist eine Aktivität mit langer Laufzeit, bei der die Erstellung der neuen Umgebung abgewartet wird. Wenn die neue Lab-Umgebung nicht erstellt werden kann, löst diese LabDeploymentProcessExceptions-Ausnahme eine Aktivität aus.
Eigenschaften
LabEnvironmentName |
Der Name der neuen Umgebung. Wenn diese Eigenschaft NULL oder leer ist, wird der Name der Umgebungsvorlage verwendet. |
LabEnvironmentTemplateUri |
Der URI einer gespeicherten Umgebungsvorlage. Der URI der Lab-Umgebungsvorlage kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. Erforderlich. |
TeamProjectHostGroupName |
Hostgruppe, in der die neue Umgebung bereitgestellt wird. Wenn die angegebene Hostgruppe nicht gefunden wird, wird eine Ausnahme vom Typ "NoTeamProjectHostGroupFoundException" ausgelöst. Erforderlich. |
DeleteLabEnvironment
Löscht eine Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der die Löschung der Umgebung abgewartet wird. Wenn das Löschen der Umgebung fehlschlägt, löst diese Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.
Eigenschaften
LabEnvironmentUri |
Der URI der zu löschenden Umgebung. Der URI der Lab-Umgebung kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. Erforderlich. |
DeleteSnapshot
Löscht eine Momentaufnahme einer Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der die Löschung der Momentaufnahme abgewartet wird. Wenn das Löschen der Momentaufnahme fehlschlägt, löst diese Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.
Eigenschaften
LabEnvironmentUri |
Der URI der Lab-Umgebung, deren Momentaufnahme gelöscht wird. Der URI der Lab-Umgebung kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. Erforderlich. |
SnapshotId |
ID der zu löschenden Momentaufnahme. Die ID der Momentaufnahme kann mithilfe der GetLabEnvironmentSnapshotId-Aktivität abgerufen werden. Erforderlich. |
ExecuteRemoteTestRun
Erstellt einen Testlauf in einer Umgebung und wartet auf dessen Fertigstellung. Dies ist eine Aktivität mit langer Laufzeit, bei der auf die Fertigstellung des Testlaufs oder auf ein Timeout gewartet wird. Sie können das Timeout mithilfe der MaxWaitTime-Eigenschaft festlegen. Mit dieser Aktivität wird der Status des Testlaufs regelmäßig überprüft, um festzustellen, welche Testläufe fertig gestellt werden. Dieses Intervall kann mithilfe der RefreshInterval-Eigenschaft konfiguriert werden. Mit der MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion-Eigenschaft kann angegeben werden, wie oft Team Foundation Server-Fehler ignoriert werden sollen, wenn der Status des Testlaufs überprüft wird.
Rückgabewert
Ein TestRunStatistics-Objekt, in dem die Details des Testlaufs gespeichert sind.
Eigenschaften
BuildNumber |
Buildnummer zur Ausführung von Tests. |
LabEnvironmentUri |
Der URI der Umgebung, in der Testfälle ausgeführt werden. Der URI der Umgebung kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. |
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion |
Die maximale Anzahl aufeinander folgender Fehler, die ignoriert werden sollen, während die Aktivität auf die Ausführung der Tests wartet. Der Standardwert dieser Eigenschaft ist 3. |
MaxWaitTime |
Ein Element vom Typ TimeSpan, in dem die maximale Wartezeit für die Fertigstellung des Testlaufs angegeben wird. Am Ende einer festgelegten Frist wird eine Timeoutausnahme ausgelöst. Der Standardwert ist 0 (null). Dies bedeutet, dass die Wartezeit der Aktivität unbegrenzt ist. |
RefreshInterval |
Ein Element vom Typ TimeSpan, in dem das Intervall angegeben ist, nach dem der Status des Testlaufs aktualisiert wird. Der Standardwert dieses Intervalls ist 60 Sekunden. |
TestDirectory |
Pfad zu den ausführbaren Testdateien. |
TestEnvironment |
Name der Testumgebung, in der die Testfälle ausgeführt werden. |
TestParameters |
Ein Microsoft.TeamFoundation.Lab.Workflow.Activities.RunTestDetails-Objekt, das Testparameter wie den Testplan, die Testauflistung, die Testeinstellungen und die Testkonfiguration angibt. Erforderlich. |
Titel |
Der Name des Testlaufs. Erforderlich. |
GenerateEnvironmentViewerFile
Generiert eine Umgebungs-Viewer-Datei, die die ID des Momentaufnahmenlinks enthält. Mit dieser Aktivität wird eine Verbindung mit einer Momentaufnahme der Umgebung hergestellt. Der Name der Umgebungs-Viewer-Datei ist der Name der Momentaufnahme ohne die folgenden Sonderzeichen: @"\[\`~\!@\#$%^&\*()+=\[{\\\]}|\\\\;:',/?\]". + "\"".
Eigenschaften
FilePath |
UNC-Pfad, in dem die Umgebungs-Viewer-Datei gespeichert wird. Das Builddienstkonto muss über eine Schreibberechtigung für den Pfad verfügen. Erforderlich. |
LabEnvironmentUri |
Der URI der Umgebung. Der URI der Umgebung kann mithilfe der GetLabEnvironmentUri-Aktivität abgerufen werden. Erforderlich. |
SnapshotId |
Die ID der Momentaufnahme. Die ID der Momentaufnahme kann mithilfe der GetLabEnvironmentSnapshotId-Aktivität abgerufen werden. Wenn die Momentaufnahme ungültig ist, wird eine Ausnahme vom Typ "InvalidSnapshotExceptions" ausgelöst. Erforderlich. |
GetBuildLocationAndBuildNumber
Gibt den Buildspeicherort und die Buildnummer für ein Build-, Bereitstellungs- und Testszenario zurück. Wenn "Teambuild" ausgewählt wird und der URI des Builds NULL ist, wird der letzte gültige Build ausgewählt, und Details werden zurückgegeben. Wenn kein gültiger Build gefunden wird, wird eine Ausnahme vom Typ "System.ArgumentException" ausgelöst. Wenn "Teambuild" nicht ausgewählt wird, wird nur der vom Benutzer angegebene Speicherort des Builds zurückgegeben.
Rückgabewert
Eine String, mit der der Speicherort des Builds angegeben wird.
Eigenschaften
BuildDetails |
Ein Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails-Objekt, das buildbezogene Informationen im Build-, Bereitstellungs- und Testszenario beinhaltet. |
BuildNumber |
Die Buildnummer des ausgewählten Builds. Dies ist ein out-Argument. Für Builds vom Typ "Teambuild" ist der Wert NULL. |
SelectedBuild |
Buildinformationen zum Buildserver. Dies ist ein out-Argument. Für Builds vom Typ "Teambuild" ist der Wert NULL. |
GetLabEnvironmentInUseMarker
Ruft die Kennzeichnung "In Gebrauch" für eine Umgebung ab.
Rückgabewert
Eine LabEnvironmentInUseMarker-Klasse, die die Details der Umgebungsmarkierung angibt.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
GetLabEnvironmentSnapshotId
Ruft die ID einer Momentaufnahme einer Umgebung ab. Wenn keine Momentaufnahme mit dem angegebenen Namen gefunden wird, wird eine Ausnahme vom Typ "NoSnapshotFoundException" ausgelöst.
Rückgabewert
Ein Int64 zur Angabe des Bezeichners der Momentaufnahme.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
SnapshotName |
Der Snapshotname. Erforderlich. |
GetLabEnvironmentStatus
Ruft den Status der Umgebung ab.
Rückgabewert
Ein LabEnvironmentState-Enumerationswert, der den aktuellen Zustand der Umgebung angibt.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
GetLabEnvironmentUri
Ruft den Umgebungs-URI für einen angegebenen Umgebungsnamen und den Namen eines Lab-Speicherorts ab. Der Lab-Speicherort kann entweder eine Hostgruppe oder eine Bibliotheksfreigabe sein. Wenn die Umgebung nicht gefunden wird, wird eine Ausnahme vom Typ "LabEnvironmentNotFoundException" ausgelöst.
Rückgabewert
Eine String, mit der der URI der Umgebung angegeben wird.
Eigenschaften
LabEnvironmentName |
Der Name der Umgebung. Erforderlich. |
ProjectName |
Name des Teamprojekts Wenn dieser Eigenschaftswert NULL ist oder nicht angegeben wird, wird das aktuelle Projekt des Builds verwendet. |
TeamProjectLabLocationName |
Der Name des Lab-Speicherorts. Dabei kann es sich entweder um einen Hostgruppennamen oder einen Bibliotheksfreigabenamen handeln. Wenn der Speicherort der Lab-Umgebung nicht gefunden wird, wird eine Ausnahme vom Typ "NoLabLocationFoundException" ausgelöst. Erforderlich. |
InitializeAgentSpecAndEnvironmentVariables
Initialisiert die Argumente, die für die RunDeploymentScript-Aktivität erforderlich sind. InitializeAgentSpecAndEnvironmentVariables extrahiert die Eigenschaften der virtuellen Computer in der Umgebung, die für die Bestimmung des Bereitstellungsskripts auf den Computern erforderlich sind.
Rückgabewert
Ein ScriptDetails-Objekt, in dem die Skriptdetails gespeichert werden, die für die Bereitstellung erforderlich sind.
Eigenschaften
BuildLocation |
Der Pfad zum Speicherort des Builds. Dient zur Erweiterung des Makros $ (BuildLocation). Erforderlich. |
DeploymentScriptDetails |
Bereitstellungsdetails im Format "Name des Lab-Systems | Skriptargumente | Arbeitsverzeichnis". Erforderlich. |
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
ResetLabEnvironmentInuseMarker
Setzt die Kennzeichnung "In Gebrauch" für eine Umgebung zurück.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
RestoreLabEnvironment
Stellt die Umgebung mit der angegebenen Momentaufnahme wieder her. Wenn die Momentaufnahme ungültig ist, wird eine Ausnahme vom Typ "InvalidSnapshotException" ausgelöst.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
SnapshotId |
Die ID der Momentaufnahme, in der die Umgebung wiederhergestellt werden soll. Die ID der Momentaufnahme kann mithilfe der GetLabEnvironmentSnapshotId-Aktivität abgerufen werden. Erforderlich. |
RunDeploymentScript
Führt das Bereitstellungsskript aus. Wenn das Skript fehlschlägt, wird eine Buildwarnung ausgelöst oder geschrieben, wie in der ThrowOnError-Eigenschaft angegeben.
Rückgabewert
Ein BuildStatus-Enumerationswert, der den Status des Bereitstellungsvorgangs angibt.
Eigenschaften
MaximumAttemptsForNetUse |
Maximale Anzahl der Versuche für das Hinzufügen von Netzauslastung. |
ScriptDetails |
Ein Skriptdetailobjekt für ein Lab-System. Erforderlich. |
SharedLocationForNetUse |
Speicherort, der für das Lab-Builddienstkonto zugänglich sein sollte. |
ThrowOnError |
Hiermit wird angegeben, ob wegen des Fehlers eine Ausnahme ausgelöst werden soll. Der Standardwert ist "true". |
RunWorkflow
Fügt einen neuen Workflow auf einem Buildcontroller eines Buildservers der Warteschlange hinzu. Es gibt zwei Möglichkeiten zur Angabe des Buildcontrollers, auf dem der Build der Warteschlange hinzugefügt werden muss:
Verwenden Sie die LabEnvironmentUri-Eigenschaft. Wenn diese Umgebung für Workflowintegration konfiguriert wird, wird der Buildcontroller der Umgebung für den Warteschlangenworkflow verwendet. Andernfalls wird eine Ausnahme vom Typ "LabDeploymentProcessException" ausgelöst.
Mit der BuildControler-Eigenschaft wird der Buildcontroller angegeben.
Rückgabewert
Ein Int32, mit dem die ID des Builds angegeben wird, der sich in der Warteschlange befindet.
Eigenschaften
BuildController |
Der Name des Buildcontrollers. Wenn diese Eigenschaft und der LabEnvironmentUri-Eigenschaftswert NULL oder nicht angegeben sind, wird der aktuelle Buildcontroller zum Hinzufügen des Builds zur Warteschlange verwendet. |
BuildDefinition |
Die Definition des der Warteschlange hinzuzufügenden Builds. Erforderlich. |
LabEnvironmentUri |
Der URI der Umgebung mit Workflowfunktionen. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
ProjectName |
Name des Teamprojekts Wenn diese Eigenschaft NULL ist oder nicht angegeben wird, wird das aktuelle Projekt des Builds verwendet. |
SaveLabEnvironment
Erstellt eine neue Umgebung und speichert sie in einer Teamprojekt-Bibliotheksfreigabe. Dies ist eine Aktivität mit langer Laufzeit, bei der das Speichern der Umgebung abgewartet wird. Wenn bei der Erstellung der neuen Umgebung ein Fehler auftritt, wird eine Ausnahme vom Typ "LabDeploymentProcessException" ausgelöst.
Rückgabewert
Eine String, mit der die URL der neuen Umgebung angegeben wird.
Eigenschaften
LabEnvironmentName |
Der Name der gespeicherten Umgebung. Wenn diese Eigenschaft NULL oder leer ist, wird der Name der Umgebung verwendet. |
LabEnvironmentUri |
Der URI der zu speichernden Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
TeamProjectLibraryShareName |
Die Bibliotheksfreigabe, in der die Umgebung gespeichert wird. Wenn die angegebene Bibliotheksfreigabe nicht gefunden wird, wird eine Ausnahme vom Typ "NoTeamProjectLibraryShareFoundException" ausgelöst. Erforderlich. |
SetLabEnvironmentInuseMarker
Legt die Kennzeichnung "In Gebrauch" für die Umgebung fest.
Eigenschaften
Kommentar |
Bei Festlegung des Markers wird ein Kommentar geschrieben. |
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
SnapshotLabEnvironment
Erstellt eine Momentaufnahme einer Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der die Erstellung der Momentaufnahme der Umgebung abgewartet wird. Wenn das Löschen der Momentaufnahme fehlschlägt, löst diese Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.
Rückgabewert
Eine Int64, die die ID der Momentaufnahme angibt.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung, deren Momentaufnahme erstellt werden muss. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
SnapshotChainId |
Gibt die ID der Momentaufnahmenkette zurück. |
SnapshotName |
Der Name der Momentaufnahme, die erstellt werden muss. Wenn die Eigenschaft NULL ist, wird der aktuelle DateTime-Wert als Name der Momentaufnahme verwendet. |
StartLabEnvironment
Startet eine Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der der Start der Umgebung abgewartet wird. Wenn der Start der Umgebung fehlschlägt, löst die Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
StopLabEnvironment
Beendet eine Umgebung. Dies ist eine Aktivität mit langer Laufzeit, bei der das Beenden der Umgebung abgewartet wird. Wenn das Beenden der Umgebung fehlschlägt, löst die Aktivität eine Ausnahme vom Typ "LabDeploymentProcessException" aus.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
WaitForTestCapabilityServices
Wartet die angegebene maximale Zeit auf die Bereitschaft der Testfunktion der Umgebung. Falls die Testfunktion am Ende der Wartezeit nicht bereit ist, wird eine Timeoutausnahme ausgelöst. Wenn die RepairCapabilityBeforeWaitBegins-Eigenschaft festgelegt wird, wird die Reparaturfunktion aufgerufen, bevor die Funktion bereit ist. Die maximale Wartezeit kann mit der MaxWaitTime-Eigenschaft konfiguriert werden.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
MaxWaitTime |
Ein System.TimeSpan-Objekt, mit dem die maximale Wartezeit für die Bereitstellung der Funktion angegeben wird. Am Ende einer festgelegten Frist wird eine Timeoutausnahme ausgelöst. Der Standardwert ist 0 (null), d. h. unbegrenzte Wartezeit. |
RepairCapabilityBeforeWaitBegins |
Wenn dieser Wert "true" ist, wird vor Beginn der Wartephase versucht, die Funktion zu reparieren. |
WaitForWorkflow
Wartet für eine festgelegte maximale Dauer auf den Abschluss des in der Warteschlange enthaltenen Builds. Wenn der Buildworkflow nicht in der festgelegten maximalen Zeit beendet wird, wird TimeOutException ausgelöst. Mit der Aktivität wird der Status des Builds in der Warteschlange regelmäßig überprüft, um festzustellen, welche Builds fertig gestellt wurden. Dieses Intervall wird mithilfe der RefreshInterval-Eigenschaft konfiguriert.
Rückgabewert
Ein BuildStatus-Enumerationswert, der den Status des Workflows angibt.
Eigenschaften
AllowPartiallySucceededBuild |
Wenn der Wert "true" ist, wird eine teilweise erfolgreiche Ausführung als erfolgreich eingestuft. |
BuildDetails |
Ein Microsoft.TeamFoundation.Build.Client.IBuildDetail-Objekt, das Details zum in der Warteschlange befindlichen Build auf dem Buildserver enthält. Dies ist ein out-Argument. |
LabWorkflowType |
Der Typ des Workflows. |
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion |
Maximale Anzahl aufeinander folgender Fehler, die ignoriert werden sollen, während die Fertigstellung des Workflows abgewartet wird. Der Standardwert hier ist 3. Diese Eigenschaft kann verwendet werden, um die Stabilität des Workflows zu erhöhen. |
MaxWaitTime |
Ein System.TimeSpan-Objekt, mit dem die maximale Wartezeit für die Fertigstellung des Workflows angegeben wird. Am Ende einer festgelegten Frist wird eine Timeoutausnahme ausgelöst. Der Standardwert ist 0 (null), d. h., die Wartezeit ist unbegrenzt. |
QueueBuildId |
Die ID des in der Warteschlange enthaltenen Builds. Erforderlich. |
RefreshInterval |
Ein System.TimeSpan-Objekt, das das Intervall angibt, nach dem der Status des Workflows aktualisiert wird. Der Standardwert dieses Intervalls ist 60 Sekunden. |
ThrowOnError |
Wenn der Wert "true" ist, wird bei einem Buildfehler eine Ausnahme ausgelöst. |
WaitForWorkflowCapabilityServices
Wartet die angegebene Dauer auf die Bereitschaft der Workflowfunktion für die Umgebung. Falls die Workflowfunktion am Ende der Wartezeit nicht bereit ist, wird eine Timeoutausnahme ausgelöst. Wenn die RepairCapabilityBeforeWaitBegins-Eigenschaft festgelegt wird, wird die Reparaturfunktion aufgerufen, bevor die Funktion bereit ist. Die maximale Wartezeit kann mit der MaxWaitTime-Eigenschaft konfiguriert werden.
Eigenschaften
LabEnvironmentUri |
Der URI der Umgebung. Mit der GetLabEnvironmentUri-Aktivität wird der URI der Umgebung abgerufen. Erforderlich. |
MaxWaitTime |
Ein System.TimeSpan-Objekt, mit dem die maximale Wartezeit für die Bereitstellung der Funktion angegeben wird. Am Ende einer festgelegten Frist wird eine Timeoutausnahme ausgelöst. Der Standardwert ist 0 (null), d. h., die Wartezeit ist unbegrenzt. |
RepairCapabilityBeforeWaitBegins |
Wenn dieser Wert "true" ist, wird vor Beginn der Wartephase versucht, die Funktion zu reparieren. |
WaitForComputerNames |
Wenn dieser Wert "true" ist, wird gewartet, bis die Computernamen aller virtuellen Computer der Umgebung verfügbar sind. |
WriteDeploymentInformation
Schreibt Bereitstellungsinformationen, die in der Buildzusammenfassung enthalten sind. Der Abschnitt mit den Bereitstellungsinformationen enthält drei Unterabschnitte: Build, Bereitstellung und Test. Sie können einem bestimmten Unterabschnitt Bereitstellungsinformationen hinzufügen, indem Sie die DeploymentInformationType-Eigenschaft verwenden. Links können den Bereitstellungsinformationen mithilfe der URL-Eigenschaft hinzugefügt werden.
Eigenschaften
Meldung |
In der Zusammenfassung anzuzeigende Meldung. Erforderlich. |
Url |
Optionale URL oder optionaler Link, der der Meldung hinzufügt werden soll. |
DeploymentInformationType |
Gibt den Unterabschnitt der Bereitstellungsinformationen für diese Informationsmeldung an. Verwenden Sie einen der folgenden Werte:
|
Lab Management-Klassen
In der folgenden Tabelle werden die Lab Management-Klassen zusammengefasst, die Sie im Workflow-Designer verwenden können, um einen Build-, Bereitstellungs- und Testprozess anzupassen. Die Klassen sind Teil des Microsoft.TeamFoundation.Lab.Workflow.Activities-Namespace.
Objekt |
Beschreibung |
|---|---|
Die LabWorkflowDetails-Klasse enthält die Konfigurationsdaten vom Assistenten für Lab-Workflowparameter. Das LabWorkflowDetails-Objekt enthält Objekte vom Typ "BuildDetails", "RunTestDetails" und "ScriptDetails". |
|
Speichert die Builddetails für ein Build-, Bereitstellungs- und Testszenario. |
|
Speichert die Details der Testparameter, die erforderlich sind, um den automatisierten Testlauf im Build-, Bereitstellungs- und Testworkflow zu erstellen. |
|
Speichert die Informationen, die für die Identifizierung der Lab-Umgebung im Build-, Bereitstellungs- und Testszenario erforderlich sind. |
|
Speichert Details des Markers "In Gebrauch" einer Umgebung. |
|
Gibt den aktuellen Zustand der Umgebung an. |
|
Speichert die Testparameterdetails, die zum Erstellen des automatisierten Testlaufs erforderlich sind. |
|
Speichert die Details des Bereitstellungsskripts die für Build-, Bereitstellungs- und Testszenarien erforderlich sind. |
|
Speichert Details eines Testlaufs. |
LabWorkflowDetails
Die LabWorkflowDetails-Klasse enthält die Konfigurationsdaten vom Assistenten für Lab-Workflowparameter. Im LabDefaultTemplate ist das LabWorkflowDetails-Objekt eines Workflows im LabWorkflowParameters-Argument enthalten. Die LabWorkflowDetails-Klasse enthält die folgenden Eigenschaften:
BuildDetails |
Ein durch den Workflow-Assistenten erstelltes Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails-Objekt, das die Builddetails für ein Build-, Bereitstellungs- und Testszenario speichert. |
DeploymentDetails |
Ein durch den Workflow-Assistenten erstelltes Microsoft.TeamFoundation.Lab.Workflow.Activities.DeploymentDetails-Objekt, das die Informationen speichert, die für die Bereitstellung eines Builds in einem Build-, Bereitstellungs- und Testszenario erforderlich sind. |
EnvironmentDetails |
Ein durch den Workflow-Assistenten erstelltes Microsoft.TeamFoundation.Lab.Workflow.Activities.LabEnvironmentDetails-Objekt, das die Informationen speichert, welche die für ein Build-, Bereitstellungs- und Testszenario zu verwendende Umgebung angeben. |
TestParameters |
Ein durch den Workflow-Assistenten erstelltes Microsoft.TeamFoundation.Lab.Workflow.Activities.RunTestDetails-Objekt, das die Testparameterdetails speichert, die zum Erstellen des automatisierten Testlaufs erforderlich sind. |
BuildDetails
Mit BuildDetails werden die Builddetails für Build-, Bereitstellungs- und Testszenarien gespeichert.
Eigenschaften
IsTeamSystemBuild |
Ein Boolean, der angibt, ob der verwendete Build vom Typ "Teambuild" ist. |
BuildDefinitionUri |
Ein Uri, der den URI der Builddefinition angibt. |
BuildDefinitionName |
Eine String, die den Namen der Builddefinition angibt |
QueueNewBuild |
Ein Boolean, der angibt, ob der neue Build in die Warteschlange gestellt werden muss. |
BuildUri |
Ein Uri, der den URI des Builds angibt, falls der Build vom Typ "Teambuild" ist |
CustomBuildPath |
Eine String, die den Pfad zum Build angibt, falls der Build nicht vom Typ "Teambuild" ist. |
Konfiguration |
DeploymentDetails
DeploymentDetails speichert die Details der Testparameter, die erforderlich sind, um den automatisierten Testlauf im Build-, Bereitstellungs- und Testworkflow zu erstellen. Sie können auf das "DeploymentDetails"-Objekt, das vom Lab Management-Assistenten erstellt wird, über die DeploymentDetails-Eigenschaft des LabWorkflowParameters-Arguments zugreifen.
Eigenschaften
PostDeploymentSnapshotPath |
Eine String, die den Pfad zum Speichern der Momentaufnahmen nach der Bereitstellung beinhaltet. |
PostDeploymentSnapshotName |
Eine String, die den Namen der Momentaufnahme angibt, die nach der Bereitstellung erstellt wird. |
TakePostDeploymentSnapshot |
Ein Boolean, der angibt, ob eine Momentaufnahme nach der Bereitstellung benötigt wird. |
Skripts |
Ein StringList-Objekt, das eine Liste von virtuellen Computern mit entsprechenden Bereitstellungsskripts enthält. |
DeploymentNeeded |
Ein Boolean, der angibt, ob die Bereitstellung ausgeführt werden muss. |
LabEnvironmentDetails
Mit einem LabEnvironmentDetails-Objekt werden die Informationen gespeichert, die zur Identifizierung der Lab-Umgebung in Build-, Bereitstellungs- und Testszenarien erforderlich sind. Sie können auf das "LabEnvironmentDetails"-Objekt, das vom Lab Management-Workflow-Assistenten erstellt wird, über die EnvironmentDetails-Eigenschaft des LabWorkflowParameters-Arguments zugreifen.
Eigenschaften
ProjectName |
Eine String, die den Namen des Teamprojekts angibt |
LabEnvironmentName |
Eine String, die den Namen der Lab-Umgebung angibt |
NewLabEnvironmentName |
Eine String, die den Namen der zu erstellenden Lab-Umgebung angibt. |
HostGroupName |
Eine String, die den Namen der Hostgruppe angibt, in der die Umgebung bereitgestellt wird. |
LabLibraryShareName |
Eine String, die den Namen der Bibliotheksfreigabe angibt, die die gespeicherte Vorlage der Lab-Umgebung enthält. |
RevertToSnapshot |
Ein Boolean, der angibt, ob für die Umgebung ein Rollback in eine Momentaufnahme ausgeführt werden soll. |
SnapshotName |
Eine String, die den Namen der Umgebungsmomentaufnahme angibt, in die das Rollback ausgeführt werden soll. |
TfsUrl |
Eine String, die die URL des Team Foundation Server-Computers angibt. |
LabEnvironmentUri |
Ein Uri, mit dem der URI der ausgewählten Umgebung angegeben wird. |
Disposition |
Ein LabEnvironmentDisposition-Enumerationswert, der den Status der Umgebung angibt. Folgende Werte sind möglich: Unbekannt – Der Status der Umgebung ist nicht bekannt. Aktiv – Die Umgebung wird auf einem Host bereitgestellt und kann gestartet und ausgeführt werden. Gespeichert – Die Umgebung wird in einer Bibliotheksfreigabe gespeichert und kann erst nach der Bereitstellung verwendet werden. |
RunTestDetails
Mit einem RunTestDetails-Objekt werden die Details der Testparameter gespeichert, die erforderlich sind, um den automatisierten Testlauf im Build-, Bereitstellungs- und Testworkflow zu erstellen. Sie können auf das "RunTestDetails"-Objekt, das vom Lab Management-Assistenten erstellt wird, über die TestParameters-Eigenschaft des LabWorkflowParameters-Arguments zugreifen.
Eigenschaften
TfsUrl |
Eine String, die die URL des Team Foundation Server-Computers angibt. |
Projektname |
Eine String, die den Namen des Teamprojekts angibt. |
TestConfigurationId |
Eine Int32, die die ID der Testkonfiguration für den Testlauf angibt. |
TestPlanId |
Eine Int32, die die ID des Testplans angibt |
TestSuiteIdList |
Ein "Systems.Collections.Generic.List<int>", das die numerischen IDs der auszuführenden Testauflistungen beinhaltet. |
TestSettingsId |
Eine Int32, die die ID der Testeinstellungen für den Testlauf angibt. |
RunTest |
Ein Boolean, der angibt, ob der Test ausgeführt werden soll. |
ScriptDetails
Beinhaltet detaillierte Informationen zu Bereitstellungsskripts. Ein "ScriptDetails"-Objekt ist erforderlich, wenn Sie dem Workflow-Designer eine RunDeploymentScript-Aktivität hinzufügen. InitializeAgentSpecAndEnvironmentVariables gibt ein "ScriptDetails"-Objekt zurück.
Eigenschaften
LabSystemName |
Eine String, die den Namen der Lab-Umgebung angibt. |
AgentSpec |
Ein AgentReservationSpec-Objekt, das Tags beinhaltet, die einem Build-Agent im Lab-System zugeordnet sind. |
FileName |
Eine String, die den Namen der Bereitstellungsskriptdatei angibt. |
Argumente |
Eine String, die die Argumente angibt, die an das Bereitstellungsskript übergeben werden sollen. |
WorkingDirectory |
Eine String, die das Arbeitsverzeichnis für das Bereitstellungsskript auf dem Lab-System angibt. |
EnvironmentVariables |
Ein "System.Collection.Generic.IDictionary<String,String>", das die Name/Wert-Paare der Umgebungsvariablen beinhaltet. |
TestRunStatistics
Speichert Details eines Testlaufs. Ein "TestRunStatistics"-Objekt wird von der ExecuteRemoteTestRun-Aktivität zurückgegeben.
Eigenschaften
TotalTests |
Ein Int32, das die Gesamtzahl der Tests im Testlauf angibt. |
PassedTests |
Ein Int32, das die Gesamtzahl der erfolgreichen Tests im Testlauf angibt. |
FailedTests |
Eine Int32, die die Gesamtzahl der fehlgeschlagenen Tests im Testlauf angibt. |
InconclusiveTests |
Eine Int32, die die Anzahl der Tests angibt, die im Testlauf nicht eindeutig sind. |
PendingTests |
Eine Int32, die die Anzahl der Tests angibt, die im Testlauf noch nicht ausgeführt wurden. |
AbortedTests |
Eine Int32, die die Anzahl der Tests angibt, die im Testlauf abgebrochen wurden. |
InProgressTests |
Eine Int32, die die Anzahl der Tests angibt, die im Testlauf derzeit ausgeführt werden. |
TestRunStatus |
Ein TestRunState-Enumerationswert, der den Status des Testlaufs angibt. |
TestRunId |
Eine Int32, die den Bezeichner des Testlaufs angibt. |
LabEnvironmentInUseMarker
Speichert Details des Markers "In Gebrauch" einer Umgebung. Mit der GetLabEnvironmentInUseMarker-Aktivität kann ein "LabEnvironmentInUseMarker"-Objekt zurückgegeben werden.
Eigenschaften
Benutzer |
Eine String, die den Benutzer angibt, der die Umgebung markiert hat. |
Timestamp |
Ein DateTime-Objekt, das die Uhrzeit angibt, zu der der Benutzer die Umgebung markiert hat. |
Kommentar |
Eine String, die von dem Benutzer angegeben wird, der die Umgebung markiert hat. |
LabEnvironmentState
Eine Enumeration, die den aktuellen Zustand der Umgebung angibt. Der Zustand einer Lab-Umgebung wird hauptsächlich vom jeweiligen Zustand der darin enthaltenen virtuellen Computer bestimmt. Wenn sich alle virtuellen Computer in einem konsistenten und stabilen Zustand befinden, lautet der LabEnvironmentState-Wert entsprechend. Andernfalls ist der Wert Gemischt oder Fehlgeschlagen. Wenn ein Vorgang in der Umgebung läuft, befindet sich die Lab-Umgebung in einem Übergangszustand, der den laufenden Vorgang angibt.
LabEnvironmentState verfügt über folgende Werte:
Unbekannt
Erstellen
CreateFailed
CreateCancelling
Aktualisieren
Gespeichert
Starting
Running
Pausing
Paused
Stopping
Beendet
CreatingSnapshot
DeletingSnapshot
RestoringSnapshot
Löschen
DeleteFailed
Deleted
Gemischt
Fehler
UnderMigration