BinFólio onOracle Instalação e atualizações

BinFólio onOracle
Instalação e atualizações
Lisboa, 28 de Novembro de 2012
Av. D. João II, Lote 1.03.2.3 . Parque das Nações
1998-031 Lisboa . Portugal
Tel. +351 213 836 300 . Fax +351 213 836 301
www.novabase.pt
BinFólio on Oracle
Índice
Índice ..................................................................................................................... 2
1.
Objectivos e Âmbito ...................................................................................... 3
2.
Instalação PC Cliente.................................................................................... 4
2.1. Material ......................................................................................................... 4
2.2. Instalação...................................................................................................... 4
3.
Atualização - Componente Visual FoxPro ..................................................... 6
3.1. Portal da Binómio.......................................................................................... 6
3.2. Substituição dos ficheiros.............................................................................. 6
4.
Atualização - Componente Oracle................................................................. 7
4.1.
4.2.
4.3.
4.4.
Recepção de scripts...................................................................................... 7
Importação dos scripts .................................................................................. 7
SQLPLUS ..................................................................................................... 8
PLSQL Developer ou TOAD.......................................................................... 8
Instalação e atualizações
Pág. 2 de 8
BinFólio on Oracle
1. Objectivos e Âmbito
Este documento contém informação sobre como instalar o BinFólio onOracle num
PC cliente e como proceder às actualizações da referida aplicação.
A actualização da aplicação BinFólio onOracle, deve ser feita quer na vertente
Financeira, quer na vertente contabilística.
Para actualizar a aplicação é imprescindível garantir os seguintes pontos:
1. As aplicações Financeiro e Contabilidade não estão a ser utilizadas;
2. A base de dados Oracle não está a ser utilizada;
3. Ter permissões de leitura e escrita aos directórios das aplicações;
4. Ter acesso à base de dados com o utilizador BINFOLIO;
5. Ter acesso à área privada do portal da Binómio;
6. Receber ou ter acesso aos emails de actualização enviados pela Binómio;
7. Ter acesso ao SQLPLUS para ligação à base de dados;
8. Ter uma aplicação que compile os objectos inválidos da base de dados
Oracle.
Garantidos estes pressupostos podemos proceder à actualização da aplicação. A
actualização do BinFólio divide-se em duas partes:
1.
2.
Componente do Visual FoxPro (VFP) – front-end;
Componente da base de dados Oracle – back-end.
Instalação e atualizações
Pág. 3 de 8
BinFólio on Oracle
2. Instalação PC Cliente
2.1. Material

Setup90.zip, bibliotecas do VFPro 9.0 para BinFólio (disponivel em
www.binomio-msi.com na área de suporte/actualizações Oracle)

Software Oracle Cliente (minimo 8.1.7)

BinFolioORA.ini/Financeiro.ini
2.2. Instalação

Instalar o setup90.zip com as opções por omissão;

Instalar ficheiro de parâmetros iniciais, de uma de duas formas:
o
Copiar BinFolioORA.ini para o directório do sistema operativo;
o
Usar financeiro.ini ao lado do financeiro.exe. Não necessita
de usar o BinfolioORA.ini no PC local;

Mapear drive para o servidor dos executáveis, caso assim esteja
indicado nos ficheiros de parâmetros;

Criar atalhos das aplicações na área de trabalho;

Criar ODBC
o
System DSN
o
Driver: Microsoft ODBC for ORACLE
o
DataSourceName: OracleBinfolio (segundo indicado no
ficheiro de parâmetros)
Instalação e atualizações
Pág. 4 de 8
BinFólio on Oracle
o


