---- Webdbpro ----- Manual de implementação
Index Pag. Introdução 2 PHP em IIS 7 3 Arquitectura 7 ECO SAF-T PT 8 Estrutura das directorias Glossário e licenciamento 12 13 Page 1 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
Introdução O ECO funciona em cima de um servidor PHP (Apache), podendo este ser montado em cima de um IIS, do XAMPP, WAMMP, ou qualquer outro servidor Apache. Neste manual, vamos primeiro mostrar como poderá configurar o IIS para trabalhar com o PHP. Relembramos que outras soluções de instalação de servidores Apache poderão ser mais simples de instalar. Recomendamos, para sistemas operativos Microsoft, o XAMPP. Page 2 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
PHP em IIS 7 O IIS deverá ser instalado com a opção de CGI (que inclui o FastCGI) Page 3 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
Faça download da última versão de PHP para a directoria c:\php. Este download pode ser obtido em http://www.php.net/downloads.php. Certifique-se que está a fazer o download dos Binários Non-thread-safe. Inicialize o IIS manager (consola do IIS do Windows) Crie um script c:\inetpub\wwwroot\hello.php com o seguinte conteúdo: <?php phpinfo();?> Vamos configurar o IIS para informar que as páginas *.php deverão ser tratados pelo FastCGI usando o executável c:\php\php-cgi.exe Page 4 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
Page 5 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
No browser de internet vamos verificar se o IIS já consegue mostrar conteúdos em php. Para isso basta ir ao endereço http://localhost/hello.php Existem outras soluções para podermos correr um site PHP em Windows de forma simples e sem ter o IIS instalado. Consultem de igual modo os seguintes sites para verem algumas das alternativas existentes: http://www.apachefriends.org/en/xampp.html http://www.wampserver.com/en/ Page 6 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
Arquitectura Esquema base Vamos precisar de um servidor para alojar o ECO (servidor PHP) e que tenha acesso via ODBC ao servidor de MSSQL onde se encontram alojadas as bases de dados PHC. Se se pretende ou não optar por soluções de firewall, DMZ (zona desmilitarizada), ou outro qualquer sistema de protecção contra ataques de hackers é critério do implementador, desde que permita aceder aos dados quer do webserver, quer do servidor MSSQL, podendo este ser o mesmo. Page 7 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
ECO SAFT Para colocar o ECO SAFT a funcionar, bastará criar uma directoria com o conteúdo do download do ECO SAFT e entrar no site no seu browser. Os ficheiros XML dos SAFT s, deverão ser copiados para a subdirectoria UPLOAD dentro da directoria do ECO SAFT. Instalação passo a passo Fazer download no site http://www.erpcenteronline.com da versão demo do visualizador de SAFT e descompactar o seu conteúdo para uma directoria dentro do seu IIS (C:/Inetpub/WWWRoot/). no IIS) Estrutura de directorias do ECO SAFT (por exemplo se instalado na directoria SAFT C:/INETPUB/WWWROOT/SAFT /UPLOAD Directoria onde devem ser colocados os ficheiros SAFT (XML). Odbc.php5 Configuração da ligação ODBC para importar dados para uma base de dados MSSQL. Lic.php5 - Ficheiro de licenciamento. Permite desbloquear as restrições da Versão DEMO. No browser colocar o endereço: localhost/saft/índex.php (ligação no computador local), ou o IP_do_IIS/saft/índex.php. Page 8 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
O primeiro ecrã lista os ficheiros XML que se encontram na directoria UPLOAD. Seleccione um ficheiro, e após seleccionar o ficheiro, o nome deste ficheiro irá aparecer na barra do menu do vosso lado esquerdo. No menu, encontram as várias opções de navegação do ficheiro SAFT. Na visualização dos documentos de facturação, os registos que aparecem sombreados a cinza correspondem a facturas anuladas. Caso tenham um código de licenciamento válido, aparece a possibilidade de estabelecer a ligação ODBC a uma base de dados MS SQL. Ao estabelecer esta ligação, serão criados automaticamente as tabelas ECO_SAFT_INVOICE_HEADER e ECO_SAFT_INVOICE_LINES. Serão estas as tabelas que vão receber os dados dos ficheiros XML. Page 9 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
Um site por empresa (ECO Gestão) Deverá ser criado um endereço específico por base de dados. A directoria ECO deverá ser replicada com nomes diferentes dentro da directoria raiz do nosso webserver (que no caso do IIS é C:/inetpub/wwwroot). Neste caso temos vários sites dentro no nosso localhost (http://localhost/4dbpro, http://localhost/temp, http://localhost/php, http://localhost/webdbpro,...) Agora percisamos de configurar as ligações ODBC entre o servidor web e as bases de dados PHC. Por cada base de dados PHC deverá ser configurada uma ligação ODBC em System DSN (32 Bits obrigatoriamente), especificando qual a base de dados que iremos ligar. Este ponto é muito importante para que todas as chamadas aos dados sejam para a base de dados pretendida. Page 10 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
Dos passos da criação ODBC apenas saliento as imagens mais importantes; a selecção do System DNS e o ecran de escolha da base de dados por defeito que obrigatoriamente deverá estar direccionada para a base de dados pretendida. Qualquer ligação ODBC deverá ter a base de dados por defeito seleccionada. Com esta arquitectura, por base de dados PHC, temos uma tabela chamada «databases» que fará o auto-registo da sua ligação ODBC. Page 11 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
Estrutura de directorias Ficheiros importantes ECO: Root /Pdf /Stimages Lic.php5 Odbc.php5 Topccemail.htm Bottomccemail.htm bopdf.php [st.ref].jpg Ficheiro de licenciamento Configuração ODBC à base de dados Cabeçalho de mailing de contas correntes Rodapé de mailing de contas correntes Configuração base de impressão de dossier interno (Open source) Deverão ser colocados as imagens em formato JPG com o nome da referência Page 12 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m
Glossário e Licenciamento A nossa directoria PHP para IIS Demo do ECO SAFT http://www.erpcenteronline.com/downloads/php.zip http://www.erpcenteronline.com/saftpt.zip O licenciamento é controlado pelo ficheiro LIC.PHP5 que se encontra nas respectivas pastas de instalação de cada site. Para obter o seu licenciamento, contacte um distribuidor oficial ERP Center Online, ou em alternativa entre em contacto connosco, e teremos imenso prazer em indicar-lhe um. Desenvolvimentos específicos são sempre possíveis de serem implementados e estamos abertos para apresentar orçamentos para os mesmos. NOTA: O ECO SAFT tem os seguintes limites: - Na sua versão DEMO, a apresentação de resultados está restrita a 50 registos por cada tipo de tabela. - Na versão DEMO, não é possível passar os dados do ficheiro XML para tabelas numa base de dados MSSQL. - O tamanho máximo do ficheiro XML é de 80MB. Page 13 h t t p : / / w w w. e r p c e n t e r o n l i n e. c o m