Executando a Amostra ISO8583

Esta amostra fornece dois métodos de teste alternativos:

Ambas as abordagens fornecem dois testes (um para os dados que fluem em cada direção) e também pressupõem que a Configuração Padrão tenha sido criada. Instruções são fornecidas na documentação do WebSphere Message Broker para Criar a Configuração Padrão.

Usando a Visualização de Teste TCPIP

Comece executando as seguintes etapas manuais:

  1. Esta amostra fornece uma Visualização de Teste TCPIP para o WebSphere Message Broker Toolkit. Para instalar esse plug-in, no Toolkit, selecione a opção de menu Ajuda -> Instalar Novo Software. Será solicitado que você selecione um local de instalação. Use o botão Incluir para Incluir um Repositório Local e especifique no diálogo pop-up o projeto TCPIP_Tester_Update local que foi colocado em sua área de trabalho ao instalar a amostra. Supondo que sua área de trabalho esteja em C:\workspace, o diálogo será semelhante a este:

    Install_Test_View1

  2. Clique em OK e será retornado para o assistente de instalação. Selecione o recurso:

    Install_Test_View2

  3. Clique em Avançar e a página Detalhes da Instalação será exibida:

    Install_Test_View3

  4. Clique em Concluir. Poderá ser solicitado que você reinicie o Toolkit, mas na maioria dos casos isso não deve ser necessário (selecione Aplicar Mudanças Agora).
  5. Para verificar se o plug-in foi instalado corretamente, selecione a opção de menu Janela -> Mostrar Visualização -> Outros e, no diálogo pop-up, escolha TCPIP, conforme mostrado abaixo:

    Show_View

  6. Se a visualização não estiver disponível, reinicie o Toolkit usando a opção -clean.
  7. Implemente o aplicativo de amostra ISO8583Application.
  8. Caso você já tenha testado usando ISO8583TestApplication, certifique-se de haver excluído esse aplicativo do Grupo de Execução antes de continuar. Você não deve tentar conectar a Visualização de Teste TCPIP ao soquete também!
  9. Agora você está pronto para executar a amostra.

Testar ISO8583 para XML

  1. Se ainda não tiver feito isso, ative a Visualização de Teste TCPIP no menu Janela -> Mostrar Visualização. Por padrão, a propriedade Nome do host (que especifica o nome do host ou o endereço IP da instalação do Message Broker em que o ISO8583Application foi implementado) é preenchida com o valor localhost. Por padrão, a propriedade Porta (que especifica a porta usada pelos fluxos de mensagens ISO8583_TCPIP_to_WMQ e ISO8583_WMQ_to_TCPIP) é preenchida com o valor 111. Você pode alterar esses valores se desejar, mas eles devem corresponder às propriedades dos fluxos de mensagens implementados.
  2. Clique no botão Procurar e navegue até o arquivo de dados de teste Test_ISO8583_to_XML.txt. Este arquivo de teste está localizado no ISO8583Application, que a amostra importa na área de trabalho do Toolkit.
  3. Clique no botão Conectar TCPIP. A janela do console na base da Visualização de Teste TCPIP deve relatar que a conexão com o fluxo de mensagens foi estabelecida com êxito:
    2012/07/05 13:02:17  Conexão de TCPIP: Uma conexão de soquete foi criada para hospedar o host local, número da porta 1111
    Você deve ver que os campos Nome do host e Porta foram desativados. Eles permanecerão assim até que a conexão seja encerrada mais tarde.
  4. Clique no botão Enviar TCPIP. A Visualização de Teste deve enviar os dados do arquivo nomeado para o soquete em que o fluxo de mensagens está recebendo. A janela do console na base da Visualização de Teste TCPIP deve relatar que os dados foram enviados com êxito:
    2012/07/05 13:02:33  Envio de TCPIP: Dados de saída gravados para o soquete foram obtidos do arquivo C:\workspace\ISO8583TestApplication\Test_ISO8583_to_XML.txt
    2012/07/05 13:02:33  Envio de TCPIP:  <DATA SHOWN HERE>
  5. Clique no botão Desconectar TCPIP. Observe que a configuração do fluxo de mensagens de amostra é tal que ele não tentará ler os dados até que o soquete tenha sido encerrado. A janela do console na base da Visualização de Teste TCPIP deve relatar que a conexão foi encerrada com êxito:
    2012/07/05 13:02:43  Desconexão de TCPIP: A conexão de soquete para hospedar o host local, número da porta 1111, foi encerrada.
  6. Use a ferramenta do cliente de teste WebSphere Message Broker Toolkit para ler a mensagem de saída correspondente que deve estar no formato XML da fila de saída denominada ISO8583.OUT. Abra o arquivo de teste de fluxo ISO8583_TCPIP_to_WMQ_Dequeue.mbtest, que está localizado no projeto ISO8583Application. Clique no botão Obter Mensagem. A mensagem de saída esperada da fila de saída (ISO8583.OUT) deve estar no formato XML e é mostrada na seção Mensagens de Saída Esperadas.

