Integração BO

PLANO DE EXPANSÃO DA IMPLANTAÇÃO DO

INTEGRAÇÃO BO NOS ESTADOS

AMBIENTES DE HOMOLOGAÇÃO
E PRODUÇÃO

Tutorial para a utilização do SoapUI

versão 1.0
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

HISTÓRICO DE VERSÕES

Data Versão Descrição

Tutorial para a utilização do SoapUI para a execução do teste de envio de

30/09/2016 1.0
BO do Estado para o ambiente de homologação do Sinesp Integração BO.

Página 2 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

Sumário
1 Objetivo............................................................................................................4
2 Obter uma versão do SoapUI............................................................................4
3 Instalar o SoapUI..............................................................................................6
4 Importar o projeto para o SoapUI...................................................................11
5 Executar o projeto SoapUI..............................................................................14
5.1 Executar o envio mínimo de BO...........................................................14
5.2 Executar o envio válido de BO.............................................................17
6 Considerações Finais......................................................................................20

Página 3 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

1 Objetivo

Apresentar, resumidamente, tutorial para a utilização da ferramenta SoapUI que

apoiará os testes do Plano de Expansão da Implantação do Integração BO nos Estados nos
ambientes de homologação.
Neste tutorial a versão utilizada para demonstração é para o sistema operacional
Microsoft Windows. O Serpro esclarece que a ferramenta SoapUI é desenvolvida por fornecedor
externo e, portanto, o Serpro não pode oferecer suporte técnico nem se responsabilizar pelo uso
indevido da ferramenta.
Mais informações podem ser obtidas, diretamente, na página do fornecedor na
internet https://www.soapui.org/.

2 Obter uma versão do SoapUI

2.1. Buscar a página do fornecedor do SoapUI na internet resulta na imagem abaixo.

2.2. A imagem abaixo ilustra o resultado da busca do item anterior (2.1). Escolha
Download SoapUI.

Página 4 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

2.3. Escolha a opção Downloads para obter a versão mais recente, de acordo com o
sistema operacional utilizado.

2.4. SoapUI está disponível para as versões de sistema operacional ilustradas abaixo.

Página 5 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

3 Instalar o SoapUI

Os procedimentos descritos na seção 2 ilustraram as ações necessárias para a

obtenção da versão do SoapUI para o seu sistema operacional. A seção 3 apresenta as etapas da
instalação, neste exemplo, no sistema operacional Microsoft Windows.

3.1. A imagem a seguir exibe a primeira tela do instalador do SoapUI versão 5.2.1.

3.2. Se concordar com os termos da licença do SoapUI, selecione aceite e continue com a
instalação.

Página 6 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

3.3. A seguir será apresentado o diretório para a instalação do SoapUI. Em nosso exemplo, não
efetuamos nenhuma modificação.

3.4. A próxima tela permite escolher quais componentes devem ser escolhidos.

Página 7 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

3.5. Em seguida, é possível escolher o local de destino dos tutoriais da ferramenta. Novamente,
em nosso exemplo, não efetuamos nenhuma modificação.

3.6. A tela a seguir permite você escolher pela criação ou não de atalhos e menu para posterior
localização e execução da ferramenta após instalação.

Página 8 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

3.7. A próxima tela é a última tela disponível antes de a instalação iniciar. Caso queira revisar as
opções selecionadas, está é a última oportunidade. Nesta etapa é possível escolher pela criação
ou não de ícone na área de trabalho.

3.8. Neste momento a instalação está em execução. Aguarde até que ela seja concluída, ou opte
por cancelar.

Página 9 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

3.9. A tela abaixo ilustra que a instalação foi concluída com sucesso. Clique em Finish para fechar
a janela de instalação e executar a ferramenta SoapUI, caso a opção Run SoapUI 5.2.1 esteja
marcada.

3.10. A tela a seguir pergunta se você quer permitir o envio de estatística anonimamente. Em
nosso exemplo, optamos por Não enviar. O envio de estatística pode ser habilitado ou não
posteriormente.

Página 10 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

4 Importar o projeto para o SoapUI

4.1. A tela a seguir pergunta se você quer receber inúmeros avisos, dentre os quais, informação
de atualizações. Em nosso exemplo optamos por não, clicando na opção Skip.

4.2. Ao iniciar o SoapUI, note que na lateral esquerda da tela lê-se Navigator, onde os projetos
são listados. Não há nenhum projeto disponível para execução.

O que faremos aqui é importar o projeto para a simulação no ambiente de homologação. Para
tanto, escolha a opção Import.

Página 11 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

