Guia de implantação do Trucker

• Configurando o Master Control Object

1. Na área de trabalho (Desktop) do Application Server está localizado o ícone CoreBuilder Config. Dê um duplo clique sobre o ícone, aguarde a tela ser carregada, clique no Menu Arquivo e depois em Master Control Object.
2. Após ter selecionado a opção Master Control Object aparecerá à seguinte tela:

3. Nesta tela está (ão) configurado(s) o(s) Servidor (es) que estão trabalhando em Load Balance. Caso existam mais servidores de aplicação (além do atual), clique no botão Incluir, informe em Servidor o nome ou endereço IP do Servidor e em Nome do objeto informe MCO, clique no botão Grava e após feche a tela.

1. Clique novamente no Menu Arquivo.
2. Clique depois em Application Data, para incluirmos uma nova Aplicação, ou até mesmo alterar as parametrizações já existentes.

Por default, sempre que efetuamos uma nova instalação do CoreBuilder, uma licença de uso é fornecida, para um único usuário, já definido como: usuário: core, senha: builder. Os demais dados da licença constam nesta tela. Para configurar estes dados para o novo cliente, é necessário solicitar junto a NewAge a licença para este cliente, o que será feito através do envio de um arquivo chamado ‘APP.SER’. Este arquivo deve ser substituído na pasta (por default): ‘C:\CoreBuilder\ApplicationServer\Server\app.ser’.

* O conteúdo destes 4 campos formam a combinação da ‘senha das licenças’. Não podem ser alterados (diferentes do registrado no arquivo APP.SER).

Clique no menu Arquivo novamente, e depois em Application Data, selecione a respectiva base que deseja configurar e clique no botão Base de Dados, após de clicar neste botão, será apresentada a tela ConnectionString, onde configuraremos a string de conexão com o respectivo Database Server.

Segue alguns exemplos de configurações

• [ORACLE] : ConnString=OCI=<end server>;UID=<user dba>;PWD=<pwd dba>;DTB=<name database>;owner=<owner>
• [MSSQLServer - 2000] : ConnString = Driver={SQL Server};Server=< end server>;Database=<database>;uid=<user>;pwd=<pwd>;
• [MYSQL]: ConnString=MySQL=<end server>;UID=<user>;PWD=<pwd>;DTB=<database>
• Onde:
• OCI ou End Server= Endereço do servidor de banco de dados;
• UID= Usuário que se conecta no banco de dados com privilégios de dba;
• PWD= Password deste usuário;
• DTB= Nome do Database;
• OWNER= Owner que desejamos nos conectar;

Por default, o ‘ConectionString’ já está configurado para o acesso ao BD ‘SQL Server’, Database ‘CoreBuilder’. Por padrão, a única alteração necessária é a do nome do Database para o correspondente da aplicação. Ex: ‘Trucker’, ‘OpenFrota’, etc.

Após realizarmos a configuração clique no botão “OK” da tela ConnectionString. Após, clique no botão Grava da tela Application Data.

Clique no Menu Arquivo novamente, e depois em IP Port Range, clique no botão “Incluir”, informe em “Porta de Entrada no Balance” a porta 3350 e em “Porta de Saída para o BAS” a porta 8000, grave e feche a tela.

Esclarecemos que estas informações são padronizadas e não podem ser alteradas.

Clique no Menu Arquivo, depois selecione a opção Transaction Master Control Object, informe o(s) servidor (es) que responderam ao Transaction Server. O Nome do Objeto sempre será MCO e o TimeOut por default é 30. Após realizar a configuração o botão “Grava” deverá ser pressionado.

Esta opção não precisa ser configurada caso exista um único servidor de aplicação.

A comunicação do Client CoreBuilder com o CoreBuilder Application Server, como vemos abaixo é realizada pelo protocolo TCP/IP, mas precisamente nas portas 3350 e 4081 IN/OUT Bound. Na porta 4081 trafega o HTTP Server interno do CoreBuilder Application Server, a faixa da banda utilizada é de no máximo 2,4 Kbps por sessão de usuário ativo.

