configurar webservice nas versões 10.70, 10.80 e 11.00

Upload: pierre-brandao

Post on 01-Mar-2018

218 views

Category:

Documents


0 download

TRANSCRIPT

  • 7/25/2019 Configurar Webservice nas verses 10.70, 10.80 e 11.00

    1/7

    Configurar Webservicea partir da verso 11.20 e 11.40

    O modo WebService uma das formas de se executar uma prova, atravs do Executor de Avaliaes ePesquisa.

    Este modo permite ao usurio executar uma prova disponibilizada atravs de um servio web, podendoestar localizado no computador local ou algum outro remoto.

    Configuraes a serem realizadas no servidor (Windows XP)

    Para configurar o Webservice em um servidor, devem ser realizados os seguintes passos:

    1 - Compartilhar a pasta Webservice, localizada em C:\totvs\CorporeRM\RMTestis, com osusurios que iro acessar o servidor para executar as provas.

    2 - Acesse o IIS(Internet Information Services) do Windowsatravs do caminho Iniciar > Todosos programas > Ferramentas administrativas > Internet Information Services.

    3 - Crie um novo diretrio virtual. Para isso:

    a - Abra Computador local.

    b - Abra a pasta Sites da Web.

    c - Selecione o Site da Web Padro, clicar com o boto direito do mouse, escolher a opo Novo >Diretrio Virtual e clicar no boto Avanar.

    d - Digite na caixa de texto Aliaso seguinte: Webservicee clique em Avanar.

    e - Para preencher a caixa de texto Diretrio, clicar no boto Procurar e abrir a pastaC:\totvs\CorporeRM\RMTestis\Webservice. Clicar em Avanar.

    f - Na etapa de Permisso de Acesso, marcar as opes de Leitura, Execuo de Scriptse

    Execuo de Aplicativose depois clicar em Avanar.

    g - Clique em Concluire feche o IIS.

    4 - Para verificar se o servidor foi configurado corretamente, abra o navegador (por exemplo, InternetExplorer) e digite o endereo onde se encontra o arquivo TstExecWebService.asmx.

    Exemplo

    http://localhost/Webservice/TstExecWebService.asmx, onde localhost o nome do servidor eWebservice o nome da pasta do Webservice.

    Configuraes a serem realizadas no servidor (Windows Vista)

    Para configurar o Webservice em um servidor, devem ser realizados os seguintes passos:1 - Compartilhar a pasta Webservice, localizada em C:\totvs\CorporeRM\RMTestis, com osusurios que iro acessar o servidor para executar as provas.

    2 - Acesse o IIS (Gerenciador do Servios de Informaes da Internet)do Windows atravs docaminho Iniciar > Todos os programas > Ferramentas administrativas > Gerenciador doServios de Informaes da Internet.

    3 - Crie um novo diretrio virtual. Para isso:a - Abra Computador local.

    b - Abra pasta Sites da Web.

    c - Selecione o Site da Web Padro (ou Default Web Site), clicar com o boto direito do mouse,

    escolher a opo Adicionar aplicativo.

  • 7/25/2019 Configurar Webservice nas verses 10.70, 10.80 e 11.00

    2/7

    d - Digite na caixa de texto Aliaso nome do servio (Exemplo Webservice) e selecione o caminhofsico C:\totvs\CorporeRM\RMTestis\Webservice.

    e - Clique em OKpara confirmar as alteraes e feche o IIS.

    4 - Para verificar se o servidor foi configurado corretamente, abra o browser (por exemplo, Internet

    Explorer) e digite o endereo onde se encontra o arquivo TstExecWebService.asmx.Exemplo

    http://localhost/Webservice/TstExecWebService.asmx, onde localhost o nome do servidor eWebservice o nome da pasta do Webservice.

    Configuraes do arquivo Web.config

    Aps realizadas as configuraes anteriores, preciso configurar o arquivo Web.config, localizado napasta C:\totvs\CorporeRM\RMTestis\ Webservice.

    Para isso, voc dever substituir o valor do Aliasde acordo com as configuraes de seu arquivoAlias.dat.

    Portanto, preciso:

    1 - Editar o arquivo Alias.dat, no caminho C:\totvs\CorporeRM\RM.Net.

    2 - Copiar o valor do elemento Alias, que est em negrito no exemplo a seguir:

    Corporerm ExemploSqlServerSqlClientServidorBasesysdbamasterkeyfalse

    true3true10false20false20false20

    3 - Editar o arquivo Web.config, no caminho C:\totvs\CorporeRM\RMTestis\Webservice.

    4 - Colar o valor copiado no passo 2, no local que est em negrito conforme o exemplo a seguir:

    ...

    ...

  • 7/25/2019 Configurar Webservice nas verses 10.70, 10.80 e 11.00

    3/7

    Ateno

    Para utilizar a comunicao em Wcf, preciso realizar as seguintes alteraes:

    1 - Abrir, com um editor de textos, os arquivos RM.Host.exe.config e RM.Host.Service.exe.config,localizados no diretrio C:\totvs\Corporerm\RM.Net,e adicionar as seguintes tags:

    2 - Alterar o valor do parmetro CommunicationStyle de Remoting para Wcf.

    O contedo dos arquivos dever ficar dessa forma:

    ...

    ...3 - No arquivo Web.config, localizado no diretrio C:\totvs\Corporerm\RMTestis\WebService\Alterar o valor do parmetro CommunicationStyle de Remotingpara Wcf.

    O contedo ficar da seguinte forma:

    ...

    ...

    Observao importante:Os arquivos Web.configdo WebService e RM.Host.exe.config/RM.Host.Service.exe.config devem possuir as mesmas tags de configurao.

  • 7/25/2019 Configurar Webservice nas verses 10.70, 10.80 e 11.00

    4/7

    Configurar Webservicenas verses 10.70, 10.80 e 11.00

    Passo 1:

    Instale a verso mais atual do TOTVS Avaliao e Pesquisa, para que voc tenha acesso aoarquivo RMTESTISWS.DLL que acompanha o RMTESTIS.EXE.

    Passo 2:

    Crie uma pasta (C:\RMTestisWS) para armazenar o arquivo do TOTVS Avaliao e Pesquisa(RMTESTISWS.DLL).

    Ateno!: No se esquea de compartilhar a pasta e dar acesso ao usurio que estar executando aprova na mquina Cliente.

    Passo 3:

    Copie o arquivo RMTESTISWS.DLL que est na C:\CORPORERM\RMTESTIS para dentro de dapasta RMTestisWS criada anteriormente.

    Passo 4:

    Acesse o servidor WEB, o IIS (Internet Information Services) no Painel de Controle do Windows e

    crie um diretrio Virtual, para isso:

    Para o IIS 6:

    Abra computador local

    Abra a pasta Sites da Web.

    Selecione o Site da Web Padro, clicar com o boto direito do mouse, escolher a opo Novo |Diretrio Virtual e clicar no boto Avanar.

    Digite na caixa de texto Alias: RMTestisWS e clique em Avanar.

    Para preencher a caixa de texto Diretrio, clicar no boto Procurar e abrir a pasta criada nopasso 2 (RMTestisWS). Clicar em Avanar.

    Na etapa de Permisso de Acesso, marcar as opes de Leitura, Execuo de Scripts eExecuo de Aplicativos e depois clicar em Avanar.

    Clique em Concluir e feche o IIS.

    Para o IIS 7:

    Abra computador local

    Abra a pasta Sites da Web.

    Selecione o Site da Web Padro, clicar com o boto direito do mouse, escolher a opoAdicionar aplicativo.

  • 7/25/2019 Configurar Webservice nas verses 10.70, 10.80 e 11.00

    5/7

    Digite na caixa de texto Alias: RMTestisWS e selecione o caminho fsico do arquivoRMTESTISWS.DLL (Definido no passo 2).

    Em pool de aplicativos, selecione a opo referente ao .Net Framework 2.0 (geralmente definidacomo ASP.NET v2.0). Caso esta opo esteja disponvel, v para a prxima etapa. Casocontrrio, ser necessrio adicion-la. Para isto, cancele a criao do aplicativo e volte naprimeira opo da configurao do IIS7 assim que adicionar o pool de aplicativo, conforme ser

    descrito logo abaixo:o Selecione Pool de aplicativo logo abaixo do nome do servidor (em conexes, a

    esquerda do gerenciador do IIS).

    o Selecione a opo Adicionar pool de aplicativos.

    o Defina o nome ASP.NET 2.0.

    o Na caixa Verso do .Net Framework, selecione .Net Framework v2.0.50727.

    o Em Modo de pipeline gerenciado, seleciona a opo Integrado.

    o Clique em ok.

    o Se o servidor for um Sistema Operacional de 64 bits, ser necessrio habilitar estepool de aplicativos para rodar aplicaes 32 bits. Para isto, selecione o pool deaplicativos que voc acabou de criar (ASP.NET v2.0), clique em Configuraes

    avanadas e habilite a opo Habilitar aplicaes 32bits para true.o Confirme as alteraes e volte para o incio da criao do aplicativo (etapa Abra

    computador local).

    Selecionar a opo Mapeamentos de manipulador e logo em seguinda a opo Adicionarmapemanto de mdulo. Preencha os campos com as seguintes opes:

    o Caminho da solicitao: *.dll

    o Mdulo: IsapiModule

    o Executvel: Arquivo RMTESTISWS.DLL localizado no diretrio criado no passo 2.

    o Nome: RMTestisWS

    Aps preencher os campos, na mesma janela selecione a opo Restries da solicitaoeconfigure as seguintes opes:

    o Mapeamento: Selecione o checkbox Invocar manipulador somente se a ... emarque a opo Arquivo logo em seguida.

    o Na aba Acesso, selecione a opo Executar.

    o Clique em OK para confirmar as alteraes e feche o IIS.

    o Aps concluir esta etapa, gerado um arquivo chamado web.config no mesmolocal onde foi criado o diretrio do passo 2, onde necessrio abrir este arquivono bloco de notas e adicionar o seguinte parmetro logo aps a oporesourceType=File: allowPathInfo="true". O contedo deve sersemelhante ao exemplo abaixo:

    Exemplo do arquivo web.config:

    Passo 5:

    Para verificar se a mquina SERVIDORA foi configurada corretamente, abra o navegador (porexemplo, o Internet Explorer) e digite o endereo onde se encontra o arquivo RMTESTISWS.DLL,incluindo o nome da mquina.

  • 7/25/2019 Configurar Webservice nas verses 10.70, 10.80 e 11.00

    6/7

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

    Passo 6:

    O endereo utilizado para executar uma prova atravs do webservice o endereo localizado noWSDL. Dando seqncia ao passo anterior, clique no WSDL, copie o endereo que se encontra na barrade endereo e informe para o usurio que estar preparando a execuo da prova na MQUINACLIENTE.

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

    Passo 7:

    No RM Testis criar o arquivo de conexo com o banco de dados no menu Utilitrios | ParmetrosConexo Executor.

    Passo 8:

    Na pasta C:\RMTestisWS, criar o arquivo RMTestisWS.Config. Editar o arquivo criado e informaro caminho do arquivo de conexo criado.

    o Exemplo: Na pasta C:\RMTestisWS, selecionar a opo Novo/Documento de texto

    utilizando o boto direito do mouse. Renomear o arquivo criado para RMTestisWS.Config. Editar o arquivo e informar o caminho do arquivo de conexo criado. C:\CorporeRM\RMTestis\ExecConnetion.Con Salvar a alterao.

    Configuraes a serem efetuadas na(s) Mquinas em que ser(o) realizada(s) a(s) prova(s)(MQUINA CLIENTE):

    Passo 1:

    Caso ainda no esteja instalado, instalar a ltima verso do RM Executor.

    Passo 2:

    Abra o RM Executor. (C:\totvs\CorporeRM\RMTestis\RMExecutor.exe), clique no botoConfiguira mtodo de conexo via Internet (Webservice) e digite o endereo da URL doWSDL.

    Exemplo:

    http://servidor/rmtestisws/wsdl/IRMTestisWS

    Passo 3:

    Na caixa de dilogo Inscrio, digite o nmero da inscrio (gerada pelo RM Testis) do candidato quefar a prova.

    Passo 4:

    Clique no boto OK e depois no boto Iniciar para dar incio a prova. Siga os passos normais paraexecutar a prova.

  • 7/25/2019 Configurar Webservice nas verses 10.70, 10.80 e 11.00

    7/7

    Erros conhecidos

    1. Erro 500.0:Este erro ocorreu em um servidor com sistema operacional de 64bits com IISverso 7 ou superior. Ser necessrio modificar o pool de aplicativos para habilit-lo a rodaraplicaes 32bits. Acesse o IIS, remova o diretrio virtual e configure o mesmo novamente deacordo com as orientaes do passo 4.

    2. Erro: Unable to load WSDL File/Location:http://localhost/RMTestisWS/RMTestisWS.dll/wsdl/IRMTestisWS. Error [End tag 'head' does notmatch the start tag 'META'.

    a. Este erro tambm ocorre com o IIS verso 7 ou superior. Acesso o local onde est aDLL RMTestisWS.dll, abra o arquivo web.config e verifique se ele possui oparmetros allowPathInfo="true" na tag RMTestisWS. Caso exista este parmetro emesmo assim o erro continue, remova o diretrio virtual e configure o mesmonovamente de acordo com as orientaes do passo 4.