4.3. Após escolher a opção Import, uma nova janela aparecerá solicitando o arquivo do projeto a
ser importado. Navegue até o local onde o projeto foi salvo e clique em Abrir.

Em nosso exemplo, o arquivo do projeto é o “ws-homintegracaobo-<uf>-soapui-project.xml”,

onde UF representa o Estado que está executando o projeto de expansão do Integração BO.

4.4. Após importar o projeto, note que ele aparecerá na lateral esquerda da janela onde lê-se
Navigator.

Clique no ícone + (sinal de adição) para expandir a árvore onde lê-se

IntegracaoBOSoapBinding.

Página 12 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

4.5. O resultado da expansão da árvore do projeto descrito no item anterior (4.4) é o apresentado
na imagem abaixo.

Para podermos executar a simulação do envio do BO será necessário expandir a árvore

enviarBO. Para isto, clique, no sinal de adição (+).

Página 13 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

5 Executar o projeto SoapUI

5.1 Executar o envio mínimo de BO

5.1.1. Após expandir a árvore enviarBO serão visualizados dois itens, ex-lote-bo-minimo e ex-
lote-bo-valido, que fazem parte do escopo do teste de envio de BO.

Primeiramente, faremos o teste com o envio mínimo de dados. Para tal, clicar duas vezes sobre
ex-lote-bo-minimo fará aparecerá a janela visualizada na lateral direita.

Para executá-lo clique no botão Play (em cor verde).

Os dados (entre as tags) disponíveis no projeto SoapUI de simulação estão

ATENÇÃO protegidos pela assinatura do certificado digital de homologação, conforme tag

específica (assinatura). Portanto, nenhum dado deve ser alterado sob pena de
anular todo o projeto e impedir a execução do teste.

Página 14 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

5.1.2. Após executar o primeiro teste (ex-lote-bo-minimo), descrito no item anterior (5.1.1), uma
nova janela será exibida à direita.

Note que aparecerá a mensagem “Lote recebido com sucesso”.

Anote o número do lote para a fase de consulta e levantamento de evidências, etapa obrigatória
do teste.

Página 15 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

5.1.3. No Integração BO, é possível consultar o lote enviado.

Página 16 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

5.2 Executar o envio válido de BO

5.2.1. De forma idêntica ao descrito na seção 5.1. Executar o envio mínimo de BO, devemos,
novamente, expandir a árvore enviarBO para visualizar os dois itens, ex-lote-bo-minimo e ex-
lote-bo-valido, que fazem parte do escopo do teste de envio de BO.

Neste momento, faremos o teste do envio válido (maior quantidade de dados). Para tal, clicar
duas vezes sobre ex-lote-bo-valido fará aparecerá a janela visualizada na lateral direita.

Para executá-lo clique no botão Play (em cor verde).

Os dados (entre as tags) disponíveis no projeto SoapUI de simulação estão

ATENÇÃO protegidos pela assinatura do certificado digital de homologação, conforme tag

específica (assinatura). Portanto, nenhum dado deve ser alterado sob pena de
anular todo o projeto e impedir a execução do teste.

Página 17 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

5.2.2. Após a execução do ex-lote-bo-valido, descrito no item anterior (5.2.1), uma nova janela
será exibida à direita.

Note que aparecerá a mensagem “Lote recebido com sucesso”.

Anote o número do lote para a fase de consulta e levantamento de evidências, etapa obrigatória
do teste.

Página 18 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

5.2.3. No Integração BO, é possível consultar o lote enviado.

Página 19 de 20
 Plano de Expansão – Integração BO
Tutorial para a utilização do SoapUI – versão 1.0

6 Considerações Finais

O Desenvolvimento do SERPRO optou por criar e disponibilizar o

pacote para o teste no ambiente de homologação com o objetivo de facilitar o teste de
envio de BO do Integração BO durante o plano de expansão.

Conforme já mencionado nas seções anteriores, o artefato

disponibilizado - “Projeto SoapUI” - ao Estado não deve ser alterado em hipótese alguma,
posto que os dados para o teste estão assinados com certificado digital.

Durante a execução do teste, a ferramenta apresentará como

resultado de saída o número do lote. Esta servirá de evidência do êxito do teste. O Estado
deve capturar (PrintScreen) esta saída e disponibilizar ao SERPRO para fins de
comprovação junto ao Ministério da Justiça do êxito do teste.

Assim, a saída apresentada na ferramenta SoapUI e a tela de

consulta de log de Boletim de Ocorrência no Integração BO devem ser armazenadas
como evidência do êxito do teste.

Página 20 de 20