Para o acesso externo à aplicação, faz necessário parametrizar no Firewall o roteamento entre o Servidor de Comunicação (Externo) e o Servidor do CoreBuilder Application Server (Interno).

Ex: Toda solicitação que chegar ao IP Externo na porta 3350 é redirecionado para o Servidor CoreBuilder Application Server porta 3350 e toda solicitação que sair do Servidor CoreBuilder Application Server porta 4081 seja redirecionada para o Firewall porta 4081.

Na comunicação entre o Client e o Server poderá sim existir um Firewall, mas desde que as portas de comunicação acima mencionadas estejam liberadas, como também vale lembrá-los que nessas portas não poderá ter nenhum tipo de parametrização de “timeout”.

O Client e o Server comunicam-se através de um Thread, nesta comunicação o client envia as informações digitadas, telas, etc em pequenos pacotes criptografados ao Server.

Além de enviar as informações, o client e Server ficam transferindo pequenos pacotes. Essa troca de informação é exclusivamente para checar se o Server ainda reconhece se o client está on-line e vice-versa. Caso ocorra uma queda do client e antes do Server derrubar a sessão no servidor, realiza aproximadamente 12 (doze) tentativas de conexão com o client, após não obtendo sucesso o Server derruba a sessão aberta no Servidor, liberando licença, Rollback, etc.

Através do Serviço ‘CoreBuilder Integration Service’, é possível consumir/alimentar um WebServer com o Corebuilder.

Para a execução dos serviços do CoreBuilder Intergration Service, necessitamos que esteja também instalado o Java Development 1.6.0, o qual é instalado automaticamente com o CoreBuilder Application Server.

Além disto, é necessário instalar o ‘Serviço Internet Information Services (IIS)’ e efetuar todas as parametrizações necessárias conforme o ‘Manual de Instalação do NewAge Application Server’ em T:\OpenCore\Documentação\Manuais\Manuais NewAge.

Sempre que houver uma atualização de clients CoreBuilder, é preciso fazer a substituição do arquivo na pasta específica.

• Atualizar Client Java: Copie o arquivo ‘client.jar ‘ da pasta ‘\Clients\Ultima atualizacao’ do CD de instalação para a pasta ‘..\ApplicationServer\Server’ do servidor.
• Atualizar Client DotNet: Copie o arquivo ‘clientNet.jar ‘ da pasta ‘\Clients\Ultima atualizacao’ do CD de instalação para a pasta ‘..\ApplicationServer\Server’ do servidor.
• Atualizar Client Ajax: Copie o arquivo ‘client.war ‘ da pasta ‘\Clients\Ultima atualizacao’ do CD de instalação para a pasta ‘C:\Arquivos de programas\Apache Software Foundation\Tomcat 6.0\webapps’ do servidor.

Também é possível que o arquivo CoreVM.exe sofra atualização específica. Quando houver, copie o arquivo ‘CoreVM.exe’ da pasta ‘CoreVM\Ultima Atualização’ do CD de instalação para a pasta ‘..\ApplicationServer\MCO’ do servidor.

Atualize a pasta de Imagens do CoreBuilder Application Server copiando o conteúdo da pasta ‘\Bitmaps’ do CD de instalação para a pasta ‘..\Bitmaps’ do servidor.

Atualize a pasta de Imagens do Client Ajax copiando o conteúdo da pasta ‘\Imagens Ajax’ do CD de instalação para a pasta ‘C:\Arquivos de programas\Apache Software Foundation\Tomcat 6.0\webapps\client\images’ do servidor.

Atualize a pasta de Imagens de bancos copiando a pasta ‘img_bancos’ do CD de instalação para a pasta ‘C:\Arquivos de programas\Apache Software Foundation\Tomcat 6.0\webapps\ROOT’ do servidor.

Em estações de trabalho de usuários desenvolvedores, podemos instalar também o client DotNet, atualmente o único com recurso de edição de telas, ferramenta design. Para instalar, execute o arquivo que se encontra na pasta específica no CD de instalação.

Efetuada a instalação, também será criado um atalho na área de trabalho da estação. Execute o client indicando o ‘Endereço IP’ do servidor e o ‘ID do cliente’ definido no ‘Application Data’.