A imagem abaixo mostra o console Visualização de Teste TCPIP ao testar ISO8583 para XML:

TCPIPTestViewSend

Testar XML para ISO8583

  1. Ative a Visualização de Teste TCPIP. Por padrão, a propriedade Nome do host (que especifica o nome do host ou o endereço IP da instalação do Message Broker em que o ISO8583Application foi implementado) é preenchida com o valor localhost. Por padrão, a propriedade Porta (que especifica a porta usada pelos fluxos de mensagens ISO8583_TCPIP_to_WMQ e ISO8583_WMQ_to_TCPIP) é preenchida com o valor 111. Você pode alterar esses valores se desejar, mas eles devem corresponder às propriedades dos fluxos de mensagens implementados.
  2. Clique no botão Conectar TCPIP. A janela do console na base da Visualização de Teste TCPIP deve relatar que a conexão com o fluxo de mensagens foi estabelecida com êxito:
    2012/07/05 13:12:02  Conexão de TCPIP: Uma conexão de soquete foi criada para hospedar o host local, número de porta 1111
    Você deve ver que os campos Nome do host e Porta foram desativados. Eles permanecerão assim até que a conexão seja encerrada mais tarde.
  3. Uma mensagem de entrada XML de exemplo é fornecida no arquivo Test_XML_to_ISO8583.txt. Este arquivo de teste está localizado no ISO8583Application, que a amostra importa na área de trabalho do Toolkit. Use a ferramenta do cliente de teste WebSphere Message Broker Toolkit para gravar esta mensagem na fila de entrada do fluxo de mensagem ISO8583_WMQ_to_TCPIP, que é denominado ISO8583.IN. Abra o arquivo de teste do fluxo ISO8583_WMQ_to_TCPIP_Enqueue.mbtest que está localizado no projeto ISO8583Application. Clique no botão Inserir Mensagem.
  4. Volte para a Visualização de Teste TCPIP e clique no botão Receber TCPIP. A Visualização de Teste deve receber os dados do soquete para o qual eles foram enviados pelo fluxo de mensagens. A janela do console na base da Visualização de Teste TCPIP deve relatar que os dados foram recebidos com êxito:
    2012/07/05 13:12:22  Recebimento de TCPIP: Dados de entrada foram lidos do soquete: <DATA SHOWN HERE>
  5. O formato da mensagem de saída esperado é mostrado na seção Mensagens de Saída Esperadas
  6. Clique no botão Desconectar TCPIP. A janela do console na base da Visualização de Teste TCPIP deve relatar que a conexão foi encerrada com êxito:
    2012/07/05 13:12:25  Desconexão de TCPIP: A conexão do soquete para hospedar o host local, número de porta 1111, foi encerrada.

A imagem abaixo mostra o console Visualização de Teste TCPIP ao testar XML para ISO8583:

