Você pode criar propriedades que aperfeiçoam o comportamento de uma extensão
de transformação. Ao contrário de regras, extratores e transfigurações, você não precisa associar
uma propriedade de extensão de transformação a uma transformação de destino. A funcionalidade da transformação
núcleo não distingue entre as propriedades de uma extensão de
transformação e as propriedades da transfiguração de destino.
Antes de Iniciar
É necessário abrir o arquivo de manifesto de plug-ins da extensão de transformação.
O arquivo de manifesto deve conter um elemento TransformationExtension.
Por Que e Quando Desempenhar Esta Tarefa
Se a
propriedade criada já existir na transformação de destino, os
seguintes eventos ocorrerão:- Se a propriedade na transformação de destino for legível e gravável,
a propriedade criada na extensão de transformação substituirá o
valor padrão na transformação de destino.
- Se a propriedade na transformação de destino for de leitura, a funcionalidade da
transformação núcleo ignorará a propriedade criada.
Para incluir uma propriedade em uma extensão de transformação:
- No editor de manifesto, na guia Extensões,
clique com o botão direito do mouse em um elemento TransformationExtension e, em seguida, clique em .
- Na área Detalhes do Elemento de Extensão,
especifique valores para os seguintes campos:
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.
- No campo name, especifique
um nome que possibilite a identificação da propriedade.
- No campo id, especifique um identificador
exclusivo para a propriedade. Esse valor deve ser exclusivo na transformação de
destino. Você deve especificar um identificador que siga esta convenção de
nomenclatura: x.y, em que x representa
o nome da extensão de transformação e y representa
o nome da propriedade.
- Especifique valores para
as outras propriedades desta área.
- Clique em .
Resultados
Para cada propriedade criada, um elemento Property é incluído
na hierarquia do elemento TransformationExtension.
Nota: 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.