Os elementos da chamada XML contêm o conteúdo da chamada e as informações
de transporte desta chamada. O conteúdo consiste em XML simples transmitido
em um transporte HTTP ou JMS. As informações de transporte referem-se às informações necessárias para enviar,
receber e responder, dependendo do protocolo selecionado.
- Atualizar nome do nó automaticamente
- Quando ativada, essa opção atualiza o nome do elemento de chamada XML no
conteúdo do teste.
- Uma direção
- Essa opção especifica que o servidor não espera nenhuma resposta após
a chamada. Isso desativa o botão Atualizar Retorno.
- Tempo Limite (ms)
- Esse é o valor de tempo limite em milissegundos. Se nenhuma resposta for recebida
depois do tempo especificado, será produzido um erro.
- Tempo de Espera (ms)
- Especifica o tempo de atraso calculado programaticamente que é observado
em cada usuário quando esse teste é executado com vários usuários virtuais. O tempo de espera
é uma emulação estatística do tempo que os usuários reais gastam lendo ou
pensando antes de executar uma ação.
- Atualizar Retorno
- Abre a janela Visualizar Retorno. Nessa janela, a chamada pode ser
feita a partir do ambiente de trabalho para criar ou atualizar o retorno de mensagem que está
associado à chamada.
Mensagem
Essas páginas apresentam o conteúdo
XML da chamada e fornecem acesso para correlação de dados em três formas diferentes.
- Form
- This view provides a simplified view of the message that focuses
on editing the values of the XML content. Use the Schema menu to enable assistance with editing XML content so that the XML
is valid and complies with the XSD specification.
In the Form view, add the XML headers that are required for standard
web service calls. On the Header bar, click Add (
) to create the default
XML header structure for WS-Addressing, WS-ReliableMessaging or WS-Coordination
requests, or click More for other standards.
You can enable or disable XML header elements and specify the correct
values for each XML element. Checks are performed to ensure that the
XML content is valid.
Nota: To add XML headers to calls in IBM® Rational AppScan, add a Static XML Headers algorithm
on the Request Stack tab of the request.
- Tree
This view provides a hierarchical view of the XML structure
of the message, including elements, namespaces, and the associated
values. You can use Add, Insert, Remove, Up, and Down to edit the XML elements and namespaces in the tree.
Click Filter to hide or show namespace,
attribute, or text nodes, depending on your requirements.
Click Allow only valid modifications to enable smart editing,
based on a specified XML schema document (XSD). To specify a set of
XSD documents for the workbench, in the test navigator, right-click
the project and select Properties and Schema Catalog. Disable Allow only valid modifications if you do not have an XSD or if you want to bypass the schema.
You can right-click an XML element to convert it to an XML fragment.
This enables you to perform data correlation (use datapools and create
references) on the entire XML fragment instead of only on the value.
- Source
- This view displays the source XML content of the message or plain
text content.
Importante: In the Source view, do not edit
the tags that start with SoaTag. If you delete or
change these tags, any references and substitutions in the test will
be broken. You cannot recreate these tags after you delete them.
Anexos
Essa página lista os anexos MIME
anexados à chamada. O conteúdo dessa visualização corresponde à especificação Multipurpose Internet Mail Extension (MIME).
Essa página pode ser
utilizada para incluir recursos do ambiente de trabalho como anexos MIME e propriedades de alteração.
O ID de
Conteúdo é o identificador utilizado pela chamada para referir-se aos anexos.
O método de uso desse identificador depende dos requisitos do servidor.
Protocolo
Essa página descreve o protocolo utilizado
para enviar a chamada. O protocolo pode ser HTTP ou JMS (Java™ Message Service),
a cada mensagem.
- HTTP
- Essa página possibilita a substituição de configurações HTTP anexadas
à chamada em uma configuração HTTP local.
- Método
Essa opção possibilita a especificação do método HTTP da chamada XML,
entre a seguinte lista de métodos:
- Versão
Essa opção possibilita a especificação de HTTP 1.0 ou de HTTP 1.1.
- URL
Esse campo possibilita a especificação da URL da chamada XML.
- Cabeçalhos
Essa seção possibilita a inclusão de cabeçalhos na chamada. Os cabeçalhos devem
ser compatíveis com o método HTTP especificado.
O aplicativo gerencia
os seguintes cabeçalhos, os quais não podem ser incluídos:
- Agente Usuário
- Conexão do Host
- Controle de Cache
- Pragma
- Tipo de Conteúdo
- Comprimento do Conteúdo
- Cookies
Essa seção possibilita o gerenciamento de cookies. Você pode incluir, editar e remover
cookies, além de criar referências.
- JMS
Essa página possibilita a inclusão de propriedades de cadeia
que estão anexadas à chamada em uma configuração JMS local. Elas serão
enviadas como propriedades de mensagem por meio do JMS.
- MQ
Essa página possibilita a substituição de configurações anexadas à
chamada em uma configuração WebSphere MQ local.
- Nome
- É o nome que será exibido na chamada de mensagem como um link para essa
configuração de protocolo.
- Nome do gerenciador de filas
- Especifica o nome do gerenciador de filas para o qual você deseja enviar a
chamada.
- Nome da fila
- Especifica o nome da fila gerenciada pelo gerenciador de filas.
- Utilizar gerenciador de filas locais
- Especifica se o servidor WebSphere MQ está sendo executado no computador local. Se o servidor estiver localizado em um computador remoto, desmarque essa opção para especificar
os detalhes do servidor MQ remoto.
- Endereço do gerenciador de filas
- Especifica o endereço IP ou o nome do host do servidor MQ remoto.
- Porta do gerenciador de filas
- Especifica a porta listener do servidor MQ remoto.
- Canal do cliente
- Especifica o canal de modo de conexão do servidor do gerenciador de filas remotas.
- Utilizar fila temporária
- Especifica se o servidor MQ criará uma fila temporária. Se selecionada,
a fila temporária será criada com o propósito exclusivo de receber mensagens
específicas e, em seguida, será excluída.
- Nome da fila
- Se Utilizar fila temporária estiver desmarcada, essa opção
especificará o nome da fila em que os retornos de mensagens do servidor MQ serão
recebidos. O gerenciador de filas especificado em Nome do gerenciador de
filas deve gerenciar essa fila.
Os retornos de chamadas e de mensagens são
associados pelo ID de correlação na mensagem MQ, o que significa que a configuração do
relatório da mensagem é configurado como MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID. O servidor
deve seguir essa restrição. Isso fornece suporte ao transporte de recursos SOAP
fornecidos pelo WebSphere MQ.
- Serviço de destino
- Esta opção é para utilizar o
Microsoft
.NET com o transporte
IBM WebSphere MQ
para o recurso SOAP. Ela especifica o nome do arquivo ASPX no
diretório listener .NET.
- Utilizar o Cabeçalho RFH2
- Especifica se as mensagens SOAP utilizam um cabeçalho RFH2, que utiliza um
formato de mensagem MQ predeterminado. Quando selecionado, outras opções do Descritor de Mensagens
ficam desativadas. Utilize essa opção para o transporte do WebSphere MQ para recursos SOAP. Se você estiver utilizando a ligação WID (WebSphere Integration Developer) MQ,
ela reconhecerá mensagens com ou sem o cabeçalho RFH2.
- Descritor de Mensagens
- Essa seção possibilita a configuração de campos da chamada de mensagem. É possível substituir um subconjunto do descritor de mensagens do MQ por um formato customizado
para ser utilizado com outros tipos de servidores, especificamente ao utilizar uma chamada de mensagem XML. Consulte a documentação do WebSphere MQ
para obter detalhes sobre os descritores de mensagens.
- Utilizar fila temporária
- Essa seção possibilita a especificação de um nome de usuário e de uma senha para autenticação
básica no servidor de aplicativos.
- Conexão SSL
- Selecione essa opção para utilizar uma configuração de SSL se uma configuração Canal
do Cliente referir-se a um canal seguro. Clique em Abrir
Editor de SSL para criar uma nova configuração de SSL ou em Alterar para
alterar a configuração de SSL associada ao teste atual.
Se
o WSDL (Web Services Description Language) utilizado para criar a chamada de
mensagem utilizar um JMS URI suportado para apontar para o servidor WebSphere MQ, a
configuração de SSL será criada automaticamente.
Se o gerador de teste não puder
criar a configuração de SSL, uma nova deverá ser criada manualmente.
Se
o WSDL tiver sido gerado com o serviço WebSphere MQ (amqwdeployWMService),
edite o WSDL para alterar a ligação de transporte de HTTP para JMS para
evitar que o gerador de teste produza uma configuração HTTP.
- Conjunto de criptografia
- Especifique o conjunto de criptografia que será utilizado na configuração do canal.
Segurança XML Local
Essa página permite a inclusão de um
algoritmo de segurança customizado implementado em uma classe Java. Algoritmos customizados podem ser aplicados para o conteúdo XML enviado para e recebido do servidor.
- Incluir, Inserir, Remover, Para Cima e Para Baixo
- Esses botões permitem a criação de uma pilha de algoritmos de segurança.
Cada
algoritmo é aplicado à pilha seqüencialmente. Clique em Incluir para
incluir um algoritmo de segurança customizado.
- Ferramentas
- Esse botão permite a alteração do modo de exibição da pilha de algoritmos.
- Algoritmo de Segurança Customizado
Após a inclusão de um algoritmo de segurança customizado na pilha. Essa janela
possibilita a especificação da classe Java que implementa o algoritmo. A classe Java
utiliza a seguinte interface:
/**
* ***************************************************************
* Confidencial IBM
*
* (c) Copyright IBM Corporation. 2008. Todos os Direitos Reservados.
*
* O código-fonte deste programa não é publicado ou, por outro lado,
* privado de seus segredos comerciais, independentemente do que tenha sido
* consolidado no Copyright Office dos Estados Unidos.
* ***************************************************************
*
*/
package com.ibm.rational.test.lt.models.wscore.datamodel.security.xmlsec;
import java.util.Properties;
import org.w3c.dom.Document;
public interface ICustomSecurityAlgorithm {
/**
* Os seguintes métodos podem ser utilizados nos dois casos:
* Execução no ambiente de trabalho e execução do teste.
*/
/**
* Chamado para processar o Documento enviado por meio de transporte.
* @param subject
*/
void process(Document subject);
/**
* Chamado para cancelar o processo de um documento recebido de um servidor.
* @param subject
*/
void unProcess(Document subject);
/**
* Propriedades definidas na UI do CustomSecurityAlgorithm.
* @param map
*/
void setProperties(Properties map);
/**
* Os métodos a seguir podem ser utilizados apenas com relação a difusão para testar a interface de serviço,
* ou com relação a acesso das informações XML anteriores, quando o jar que contém
* o algoritmo de segurança customizado é implementado no projeto de teste de desempenho. Nesse
* caso, não é possível utilizar o algoritmo diretamente do ambiente de trabalho.
*/
/**
* Esse objeto corresponde ao objeto ITestExecutionService.
* Isso aplica-se apenas a um algoritmo que deva ser vinculado à execução do teste.
* Se você planeja utilizar esse objeto, precisará implementar o jar que contém a
* implementação em seu projeto de teste de desempenho e não diretamente no JRE.
*
* No caso de precisar do documento XML anterior recebido da execução, você poderá
* obter o valor utilizando:
* IDataArea area = ((ITestExecutionService)executionObject).findDataArea(IDataArea.VIRTUALUSER);
*String previousXML = (String) area.get("PREVIOUS_XML"); //$NON-NLS-1$
*
*/
void setExecutionContext(Object executionObject);
- O método process modifica o XML antes de ele ser enviado
ao servidor.
- O método unprocess modifica o XML depois de ele ser recebido
do servidor.
- O método setProperties recupera as propriedades
definidas no editor de segurança dessa interface de segurança customizada.
- O método setExecutionContext é chamado durante o teste
com o objeto ITestExecutionServices correspondente à
mensagem, utilizando essa interface de segurança customizada.
- Nome da Classe de Algoritmo de Segurança Customizado
- Especifica a classe que implementa o algoritmo de segurança.
Clique em Procurar
Classe para selecionar uma classe no espaço de trabalho.
- Nome do Algoritmo
- Especifica um nome para o algoritmo atual.
- Propriedades
- Essa lista especifica as propriedades utilizadas pelo método setProperties
no algoritmo. Utilize Incluir, Remover
ou Editar para criar a lista de propriedades.