Você pode definir assistentes para gravadores e clientes.
O assistente de Nova Sessão de Gravação é executado na seguinte sequência:
- O arquivo de sessão de gravação é selecionado.
- O cliente é selecionado.
- O método de gravação é selecionado.
- As páginas do assistente do cliente são exibidas.
- As páginas do assistente de gravador são exibidas.
As etapas 4 e 5 podem ser combinadas em uma única etapa. As etapas 4 e 5 são contribuições de extensão.
Declare um assistente para cada cliente e cada gravador definidos.
Um cliente ou um gravador que não possua um assistente declarado não é disponibilizado na interface com o usuário e pode ser iniciado usando apenas um arquivo de configuração de gravação ou programaticamente.
Quando o assistente de Nova Sessão de Gravação é concluído, ele produz uma configuração da sessão de gravação que contém uma configuração de cliente e uma ou mais configurações de gravadores. A configuração da sessão de gravação é usada para iniciar uma sessão de gravação e para instanciar os gravadores e clientes correspondentes.
Vários tipos de assistentes podem ser definidos, dependendo de como você definiu os gravadores e clientes:
- Se você definiu apenas um gravador e planeja usar um cliente fornecido com o produto, defina um assistente de gravador.
- Se você definiu um ou mais tipos de clientes e um ou mais tipos de gravadores e quiser combinar clientes e gravadores de várias formas, defina um assistente para cada cliente e um assistente para cada gravador.
- Se você definiu um tipo de gravador e um tipo de cliente para serem usados juntos, considere definir um único assistente que configure ambos.
Informações adicionais sobre o assistente de Nova Sessão de Gravação:
- A etapa de seleção do método de gravação será exibida apenas se houver mais de um método de gravação disponível para o cliente selecionado na etapa 2.
- Assistentes que configuram gravadores e clientes têm precedência sobre assistentes separados para clientes e gravadores.
Para definir um assistente de cliente:
- Declare um novo assistente de cliente no arquivo plugin.xml usando o ponto de extensão com.ibm.rational.test.lt.recorder.ui.clientWizard.
- Especifique o ID do cliente que o assistente de cliente configura.
- Opcionalmente, forneça uma classe de implementação. Se não for fornecida
uma classe, o assistente não possui uma página de configuração. Se você fornecer uma classe, deverá estender a classe com.ibm.rational.test.lt.recorder.ui.wizards.NewClientWizard.
Sobre as implementações da classe NewClientWizard:
- Esta classe estende o assistente de classe JFace, para que a classe precise estender métodos típicos, como addPages().
- A classe é transmitida em uma configuração de cliente vazia, com o ID de cliente selecionado pelo usuário na etapa 2.
- A classe configura as opções de configuração do cliente, que estão disponíveis usando o método getClientConfiguration(). Essa configuração geralmente é feita no método doPerformFinish().
Para definir um assistente de gravador:
- Declare um novo assistente de gravador no arquivo plugin.xml usando o ponto de extensão com.ibm.rational.test.lt.recorder.ui.recorderClientWizard e o elemento recordersWizard.
- Especifique um ou mais IDs de gravadores que o assistente de gravador configurará.
Se o assistente de gravador declarar as configurações de mais de um gravador, examine o atributo performsRecorderSelection. Esse atributo especifica se o assistente permitirá que o usuário escolha quais gravadores serão usados ou se a estrutura escolherá qual gravador usar. Dependendo das condições, o atributo chamará o assistente com o ID de gravador que o usuário selecionou.
No primeiro caso, a etapa de seleção do método de gravação sempre será exibida, embora no último caso a etapa de seleção do método de gravação possa ser ignorada. No primeiro caso, o assistente pode ativar vários gravadores, embora no último caso apenas um gravador seja ativado. Escolha a primeira opção se você precisar ativar mais de um gravador em uma sessão de gravação.
- Forneça uma classe de implementação. Isso será opcional apenas se você tiver associado o assistente com exatamente um gravador ou se o atributo performsRecorderSelection for false. Se não for fornecida
uma classe, o assistente não possui uma página de configuração. Se você fornecer uma classe, deverá estender a classe com.ibm.rational.test.lt.recorder.ui.wizards.NewRecordersWizard.
Sobre as implementações de NewRecordersWizard:
- Esta classe estende o Assistente de classe de JFace, portanto, ela deve estender
métodos típicos, como addPages().
- Se o valor performsRecorderSelection for true, a classe será transmitida como nula para seu método initialize() e deverá chamar o método setRecorderConfigurations() de seu método doPerformFinish(), com as configurações de gravador para cada gravador que precisar ser incluído na sessão de gravação.
- Se o valor performsRecorderSelection for false, a classe será transmitida como uma configuração de gravador vazia, com o ID de gravador selecionado na etapa 3, para seu método initialize() e deverá preencher a configuração de gravador vazia com as opções de gravador em seu método doPerformFinish().
Para definir um assistente que configure um cliente e um ou mais gravadores juntos:
- Declare um novo assistente de gravador e cliente no arquivo plugin.xml usando o ponto de extensão com.ibm.rational.test.lt.recorder.ui.recorderClientWizard e o elemento combinedWizard.
- Especifique o ID do cliente que esse assistente configura.
- Especifique um ou mais IDs de gravadores que esse assistente configura.
- Se esse assistente declarar configurações para mais de um gravador, examine o atributo performsRecorderSelection.
Esse atributo especifica se o assistente permitirá que o usuário escolha quais gravadores serão usados ou se a estrutura escolherá qual gravador usar e, em seguida, chama o assistente com o ID de gravador selecionado pelo usuário.
No primeiro caso, a etapa de seleção do método de gravação sempre será exibida, embora no último caso a etapa de seleção do método de gravação possa ser ignorada. No primeiro caso, o assistente pode ativar vários gravadores, embora no último caso apenas um gravador seja ativado. Escolha a primeira opção se você precisar ativar mais de um gravador em uma sessão de gravação.
- Forneça uma classe de implementação. Isso será opcional apenas se você tiver associado o assistente com exatamente um gravador ou se o atributo performsRecorderSelection for false. Se não for fornecida
uma classe, o assistente não possui uma página de configuração. Se você fornecer uma classe, deverá estender a classe com.ibm.rational.test.lt.recorder.ui.wizards.NewRecorderClientWizard.
Sobre implementações da classe NewRecorderClientWizard:
- Esta classe estende o Assistente de classe de JFace, portanto, ela deve estender
métodos típicos, como addPages().
- Se performsRecorderSelection for true, a classe será transmitida como uma configuração de gravador nula para seu método initialize() e deverá chamar o método setRecorderConfigurations() de seu método doPerformFinish(), com as configurações de gravador para cada gravador que deve ser incluído na sessão de gravação.
- Se performsRecorderSelection for false, a classe será transmitida como uma configuração de gravador vazia, com o ID de gravador selecionado na etapa 3, para seu método initialize() e deverá atender à configuração de gravador vazia com operações de gravador em seu método doPerformFinish().
- A classe é transmitida em uma configuração de cliente, com o ID de cliente selecionado na etapa 2, para seu método initialize(). Ela deve preencher a configuração do cliente com as opções de cliente em seu método doPerformFinish().