Incluindo Páginas em Configurações de Transformação

Você pode criar páginas customizadas para configurações de transformação. Você pode criar essas páginas para que os usuários da transformação possam especificar valores para as propriedades incluídas em uma transformação. Quando um usuário de transformação cria uma configuração de transformação, as novas páginas são exibidas no editor ou no assistente de configuração de transformação.
Antes de Iniciar

Um autor de transformação deve registrar a transformação no serviço de transformação. A transformação deve definir as propriedades associadas às novas guias de configuração.

Como o autor de páginas de configuração de transformação customizadas, você deve identificar um projeto no espaço de trabalho que contenha esses artefatos de interface com o usuário. É possível criar um projeto que contenha o código Java™ que implemente as novas páginas, ou é possível definir as páginas em um projeto existente que contenha uma transformação.
Nota: O exemplo nesse tópico presume que você defina as páginas customizadas em um plug-in diferente da transformação.
Para obter informações adicionais sobre as classes da interface com o usuário listadas nesse tópico, consulte a seção "UI de Transformação" doRational Transformation Developer Guide.
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.
Por Que e Quando Desempenhar Esta Tarefa

Para incluir páginas em uma configuração de transformação:

  1. No projeto que você identificou para conter as páginas customizadas, crie as seguintes classes Java:
    • Uma classe que estende a classe com.ibm.xtools.transform.ui.AbstractTransformGUI
    • Para cada página com a qual você contribui para a configuração de transformação, uma classe que estende a classe com.ibm.xtools.transform.ui.AbstractTransformConfigTab
  2. Alterne para a perspectiva Java: Clique em Janela > Abrir Perspectiva > Java.
  3. Na visualização Package Explorer, dê um clique duplo na classe Java que você criou na etapa 1, que estende a classe com.ibm.xtools.transform.ui.AbstractTransformGUI.
  4. No editor de arquivo Java, especifique o código Java para substituir o método nomeado getConfigurationTabs(ITransformationDescriptor descriptor). Esse método retorna a lista de páginas para exibir no editor de configuração de transformação ou assistente. É possível usar o seguinte fragmento de código como um exemplo:
    public AbstractTransformConfigTab[] getConfigurationTabs(
    			ITransformationDescriptor descriptor) {
    
    		AbstractTransformConfigTab[] superTabs =
    			super.getConfigurationTabs(descriptor);
    		
    		AbstractTransformConfigTab[] myTabs =
    			new AbstractTransformConfigTab[superTabs.length + 1];
    		
    		for (int i = 0; i < superTabs.length; i++) {
    			myTabs[i] = superTabs[i];
    		}
    		
    		myTabs[myTabs.length - 1] = new MyTab(descriptor, "My tab ID", "My tab label");
    		return myTabs;
    	}
  5. Para cada classe que você criou na etapa 1 que estende a classe com.ibm.xtools.transform.ui.AbstractTransformConfigTab, implemente os métodos nomeados populateContext, populateTab, e createContents, como no exemplo a seguir:
    public Control createContents(Composite parent) {
    		Composite contents = new Composite(parent, SWT.None);
    		contents.setLayout(new GridLayout());
    		text = new Text(contents, SWT.None);
    		text.addModifyListener(new ModifyListener() {
    			public void modifyText(ModifyEvent e) {
    				setDirty();
    			}
    		});
    		
    		return contents;
    	}
    
    	public void populateContext(ITransformContext context) {
    		context.setPropertyValue("MyPropertyId", text.getText());
    	}
    
    	public void populateTab(ITransformContext context) {
    		String newText = (String) context.getPropertyValue("MyPropertyId");
    		if (newText == null) {
    			newText = "";
    		}
    
    		text.setText(newText);
    	}
  6. Clique em Arquivo > Salvar; e depois reconstrua o projeto.
  7. Abra a perspectiva Desenvolvimento de Plug-ins: Clique em Janela > Abrir Perspectiva > Outro > Desenvolvimento de Plug-ins.
  8. Na visualização Package Explorer, expanda o nome do projeto que contém a transformação para a qual você está criando as páginas customizadas.
  9. Na pasta META-INF do projeto de transformação, dê um clique duplo no arquivoMANIFEST.MF.
  10. Na página Extensões, na seção Todas as Extensões, clique no elemento Transformação ao qual incluir as páginas customizadas.
  11. Na seção Detalhes do Elemento de Extensão, no campo transformGUI, especifique o identificador de plug-in (ID) e o nome do pacote e classe Java que você criou na etapa 1, que substitui o método getConfigurationTabs(ITransformationDescriptor descriptor). Se a class que estende a classe com.ibm.xtools.transform.ui.AbstractTransformGUI estiver localizada no mesmo plug-in da transformação, não especifique o ID de plug-in. Um parâmetro nomeado transformGUI é incluído no arquivo MANIFEST.MF, como no seguinte exemplo:
    <Transformation
        groupPath="myTrans"
        id="myTrans.transformation"
        name="Transformation"
        sourceModelType="resource"
        targetModelType="resource"
        transformGUI="com.myTransform.ui/com.myTransform.ui.MyGUI"</Transformation>
    </Transformation>
  12. Clique em Arquivo > Salvar.
Resultados
Para testar as páginas customizadas, inicie um ambiente de trabalho de tempo de execução e crie uma configuração de transformação para a transformação.O editor de configuração de transformação e o assistente exibem as páginas que estão na lista que o método getConfigurationTabs retorna.

Feedback