O client Ajax não requer instalação, uma vez que é executado a partir do navegador Web. Para executar o client é necessário apenas que o arquivo client.war encontre-se na pasta ‘C:\Arquivos de programas\Apache Software Foundation\Tomcat 6.0\webapps’.

Para acessar o Application Server pelo client Ajax, digite no prompt do navegador: ‘http://localhost:8080/client/app’ se você estiver no servidor. Em outras estações, substitua ‘localhost’ pelo endereço IP do servidor.

O primeiro passo é efetuar a liberação das unidades que poderão utilizar o Trucker e os módulos que poderão ser acessados. Acesse Configurações > Ferramentas > Gerador do Arquivo INI.

Marque os módulos liberados e informe o CNPJ das Unidades de Negócio que utilizarão o sistema, conforme contrato comercial firmado com o cliente.

Em seguida, selecione a opção ‘Gerar INI’. Sem esta definição, não será possível cadastrar as Unidades de Negócio e não será liberado o acesso aos módulos na Árvore de Menu para os usuários comuns. Lembrando que as configurações do INI não interferem no acesso ao sistema por parte do usuário com status de Desenvolvedor.

Todas as tabelas com conteúdo estático (pertence a template), já estão populadas na nova base instalada. Porém, algumas tabelas não estáticas que possuem registros de sistema ou sugestões básicas de cadastro, devem ser populadas através da opção: Configurações > Ferramentas > Banco de Dados > Popular Tabelas não Estáticas. Selecione todas as tabelas disponíveis em seguida a opção ‘Popular’.

As triggers são responsáveis pela gravação de logs de acessos as opções do sistema e inclusão, alteração ou exclusão de dados. Para geração dos logs, selecione a opção ‘gerar triggers em: Configurações > Ferramentas > Banco de Dados > Gerer Trigguers para Tabelas.

Após gerar o Arquivo INI, efetue a gravação do Cadastro da Unidade Matriz com os dados básicos. Este cadastro será necessário para efetuar a gravação de outros cadastros, como por exemplo, a seqüência de documentos por unidade. Efetue o cadastro em: Cadastro > Empresas > Unidades de Negócio.

Se houverem outras unidades, o usuário Administrador deve ser orientado a efetuar o cadastro das mesmas.

No Manual de Implantação de cada um dos módulos do Trucker, temos a indicação de quais documentos precisam ter a seqüência cadastrada. É possível, contudo, que antes da implantação efetiva dos módulos, o cliente deseje efetuar alguns cadastros básicos, como cadastro de clientes/fornecedores e cadastro de tabelas de preço. Para efetuar os mesmos é preciso ter a seqüência destes documentos cadastrada (aliás, os únicos cadastros que precisam de seqüência, os demais possuem número seqüencial independente do cadastro).

Para efetuar o castro de seqüência acesse: Configurações > Seqüência de Documentos > Seqüência.

No Manual de Implantação de cada um dos módulos do Trucker, temos a indicação de quais preferências precisam de definição. De forma geral, é importante verificar a condição default das preferências, lembrando que as mesmas podem ser definidas por usuário.

1. Quando a impressora está conectada em LPT1 à estação da qual se pretende imprimir, nenhuma configuração faz-se necessária. É o cenário mais simples.

2. Quando a impressora está conectada em porta USB na estação da qual se pretende imprimir, deve-se configurar o client/impressora como se fosse uma impressão em rede (isto por dificuldades em enviar direto para a porta USB), conforme o próximo item.

Quando a impressora está conectada em outra estação da rede, siga os seguintes passos:

1. Identificar o nome do computador onde a impressora está instalada. No ícone "Meu Computador" desta estação, clicar com o botão direito do mouse, e na aba Nome do computador, copiar o nome completo deste.

2. Identificar o nome do compartilhamento da impressora. Acesse Iniciar > Configurações > Impressoras..., localizar a impressora desejada, com o botão direito do mouse, escolher a opção "Propriedades" na aba "Compartilhamento" marcar a opção "Compartilhamento da Impressora", e copiar o nome deste compartilhamento.

