Odkazy na atributy Ant

Toto téma popisuje atributy úloh Ant sestavení Jazz.

Níže uvedená tabulka popisuje atributy úlohy Ant sestavení Jazz.

Atribut Popis

activityId

Jedinečný identifikátor aktivity sestavení.

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 definice 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 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í, které 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í znova 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 waitForTeamBuild je to UUID výsledku sestavení, který je očekáván.

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 čeká.

changeSetFile

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

changesAcceptedProperty

Ukládá počet akceptovaných sad změn. Vlastnost je definována a nastavena pouze tehdy, je-li akceptována alespoň jedna změna.

componentMap

Cesta k souboru, který obsahuje informace o mapování název-balíku-pro-komponentu.

Pro úlohu junitLogPublisher je to cesta k souboru, který obsahuje informace o mapování název-balíku-pro-komponentu. Název balíku musí odpovídat balíku pro třídu testovací sady JUnit.

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. Výchozí nastavení je výchozí kódování aktuální platformy. Další informace viz Seznam znakových sad IANA.

deletePropertiesFile

Cesta k souboru vlastností. Tento soubor vlastností určuje vlastnosti, které by měly 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.

destination

Lokální adresář, kde jsou uloženy načtené soubory. Pokud existuje, je odstraněn před načtením.

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í.

Pro úlohu JUnitLogPublisher je to cesta k protokolu XML JUnit nebo cesta k adresáři obsahujícímu protokoly XML JUnit. 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 úlohy filePublisher je to cesta k souboru nebo adresáři souborů, které se mají publikovat.

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

inputFileType

Pro úlohu workItemPublisher tento příznak indikuje, 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 pro 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 obsahující tuto šablonu, která může selhat, aniž by způsobila selhání celého sestavení. Šablona 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 obsahující úpravy času pro každou složku ve zdrojovém adresáři sourceDirectory. Hodnota každé vlastnosti je poslední upravený čas 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, řetězec standardně s nulovou délkou, není-li zadáno jinak.

passwordFile

Soubor hesel použitý pro připojení. Můžete použít vhodný soubor hesel vyvoláním 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ší výchozí stavy 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 UUID žádosti sestavení, která je očekávána.

requestUUIDFile

Cesta k souboru, v němž se má uložit UUID další žádosti o sestavení pro zadaný 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á 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í 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í UUID výsledku sestavení.

snapshotName

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

sourceDirectory

Pro úlohu pluginOrganizer je to zdrojový adresář, který se má používat. Předpokládá se, že 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.

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 další výstup zpráv. Výchozí nastavení je false.

workspaceUUID

Pro úlohu teamAccept je to UUID pracovního prostoru, do kterého se mají akceptovat změny.

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

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

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 UUID pracovního prostoru, do kterého se mají akceptovat 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