Odkazy na atributy Ant

Toto téma popisuje atributy úlohy Ant sestavení Jazz Team Build.

Tabulka níže popisuje atributy úlohy Ant sestavení Jazz Team Build.

Atribut Popis

activityId

Jedinečný identifikátor aktivity sestavení. Identifikátor activityId předaný aktivitě completeBuildActivity je přechováván ve vlastnosti nastavené úlohou startBuildActivity. Určete hodnotu atributu activityId použitím syntaxe zástupného prvku hodnoty vlastnosti ${}.

activityIdProperty

Ukládá jedinečné ID nově spuštěné aktivity. Je nezbytné pouze tehdy, pokud volající zamýšlí výslovně dokončit tuto aktivitu pomocí úlohy completeBuildActivity, nebo pokud se tato aktivita používá jako nadřízený prvek pro podřízené aktivity.

autoComplete

Pro úlohu startTeamBuild určuje, zda má být sestavení dokončeno automaticky. Výchozí nastavení je true. Když má tento atribut hodnotu true, při spuštění nástroje Ant musíte použít parametr -listener com.ibm.team.build.ant.listener.TeamBuildListener.

Pro úlohu startBuildActivity určuje, zda se má aktivita automaticky dokončit v některé z následujících situací: Nadřízená aktivita je dokončena, spustí se další rovnocenná aktivita nebo je sestavení dokončeno. Výchozí hodnota je false.

buildDefinitionId

Pro úlohu getNextTeamBuildRequest určuje ID definice sestavení, které se má zkontrolovat na nevyřízené žádosti. Pokud není ID definice sestavení podporováno určeným sestavovacím strojem, pak není žádost načtena.

Pro úlohu requestTeamBuild je to identifikátor definice sestavení, která se má použít.

Pro úlohu startTeamBuild je to definice sestavení pro sestavení, které se má spustit. Je nezbytné, pokud není zadáno requestUUID.

buildDefinitionIdProperty

Ukládá ID definice sestavení další žádosti o sestavení pro určený stroj. Je definováno pouze tehdy, pokud je načtena žádost pro určený stroj. Nepoužije se, pokud je zadáno buildDefinitionId.

buildLabel

Štítek sestavení, který byl vygenerován sestavovacím strojem Jazz Build Engine. Například 20080215-1234.

buildLabelPrefix

Určuje předponu pro štítek sestavení, jako např. I pro integraci. Pokud definujete tuto vlastnost v definici sestavení nebo v sestavovacím stroji, hodnota je předřazena před štítek, který vygeneruje sestavovací stroj Jazz Build Engine. Například I20080215-1234.

buildResultUUID

Klíč UUID výsledku sestavení, který se má aktualizovat. Hodnota tohoto atributu je zpravidla ${buildResultUUID}, protože vlastnost je při použití sestavovacího stroje Jazz Build Engine vestavěna.

Pro úlohu completeBuild je to UUID výsledku sestavení, jenž se má dokončit.

Pro úlohu teamAccept je to výsledek sestavení, který se má aktualizovat informacemi ze snímku. Snímek lze použít k pozdějšímu novému vytvoření pracovního prostoru sestavení.

Pro úlohu teamFetch bude tento výsledek sestavení aktualizován informacemi o pracovním prostoru sestavení. To umožňuje, aby byl později pracovní prostor sestavení znovu vytvořen z výsledku sestavení. Tento atribut by měl být nastaven při nejvýše jednom vyvolání této úlohy na sestavení. Výsledky sestavení nemohou mít k sobě přidružen více než jeden pracovní prostor. Tato úloha vyvolá výjimku, pokud již má výsledek sestavení k sobě přidružen pracovní prostor.

Pro úlohu waitForTeamBuild je to UUID výsledku sestavení, na který se čeká. Zadává se obvykle v případě, že bylo sestavení spuštěno prostřednictvím volání {@link StartBuildTask}, které vrací UUID výsledku sestavení ve vlastnosti určené atributem resultUUIDProperty.

buildNotNecessary