3. Cadastrar a impressora no Trucker. Em Configurações > Impressoras > Impressoras da Rede. Inclua uma nova impressora, observando que a Descrição (nome da impressora) deverá ter o nome idêntico do compartilhamento da impressora. O campo "Observação" pode ser qualquer expressão que auxilie o usuário a identificar a impressora e o campo "Unidade" deverá ser preenchido obrigatoriamente.

4. Atribuir a impressora ao usuário que irá utilizá-la em Configurações > Impressoras > Impressoras por Usuário. É possível atribuir mais de uma impressora por usuário. Quando isto ocorrer, ao imprimir, será solicitado que o usuário selecione a impressora que deseja enviar a impressão.

5. Configurar o client da estação que irá enviar a impressão em rede. No menu Ferramentas (corebuilder), selecione a opção ‘Preferências’ e ‘Printer Options’. Na janela ‘Printer Configurations’, o campo "Printer Name" deverá ser preenchido com o nome idêntico do compartilhamento da impressora e do cadastro de impressoras da rede. O campo "Description" deverá ser preenchido com pelo menos um espaço em branco, e no campo "Command" deverá ser preenchido com o comando 'copy $file \\nome_computador_impressora\nome_compartilhamento_impressora. Por último clicar no botão ‘Save the Configurations’.

Para configurar mais de uma impressora, basta preencher os campos com os dados da nova impressora.

Uma mensagem de erro comum quando há problemas com a configuração de impressão é: “ERRO: Não foi possível encontrar o arquivo OUTPRINT.TXT”.

Para tentar solucionar problemas com a impressão, proceda com os seguintes testes:

• Verifique se é possível imprimir a partir do Windows (imprima uma página de teste) na estação onde a impressora está instalada.
• No prompt do DOS (CMD), tente imprimir o conteúdo de um arquivo texto qualquer utilizando o seguinte comando: copy arquivo_texto.txt \\nome_computador_impressora\nome_compartilhamento_impressora
• Se estes testes forem executados com êxito, não há problemas com a impressora, a rede ou o compartilhamento. O problema está na configuração do Client Trucker.

Para cadastrar um usuário acesse: Configuração > Controle de Acesso > Usuários. Selecione a opção ‘novo’, conforme a imagem abaixo:

• Nome Login: nome que o usuário usará para entrar no sistema. Geralmente, primeiro nome.
• Assinatura: utilizado na gravação da versão dos componentes. Específico para usuários administrador.
• Definir perfil de atalho para desktop: Recurso utilizado para facilitar o acesso do usuário a algumas opções do menu, previamente definidas.
• Trocar senha no próximo Login: Marque esta opção quando incluir um novo usuário. Em seguida selecione a opção ‘definir senha’. O sistema irá gerar uma senha automática para o primeiro login do usuário. Quando este logar-se, será solicitado a nova senha do usuário.
• Administrador: Opção que define o status de ‘administrador’.
• Unidades: Selecione nesta opção quais Unidades de Negócio o usuário poderá acessar. Nesta opção, é possível selecionar qual é a ‘Unidade Ativa’ deste usuário, que proporcionará o acesso automático do usuário nesta unidade sempre que logar-se.
• Turnos: Restrição de acesso ao sistema pelo turno (horário) definido.

Toda instalação do Trucker deve considerar o cadastro de pelo menos um usuário administrador. O status de Administrador dará direito de acesso ao usuário a opções no sistema restritas a usuários comuns, como exemplo, as opções do próprio Controle de Acesso.

Para cadastrar um usuário Administrador basta marcar a opção ‘Administrador’ no cadastro do usuário.

Havendo necessidade de restringir o acesso também por horário, é possível criar turnos de acesso e atribuir este(s) turno(s) ao usuário. Acesse: Configuração > Controle de Acesso > Turnos de Acesso.

Acessando Configuração > Controle de Acesso > Grupos de Acesso, você poderá criar os grupos de acesso e vincular os usuários pertencentes a este grupo, conforme imagem abaixo:

Acessando Configuração > Controle de Acesso > Direitos de Acesso por Grupo, você poderá definir quais janelas do sistema serão liberadas/bloqueadas para o grupo.