Service Name : Binfolio
Instalar Cliente ORACLE
o
Instalação Runtime
o
Nome do serviço de rede: Binfolio
o
Protocolo: TCP/IP
o
Nome do Host: nome ou IP da máquina onde está a BD
Oracle
o
Porta: 1521
o
Nome do serviço: Nome da base de dados (tipicamente:
binfolio)
Validar as ligações via SQLPlus e via Excel ou um dos executáveis
Instalação e atualizações
Pág. 5 de 8
BinFólio on Oracle
3. Atualização - Componente Visual FoxPro
3.1. Portal da Binómio
Aceder ao portal em www.binomio-msi.com e fazer o login com o seu
utilizador e respectiva senha. Será automaticamente direccionado para a
área de actualizações.
Deverá descarregar os ficheiros com a data mais recente. Sendo que:
Ficheiro
Descrição
DataFinOra.zip
Financeiro90.zip
Contém os ficheiros com as remote views do VFP.
Financeiro.dbc
Financeiro.dct
Financeiro.dcx
Executável do Financeiro – Gestão de ativos
Contabilidade90.zip
Executável da Contabilidade
Relatorio.txt
Lista de todos os scripts enviados pela Binómio, ordenado por
data crescente
VersaoBinFolio.txt
Indicação da versão do EXE do Financeiro – Gestão de Ativos
3.2. Substituição dos ficheiros
Crie um directório com a data em que é feito o processo de actualização.
Coloque nesse directório os ficheiros descarregados do nosso portal.
Substitua os ficheiros atuais pelos que foram descarregados.
Instalação e atualizações
Pág. 6 de 8
BinFólio on Oracle
4. Atualização - Componente Oracle
4.1. Recepção de scripts
Sempre que é disponibilizada uma actualização do BinFólio OnOracle, a
Binómio envia um e-mail aos clientes informando da sua existência. Este email pode conter ficheiros (scripts em sql) que têm de ser importados para o
ORACLE. Poderão receber 1 ou 2 ficheiros por e-mail, nos seguintes
formatos:
1. aaaammdd_hhmmss_SQLUpdate.sql (estrutura de dados)
2. aaaammdd_hhmmss_Update.sql (procedimentos e funções)
Actualmente estes ficheiros vêm zipados!
Podem optar por, ao receber o e-mail, não efectuar a actualização.
Se optarem por não proceder à Actualização, os scripts, que vão sendo
enviados, têm que ser guardados (numa pasta de Recebidos).
Quando finalmente optarem por efectuar a actualização terão de executar
todos os scripts até então recebidos e que ainda não foram importados para
ORACLE. Para confirmar que recepcionaram todos os scripts enviados por
email pela Binómio, sugerimos a consulta do ficheiro Relatorio.txt, que se
encontra no nosso portal em Suporte\Actualizações Oracle.
Caso verifique que lhe faltam alguns ficheiros poderá puxá-los da nossa
página (também em Suporte\Actualizações Oracle), seguindo o link: Existem
Scripts Oracle disponiveis para os anos xxxx e xxxx.
Após executar os scripts marque-os ou identifique-os como importados!
Em caso de erro na sua execução deverão contactar imediatamente a
Binómio.
4.2. Importação dos scripts
Têm de ser corridos por ordem cronológica (Data e Hora) e sempre o
aaaammdd_hhmmss_SQLUpdate.sql primeiro.
Instalação e atualizações
Pág. 7 de 8
BinFólio on Oracle
Para o fazer aconselhamos o uso da ferramenta oficial da Oracle, o
SQLPLUS.
Em qualquer dos casos é obrigatório, no final da importação dos
scripts, confirmar a existência de objectos inválidos e em caso
afirmativo compilá-los!
4.3. SQLPLUS






Copiar todos os scripts por importar para um DIR (com a data em que está
a fazer a atualização)
Na linha de comando DOS:
o CD DIR dos scripts...
o dir /on /b *Update.sql > todos.sql
Editar o ficheiro todos.sql
o Na 1ª linha: spool output.txt
o Em todos os ficheiros por uma @ antes
o Na última linha:
 EXEC DBMS_UTILITY.compile_schema(‘BINFOLIO’)
 spool off
Na linha de comando DOS:
o CD DIR dos scripts...
o SQLPLUS binfolio/binomio@binfolio
o @todos.sql
o Exit
Examinar o output.txt para ver se há erros.
Compilar os objectos inválidos
4.4. PLSQL Developer ou TOAD
Numa destas ferramentas visuais de gestão de base de dados compile os
objectos inválidos.
Instalação e atualizações
Pág. 8 de 8