Nastavte na hodnotu true, pokud sestavení nebylo nezbytné. Sestavení nemusí být nezbytné například tehdy, pokud od předchozího sestavení nedošlo k žádným změnám zdroje. Tento atribut použijte pouze ve skriptu Ant, který řídí celý životní cyklus sestavení.

buildStateProperty

Vlastnost pro zápis stavu sestavení, když úloha ukončí čekání. Je nastavena pouze tehdy, pokud sestavení vstoupilo do jednoho z určených stavů, na které se má čekat.

buildStatusProperty

Této vlastnosti bude přiřazen stav sestavení, hodnotou je jedna z hodnot OK, INFO, VAROVÁNÍ nebo CHYBA.

changeSetFile

Soubor, který se má použít k uložení serializovaných sad změn.

changesAcceptedProperty

Ukládá počet přijatých sad změn. Vlastnost je definována a nastavena pouze tehdy, je-li přijata alespoň jedna sada změn.

componentMap

Cesta k souboru, který obsahuje informace o mapování názvů balíků na komponenty.

Cesta k souboru obsahující informace o mapování názvu balíku na komponentu. Název balíku musí odpovídat balíku pro třídu testovací sady.

componentName

Specifická komponenta, která má být přidružena k tomuto příspěvku.

contentType

Typ artefaktu. Není-li zadán, je nastaven na hodnotu aplikace/neznámá.

Pro úlohu filePublisher je to typ artefaktu. Není-li zadán, výchozí hodnota je aplikace/neznámá.

Pro úlohu logPublisher je to typ artefaktu. Není-li zadán, výchozí hodnota je text/prostý.

contributionTypeId

ID rozšířeného typu příspěvku pro tento příspěvek.

characterEncoding

Kódování znaků použité v souboru artefaktu. Musí to být název odpovídající standardu IANA. Standardně se použije výchozí kódování aktuální platformy. Další informace viz téma Seznam názvů znakových sad IANA.

deletePropertiesFile

Cesta k souboru vlastností. Tento soubor vlastností určuje vlastnosti, které mají být vynechány, když je sestavení spuštěno. Předpokládá se, že vlastnosti v definici sestavení existují. Cesta může být relativní cesta ze základního adresáře souboru sestavení nebo úplná cesta.

deleteAllowed

Určuje, zda bude možné odstranit výsledek sestavení.

destination

Lokální adresář, kde jsou uloženy načtené soubory.

engineId

Pro úlohu getNextTeamBuildRequest je to identifikátor sestavovacího stroje, pro který se má načíst další žádost o sestavení.

Pro úlohu startTeamBuild je to identifikátor sestavovacího stroje, který spouští sestavení. Je nezbytný, pokud není zadán requestUUID.

failOnError

Pokud je hodnota nastavena na true (výchozí nastavení), úloha se nezdaří, pokud narazí na chybu. Je-li nastavena na false, některé chyby jsou ignorovány a úloha je dokončena.

filePath

Pro úlohy, které potřebují vstupní soubor, určuje cestu k souboru. Může to být absolutní cesta nebo relativní cesta k základnímu adresáři souboru sestavení.

Cesta k protokolu XML nebo cesta do adresáře, který obsahuje protokoly XML. Cesta může být relativní cesta ze základního adresáře souboru sestavení nebo úplná cesta.

Pro úlohu jdtCompileLogPublisher je to cesta k souboru protokolu kompilátoru JDT nebo k adresáři souborů, které se mají publikovat.

Pro úlohu filePublisher je to cesta k souboru nebo adresáři souborů, které se mají publikovat.

Pro úlohu workItemPublisher nastavte cestu k výstupnímu souboru sady změn z úlohy teamAccept nebo k souboru pracovních položek. Soubor pracovních položek musí obsahovat jedno ID pracovní položky na každém řádku. Cesta může být relativní k základnímu adresáři souboru sestavení nebo absolutní cesta.

Pro mstestLogPublisher jde o cestu k protokolu TRX XML nebo o cestu do adresáře, který obsahuje protokoly TRX XML. Cesta může být relativní cesta ze základního adresáře souboru sestavení nebo úplná cesta.