Neste cadastro é possível filtrar as janelas por módulo ou por ‘palavra chave’. Estas opções são interessantes por tornar mais fácil e organizado o processo de seleção das janelas, conforme figura abaixo:

Também é possível bloquear um controle/campo de uma janela. Selecione a opção ‘campos’, que exibirá a janela abaixo. Transfira para a direita as opções que deseja bloquear, conforme exemplo que segue.

Acessando Configuração > Controle de Acesso > Exceções de Acesso por Usuário, é possível liberar ou bloquear o acesso a uma janela ou o controle de uma janela para um usuário específico, mesmo que este já participe das definições de algum grupo.

Por regra, quando um usuário acessa o Trucker, são carregadas as configurações dos grupos nos quais ele participa; em seguida as configurações das exceções do usuário. Assim, as exceções sempre assumem o último status daquela opção.

Por meio das triggers geradas no banco de dados, é possível registrar os acessos do usuário as opções do sistema, e as alterações de dados realizadas pelo mesmo.

Acessando Configuração > Controle de Acesso > Consulta de Log, teremos as opções para filtrar o período, o usuário, a atividade e o arquivo de dados que queremos consultar.

Em empresas com grande número de acessos/usuários, convém executar a limpeza de logs periodicamente, auxiliando a performance do sistema. Nesta opção não excluímos necessariamente os registros de log, apenas transferimos para outro banco de dados.

Lembramos que os registros transferidos podem ser consultados também através da opção ‘consultar arquivo de logs excluídos’ na tela de consulta de log.

Para acessar a limpeza de log acesse Configuração > Controle de Acesso > Limpeza de Log.

1. Para executar a biblioteca java, acesse o prompt de comando (CMD) e execute o comando “java -jar cte.jar” a partir da pasta ‘cte’ no servidor Trucker.

2. Executando o comando acima, o aplicativo deverá informar que a sintaxe está errada e mostrará as todas opções disponíveis, conforme imagem abaixo:

3. Para verificar se o aplicativo já está pronto para ser utilizado, basta executar a opção 1, “consultar status serviço”, que apenas verificará se os serviços da SEFAZ estão no ar, executando o comando, por exemplo, “java -jar cte.jar 1 a.xml sc.properties”. O arquivo “a.xml” não precisa necessariamente existir, pois é utilizado somente em alguns processos.

O arquivo ‘.properties’ é gerado automaticamente pelo Trucker e apagado em seguida, pois é no sistema que estão cadastradas todas as configurações do CT-e). Para efeito de teste, pode ser utilizado o arquivo “estado.properties” que se encontra na pasta ‘cte’. No entanto, antes de executar o comando, é preciso editar o conteúdo deste arquivo, atualizando seu conteúdo para compatibilizar com os dados inseridos no Trucker, ex: Certificado, senha, etc.

1. Cadastro de Sequência para o Documento ‘Lote de Nota Fiscal Eletrônica’. Cadastrar zero no campo ‘último’ caso nunca tenha enviado um lote a Prefeitura.

2. Cadastro de Sequência para o Documento ‘Recibo Provisório de Serviço’. Cadastrar no campo ‘último’ o número da última nota fiscal de serviço emitida.

3. Em Cadastro > Fiscal > Alíquotas, cadastrar as alíquotas necessárias para emissão deste tipo de documento fiscal: PIS, COFINS, CSLL, ISS, IRPJ. Instruções sobre o preenchimento deste cadastro encontram-se no Manual de Implantação do Módulo Expedição.

4. Em Cadastro > Fiscal > Serviços Municipais, cadastrar o serviço fiscal com o seu respectivo código e alíquota na Prefeitura, por Unidade emissora, conforme exemplo abaixo:

Instruções sobre o preenchimento deste cadastro encontram-se no Manual de Implantação do Módulo Expedição.

5. Em Cadastro > Comercial > Clientes, opção ‘Faturamento’, efetuar o cadastro do e-mail do cliente para recebimento da NF eletrônica, que será enviado diretamente pela Prefeitura.

Acesse configuração > Backup > Gerenciamento de Backup.

