O Manual de Instalação e Conversão tem por objetivo informar os procedimentos para instalação do Controle Patrimonial nas estações de trabalho e configuração das bases de dados Firebird e Oracle, bem como descrever as rotinas de conversão do sistema Ageware para o Controle Patrimonial.
O documento está organizado em dois processos: Instalação e Conversão.
Os roteiros de trabalho apresentam a seqüência de telas que devem ser acessadas, abas e botões que devem ser selecionados ou tarefas a serem realizadas para executar uma determinada atividade ou processo.
O manual foi elaborado de forma simples e objetiva para facilitar a localização das informações.

Orientações para Instalação do Controle Patrimonial

Inclusão do Controle Patrimonial no Apollo

Para inclusão do Controle Patrimonial no Apollo é necessário executar os procedimentos descritos a seguir:

• Solicitar à Linx uma nova chave de liberação onde conste a permissão de uso do Controle Patrimonial;

Nas estações de trabalho onde será utilizado o Controle Patrimonial, é necessário copiar o programa ControlePatrimonial.exe do CD para o diretório da estação onde está o programa Apollo.exe.

Verificação e Inclusão de Período

Nesse momento, é possível verificar se o sistema está funcionando e se o menu do Controle Patrimonial está disponível. É necessário cadastrar o período inicial de implantação.
Para isso, basta abrir o Windows Explorer (Windows) ou Gerenciador de Janelas (Linux), acessar a pasta do Controle Patrimonial e executar o programa ControlePatrimonial.exe com um duplo clique. Em seguida, entrar no sistema com o usuário ADMIN e senha ADMIN, para quem não utilizava o Apollo, ou com o usuário normal, para quem já utiliza o produto. Lembre-se que o usuário deve ter acesso ao menu do Controle Patrimonial. Na seqüência, deve clicar na opção Cadastros/Grupos Contábeis e verificar se já existem alguns grupos cadastrados.
Para incluir o período, basta entrar no menu Controle Patrimonial > Movimentação > Implantação de Bens/Saldos. O sistema solicitará o último dia do mês de implantação e se a conversão é do sistema Ageware. Deve ser informado o último dia do mês calculado no sistema anterior e indicar se é uma conversão do sistema Ageware/Outros.
Exemplo:

• Se no Ageware/Outro Sistema foi feito o cálculo até Dezembro/2006, o dia informado para criar o período de implantação é 31/12/2006.

Entre em contato com o Suporte Nacional, caso não esteja aparecendo algum grupo ou não consiga incluir o período.

Verificação e Inclusão dos Centros de Custo

Execute o sistema Controle Patrimonial e cadastre os centros de custos utilizados na contabilidade. O cadastramento dos centros de custos é pré-requisito para a execução da conversão do sistema Ageware através do programa acpafx, que solicitará as equivalências entre os centros de custos utilizados pela Ageware e pelo Controle Patrimonial.
Para realizar o cadastro, é necessário acessar Controle Patrimonial > Cadastros > Centro de Custos. Em seguida, clicar no botão +. No campo Centro de Custo, informar o código do Centro de Custo e, no item Descrição, a descrição do centro.
Observação:

• O cadastro deve ser realizado com acompanhamento do Contador e observar as informações do Controle Patrimonial Ageware.

Orientações para Conversão de Dados

Conversão

Este processo define as rotinas de conversão do sistema Ageware para o Controle Patrimonial.
O processo de conversão está dividido em duas etapas:

• Conversor COBOL: A concessionária deve executar os conversores no sistema Ageware para gerar o arquivo texto (ageware.txt);
• Conversor Delphi: Deve ser utilizado para verificar o conteúdo do arquivo texto e gerar as informações para as tabelas do Controle Patrimonial no Banco de Dados.

Conversor Cobol

O conversor acpafx gera um arquivo texto com o nome ageware.txt no diretório obj, o mesmo onde será executado o programa.
Ao executar o conversor, aparecerá na tela apenas o início e o final de cada tabela. O conversor solicita as informações da empresa no sistema Ageware e as informações para implantação no Controle Patrimonial, conforme a tela abaixo.

Preenchimento dos campos:

• Grupo Empresarial, Empresa e Filial: Inserir os mesmos dados utilizados para acesso ao sistema Ageware.
• Revenda Apollo: Informar o número da revenda cadastrada no Apollo.
• Data Implantação: Inserir a data inicial e a final do último período encerrado no Ageware.

O arquivo ageware.txt não é substituído pelo programa Conversor. Se o usuário realizar mais de uma conversão (Cobol e Delphi), executando todos os procedimentos, deve renomear ou excluir o arquivo ageware.txt anteriormente gerado, para evitar que as informações da próxima rotina de conversão sejam adicionadas a ele.
O conversor irá acessar as tabelas do sistema Ageware e gerar o arquivo txt com as informações do último período encerrado para implantação no Controle Patrimonial.
Durante o processo de conversão, serão solicitadas, na tela, as equivalências entre os centros de custo do sistema Ageware e do Controle Patrimonial.
O conversor deve ser executado através do prompt de comando, conforme sistema operacional:

Linux

• Logar-se com um usuário que tenha acesso aos diretórios e acessar o diretório obj.

Exemplo:
$ cd /acp/obj ou $cd /acp/acpobj
Depois $ cobrun –F acpafx

Windows/DOS

Abrir uma sessão do DOS, pelo menu Iniciar > Executar e digitar command.com. Em seguida, acessar o diretório obj.
Exemplo:
C:\> cd \acp\obj ou C:\> cd \acp\acpobj
Depois C:\acp\acpobj> xm –F acpafx
Após o término, o arquivo ageware.txt será gerado e deverá ser copiado para uma estação qualquer que tenha acesso ao Controle Patrimonial e ao programa Converte.exe.

