| Utilizar uma Configuração de Transformação |
Dependendo da visualização em que você está, conclua uma das seguintes etapas:- Na visualização de navegação, clique com o botão direito do mouse em um arquivo de configuração da transformação ou no arquivo (.tc); em seguida, clique em Transformar e em uma transformação. Quando você aplica uma configuração de transformação, uma instância da transformação é criada e a transformação é executada com as propriedades que a configuração define.
- Na visualização Explorador de Projetos,
clique com o botão direito do mouse em uma transformação; em seguida, clique em Executar Transformação. Na janela Selecionar Configuração, especifique a configuração da transformação a ser executada e clique em OK.
- Se você desejar aplicar uma configuração de transformação a partir do editor de configuração de transformação, vá para a guia Principal e clique em Executar.
|
| Substituir a origem da transformação que está definida em uma configuração da transformação |
Na perspectiva Modelagem, selecione e clique com o botão direito do mouse nos elementos do modelo de origem ou do projeto; em seguida, clique em Transformar, em uma configuração de transformação e em uma transformação. A configuração da transformação não é afetada e a origem especificada na página Origem e Destino do editor de configuração da transformação ou no assistente de Nova Configuração de Transformação não altera. O arquivo de configuração de transformação deve estar no mesmo projeto que os elementos selecionados. Dica: Para executar essa transformação novamente, clique em . A transformação utiliza os mesmos elementos de origem da transformação que você executou.
|
| Executar a transformação da linha de comandos |
Para executar uma transformação de uma linha de comandos, utilize esta sintaxe:eclipse -data workspace-path -application
com.ibm.xtools.transform.core.transformationRunner -transformConfigs
"[-R]transformation-configuration-path1,[-R]transformation-configuration-path2,..."
No parâmetro -transformConfigs, você deve especificar o caminho de espaço de trabalho completo e o nome do arquivo de configuração, não o nome do caminho do sistema de arquivo, de uma ou mais configurações de transformação.
A execução de uma transformação de uma linha de comandos suprime todas as caixas de diálogo que a transformação gera.
Como exemplo, uma configuração de transformação chamada MyConfig.tc está em um projeto denominado MyProject em um espaço de trabalho denominado MyWorkspace. Essa configuração de transformação especifica as informações de configuração de uma transformação denominada MyTransformation, e de uma transformação reversa correspondente chamada MyReverseTransformation.- Para chamar MyTransformation, você pode executar a configuração MyConfig.tc digitando o seguinte texto na linha de comandos:
eclipse -data /MyWorkspace -application com.ibm.xtools.
transform.core.transformationRunner -transformConfigs
"MyProject/MyConfig.tc"
- Para executar a transformação reversa, especifique a opção -R no início do caminho de configuração da transformação, como neste exemplo:
eclipse -data /MyWorkspace -application com.ibm.xtools.
transform.core.transformationRunner -transformConfigs
"-RMyProject/MyConfig.tc"
- Para executar várias transformações, no parâmetro -transformConfigs, especifique uma lista separada por vírgula de configurações de transformação, incluindo o nome do caminho do espaço de trabalho para cada configuração. Você pode executar transformações reversas ou avançadas, como neste exemplo:
eclipse -data /MyWorkspace -application com.ibm.xtools.
transform.core.transformationRunner -transformConfigs
"MyProject/MyConfig.tc, -RMyProject/MyConfig.tc"
|
| Invocar a API de Transformação |
Para executar a transformação como parte de um aplicativo, você pode invocar a API de transformação, como neste exemplo:IFile file = ResourcesPlugin.getWorkspace().getRoot().
getFile(new Path("/MyWorkspace/MyConfig.tc"));
try
{ITransformConfig config = TransformConfigUtil.
loadConfiguration(file);IStatus status = TransformController.
getInstance().execute(config, null, false, null); } catch
(IOException e) { // Não foi possível ler o arquivo de configuração.}
Também é possível carregar uma configuração de transformação especificando uma URL, como neste exemplo: try {
URL url= new URL(platform:/plugin/myPluginID/myConfig.tc);
ITransformConfig config = TransformConfigUtil.loadConfiguration(url);
}
catch (MalformedURLException malURLEx) {
// Trate a exceção.
}
catch (IOException ioEx) {
// Trate a exceção.
Você pode especificar uma URL que utiliza protocolos diferentes, como nestes exemplos: - -platform:/plugin/myPluginID/myConfig.tc
- -http://myServer.myCompany.com/myConfig.tc
- -ftp://myUsername:myPassword@myServer.myCompany.com/myConfig.tc
- -jar:file:c:/myFolder/myJar.jar!/myConfig.tc
- -file:c:/myFolder/myConfig.tc
|
| Executar uma configuração de transformação a partir de um script Ant |
Para executar uma transformação a partir de um script Ant ou arquivo build.xml, dentro das tags <project></project>, crie um elemento target, como neste exemplo:<target name="generate"> <echo>Running transformation
'myProject/myConfig.tc'...</echo> <com.ibm.xtools.
transform.core.runTransformation transformConfig=
"myProject/myConfig.tc" reverse="false"/> </target>
No arquivo build.xml, no elemento project, configure o atributo default igual ao valor especificado para o atributo name no elemento target.
O atributo transformConfig deve especificar um caminho de espaço de trabalho válido.
Para executar a transformação reversa, configure o atributo reverse para true. Importante: A configuração de transformação deve implementar o Design Contract Management Protocol (DCMP) de Modelagem Reconciliada.
Para executar o script Ant, clique com o botão direito do mouse no arquivo build.xml; em seguida, clique em
|