inputFileType

Pro úlohu workItemPublisher tento příznak označuje, zda atribut filePath označuje soubor sady změn nebo soubor pracovních položek. Platné hodnoty jsou CHANGESET a WORKITEM. Není-li tento atribut zadán, úloha předpokládá, že atribut filePath ukazuje na soubor sady změn.

interval

Čas mezi kontrolami určujícími, zda je sestavení v požadovaném stavu. Hodnota je v sekundách a musí být větší než nula a menší nebo rovna hodnotě časového limitu. Výchozím nastavením je kontrola každých 30 sekund.

label

Štítek použitý pro sestavení.

Pro startBuildActivity je to štítek, který popisuje aktivitu sestavení. Není-li zadán, jako štítek se použije hodnota atributu activityID.

LocalFilePath

Cesta k lokálnímu souboru, který se použije k výpočtu velikosti souboru pro publikovaný odkaz.

mayFailPattern

Podřetězec názvu třídy testovací sady. Libovolný název třídy testovací sady, který obsahuje tento vzorek, může selhat, aniž by to způsobilo selhání celého sestavení. Vzorek je jednoduchý řetězec, nikoli regulární výraz. Není-li zadána, každé selhání testovací sady způsobí nezdar sestavení.

overridePropertiesFile

Cesta k souboru vlastností. Tento soubor vlastností může přidat nové vlastnosti nebo přepsat existující vlastnosti v definici sestavení. Cesta může být relativní cesta ze základního adresáře souboru sestavení nebo úplná cesta.

outputPropertiesFile

Určuje výstupní soubor, který bude zapsán a bude obsahovat vlastnost pro každý adresář ve zdrojovém adresáři sourceDirectory. Tento soubor vlastností obsahuje cesty ke složkám a časová razítka, která popisují čas úpravy pro každou složku ve zdrojovém adresáři sourceDirectory. Hodnota každé vlastnosti je čas její poslední změny v GMT. Soubor je formátován jako soubor vlastností ve stylu java. Například:

  • com.ibm.team.scm.admin.service=200803060309
  • com.ibm.team.scm.client=200803060309
  • com.ibm.team.scm.feature.server=200803060309

parentActivityID

Identifikátor existující aktivity, která má být použita jako nadřízená. Aktivita s tímto identifikátorem musí existovat a nesmí být dokončena.

password

Heslo pro ID uživatele, standardně řetězec s nulovou délkou, není-li zadáno jinak.

passwordFile

Soubor hesel použitý pro připojení. Vhodný soubor hesel můžete vytvořit vyvoláním sestavovacího stroje Jazz Build Engine s argumentem -createPasswordFile. Můžete zadat pouze jeden soubor hesel.

pdeBuild

Pokud je hodnota nastavena na true, vydavatel interpretuje adresářovou strukturu protokolu jako vygenerovanou sestavením pde. Adresář modulů plug-in se musí v hierarchii objevit v dané cestě k souboru. Vydavatel seskupí balíky podle modulu plug-in.

rawOutputPropertiesFile

Cesta k souboru vlastností. Cesta může být relativní cesta ze základního adresáře souboru sestavení nebo úplná cesta. Tento soubor obsahuje interní ID složky a úrovně baseline, které popisují nejnovější úrovně baseline pro každou složku ve zdrojovém adresáři sourceDirectory.

requestUUID

Určuje existující žádost o sestavení, která se má použít při spuštění sestavení. Je-li zadána, nelze zadat buildDefinitionID a engineID.

Pro waitForTeamBuild je to klíč UUID žádosti o sestavení, na kterou se čeká. Zadává se obvykle v případě, že bylo sestavení vyžádáno prostřednictvím volání {@link RequestBuildTask}, které vrací UUID požadavku sestavení ve vlastnosti určené atributem requestUUIDProperty.

requestUUIDFile

Cesta k souboru, v němž se má uložit klíč UUID další žádosti o sestavení pro určený sestavovací stroj. Cesta může být relativní k základnímu adresáři souboru sestavení nebo úplná cesta. Soubor je formátován ve formátu java.util.Properties a obsahuje vlastnost s názvem zadaným pomocí requestUUIDProperty.