TCPIPTestViewReceive

Usando o ISO8583TestApplication

Se você importou e implementou a amostra usando o link em ISO8583 Visão Geral da Amostra, as filas MQ requeridas terão sido criadas para você e ISO8583Application terá sido implementado. Como alternativa, se você não tiver feito isso e apenas importou os projetos em sua área de trabalho, crie as filas (ISO8583.IN, ISO8583.OUT, ISO8583.TESTER.IN, ISO8583.TESTER.OUT) e implemente ISO8583Application manualmente agora.

Este método de teste também exige que você implemente manualmente o aplicativo de teste ISO8583TestApplication. Faça isso agora. O aplicativo de teste contém um fluxo de mensagens muito simples que media dados entre mensagens e conexões de soquete TCPIP:

ISO8583TestTool

Testar ISO8583 para XML

  1. Inicie o cliente de teste integrado do WebSphere Message Broker Toolkit abrindo o arquivo de teste de fluxo SendTCPIP_with_ISO8583TestTool.mbtest que está localizado no projeto ISO8583TestApplication. Esse teste é configurado para ler os dados de exemplo ISO8583 do arquivo denominado Test_ISO8583_to_XML.txt (no projeto ISO8583Application) e gravá-lo na fila de entrada (ISO8583.TESTER.IN) do fluxo de teste. Clique no botão Enviar Mensagem no cliente de teste para inserir a mensagem na fila.
  2. O fluxo de mensagens ISO8583TestTool simplesmente lerá a mensagem e a enviará para o soquete TCPIP de entrada do fluxo de mensagens principal ISO8583_TCPIP_to_WMQ. O fluxo de mensagens ISO8583_TCPIP_to_WMQ analisará a mensagem ISO8583 usando o modelo DFDL fornecido, removerá PrimaryBitmap e SecondaryBitmap (que não são necessários na mensagem de saída XML) e transformará os dados como uma mensagem XML de saída, que é gravada para a fila de saída ISO8583.OUT. Leia esta mensagem de saída correspondente usando a ferramenta cliente de teste do Message Broker Toolkit. Abra o arquivo de teste de fluxo ISO8583_TCPIP_to_WMQ_Dequeue.mbtest que está localizado no projeto ISO8583Application. Clique no botão Obter Mensagem. A mensagem de saída esperada da fila de saída (ISO8583.OUT) deve estar no formato XML e é mostrada na seção Mensagens de Saída Esperadas.

Testar XML para ISO8583

  1. Inicie o cliente de teste integrado do WebSphere Message Broker Toolkit abrindo o arquivo de teste de fluxo ISO8583_WMQ_to_TCPIP_Enqueue.mbtest que está localizado no projeto ISO8583Application. Esse teste é configurado para ler os dados de exemplo XML do arquivo denominado Test_XML_to_ISO8583.txt (no projeto ISO8583Application) e gravá-lo na fila de entrada (ISO8583.IN) do fluxo principal. Clique no botão Enviar Mensagem no cliente de teste para inserir a mensagem na fila.
  2. O fluxo de mensagens ISO8583_WMQ_to_TCPIP analisará o XML, analisará os campos que ele contém e criará PrimaryBitmap e SecondaryBitmap de acordo. O fluxo enviará então a mensagem com formato ISO8583 para o soquete de saída, que será recebido pelo fluxo de teste ISO8583TestTool. Esses dados serão gravados na fila de saída ISO8583.TESTER.OUT. Leia esta mensagem de saída usando a ferramenta cliente de teste do Message Broker Toolkit. Abra o arquivo de teste do fluxo ReceiveTCPIP_with_ISO8583TestTool.mbtest que está localizada no projeto ISO8583TestApplication. Clique no botão Obter Mensagem. A mensagem de saída esperada da fila de saída (ISO8583.TESTER.OUT) deve estar no formato ISO8583 e é mostrada na seção Mensagens de Saída Esperadas.

Voltar para o Início da Amostra