Você pode criar propriedades de transformação em plug-ins do Eclipse que
contenham transformações de modelo em modelo. 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:
- 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 .
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.
- 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.
- 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.
- 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.
- Clique em .
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 campo name, digite %MyNewPropertyName
- No campo id, digite MyNewPropertyName
- No campo metatype, digite String
- No campo metatypeData, digite maxLength=3
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.