getNextTeamBuildRequest

Die Task 'getNextTeamBuildRequest' ruft die nächste Erstellungsanforderung für eine angegebene Engine und eine optionale Erstellungsdefinition ab.

Die Task 'getNextTeamBuildRequest' gibt eine Anforderungs-UUID (Universally Unique Identifier) zurück, die Sie auf eine der folgenden Arten verwenden können:

Sie können die UUID an die Task 'startTeamBuild' senden, um eine Erstellung für die Anforderung zu starten.
Sie können die UUID an die Task 'completeTeamBuild' senden, um das Attribut 'buildNotNecessary' auf den Wert 'true' zu setzen. Eine Erstellung ist vielleicht nicht erforderlich, wenn in der Quelle keine Änderungen seit der letzten Erstellung vorhanden sind.

In der nachfolgenden Tabelle werden die Attribute der Task 'getNextTeamBuildRequest' beschrieben.

Attribut	Beschreibung	Erforderlich
engineId	Für die Task 'getNextTeamBuildRequest': Die Kennung der Erstellungsengine, für die die nächste Erstellungsanforderung abzurufen ist.	Ja
repositoryAddress	Die Adresse des zu verwendenden Team-Repositorys. Der Wert dieses Attributs entspricht in der Regel der Variablen ${repositoryAddress}, weil diese Eigenschaft bei Verwendung der Jazz-Erstellungsengine als integrierte Eigenschaft verfügbar ist.	Ja
requestUUIDProperty	Speichert die UUID (Universally Unique Identifier) der abgerufenen Erstellungsanforderung. Dieses Attribut wird nur festgelegt, wenn eine Anforderung gefunden wird.	Ja
userId	Die zu verwendende Benutzer-ID.	Ja
buildDefinitionId	Für die Task 'getNextTeamBuildRequest': Gibt eine Erstellungsdefinitions-ID zur Prüfung auf anstehende Anforderungen an. Wenn die Erstellungsdefinitions-ID von der angegebenen Erstellungsengine nicht unterstützt wird, wird keine Anforderung abgerufen.	Nein
buildDefinitionIdProperty	Speichert die Erstellungsdefinitions-ID der nächsten Erstellungsanforderung für die angegebene Engine. Diese Eigenschaft wird nur definiert, wenn eine Anforderung für die angegebene Engine abgerufen wird. Gilt nicht, wenn 'buildDefinitionId' angegeben wird.	Nein
requestUUIDFile	Der Pfad zu der Datei, in der die UUID (Universally Unique Identifier) der nächsten Erstellungsanforderung für die angegebene Erstellungsengine zu speichern ist. Der Pfad kann ein relativer Pfad in Bezug auf das Basisverzeichnis der Erstellungsdatei oder ein vollständiger Pfad sein. Die Datei wird im Format 'java.util.Properties' formatiert und enthält eine Eigenschaft mit dem Namen, der durch das Attribut 'requestUUIDProperty' angegeben wird.	Nein
failOnError	Bei 'true' (Standardwert) schlägt die Task fehl, wenn ein Fehler auftritt. Bei 'false' werden einige Fehler ignoriert und die Task wird abgeschlossen.	Nein
password	Das Kennwort für die Benutzer-ID. Standardmäßig eine Zeichenfolge mit der Länge null, wenn nicht angegeben.	Nein
passwordFile	Die Kennwortdatei, die für die Verbindung zu verwenden ist. Sie können eine passende Kennwortdatei erstellen, indem Sie die Jazz-Erstellungsengine mit dem Argument '-createPasswordFile' aufrufen. Sie können nur eine Kennwortdatei angeben.	Nein
verbose	Gibt eine umfangreichere Nachrichtenausgabe an. Die Standardeinstellung ist "false".	Nein

Beispiel

<getNextTeamBuildRequest repositoryAddress="${repositoryAddress}"
		                         userId="${userId}"
		                         password="${password}"
		                         engineId="${buildEngineId}"
		                         requestUUIDProperty="requestUUID" />

<fail message="Did not find the next request as expected."
		      unless="requestUUID" />
<echo message="request UUID = ${requestUUID}" />