Criando Propriedades de Transformação

Você pode criar propriedades de transformação em plug-ins do Eclipse que contenham transformações. As propriedades de transformação aperfeiçoam a saída gerada por uma transformação. Você pode especificar valores para essas propriedades ao criar ou editar uma configuração de transformação.
Antes de Iniciar
É necessário ter um arquivo de manifesto de plug-ins aberto no editor de manifesto. O arquivo de manifesto deve conter uma instância do ponto de extensão do provedor de transformação, um elemento de provedor de transformação e uma transformação.
Por Que e Quando Desempenhar Esta Tarefa
Para criar uma propriedade de transformação:
  1. No editor de manifesto de plug-ins, na guia Extensões, expanda com.ibm.xtools.transform.core.transformationProviders, expanda o elemento TransformationProvider apropriado, clique com o botão direito do mouse no elemento Transformation no qual você deseja incluir uma propriedade e, em seguida, clique em Nova > Propriedade.
    Nota: Também é possível criar uma propriedade de transformação clicando no elemento Transformation e clicando em Editar. No assistente Autoria de Transformação, na página Nova Transformação, na tabela Propriedades, clique em Inserir e especifique valores para as colunas na tabela. Para excluir uma propriedade, clique em uma linha na tabela Propriedades e clique em Excluir.
  2. No editor de manifesto de plug-ins, na guia Extensões, na área Detalhes do Elemento de Extensão, no campo name, especifique um nome que possibilite a identificação da propriedade.
    Dica: Para obter informações adicionais sobre os campos da área Detalhes do Elemento de Extensão, coloque o ponteiro do mouse sobre o nome para exibir a ajuda instantânea.
  3. Na área Detalhes do Elemento de Extensão, no campo id, especifique um identificador exclusivo para a propriedade. Esse valor deve ser exclusivo na transformação. Você deve especificar um identificador que siga esta convenção de nomenclatura: x.y, em que x representa o nome da transformação e y representa o nome da propriedade.
  4. Opcional: Especifique informações adicionais sobre a propriedade. Por exemplo, no campo metatype, especifique o tipo da propriedade. Por exemplo, para criar uma propriedade do tipo String que tenha um comprimento máximo de três caracteres, especifique os seguintes valores:
    • No campo metatype, digite String.
    • No campo metatypeData, digite maxLength=3.
  5. Clique em Arquivo > Salvar.
Resultados
É criado um elemento Property no arquivo de manifesto de plug-ins. A nova propriedade será exibida na página Propriedades do assistente Nova Configuração de Transformação ou no editor de configuração de transformação na próxima vez que você criar ou editar uma configuração de transformação. Você pode recuperar as informações sobre a propriedade chamando os métodos da interface ITransformationProperty. Os métodos desta interface extraem o valor e os metadados de uma propriedade de transformação. Se você extrair os dados de metatipo subjacentes do valor de propriedade utilizando o método getMetatypeData, para validar o valor de propriedade, você poderá especificar o código do aplicativo para analisar a Cadeia que esse método retorna. Para obter informações sobre como recuperar os valores de propriedades customizadas, consulte a documentação HTML Javadoc da classe ITransformationProperty.
Exemplo
Por exemplo, para criar uma propriedade String chamada My String Property que tenha um comprimento máximo de três caracteres, no editor de manifesto de plug-ins, na guia Extensões, na área Detalhes do Elemento de Extensão, especifique os seguintes valores:
No arquivo plugin.properties, inclua a seguinte linha para designar um valor para a variável %MyNewPropertyName:
MyNewPropertyName=My String Property
O que Fazer Depois
Nota: Se você criar um novo plug-in utilizando o modelo Plug-in com Transformação, poderá especificar essas informações na página Nova Transformação do assistente Autoria de Transformação.
Nota: Algumas informações, como links para a documentação do Eclipse ou para guias de desenvolvedor, estão disponíveis apenas a partir dos tópicos na ajuda do produto.

Feedback