Criando Propriedades em Extensões de Transformação

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:

  1. 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 Nova > Propriedade.
  2. 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.
  3. Clique em Arquivo > Salvar.
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.

Feedback