Detalhes da Chamada XML

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 (Add button) 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:
  • POST
  • GET
  • PUT
  • DELETE
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.

Feedback