Níže uvedená tabulka popisuje atributy úlohy Ant sestavení Jazz.
| Atribut | Popis |
|---|---|
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. |
|
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. |
|
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. |
|
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. |
|
Štítek sestavení, který byl vygenerován sestavovacím strojem Jazz Build Engine. Například 20080215-1234. |
|
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. |
|
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. |
|
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í. |
|
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á. |
|
Soubor, který se má použít k uložení serializovaných sad změn. |
|
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. |
|
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. |
|
Specifická komponenta, která má být přidružena k tomuto příspěvku. |
|
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ý. |
|
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. |
|
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. |
|
Lokální adresář, kde jsou uloženy načtené soubory. Pokud existuje, je odstraněn před načtením. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Č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. |
|
|
Pro startBuildActivity je to štítek, který popisuje aktivitu sestavení. Není-li zadán, jako štítek se použije hodnota pro activityID. |
|
Cesta k lokálnímu souboru, který se použije k výpočtu velikosti souboru pro publikovaný odkaz. |
|
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í. |
|
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. |
|
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:
|
|
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. |
|
Heslo pro ID uživatele, řetězec standardně s nulovou délkou, není-li zadáno jinak. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Ukládá UUID načtené žádosti o sestavení. Je nastaven pouze tehdy, je-li nalezena žádost. |
|
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. |
|
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. |
|
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. |
|
Seznam názvů stavů sestavení
oddělených čárkami. Výchozí nastavení jsou COMPLETED a INCOMPLETE. Platné hodnoty jsou následující:
|
|
Stav, který má být nastaven v IBuildResultContribution. Platné hodnoty jsou OK, ERROR a WARNING. |
|
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. |
|
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. |
|
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. |
|
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. |