Referência de Atributo Ant

Este tópico descreve os atributos da tarefa Ant de construção do Jazz.

A tabela abaixo descreve os atributos da tarefa Ant de construção do Jazz.

Atributo	Descrição
activityId	Identificador exclusivo da atividade de construção.
activityIdProperty	Armazena o ID exclusivo de uma atividade recém-iniciada. Somente é necessário se o responsável pela chamada pretender explicitamente concluir esta atividade utilizando a tarefa completeBuildActivity ou se esta atividade for utilizada como uma atividade-pai para as atividades-filhas.
autoComplete	Para a tarefa startTeamBuild, especifica se a construção deverá ser concluída automaticamente. O padrão é verdadeiro. Quando este atributo é true, você deve utilizar o parâmetro -listener com.ibm.team.build.ant.listener.TeamBuildListener ao ativar o Ant. Para a tarefa startBuildActivity, especifica se a atividade deve ser automaticamente concluída em qualquer uma das seguintes situações: a atividade-pai é concluída, a próxima atividade é iniciada ou a construção é concluída. O padrão é false.
buildDefinitionId	Para a tarefa getNextTeamBuildRequest, especifica um ID de definição de construção para verificar os pedidos pendentes. Se o ID de definição de construção não for suportado pelo mecanismo de construção especificado, então um pedido não é recuperado. Para a tarefa requestTeamBuild, o identificador da definição de construção a ser utilizada. Para a tarefa startTeamBuild, a definição de construção da construção a ser iniciada. Obrigatória se requestUUID não for especificado.
buildDefinitionIdProperty	Armazena o ID da definição da construção do próximo pedido de construção para o mecanismo especificado. Ele é definido somente se um pedido para o mecanismo especificado for recuperado. Não aplique se buildDefinitionId for especificado.
buildLabel	A etiqueta da construção que foi gerada pelo Jazz Build Engine. Por exemplo, 20080215-1234.
buildLabelPrefix	Especifica um prefixo para a etiqueta de construção, como `I` para integração. Se você definir esta propriedade em sua definição de construção ou seu mecanismo de construção, o valor é acrescentado para a etiqueta que o Jazz Build Engine gera. Por exemplo, I20080215-1234.
buildResultUUID	O UUID do resultado da construção a ser atualizado. O valor deste atributo é tipicamente ${buildResultUUID} porque a propriedade é incorporada quando se utiliza o Mecanismo de Construção do Jazz. Para a tarefa completeBuild, o UUID do resultado de construção a ser concluída. Para a tarefa teamAccept, o resultado da construção a ser atualizado com as informações de captura instantânea. A captura instantânea pode ser utilizada para recriar o espaço de trabalho de construção posteriormente. Para a tarefa teamFetch, este resultado de construção será atualizado com as informações do espaço de trabalho de construção. Isso permite que o espaço de trabalho de construção seja recriado posteriormente a partir do resultado da construção. Este atributo deve ser configurado em no máximo uma chamada desta tarefa por construção. Os resultados da construção não podem ter mais de um espaço de trabalho associado a eles. Esta tarefa gera uma exceção se o resultado da construção já tiver um espaço de trabalho associado a ele. Para waitForTeamBuild, o UUID do resultado da construção que é aguardado.
buildNotNecessary	Configurado como true se a construção não for necessária. Por exemplo, uma construção pode não ser necessária se não tiverem ocorrido alterações na origem desde a construção anterior. Utilize somente este atributo em um script Ant que controle todo o ciclo de vida da construção.
buildStateProperty	A propriedade para gravar o estado da construção quando a tarefa concluir a espera. Ela é configurada somente se a construção entrar em um dos seguintes estados de espera.
changeSetFile	Arquivo a ser utilizado para armazenar conjuntos de alterações serializadas.
changesAcceptedProperty	Armazena o número de conjuntos de alterações aceitas. A propriedade é definida e configurada somente se no mínimo um conjunto de alterações for aceito.
componentMap	Caminho para um arquivo que contém informações de mapeamento de nome do pacote para componente. Para a tarefa junitLogPublisher, o caminho para um arquivo que contém informações de mapeamento de nome do pacote para componente. O nome do pacote deve corresponder ao pacote para a classe de conjunto de testes JUnit.
componentName	O componente específico a ser associado a esta contribuição.
contentType	O tipo do artefato. Se não for especificado, ele é definido como application/unknown. Para a tarefa filePublisher, o tipo do artefato. Se não for especificado, o padrão é application/unknown. Para a tarefa logPublisher, o tipo do artefato. Se não for especificado, o padrão é text/plain.
contributionTypeId	O ID do tipo de contribuição estendido desta contribuição.
characterEncoding	A codificação de caracteres utilizada no arquivo de artefato. Ele deve ser um nome compatível com IANA. Padrões para a codificação padrão da plataforma atual. Para obter informações adicionais, consulte Lista IANA de Nomes de Conjuntos de Caracteres.
deletePropertiesFile	Caminho para um arquivo de propriedades. Este arquivo de propriedades especifica propriedades que devem ser omitidas quando a construção é executada. As propriedades são assumidas como existentes na definição da construção. O caminho pode ser um caminho relativo a partir do diretório de base do arquivo de construção ou um caminho completo.
destino	Diretório local onde os arquivos buscados são armazenados. Se existir, ele será excluído antes da busca.
engineId	Para a tarefa getNextTeamBuildRequest, o identificador do mecanismo de construção para o qual recuperar o próximo pedido de construção. Para a tarefa startTeamBuild, o identificador do mecanismo de construção que executa a construção. Obrigatório se requestUUID não for especificado.
failOnError	Se true (o padrão), a tarefa falha se encontrar um erro. Se false, alguns erros são ignorados e a tarefa é concluída.
filePath	Para tarefas que necessitam de um arquivo de entrada, especifica o caminho para um arquivo. Ele pode ser um caminho absoluto ou um caminho relativo para o diretório de base do arquivo de construção. Para a tarefa JUnitLogPublisher, o caminho para o log XML do JUnit, ou um caminho para um diretório que contém os logs XML do JUnit. O caminho pode ser um caminho relativo a partir do diretório de base do arquivo de construção ou um caminho completo. Para a tarefa jdtCompileLogPublisher, o caminho para o arquivo de log do compilador JDT ou diretório de arquivos a ser publicado. Para a tarefa filePublisher, o caminho para o arquivo ou diretório de arquivos para publicar. Para a tarefa workItemPublisher, configure o caminho para uma saída do arquivo do conjunto de alterações a partir da tarefa teamAccept, ou um arquivo de itens de trabalho. Um arquivo de itens de trabalho deve conter IDs de itens de trabalho, um em cada linha. O caminho pode ser relativo ao diretório de base do arquivo de construção ou um caminho absoluto.
inputFileType	Para a tarefa workItemPublisher, este sinalizador indica se o atributo filePath indica um arquivo de conjunto de alterações ou um arquivo de item de trabalho. Os valores válidos são CHANGESET e WORKITEM. Se este atributo não for especificado, a tarefa assume que o atributo filePath aponta para um arquivo de conjunto de alterações.
intervalo	O tempo entre as verificações para determinar se a construção está no estado necessário. O valor está em segundos e deve ser maior que zero e menor que o valor de tempo limite. O padrão é verificar a cada 30 segundos.
rótulo	A etiqueta a ser utilizada para a construção. Para startBuildActivity, a etiqueta que descreve a atividade de construção. Se não for especificado, o valor para o activityID é utilizado como a etiqueta.
LocalFilePath	Um caminho para um arquivo local que é utilizado para calcular o tamanho do arquivo para o link publicado.
mayFailPattern	Uma subcadeia de um nome de classe do conjunto de testes. Todo nome de classe do conjunto de testes que contém o padrão pode falhar sem fazer com que a construção geral falhe. O padrão é uma cadeia simples, não uma expressão comum. Se não for especificado, toda falha de conjunto de testes fará com que a construção falhe.
overridePropertiesFile	Caminho para um arquivo de propriedades. Este arquivo de propriedades pode incluir novas propriedades ou sobrepor propriedades existentes na definição da construção. O caminho pode ser um caminho relativo a partir do diretório de base do arquivo de construção ou um caminho completo.
outputPropertiesFile	Especifica um arquivo de saída que será gravado para conter uma propriedade para cada diretório em sourceDirectory. Estes arquivos de propriedades contêm caminhos de pastas e registros de data e hora que descrevem o horário da modificação para cada uma das pastas no sourceDirectory. Cada valor de propriedade é seu último horário de modificação em GMT. O arquivo é formatado como um arquivo de propriedades em estilo java. Por exemplo: com.ibm.team.scm.admin.service=200803060309 com.ibm.team.scm.client=200803060309 com.ibm.team.scm.feature.server=200803060309
parentActivityID	O identificador de uma atividade existente a ser utilizada como atividade-pai. Uma atividade com este identificador deve existir e não pode estar concluída.
senha	A senha para o ID do usuário, que é uma cadeia de comprimento zero por padrão, a menos que seja especificada.
passwordFile	O arquivo de senha a ser utilizado para a conexão. É possível criar um arquivo de senhas adequado chamando o Mecanismo de Construção do Jazz com o argumento -createPasswordFile. É possível especificar somente um arquivo de senhas.
pdeBuild	Se for true, o publicador interpreta a estrutura de diretórios do log como sendo gerada pela construção do PDE. Um diretório de plug-ins deve aparecer na hierarquia sob o filePath especificado. O publicador agrupa pacotes por plug-in.
rawOutputPropertiesFile	Caminho para um arquivo de propriedades. O caminho pode ser um caminho relativo a partir do diretório de base do arquivo de construção ou um caminho completo. Este arquivo de propriedades contém uma pasta interna e IDs de linha de base que descrevem as linhas de base mais recentes para cada uma das pastas no "sourceDirectory
requestUUID	Especifica um pedido de construção existente para utilizar ao iniciar a construção. Se for especificado, o buildDefinitionID e o engineID não podem ser especificados. Para waitForTeamBuild, o UUID do pedido de construção que é aguardado.
requestUUIDFile	Caminho para o arquivo no qual armazenar o UUID do próximo pedido de construção para o mecanismo de construção especificado. O caminho pode ser relativo ao diretório de base do arquivo de construção ou um caminho completo. O arquivo é formatado como um formato java.util.Properties e contém uma propriedade com o nome especificado pelo requestUUIDProperty.
requestUUIDProperty	Armazena o UUID do pedido de construção recuperado. Ele é configurado somente se um pedido for localizado.
repositoryAddress	Endereço do repositório da equipe a ser utilizado. O valor deste atributo é tipicamente ${repositoryAddress} porque a propriedade é incorporada quando se utiliza o Mecanismo de Construção do Jazz.
resultUUIDFile	Arquivo a ser utilizado para armazenar o resultado da construção. O caminho pode ser um caminho relativo para o diretório de base do arquivo de construção ou um caminho completo. O arquivo é formatado no formato java.util.Properties e contém uma propriedade com o nome especificado pelo atributo resultUUIDProperty.
resultUUIDProperty	Propriedade para armazenar o UUID do resultado da construção.
snapshotName	Nome para uma captura instantânea que é criada no espaço de trabalho.
sourceDirectory	Para a tarefa pluginOrganizer, o diretório de origem a ser utilizado. É assumido que existem os diretórios de plug-ins e recursos. Para a tarefa teamLastModified, um local de diretório no sistema de arquivos local. O valor do atributo sourceDirectory deve ser a raiz do espaço de trabalho do Repositório do Jazz. Por exemplo, se a tarefa teamFetch buscar por c:\fetched, o sourceDirectory no teamLastModified deverá ser c:\fetched. Esta tarefa não é compatível com o utilitário da linha de comandos scmtools.
statesToWaitFor	Uma lista separada por vírgulas dos nomes de estado da construção. Os padrões são COMPLETED e INCOMPLETE. Os valores válidos são os seguintes: NOT_STARTED: uma construção pedida não iniciada. Também referenciada como pendente. IN_PROGRESS: a construção está em progresso. COMPLETED: a construção foi concluída normalmente, mas pode conter erros. CANCELED: o pedido de construção foi cancelado antes da construção ter sido iniciada. INCOMPLETE: a construção não foi concluída normalmente. Também referenciada como abandonada.
status	O status para configurar no IBuildResultContribution. Os valores válidos são `OK`, `ERROR` e `WARNING`.
targetDirectory	O diretório para onde mover o conteúdo.
tempo limite	A quantidade máxima de tempo que a tarefa aguarda na construção. O valor está em segundos e deve ser maior que zero. O padrão é aguardar para indefinidamente.
timestampFormat	Um formato de registro de data e hora, como http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html. O padrão é yyyyMMddHHmm.
url	URL do link.
userId	ID do usuário a ser utilizado.
verbose	Especifica saída de mais mensagens. O padrão é falso.
workspaceUUID	Para a tarefa teamAccept, o UUID do espaço de trabalho no qual aceitar alterações. Para a tarefa teamFetch, o UUID do espaço de trabalho a partir do qual buscar. Para a tarefa teamLastModified, o UUID do contexto do espaço de trabalho a ser utilizado. Se tiver múltiplos espaços de trabalho com o mesmo nome, será necessário utilizar este atributo em vez de workspaceName.
workspaceName	Para a tarefa teamAccept, o nome do espaço de trabalho no qual aceitar alterações. Para a tarefa teamFetch, o nome do espaço de trabalho a partir do qual buscar. Para a tarefa teamLastModified, o nome do espaço de trabalho a ser utilizado.