RH3 API

Este manual desenvolvido com base na versão 7.5 do IIS e sistema operacional windows 7 apenas para fins explicativos.

Para efetuar a correta configuração do IIS e ISAPI dll, o usuário deverá efetuar os seguintes passos (caso se faça necessário, clique nas imagens para aumenta-las).

Nota: Este guia foi elaborado para ser usado como base tanto nas instalações em máquinas locais como no RH3Cloud.

1. A instalação do IIS deve ter sido efetuada. Seguem abaixo alguns links úteis:
   
   
   • Instalando o IIS 7 no Windows Server 2008 (http://social.technet.microsoft.com/wiki/contents/articles/2417.aspx);
     
     
   • Instalando o IIS 7.5 no Windows 7 Home Premium, Home Basic ou Home Starter (http://technet.microsoft.com/pt-br/library/cc731911.aspx);
     
     
   • Instalando o IIS 7.5 no Windows Server 2008 R2 (http://technet.microsoft.com/pt-br/library/cc771209.aspx).
     
     
2. A porta TCP selecionada (padrão 80) deve estar acessível para a rede onde o portal irá operar e receber conexões.

1. Certifique-se que as opções de “Serviços de Informações da Internet” abaixo, estão selecionadas:
   
   
   
   
   • Painel de controle;
     
     
   • Programas e Recursos;
     
     
   • Ativar ou desativar recursos do Windows.
     
     
     • Ferramentas de Gerenciamento da Web;
       
       
     • Serviços da Word Wide Web.
       
       
2. Na opção de “Ferramenta de Gerenciamento da WEB”, certifique-se que apenas as seguintes opções estão selecionadas:
   
   
   • Console de Gerenciamento do IIS;
     
     
   • Script e Ferramentas de Gerenciamento do IIS;
     
     
   • Serviço de gerenciamento do IIS.
     
     
3. Na opção de “Serviços da Word Wide Web”, certifique-se que apenas as seguintes opções estão selecionadas:
   
   
   • Recursos de Desenvolvimento de Aplicativos;
     
     
   • Recursos HTTP Comuns.
     
     
4. Na opção “Recursos de Desenvolvimento de Aplicativos”, certifique-se que a opção Extensões ISAPI está selecionada;
   
   
5. Na opção “Recursos HTTP Comuns”, certifique-se que as seguintes opções estão selecionadas:
   
   
   • Conteúdo Estático;
     
     
   • Documento Padrão;
     
     
   • Publicação WebDAV;
     
     
   • Redirecionamento de HTTP.
     
     
6. Clicar em “OK” para instalar as opções selecionadas (caso tenha sido necessário alterar alguma configuração);
   
   

1. Abrir a pasta compartilhada do IIS para colocar os arquivos do RH3 API no diretório: “c:\inetpub\wwwroot”;
   
   
   
   
2. Ainda dentro de “c:\inetpub\wwwroot”, criar uma nova pasta para colocar os arquivos do RH3 API. Chamar a pasta de rh3api. O nome desta pasta será o nome utilizado na URL. Exemplo: http://localhost/rh3api/;
   
   
3. O usuário deverá entrar em contato com a RH3 Software, para ter acesso aos arquivos de configuração a serem colocados neste diretório criado;
   
   
4. O diretório deverá conter agora os seguintes arquivos e pastas:
   
   
   • css (pasta);
     
     
   • images (pasta);
     
     
   • js (pasta);
     
     
   • templates (pasta);
     
     
   • RH3APIV2.dll.
     
     

Para que o portal funcione corretamente, é necessário dar permissão de acesso aos diretórios “C:\inetpub\wwwroot\rh3api”. Abaixo segue o passo a passo de como dar acesso a um diretório:

1. Através do Windows Explorer, selecionar a localização do diretório a ser dada a permissão (ex: C:\inetpub\wwwroot);
   
   
2. Com o botão direito do mouse, clique no diretório que deseja dar as permissões (ex: rh3api) e escolha a opção “Propriedades”;
   
   
3. Selecionando o usuário IIS_IUSRS, clique no botão “Avançadas”;
   
   
   
   
4. Clique no botão “Alterar permissões”;
   
   
   
   
5. Clique no botão “editar”, selecione “Controle total” e clique em “OK”;
   
   
   
   
6. Para as próximas telas, clique em “Aplicar”, “OK” e “OK”;
   
   
   
   
7. Volte ao Windows Explorer, selecione novamente o diretório “rh3api”, clique com o botão direito em propriedades e certifique-se que o mesmo está com a seguinte configuração;
   
   
   
   

1. Abrir o gerenciador do IIS para configurar;
   
   
   
   
   • Painel de Controle;
     
     
   • Ferramentas Administrativas;
     
     
   • Gerenciador do Serviços de Informações da Internet (IIS);
     
     
   • Seleciona: Máquina (localizado no item conexões) \ Sites \ Default Web Site \ rh3api.
     
     
2. Para converter a pasta onde estão os arquivos do rh3api para aplicativo;
   
   
   
   
   • Clicar com o botão direito do mouse em “rh3api”;
     
     
   • Converter para Aplicativo;
     
     
   • O alias deverá estar “rh3api”;
     
     
   • Clicar em “OK”.
     
     
3. Defina a dll como documento padrão, ou seja, ao acessar a URL (http://localhost/rh3api/), ele vai buscar a dll;
   
   
   
   
   • Duplo clique em “Documento Padrão”;
     
     
   • Clique com o botão direito do mouse para adicionar o documento padrão;
     
     
   • Clique em “Adicionar”;
     
     
   • No campo “nome” informe “RH3APIV2.dll”;
     
     
   • Clique em “OK”.
     
     
4. Ative o mapeamento para utilizar arquivos dll para execução;
   
   
   
   
   • Clique no nome da máquina para voltar a tela inicial de configuração;
     
     
   • Duplo clique em “Mapeamentos de Manipulador”;
     
     
   • Clique com o botão direito do mouse em ISAPI-dll;
     
     
   • Escolha a opção “Editar permissões de Recursos”;
     
     
   • Marque as opções: Leitura, Script e Executar;
     
     
   • Clique em “OK”.
     
     
5. Você deve dar permissão para que a dll do rh3api possa ser executada;
   
   
   
   
   • Clique no nome da máquina para voltar a tela inicial de configuração;
     
     
   • Duplo clique em “Restrições ISAPI e CGI”;
     
     
   • Clique com o botão direito do mouse em “WebDAV”;
     
     
   • Selecione a opção “Adicionar”;
     
     
   • Em “Caminho ISAPI ou CGI” preencha com: “c:\inetpub\wwwroot\rh3api\RH3APIV2.dll”;
     
     
   • Em “Descrição” preencha com: “rh3api”;
     
     
   • Marque a opção “Permitir que o caminho da extensão seja executado”;
     
     
   • Clique em “OK”.
     
     
6. ATENÇÃO: Quando a máquina for 64 bits, o usuário deverá executar o seguinte:
   
   
   • Para verificar se a máquina é 64 bits:
     
     
     • Clicar no botão iniciar;
       
       
     • Botão direito em “Computador”;
       
       
     • Clicar em “Propriedades”;
       
       
     • Neste ponto, estará exibindo se o sistema operacional é 32 ou 64 bits.
       
       
   • Clique no nome da máquina para voltar a tela inicial de configuração;
     
     
   • Selecionar a opção “Pool de aplicativos”.
     
     
   • Clicar com o botão direito do mouse para criar criar um novo pool de aplicativos para que não fiquem várias aplicações utilizando o mesmo pool (ex: rh3api, portal web,…).
     
     
     
     
   • Criar com o nome rh3api.
     
     
     
     
     
     
   • Clicar em “rh3api”;
     
     
   • Clicar em “Configurações Avançadas”;
     
     
   • Na aba “Geral”, colocar “True” na opção “Habilitar aplicativos de 32 bits”. esta opção só aparecerá se seu sistema operacional for realmente de 64 bits.
     
     
     
     
7. Alterando as credenciais de autenticação do rh3api;
   
   
   • Selecione o rh3api e dê um duplo clique em autenticação;
     
     
     
     
   • Clique com o botão direito do mouse no item “Autenticação anônima” e clique em “Editar”
     
     
     
     
   • Selecione a opção “Identidade do pool de aplicativos” e clique em “OK”.
     
     
     
     
8. Execute a opção “Reiniciar Servidor”;
   
   
9. Acesse a URL (http://localhost/rh3api/) no browser;
   
   
10. O sistema deverá funcionar a partir deste momento.
    
    

Nota: No ambiente de testes, quando for testar uma DLL gerada pela máquina oficial, o usuário deverá colocar localhost (ex: http://localhost/rh3api/RH3APIV2.dll/$/) e quando for testar uma DLL gerada por uma máquina de desenvolvedor, deverá ser com 127.0.0.1 (ex: http://127.0.0.1/rh3api/RH3APIV2.dll/$/). Esta é uma regra imposta pelo próprio componente IntraWeb.

1. Seleciona rh3api e dá um duplo clique em “Filtragem de solicitações”.
   
   
   
   
2. Clique com o botão direito no arquivo e clique em “Editar configurações e recursos”
   
   
   
   
3. Configure a tela conforme imagem abaixo.
   
   
   
   
4. Copiar o arquivo “Config.ini” da pasta “C:\RH3” para “C:\inetpub\wwwroot\rh3api”.
   
   
5. O arquivo “config.ini” deverá ter o conteúdo conforme exemplo abaixo.

[NOMECLIENTE_BI]
schema=
usuario=nomecliente_bi
senha=jRvPjGrNKugQRNC
maxConexoesDB = 5
maxConexoesTrans = 2
maxObjWorkflow = 100
timeoutConexaoDB = 5
timeoutObjWorkflow = 120
tempoEsperaConexaoDB = 5
;debug = W, C