Conversor Delphi

Conversor único que realiza a leitura do arquivo texto gerado pelo Conversor Cobol e grava seu conteúdo nas tabelas do Banco de Dados.
Na estação onde foi copiado o arquivo ageware.txt, deve-se acessar a pasta Apollo e executar o programa converte.

Depois de executar o programa, o usuário terá acesso aos seguintes campos:

• Banco de Dados: Existem dois bancos de dados disponíveis: Interbase (para Interbase ou Firebird) ou Oracle. Um deles deve ser selecionado.
• Situação (Aberto / Fechado): O campo determina se a seção do banco está aberta ou fechada. É automático e pode ser alterado com um clique no botão Abrir BD. Se o programa obtiver sucesso, a situação é alterada para Aberto.
• Base de Dados: Nome da base de dados onde os dados são convertidos. Se for Interbase ou Firebird, é o nome do Banco de Dados com o caminho para o arquivo completo. Exemplo: c:\apollo\bd\apollo.gdb. Caso seja Oracle, é o nome da instância criada para o Banco de Dados. Se o arquivo conexao.dat estiver no mesmo diretório, então, tanto o Banco de Dados, quanto a base de dados serão carregados com as informações que constam nesse arquivo, podendo ser alteradas conforme necessário.
• Abrir BD: Depois de informar o Banco de Dados e a base de dados, deve-se clicar no botão Abrir BD. A situação do banco deve ser alterada para Aberto. Caso não ocorra a alteração, alguma informação referente ao Banco de Dados está incorreta e ele não será aberto.
• Diretório Arquivo Texto: Campo que contém o diretório onde está o arquivo texto gerado pelo Conversor Cobol. Obrigatoriamente, deve ser informado com * (barra invertida), no caso de Windows, ou */ (barra normal), no caso de Linux, incluindo a respectiva barra ('\' ou '/') no final da descrição. Exemplo: Windows - C:\acp\acpobj\ ou Linux: /acp/acpobj/
• Nome do Arquivo Texto: Campo onde consta o nome do arquivo texto que foi gerado pelo Conversor Cobol. O default é mrsys21.txt, gerado automaticamente pelo Conversor Cobol. Para o Controle Patrimonial, deverá ser alterado para ageware.txt.
• Empresa: Local onde aparecem as empresas cadastradas na base para conversão, depois que o Banco de Dados estiver aberto. Caso exista mais de uma, é necessário selecionar aquela a que os dados pertencem. É importante lembrar que o campo Empresa não deve ser confundido com a filial. Por isso, deve-se utilizar o seu respectivo código. As filiais (concessionárias) são convertidas automaticamente com a utilização dos conversores.
• Cliente Padrão Conversão: Não informar.
• Carregar: Após o Banco de Dados aparecer como Aberto, deve-se informar o diretório e o nome do arquivo, e clicar no botão Carregar para que o programa inicie os processos com o arquivo texto no Banco de Dados.
• Sair: Botão utilizado para sair do programa.
• Atualiza Numeradores: Botão que acerta os numeradores do sistema, com base nas informações convertidas. Não é necessário clicar nele para a implantação do Controle Patrimonial.
• Entradas: Campo que identifica automaticamente qual o arquivo de entrada do processo, ao iniciar a conversão.
• Saídas: Campo que identifica automaticamente as tabelas de destino, onde os dados são armazenados no Banco de Dados, ao iniciar a conversão.
• Lidos: Local onde pode ser visualizado o número de registros lidos durante o processo.
• Erros: Local onde pode ser visualizado o número de registros com erro durante o processo.

Após finalizar a conversão, é gerado um arquivo texto com o nome de LogConversao.txt, no mesmo diretório do arquivo texto utilizado no processo. Neste log estão descritas as seguintes informações:

• Origem: Arquivo texto de origem da conversão. Exemplo: c:\acp\ageware.txt
• Destino: Tabelas de destino da conversão: Exemplo: AFX_BEM
• Erro: Para cada registro aparece uma linha demonstrando o erro retornado pelo Banco de Dados, que causou a não inclusão do registro na base de dados, além do comando SQL que o programa de conversão tentou executar. Estes erros devem ser analisados um a um pelo usuário, o qual verificará se deve aceitar, ou seja, a informação não é necessária no sistema, ou o dado está realmente com problema. Caso decida aceitar o erro, é necessário observar os registros que dependem daquele que está errado, pois, como se trata de Banco de Dados, o mesmo pode gerar inconsistências de integridade, não permitindo a inclusão de informações que dependam de registro em outra tabela. Caso a solução para corrigi-lo seja refazer o processo, os dados gerados devem ser excluídos da base de dados ou deve-se voltar um backup da base anterior ao processo da conversão. Se o usuário não realizar essa tarefa, novos erros ocorrerão na tentativa de inclusão de registros que já existem na base de dados.

Final Conversão: Demonstra os dados referentes ao número de registros lidos, número de registros com erro e horário de início e finalização da conversão. Exemplo: 3186 Registros Lido(s), 4 erro(s) encontrados. Iniciado às: 13:08:33 Finalizado às: 13:09:41.
Agora, é necessário entrar no sistema e conferir se os dados do sistema Ageware foram convertidos corretamente para o Controle Patrimonial.

Dúvidas

Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Linx DMS Apollo através do telefone +55 (51) 2101-9933 ou através do site help.linx.com.br.