Como Fazer – Execução de provas no modo WebService

Produto: TOTVS Avaliação e Pesquisa                 Versão: 11.00

Processo: Execução de provas no modo WebService

Subprocesso: Configuração do WebService

 

Como fazer para configurar o modo de execução de provas via WebService?

O modo WebService é uma das formas de executar uma prova, e é feito através do RM Executor.

O RM Executor permite que o usuário execute uma prova disponibilizada através de um serviço web, podendo estar localizado no host local ou remoto.

 

Configurações a serem realizadas no servidor (Máquina servidora)

1. Instale a versão mais atual do TOTVS Avaliação e Pesquisa, para que você tenha acesso ao arquivo RMTestisWS.dll que acompanha o RMTestis.exe, conforme mostra a figura abaixo:

2. Crie uma pasta chamada RMTestisWS no diretório C:\ (ou seja, o diretório da pasta criada será C:\RMTestisWS) para armazenar o arquivo RMTestisWS.dll.
Compartilhe a pasta e dê acesso ao usuário que estará executando a prova na máquina cliente.

3. Copie o arquivo RMTestisWS.dll que está no diretório C:\totvs\Corporerm\RMTestis para dentro de da pasta RMTestisWS criada anteriormente.

4. Acesse o servidor WEB, o IIS (Internet Information Services) no Painel de Controle do Windows conforme as figuras abaixo:

Windows XP

Windows Vista

5. Crie um novo diretório virtual. Para o IIS 6, utilizando o Windows XP:

· Abra Computador local.

· Abra a pasta Sites da Web.

· Selecione o Site da Web Padrão, clicar com o botão direito do mouse, escolher a opção Novo | Diretório Virtual e clicar no botão Avançar.

· Digite na caixa de texto Alias o seguinte: RMTestisWS e clique em Avançar.

· Para preencher a caixa de texto Diretório, clicar no botão Procurar e abrir a pasta criada no passo 2 (C:\RMTestisWS). Clicar em Avançar.

· Na etapa de Permissão de Acesso, marcar as opções de Leitura, Execução de Scripts e Execução de Aplicativos e depois clicar em Avançar.

· Clique em Concluir e feche o IIS.

Veja como fica o ambiente após as configurações:

Para o IIS 7, utilizando o Windows Vista:

· Abra Computador local.

· Abra a pasta Sites da Web.

· Selecione o Site da Web Padrão (ou Default Web Site), clicar com o botão direito do mouse, escolher a opção Adicionar novo diretório virtual.

· Digite na caixa de texto Alias o seguinte: RMTestisWS e selecione o caminho físico do arquivo RMTestisWS.dll
(definido no passo 2).

· Clicar em OK após finalizar.

· Selecionar a opção Mapeamentos de manipulador e logo em seguida a opção Adicionar mapeamento de módulo.

Preencha os campos com as seguintes opções:

o Caminho da solicitação: *.dll

o Módulo: IsapiModule

o Executável: arquivo RMTestisWS.dll localizado no diretório criado no passo 2 (C:\RMTestisWS).

o Nome: RMTestisWS

· Após preencher os campos, na mesma janela selecione a opção Restrições da solicitação e configure as seguintes opções:

o Mapeamento: selecione a caixa Invocar manipulador somente se a ... e marque a opção Arquivo logo em seguida.

o Na aba Acesso, selecione a opção Executar.

o Clique em OK para confirmar as alterações e feche o IIS.

o Após concluir esta etapa, é gerado um arquivo chamado web.config no mesmo local onde foi criado o diretório do passo 2 (C:\RMTestisWS), onde é necessário abrir este arquivo no bloco de notas e adicionar o parâmetro allowPathInfo="true" logo após a opção resourceType=”File”. O conteúdo deve ser semelhante ao exemplo abaixo:

<?xml version="1.0" encoding="UTF-8"?>

<configuration>

<system.webServer>

<directoryBrowse enabled="true" />

<handlers accessPolicy="Read, Execute, Script">

<remove name="CGI-exe" />

<remove name="ISAPI-dll" />

<add name="RMTestisWS" path="*.dll" verb="*" modules="IsapiModule" scriptProcessor="C:\RMTestisWS\RMTestisWS.dll"

resourceType="File" allowPathInfo="true" requireAccess="Execute" />

</handlers>

</system.webServer>

</configuration>

6. Para verificar se a máquina servidora foi configurada corretamente, abra o navegador (por exemplo, Internet Explorer) e digite o endereço onde se encontra o arquivo RMTestisWS.dll, incluindo o nome da máquina.
Exemplo:

http://servidor/RMTestisWS/RMTestisWS.dll/wsdl/IRMTestisWS

Esse endereço deverá ser informado para o usuário que preparará a execução da prova na máquina cliente.

A página deve apresentar o seguinte resultado:

7. No TOTVS Avaliação e Pesquisa criar o arquivo de conexão com o banco de dados no menu Utilitários | Parâmetros Conexão Executor, conforme figura abaixo:

O arquivo deverá estar disponibilizado da seguinte forma:

8. Na pasta C:\RMTestisWS, criar o arquivo RMTestisWS.config. Editar o arquivo criado e informar o caminho do arquivo de conexão criado.

Exemplo:

Na pasta C:\RMTestisWS, selecionar a opção Novo | Documento de texto utilizando o botão direito do mouse.

Renomear o arquivo criado para RMTestisWS.config.

Editar o arquivo e informar o caminho do arquivo de conexão criado.

C:\CorporeRM\RMTestis\ExecConnetion.Con

Salvar a alteração.

Veja como ficará o arquivo RMTestisWS.config:

Configurações a serem realizadas no cliente (Máquina cliente)

1. Abra o RM Executor. (localizado em C:\totvs\CorporeRM\RMTestis\RMExecutor.exe), clique no botão Configuira método de conexão via Internet (Webservice) (ícone ) e digite o endereço da URL, informado no passo 5 da configuração realizada para o servidor.
Exemplo:

http://servidor/RMTestisWS/RMTestisWS.dll/wsdl/IRMTestisWS

Veja:

2. Na caixa de diálogo Inscrição, digite o número da inscrição (gerada pelo TOTVS Avaliação e Pesquisa) do candidato que fará a prova.

3. Clique no botão OK e depois no botão Iniciar para dar início à prova. Siga os passos normais para executar a prova.