1. Defina o nome da base que deseja fazer backup na opção “Data Base”.
2. Defina a pasta de destino do backup na opção: “Pasta do Backup”.
3. Para finalizar é só clicar no botão “Executar Backup Manual”. Depois de concluído verifique se o backup se encontra na pasta de destino, lembrando que este processo pode ser demorado dependendo do tamanho da base.

Na mesma opção onde executamos o backup manual também programamos o backup automático, acrescentando as configurações de agendamento:

1. Backup Diário. Configure os dias da semana que deseja fazer backup, o padrão do nome do arquivo salvo é este: NOME DA BASE + DIA + No. Dia da Semana + .bak

Ex: TRUCKER_DIA_2.bak - Este exemplo representa o backup de segunda-feira e toda a semana será sobrescrito.

2. Backup Semanal. Configure as semanas que deseja fazer backup, lembrando que o backup semanal só será executado na sexta-feira e o padrão do nome do arquivo é este: NNOME DA BASE + SEM + No. da Semana + .bak

Ex: TRUCKER_SEM_4.bak - Este exemplo representa o backup da quarta semana do mês e será sobrescrito todo mês.

3. Backup Mensal. Configure o dia do mês que deseja fazer o backup mensal, no caso da imagem acima todo dia 18 de cada mês será executado o backup mensal, o padrão do nome do arquivo é este: NOME DA BASE + MÊS + No. do mês + .bak

Ex: TRUCKER_MES_12.bak Este exemplo representa o backup do mês de dezembro e será sobrescrito todo ano.

Para que o Backup Automático seja executado conforme o agendamento configurado, é preciso configurar o Agendamento de Tarefa do Corebuilder.

1. Execute o aplicativo ‘CoreBuilder Config’ que se encontra na subpasta ‘Server’, no servidor onde foi instalado o CoreBuilder Application Server. No menu ‘Arquivo’ selecione a opção ‘Transaction Master Control Object’.

Clique em Incluir e preencha os campo: 

• Servidor: Servidor onde está localizado o CoreVM.
• Nome do objeto: sempre "MCO".
• TimeOut: É o intervalo que o Core usa para verificar se tem um novo agendamento para ser executado. Por default, sempre ‘30’.

2. Selecione no menu a opção ‘Application Data’ e em seguida ‘Transaction Server’ acessando a tela abaixo:

Agora você deve preencher "User" com um usuário existente na base que você está utilizando o agendamento de tarefas e em "Password" sua respectiva senha.

• MCO Preferencial deste Transaction Server: É o MCO que você vai utilizar, no caso de apenas um MCO podemos deixar em branco.
• Número de servidores: É a quantidade de CoreVM que será iniciado para ser utilizado pelo "Transaction Service", é necessário pelo menos 1, pois é através dele que as tarefas agendadas serão executadas.

3. Agora acessando o Trucker pelo Client, no menu ‘Ferramentas’ do Corebuilder, selecione Ferramentas > Agendamento de Tarefas.

4. Feito estas configurações é necessário configurar o agendamento, como exemplo vamos usar o agendamento de backup, mas qualquer outra tarefa pode ser agendada nesta opção.

5. A ‘expressão ao executar’ do backup deve ser a apresentada acima: ‘TR_BACKUP_AUT:Exec()’. A opção ‘Agendado’ deve ficar ativada através do botão ‘Agendar / Desagendar’. A opção ‘Realizar Log das execuções’ é importante manter ligada para observarmos a estabilidade do agendamento. Estes mesmos logs podem ser observados no botão ‘Log de execuções’.

6. Para finalizar precisamos reiniciar todos os serviços, e sempre que tiver qualquer alteração no agendamento de tarefas é necessário reiniciar o serviço “CoreBuilder Transaction Service”.

7. Após configurar o procedimento de Backup, imprima e entregue ao cliente o documento da próxima página, intitulado ‘Política de Segurança de Backup’.

Quando agendar a tarefa, o campo ‘horário de execução’ ou ‘Hora’, deve ser preenchido no formato ’99:99:99’ , não esquecendo de incluir os segundos.