requestUUIDProperty

Ukládá klíč UUID načtené žádosti o sestavení. Je nastaven pouze tehdy, je-li nalezena žádost.

repositoryAddress

Adresa týmového úložiště, které se má použít. Hodnota tohoto atributu je zpravidla ${repositoryAddress}, protože tato vlastnost je při použití sestavovacího stroje Jazz Build Engine vestavěna.

resultUUIDFile

Soubor, který se má použít k uložení výsledku sestavení. Cesta může být relativní cesta vůči základnímu adresáři souboru sestavení nebo úplná cesta. Soubor je formátován ve formátu java.util.Properties a obsahuje vlastnost s názvem zadaným pomocí resultUUIDProperty.

resultUUIDProperty

Vlastnost pro uložení klíče UUID výsledku sestavení.

snapshotName

Název snímku, který je vytvořen v pracovním prostoru.

snapshotUUIDProperty

Poskytuje název vlastnosti pro přístup k UUID snímku, který je vytvořen.

sourceDirectory

Pro úlohu pluginOrganizer je to zdrojový adresář, který se má používat. Předpokládá se, že v něm existují adresáře modulů plug-in a funkcí.

Pro úlohu teamLastModified je to umístění adresáře v lokálním systému souborů. Hodnota atributu sourceDirectory musí být kořenový adresář pracovního prostoru úložiště Jazz. Pokud například úloha teamFetch načítá do adresáře c:\fetched, adresář sourceDirectory v úloze teamLastModified by měl být c:\fetched. Tato úloha není kompatibilní s obslužným programem příkazového řádku scmtools.

statesToWaitFor

Seznam názvů stavů sestavení oddělených čárkami. Výchozí nastavení jsou COMPLETED a INCOMPLETE. Platné hodnoty jsou následující:
  • NOT_STARTED: Požadované sestavení nebylo spuštěno. Nazývá se také nevyřízené.
  • IN_PROGRESS: Sestavení probíhá.
  • COMPLETED: Sestavení bylo normálně dokončeno, ale může obsahovat chyby.
  • CANCELED: Žádost o sestavení je zrušena před spuštěním sestavení.
  • INCOMPLETE: Sestavení nebylo normálně dokončeno. Nazývá se také opuštěné.

status

Stav, který má být nastaven v IBuildResultContribution. Platné hodnoty jsou OK, ERROR a WARNING.

tags

Nastavuje značky pro výsledek sestavení. Jednotlivé značky v řetězci jsou vzájemně odděleny čárkou nebo mezerou.

targetDirectory

Adresář, do kterého se má obsah přesunout.

timeout

Maximální čas, po který úloha čeká na sestavení. Hodnota je v sekundách a musí být větší než nula. Výchozí nastavení je čekat navždy.

timestampFormat

Formát časového razítka, jako je např. http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html. Výchozí nastavení je rrrrMMddHHmm.

url

Adresa URL odkazu.

userId

ID uživatele, které se má použít.

verbose

Určuje podrobnější výstup zpráv. Výchozí nastavení je false.

workspaceUUID

Pro úlohu teamAccept je to klíč UUID pracovního prostoru, do kterého se mají přijímat změny.

Pro úlohu teamFetch je to klíč UUID pracovního prostoru, ze kterého se má načítat.

Pro úlohu teamLastModified je to klíč UUID kontextu pracovního prostoru, který se má použít.

Máte-li více pracovních prostorů se stejným názvem, můžete být potřebné použít tento atribut místo workspaceName.

workspaceName

Pro úlohu teamAccept je to název pracovního prostoru, do kterého se mají přijímat změny.

Pro úlohu teamFetch je to název pracovního prostoru, ze kterého se má načítat.

Pro úlohu teamLastModified je to název pracovního prostoru, který se má používat.


Váš názor

Byla tato pomoc užitečná? Zpětnou vazbu můžete poskytnout na stránkách Jazz.net (registrace je požadována): Komentář na fóru nebo odeslat chybu