getNextTeamBuildRequest
IBM Rational Team Concert Client for Microsoft Visual Studio IDE  

getNextTeamBuildRequest

Die Task 'getNextTeamBuildRequest' ruft die nächste Buildanforderung für eine angegebene Engine und eine optionale Builddefinition 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 einen Build 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. Ein Build ist vielleicht nicht erforderlich, wenn in der Quelle keine Änderungen seit dem letzten Build 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 Build-Engine, für die die nächste Buildanforderung 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-Build-Engine als integrierte Eigenschaft verfügbar ist.

Ja

requestUUIDProperty

Speichert die UUID (Universally Unique Identifier) der abgerufenen Buildanforderung. 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 Builddefinitions-ID zur Prüfung auf anstehende Anforderungen an. Wenn die Builddefinitions-ID von der angegebenen Build-Engine nicht unterstützt wird, wird keine Anforderung abgerufen.

Nein

buildDefinitionIdProperty

Speichert die Builddefinitions-ID der nächsten Buildanforderung 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 Buildanforderung für die angegebene Build-Engine zu speichern ist. Der Pfad kann ein relativer Pfad in Bezug auf das Basisverzeichnis der Builddatei 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-Build-Engine 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}" />

Feedback

War dies hilfreich? Sie können unter Jazz.net Feedback geben (Registrierung erforderlich): Geben Sie Kommentare in den Foren ab oder melden Sie einen Bug bzw. Fehler.