Sie sind auf Seite 1von 52

Guia Srie 1 (First)

Instalao e configurao
Este guia tem o objetivo de auxiliar no processo de instalao e configurao do Srie 1 (First).

PDE Unidade Belo Horizonte TOTVS S/A Reviso: 28/08/2009

Contedo
1.
1.1. 1.2. 1.3. 1.4. 1.5.

O Srie 1 (First)....................................................................................................................... 4
Administrativo Financeiro........................................................................................................................... 4 Compras......................................................................................................................................................... 4 Faturamento.................................................................................................................................................. 5 Estoques......................................................................................................................................................... 5 Outros ............................................................................................................................................................ 6

2.
2.1. 2.2. 2.3. 2.4.

A Estrutura da Tecnologia do Srie 1 (First) ............................................................................. 7


Servidor de Aplicao..................................................................................................................................... 7 O Terminal Thin-Client ................................................................................................................................... 7 Os Dados ........................................................................................................................................................ 7 O repositrio de APOs .................................................................................................................................... 8

3. 4. 5. 6.
6.1. 6.2. 6.3. 6.4. 6.5.

Diretrios do Srie 1 (First) ..................................................................................................... 9 Aplicativos do Srie 1 (First).................................................................................................. 12 Nomenclaturas do Srie 1 (First) ........................................................................................... 13 Instalao do Srie 1 (First) ................................................................................................... 14
Locais para baixar os arquivos de instalao .............................................................................................. 14 Procedimento quando de uma atualizao de verso................................................................................. 14 Procedimento quando da primeira instalao............................................................................................. 15 Cuidados a serem tomados.......................................................................................................................... 18 Instalao do Server no LINUX..................................................................................................................... 19

7. 8.
8.1. 8.2.

Desinstalando o Srie 1 (First)............................................................................................... 20 Conhecendo os Arquivos de Configurao ............................................................................. 21


Configurao do TotvsAppServer.ini............................................................................................................ 21 Configurando o TOTVS Smart Client ............................................................................................................ 28

9.
9.1. 9.2.

Topologia de Utilizao de Rede do Srie 1 (First).................................................................. 32


Caractersticas e Possibilidades de Topologias de Rede .............................................................................. 32 Instalao do Srie 1 (First) em redes Netware Novell ................................................................................ 33

10.
10.1. 10.2. 10.3.

Outros Aplicativos Instalados................................................................................................ 36


TOTVS Development Studio ......................................................................................................................... 36 TOTVS Monitor............................................................................................................................................. 36 SDU .............................................................................................................................................................. 36

11.
11.1. 11.2.

Acessando o Srie 1 (First) .................................................................................................... 37


Identificando sua Empresa........................................................................................................................... 39 Consultando o Sistema de Ajuda ................................................................................................................. 41

12.
12.1. 12.2. 12.3. 12.4.

TOPConnect ......................................................................................................................... 44
Conceito de Ambiente.................................................................................................................................. 45 Instalao do TOPConnect........................................................................................................................... 46 Ambiente Windows.................................................................................................................................... 46 Ambiente Unix e Linux ............................................................................................................................. 52

Pgina 2

Pgina 3

1. O Srie 1 (First)
O Srie 1 (First) uma soluo de gesto empresarial sob medida para micro e pequenas empresas que buscam uma ferramenta integrada para automatizar seus processos bsicos administrativos e financeiros. Dentre os principais controles do Srie 1 (First), destacam-se

1.1. Administrativo Financeiro


Controle de despesas e receitas - manuteno, renegociao, consulta e emisso de relatrios de acompanhamento das despesas e receitas. Controle de baixas - controle de baixas das provises em aberto e transaes programadas. Movimentao bancria - controle da movimentao bancria, extrato de contacorrente, reconciliao bancria automtica. Fluxo de caixa - resumo dos saldos bancrios, despesas e receitas previstas, possibilidade de consultas grficas. Transaes programadas - manuteno das transaes programadas. Oramentos - controle mensal de oramentos por categorias financeiras e dos valores de despesas e receitas, possibilitando a emisso de relatrios e consultas grficas de valores orados X reais. CNAB - intercambiar informaes digitalmente entre o sistema de informtica do Banco e o Srie 1 (First).

1.2. Compras
Consulta posio Fornecedor - controle gerencial de anlise da situao dos Fornecedores com relao s movimentaes financeiras e movimentaes de compra realizadas em determinado perodo. Controle de solicitaes de compras - manuteno, consulta e impresso da solicitao de compras e do relatrio de acompanhamento de solicitaes. Controle de cotao de compras - registro do preo obtido da oferta de diversos fornecedores em relao ao material cuja compra foi solicitada. Incluso automtica de Pedido de Compra. Controle de pedidos de compras - manuteno, consulta e impresso de pedidos de

Pgina 4

compras e do relatrio de acompanhamento de pedidos (em aberto/atendidos). Nota fiscal de entrada - gerao de notas fiscais de entrada. Integrao com a rea financeira. Estoque - controle de estoque fsico. Devoluo de mercadorias - controle de devoluo. Beneficiamento - controlar o envio e o recebimento de materiais que vo possuir algum tipo de beneficiamento, poder de/em terceiros.

1.3. Faturamento
Consulta posio Cliente - controle gerencial de anlise da situao dos Clientes com relao s movimentaes financeiras e movimentaes de venda realizadas em determinado perodo. Tabela de Preo - compor diversas formas de comercializao, considerando, para um ou diversos produtos, condies especficas de venda, utilizando critrios diferenciados, como, Estado, regio e faixa de preos. Ordem de Servio - apontar os materiais e a mo-de-obra que sero utilizadas para manuteno do equipamento/produto. Controle de pedidos - manuteno, consulta e emisso de pedidos de venda. Controle de vendedores - gerao de vendedores para previso de comisses. Resumo de vendas - consultas e relatrios para informaes gerenciais sobre estatsticas de vendas. Notas fiscais de sada - gerao de notas fiscais de sada. Faturamento de pedido de venda - parcial e mltiplo. Nota fiscal eletrnica - de acordo com a legislao federal que regulamenta o SPED Sistema Pblico de Escriturao Digital. Integrao com a rea financeira. Estoque - controle de estoque fsico. Devoluo de mercadorias - controle de devoluo.

1.4. Estoques
Controle de estoques por armazns. Controle de lote por produto.

Pgina 5

Gerenciador de estrutura de produtos. Gerenciamento de empenhos e previso de entradas - manuteno, consulta e emisso de relatrios de empenhos e de previso de vendas. Movimentaes internas - manuteno de requisies/devolues ao estoque fsico. Produo - manuteno de ordens de produo, apontamentos de produo. Kardex fsico do estoque. Giro e realimentao do estoque - solicitao de compras automtica, previso de materiais - MRP. Inventrio - lanar o balano de produtos em estoque no final do perodo por armazns e/ou grupo de produtos.

1.5. Outros
Aceleradores de implantao templates para agilizar o processo de implantao. Grade de produtos insero de produtos com indicao de cdigo, coluna e linha. Contabilizao gerar lanamentos contbeis para serem exportados a outros Sistemas. Consulta relacional - definir as informaes desejadas atravs de filtros, possibilitando a criao de relatrios, de acordo com a necessidade da empresa. Nota fiscal paulista instrues normativas CAT 85 e CAT102. Mashup consulta aos Correios e a Receita Federal. WorkFlow - automatizar os processos, principalmente atravs do envio de e-mails, que usualmente so realizados manualmente no dia a dia de uma empresa.

Pgina 6

2. A Estrutura da Tecnologia do Srie 1 (First)


A tecnologia do Srie 1 (First) desenvolvida pela TOTVS estruturada em: Servidor de Aplicao (TOTVS Application Server) e Interface (TOTVS Smart Client), ou seja, uma aplicao Windows 32 bits ou Linux que se encarrega do gerenciamento das conexes, da execuo do cdigo AdvPl e do acesso ao de banco de dados atravs do ISAM padro CTREE e uma aplicao thin-client que efetua apenas a interface com o usurio. O Srie 1 (First) dividido em quatro camadas para a operao. So elas:

2.1. Servidor de Aplicao


O TOTVS Application Server a aplicao encarregada da compilao e da execuo do cdigo em AdvPl, no qual o Srie 1 (First) est escrito. Na linguagem AdvPl, as rotinas so mantidas em APOs (TOTVS Objects) individuais repositrios. Isso permite que as rotinas sejam carregadas e descarregadas dinamicamente da memria da mquina, onde o Servidor est sendo executado, ou seja, de acordo com a necessidade de execuo dos Terminais conectados, e isto facilita a atualizao aps correes de no-conformidades ou criao de melhorias, pois apenas os APOs modificados necessitam ser atualizados. Deste modo, a performance alta e no requer muito da mquina para a execuo do servidor.

2.2. O Terminal Thin-Client


O TOTVS Smart Client a aplicao encarregada da interface com o usurio. No existe processamento local, por isso o trfego de rede entre o Terminal e o Servidor de Aplicao baixo, tratando-se apenas de comandos para o desenho das telas e do tratamento do teclado e mouse.

2.3. Os Dados
O acesso aos dados efetuado pelo Servidor de Aplicao atravs do ISAM padro Codebase. Na verso Srie 1 (First), a bases de dados tem suporte a controle de transao, graas ao ISAM padro Codebase.

Pgina 7

2.4. O repositrio de APOs


Nesta parte do sistema que esto os programas AdvPl a serem executados para a execuo do sistema ERP. atravs do repositrio de APOs que podemos incluir novas atualizaes no sistema.

Pgina 8

3. Diretrios do Srie 1 (First)


Durante a instalao do Srie 1 (First) so criados alguns diretrios para gravao dos seus arquivos. Veja a seguir a estrutura de diretrios do sistema bem como a finalidade de cada um destes.

\Serie1 (Ncleo) Diretrio onde armazenado o ncleo (kernel) do Srie 1 (First). Toda a parte de tecnologia First.

\Serie1\APO Diretrio onde so encontrados os repositrios de APOs.

\Serie1\BIN\SMARTCLIENT nele que so encontrados os arquivos executveis, DLLs e arquivos de configurao do sistema para acesso ao Client.

\Serie1\BIN\APPSERVER nele que so encontrados os arquivos executveis, DLLs e arquivos de configurao do sistema que devem ser executados no Servidor.

\Serie1\HELP Contm os helps e e-Learnings das rotinas em HTML e SWF.

\Serie1\INCLUDE Aqui esto as bibliotecas necessrias para a compilao de programas AdvPl.

\Serie1\UPDATES Este diretrio sugerido para armazenar as atualizaes do sistema.

\Serie1\First_Data\DATA Contm a base de dados do cliente.

Pgina 9

\Serie1\First_Data\SAMPLES Diretrio onde armazena exem plos/modelos de integrao com o Excel e Word, templates para aceleradores de implantao e arquivos de configurao de exportao de tabelas.

\Serie1\First_Data\SAMPLES\DOCUMENTS\EXCEL Contm as planilhas para integrao do Srie 1 (First) com Microsoft Excel.

\Serie1\First_Data\SAMPLES\DOCUMENTS\WORD Contm os modelos de documentos Word para integrao com First.

\Serie1\First_Data\SAMPLES\TEMPLATES\CTREE Contm os templates para aceleradores de implantao para o acesso ao Sistema via Ctree.

\Serie1\First_Data\SAMPLES\TEMPLATES\TOPCONNECT Contm os templates para aceleradores de implantao para o acesso ao Sistema via TopConnect.

\Serie1\First_Data\SAMPLES\TEMPLATES\ARQSCONFIG Contm os arquivos de configurao e para a rotina de exportao de dados com layout definido pelo usurio.

\Serie1\First_Data\SEMAFORO Contm arquivos para controle de operaes que necessitam de acesso exclusivo.

\Serie1\First_Data\SPOOL Neste diretrio so gravados os relatrios gerados em disco.

\Serie1\First_Data\SYSTEM Contm os arquivos auxiliares com drivers de impressoras, helps de campos e parmetros, configuraes e logotipo da empresa.

Pgina 10

\Serie1\First_Data\SYSTEMLOAD Contm arquivos para gerao de help de campo.

Pgina 11

4. Aplicativos do Srie 1 (First)


Alm do Server, o Srie 1 (First) possui, basicamente, trs outros aplicativos utilizados com diferentes finalidades. So eles:

TOTVS Smart Client (TotvsSmartClient.exe) o TOTVS Smart Client que utilizamos para interagir com todo o sistema, ele pode ser instalado de duas maneiras, no servidor ou na prpria estao de trabalho.

TOTVS Development Studio (TotvsDevStudio.exe) Trata-se do ambiente de desenvolvimento do Srie 1 (First), atravs deste aplicativo que vamos fazer todos os acessos aos repositrios de APOs (aplicaes de patchs corretivas enviadas pela TOTVS, sem a necessidade de instalar um novo programa ou mesmo fazer novas configuraes).

TOTVS Monitor (TotvsMonitor.exe) Atravs do TOTVS Monitor podemos interagir com os usurios conectados ao sistema. Analisar os programas em uso, derrubar conexes pendentes, enviar mensagens aos usurios etc.

Pgina 12

5. Nomenclaturas do Srie 1 (First)


As principais nomenclaturas do Srie 1 (First) so as que se referem a partes do sistema so elas:

Build: Verso completa do sistema com seus executveis, DLLs e RPO completo. O build do sistema pode ser identificado atravs das opes Ajuda + Sobre dentro dos ambientes do sistema. RPO: o arquivo de repositrio de APOs. Pacotes de Atualizao (.PAK) arquivos gerados para atendimento s alteraes legais ou emergenciais que envolvem um grupo de programas. Atualizao de RPO (Update - .UPD) arquivo gerado para atualizao completa de RPO. Verso Master: Mesma definio de build, porm neste caso a verso ser utilizada como referncia para a gerao de atualizaes. A definio dos nomes dos arquivos dos repositrios de APOs segue a seguinte estrutura: 1 (C)Tree; 2 (P)ortuguese, (E)nglish, (S)panish; 3 Verso; 4 Verso; 5 Verso. Por exemplo, ttcp101.rpo ser um repositrio de APOs para base de dados CTree, idioma Portugus e verso 10.1.

Pgina 13

6. Instalao do Srie 1 (First)

6.1. Locais para baixar os arquivos de instalao


ftp://webshare.rm.com.br/First/server/First R3.msi

6.2. Procedimento quando de uma atualizao de verso

ATENO: Copiar o arquivo TOTVSAPPSERVER.INI da pasta: C:\Arquivos de Programas\TOTVS\Serie1\Bin\appserver para a raiz do C:\. Efetuar um backup da pasta atual do Srie 1 (First).
Se este arquivo no for copiado o programa de instalao no atualizar os arquivos referentes base de dados, spool, profile e algumas configuraes. Este procedimento dever ser realizado manualmente. Favor, entrar em contato com o Suporte do Srie 1 (First). Aps finalizar, realizar o procedimento de primeira instalao.

Pgina 14

6.3. Procedimento quando da primeira instalao Clicar no arquivo First R3.msi. Aparecer a tela abaixo:

Clique em Avanar para prosseguir.

Pgina 15

ATENO: Recomenda-se o uso do diretrio padro de instalao para que processo de suporte e treinamento seja facilitado. Evite o uso de unidades lgicas (drives de rede), para tanto utilize sempre o computador que faz o papel de servidor para efetuar a instalao. Com isso, diminui-se o risco de erros em eventuais desinstalaes do sistema. Escolha o local de destino e clique em Avanar para prosseguir.

Pgina 16

Clique em Instalar

Informe o tipo do banco de dados, o idioma do repositrio de fontes e o pas base para os dicionrios de dados. Clique em OK.

Pgina 17

A instalao foi executada com sucesso, clique em Concluir.

6.4. Cuidados a serem tomados


Espao em disco disponvel no Servidor Windows: ter efetuado login como Administrador ou usurio equivalente. Linux: ter efetuado login como Administrador (ROOT). Windows/Linux: deve-se utilizar a ltima verso ServicePack disponibilizada pelo fabricante do software

Pgina 18

6.5. Instalao do Server no LINUX


1. Crie uma estrutura de diretrios de acordo com o item 3 deste manual. 2. Baixe os binrios que esto em ftp://webshare.rm.com.br/linux/ e descompacte-os nas suas respectivas pastas (smartclientlinux.zip e appserverlinux.zip) 3. Configurar o arquivo totvssrvlinux.ini. 4. Configurar o arquivo totvssmartclient.ini. 5. Excecutar o Server.

Pgina 19

7. Desinstalando o Srie 1 (First)


A desinstalao do Srie 1 (First) pode ser feita da seguinte forma:
Windows

Acesse o Painel de Controle. Selecione "Adicionar ou Remover Programas". Selecione "Serie1" e clique em "Adicionar/Remover". Siga as orientaes da janela. Apague os diretrios do Serie1.

Linux

Pgina 20

8. Conhecendo os Arquivos de Configurao


O Srie 1 (First) possui os seguintes arquivos de configurao:

TotvsAppServer.ini: Neste arquivo so configuradas praticamente todas as funcionalidades disponveis no Srie 1 (First). o arquivo de configurao utilizado pelo TOTVS Application Server. TotvsSmartClient.ini: Neste arquivo so definidas as configuraes pertinentes ao TOTVS Smart Client, como direcionamento de conexo, protocolos utilizados, entre outros. TotvsDevStudio.ini: Neste arquivo ficam gravadas todas as opes do TOTVS Development Studio (Posio de janelas, Fonte utilizada, ltimos arquivos abertos, Preferncias de Idioma, Diretrio para localizao de fontes entre outros). Este arquivo no deve ser alterado manualmente. Adslocal.cfg: Semelhante ao arquivo AXS.CFG de instalaes do Ads em redes Netware, este arquivo permite diversas configuraes como nmero de usurios, nmero mximo de tabelas a serem abertas, nmero de Workareas disponveis entre outros (Este arquivo s utilizado para instalaes que possuam o parmetro LOCALFILES=ADS no arquivo TotvsAppServer.ini). TotvsDevStudio.cfg: Aqui ficam guardadas todas as configuraes de feitas no TOTVS Development Studio (No deve ser alterado manualmente).

8.1. Configurao do TotvsAppServer.ini


O arquivo TotvsAppServer.ini responsvel pela configurao do TOTVS Application Server. Durante a instalao do Srie 1 (First), este arquivo criado e configurado conforme as opes selecionadas. A seguir so detalhadas todas as configuraes que se encontram no arquivo TotvsAppServer.ini.

Pgina 21

Sees Environment
As sees Environment contm as informaes dos diretrios de execuo do TOTVS Application Server, as informaes do idioma, interface, diretrios e repositrio. Estas informaes so identificadas para cada conexo, ou seja, cada TOTVS Smart Client que se conectar ao Servidor deve informar qual a seo que deseja utilizar. Assim, os diretrios para trabalho, o idioma, a interface e o repositrio podem ser obtidos a partir das informaes da seo definida. Uma seo padro, chamada Environment, criada na instalao e utilizada sempre que o TOTVS Smart Client se conectar sem informar uma seo atravs de parmetros de linha de comando. Chave SourcePath RootPath StartPath Descrio Identifica o diretrio onde os repositrios de APOs so mantidos na mquina em que o TOTVS Application Server est instalado. Identifica o diretrio raiz do Srie 1 (First), a partir do qual todos os diretrios utilizados pelo Srie 1 (First) sero criados. Identifica o diretrio onde os arquivos de configurao do Srie 1 (First) se encontram. o diretrio inicial de execuo do sistema. Este diretrio criado a partir do diretrio raiz, definido na chave anterior. RpoDb Identifica o tipo de base de dados utilizada: CTREE. Esta informao utilizada pelo servidor para definir qual repositrio ser acessado. Identifica a linguagem que ser utilizada. Pode ser Portuguese, English ou Spanish. Esta informao tambm utilizada pelo servidor para definio do repositrio a ser acessado. RpoVersion Trace Identifica a verso do Srie 1 (First). Indica se deve ser feito o Log de warnings em arquivo. O arquivo de log (Trace.log) ser criado no diretrio \bin\appserver. Valores possveis: 1 (faz log), 0 (no faz log) Indica se durante a abertura dos mdulos, o sistema ir efetuar a abertura pelo menu (padro) ou por necessidade (abre e fecha arquivos conforme utilizao). O valores possveis so: 1- Abre arquivos por demanda, 0-Abre os arquivos a partir do menu. Indica qual a base de dados que ser utilizada para abertura dos arquivos locais: CTREE.

RpoLanguage

FilesOnDemand

LocalFiles

Pgina 22

Localdbextension

Define qual ser a extenso default dos arquivos ISAM para os Drivers CTREE. So definidos como arquivos ISAM: Arquivos de Trabalho Valores vlidos: Devem iniciar com ponto e 3 caracteres adicionais vlidos para extenso de arquivo no SO utilizado. Default: .dtc

PictFormat

Esta chave permite a criao de environments com composio de data no formato "ms, dia, ano" , caso utilizar esta caracterstica basta informar AMERICAN nesta chave. Contedos Possveis = DEFAULT, AMERICAN DEFAULT = Default (Dia,Ms,Ano)

Drivers

A seo Drivers define quais protocolos de conexo podero ser utilizados para que os terminais conectem-se ao TOTVS Application Server. Chave Active Descrio Identifica os nomes das sees de configurao de protocolos ativos. Mais de uma seo pode ser informada separando-as por uma vrgula (,), desse modo permitindo que existam conexes de terminais ao servidor efetuadas atravs de diferentes protocolos.

Pgina 23

Sees Protocolos de Conexo


O TOTVS Application Server pode se utilizar do protocolo TCP-IP para realizar a conexo com os terminais. A configurao do protocolo utilizado efetuada atravs de sees com as chaves definindo informaes como a porta de conexo, o servio e o tipo da conexo. As conexes ativas, ou seja, que podem ser utilizadas pelos terminais para se conectar ao Servidor, so aquelas cujos nomes de sees esto definidos na chave Active descrita anteriormente. Podem-se criar diversas sees com as conexes utilizadas. Chave InactiveTimeout Port Descrio Determina o tempo de espera at a queda da conexo, no caso de no haver respostas. Identifica a porta que ser utilizada para as comunicaes via TCPIP. Obs: O Srie 1 (First) utiliza TCP Stack (A mesma porta para todos os usurios).

ServerNetwork
Esta seo utilizada no caso do uso de Balanceamento de Carga. Deve-se informar na chave a seguir quais so os servidores disponveis na rede. Chave Servers Descrio Especificar os nomes das sees que contm as informaes dos servidores, separados por vrgula e na seqncia de busca desejada. Dentro de cada nova seo de servidor, deve-se informar o nome, o tipo de conexo (TCP), a porta ou servio e o nmero de conexes permitidas. Exemplo: [ServerNetwork] Servers=SERVER1,SERVER2 Masterconnection=0 (Default ligado) ;Informa que o master no ir aceitar conexes [SERVER1] TYPE=TCPIP Server=Servidor1 Port=1010 Connections=60

Pgina 24

[SERVER2] TYPE=TCPIP Server=Servidor2 Port=3024 Connections=40

HTTP
Esta seo permite ao TOTVS Application Server atuar como Servidor Http (Protocolo Internet), ou seja, pode fornecer pginas em Html para um Browser. Chave Enable Path Port Descrio 1=Ligado e 0=Desligado Local onde ser o diretrio raiz para as pginas. Nmero da porta utilizada para a conexo http.

FTP
Esta seo permite ao TOTVS Application Server atuar como Servidor FTP (Protocolo Internet). Chave Enable Path Port Descrio 1=Ligado e 0=Desligado Diretrio raiz para os arquivos de FTP. Define o nmero da porta de conexo FTP.

Pgina 25

ONSTART
Nesta seo, pode-se determinar a execuo de uma funo (Sem interface) logo aps o acesso ao Server. Chave Jobs Descrio Informe o(s) nome(s) de seo(es) para executar funes. Ex: [ONSTART] Jobs=JOB1,JOB2 [JOB1] Main=RecalcJur() Environment=Envtop [JOB2] Main=GetProdAtu() Environment=Environment

Pgina 26

Service
Utilize esta seo para informar o nome interno e externo do Servio do TOTVS Application Server no Windows NT. Esta opo til quando for necessrio utilizar mais de um TOTVS Application Server rodando como servio na mesma mquina, pois permite ao usurio informar nomes diferentes. Chave Name Displayname Descrio Nome interno do Servio Nome a ser exibido na janela de servios do Windows NT.

A seguir apresentado um exemplo do arquivo de configuraes do TOTVS Application Server, onde pode-se visualizar dois Environments diferentes: EnvCTree e EnvTop. A diferena entre eles que utilizam de bases de dados e idiomas diferentes.
[EnvCTree] SourcePath=C:\Arquivos de Programas\TOTVS\Serie1\APO\ RootPath=C:\ Arquivos de Programas\TOTVS\Serie1\First_Data StartPath=\SYSTEM RpoDb=CTree RpoLanguage=Portuguese RpoVersion=101 [EnvTop] SourcePath=C:\ Arquivos de Programas\TOTVS\Serie1\APO\ RootPath=C:\ Arquivos de Programas\TOTVS\Serie1\First_Data StartPath=\SystemTOP RpoDb=Top RpoLanguage=English RpoVersion=101 [TopConnect] DataBase=MSSQL7 Server=172.16.1.13 ALIAS=TOPFirst [Drivers] Active=TCP

[TCP] TYPE=TCPIP Port=1010

Pgina 27

8.2. Configurando o TOTVS Smart Client


As configuraes do TOTVS Smart Client tambm podem ser customizadas, de modo que pode-se manter diferentes conexes em um mesmo servidor. Por exemplo:

Uma rede local com conexes via TCP-IP e algumas outras conexes remotas, via modem ou Internet, utilizando TCP-IP; Diferentes redes conectadas via linha privada. Cada uma destas redes mantm um TOTVS Application Server para o processamento distribudo.

Estas configuraes so mantidas no arquivo TotvsSmartClient.INI que se encontra no diretrio de execuo do TOTVS Smart Client:

Sees Config

Identifica informaes gerais de configurao do TOTVS Smart Client. Chave LastMainProg Descrio Contm a lista dos ltimos programas iniciais executados no TOTVS Smart Client. o APO que inicia a execuo. Por exemplo, pode-se iniciar do Srie 1 (First). Informa se deve procurar o TOTVS Application Server na mquina local, para ser executado automaticamente. Default = 0; para ativar especificar 1. Define o idioma utilizado para exibir as mensagens do TOTVS Smart Client. Apenas as mensagens originadas do TOTVS Smart Client so afetadas. Para uma traduo geral, deve-se ter o RPO no idioma requerido. 1 = Portugus, 2 = Espanhol, 3 = Ingls.

Twotier

Language

Drivers
A seo Drivers define quais os protocolos podem ser utilizados para que o Terminal conecte-se ao TOTVS Application Server. igual a seo de mesmo nome no arquivo de configuraes do TOTVS Application Server. A diferena que as sees aqui informadas (que devem ser separadas por vrgulas) so utilizadas em tentativas de conexo, de acordo com a ordem em que foram informadas.

Sees de Protocolos de Conexo


As sees de configuraes de protocolos so definidas da mesma forma que no arquivo de configuraes do TOTVS Application Server. No necessitam ter o mesmo nome que o definido no TOTVS Application Server, porm as informaes devem ser as mesmas e, somente os protocolos definidos na chave Active da

Pgina 28

seo Drivers do arquivo de configurao do TOTVS Application Server, podem ser utilizados quando estiver configurando o TOTVS Smart Client. Notas:

Para a execuo local (TOTVS Application Server e TOTVS Smart Client executados na mesma mquina) pode-se informar: Server = LocalHost. Para execuo remota, o nome do servidor ou o endereo IP informado para o TOTVS Smart Client deve ser o mesmo configurado no TOTVS Application Server onde o terminal est conectado. Do mesmo modo, a porta informada na chave Port deve ser a mesma configurada em ambos, TOTVS Application Server e TOTVS Smart Client.

A seguir apresentado um exemplo do arquivo de configuraes do TOTVS Smart Client:


[Environment] EnvServer=ENVIRONMENT [Config] LastMainProg=FIRST [Drivers] Active=TCP [TCP] TYPE=TCPIP Server=[Nome do Computador ou nmero IP do Computador] Port=1010

Para instalar o TOTVS Application Server como servio basta executar a seguinte linha de comando a partir do diretrio do executvel do Server. Ex: [c:\ Arquivos de Programas\TOTVS\Serie1\bin\appserver\TotvsAppServer.exe install.

Parmetros da Linha de Comando do TOTVS Smart Client


Ao ser iniciado, o TOTVS Smart Client exibe a tela de parmetros iniciais, para identificao do Ambiente, da Conexo e do APO inicial. Porm, tais informaes podem ser informadas atravs da linha de comando do cone de acesso ao TOTVS Smart Client.

Pgina 29

As opes de linha de comando do TOTVS Smart Client so:

-Q (Quiet): Indica que o TOTVS Smart Client no deve mostrar o Splash (imagem de apresentao) e a tela de identificao de parmetros iniciais necessita ser acompanhada da clusula P; -P (Main Program): Identifica o programa (APO) inicial; -R (CfgSection): Nome da seo de configurao. Por default, Config; -E (Environment): Nome da seo de environment no .INI do Server que ser utilizada para definies gerais; -C (Connection): Nome da seo de conexo que ser utilizada para a conexo ao TOTVS Application Server; -A (Parmetros para o Programa Inicial): Identifica um parmetro que ser passado para o programa inicial; -L (TOTVS Smart Client Log File): Para no-conformidades que ocorram no TOTVS Smart Client (antes que este possa se conectar ao TOTVS Application Server), gerado um arquivo de log no diretrio de execuo deste aplicativo. Este arquivo tem o nome definido pela identificao do executvel (TOTVS Smart Client) + um caracter de underline (_) + o nome da mquina em que o TOTVS Smart Client est sendo executado (com extenso .LOG). Esta opo permite informar um nome especfico para a gerao deste arquivo de log, visando automatizaes especficas que necessitem saber quando uma noconformidade ocorreu no TOTVS Smart Client (por exemplo, impossibilidade de conexo).

-M (AllowMultiSession): Permite mltiplas instncias (Cpias) do TOTVS Smart Client na mesma mquina (Default: no permite); Por exemplo, pode-se utilizar a seguinte linha de comando:
TotvsSmartClient.exe.Q P=FIRST E=ENVIRONMENT

Pgina 30

para executar o Srie 1 (First) em uma base de dados utilizando o idioma ingls.

Pgina 31

9. Topologia de Utilizao de Rede do Srie 1 (First)


Devido sua diviso em camadas, a tecnologia TOTVSTec permite montar o ambiente de execuo com diferentes topologias, priorizando a execuo, o trfego de rede ou os recursos individuais das mquinas existentes, o que torna o processamento distribudo. Essa uma das grandes vantagens da tecnologia TOTVSTec.

9.1. Caractersticas e Possibilidades de Topologias de Rede

Pode-se manter um ou mais servidores de aplicao do Srie 1 (First) (TOTVS Application Server); Um TOTVS Application Server pode estar na mesma mquina que o gerenciador de banco de dados; Mquinas melhores ou com mais recursos podem ter um TOTVS Application Server executando localmente. Isto prioriza o processamento local, mas aumenta o trfego de rede entre o gerenciador de banco de dados e o TOTVS Application Server; Do mesmo modo, pode-se executar servidores remotamente, priorizando o processamento; As conexes devem ser efetuadas atravs do protocolo TCP-IP ; Pode-se criar conexes via Internet atravs da montagem de um Web Server na empresa ou atravs de provedores de acesso. Neste caso, o TOTVS Application Server pode ser executado no provedor ou na empresa utilizando uma LP para a conexo ao provedor de acesso; A Internet utilizada apenas como o meio de comunicao, ou seja, a conexo TCP-IP entre o TOTVS Smart Client e o TOTVS Application Server. Alm da segurana oferecida pelo sistema Srie 1 (First), a segurana deve ser oferecida pela conexo. Por isso, aconselhvel que o servidor Web no seja o mesmo servidor da base de dados;

Pode-se manter uma pgina para o download do TOTVS Smart Client, de modo que os usurios remotos possam efetuar o download para conectar-se e utilizar o sistema.

A definio da melhor topologia para execuo um passo importante da implementao da tecnologia TOTVSTec, pois influencia totalmente

Pgina 32

a performance. O maior trfego de rede est localizado entre o TOTVS Application Server e o Banco de Dados, j que o trfego entre o TOTVS Application Server e o TOTVS Smart Client contm somente informaes para montagem de telas e controle de teclado e mouse. Desta forma, dependendo do tipo e da velocidade da conexo, pode se tornar invivel manter um TOTVS Application Server em uma cidade conectado ao banco de dados em outra. Por outro lado, caso existam muitas conexes nesta outra cidade, ou caso estas conexes executem processamentos pesados, priorizar o processamento disponibilizando um TOTVS Application Server para ser executado localmente nesta cidade pode ser uma boa soluo.

9.2. Instalao do Srie 1 (First) em redes Netware Novell


Para a instalao do Srie 1 (First) em redes Novell Netware so necessrios alguns procedimentos especficos. Segue um roteiro para a instalao e configurao do sistema:

A partir de uma estao qualquer, faa a instalao do sistema em unidade de disco local; Na estao a partir da qual est sendo instalado o sistema, crie o mapeamento a ser utilizado pelo Srie 1 (First) (recomenda-se a criao de drive especfico para o sistema) Ex. I:; Na unidade rede, faa a cpia idntica da rvore de diretrios criada pela instalao no disco local; No diretrio SERIE1\BIN, edite o arquivo TotvsSmartClient.INI e, na seo TCP, coloque o parmetro Server igual a LocalHost. [TCP] TYPE=TCPIP Server=SERVIDOR Port=1010 [TCP] TYPE=TCPIP Server=LOCALHOST Port=1010

Acrescente na seo [CONFIG] do arquivo TotvsSmartClient.INI (localizado no diretrio SERIE1\BIN), o parmetro TWOTIER=1; No diretrio SERIE1\BIN, edite o arquivo TOTVSAPPSERVER.INI e, na seo Environment, troque a unidade de disco para direcionar o novo local.

Pgina 33

Exemplo:
[ENVIRONMENT] SourcePath=C:\ Arquivos de Programas\TOTVS\Serie1\APO RootPath=C:\ Arquivos de Programas\TOTVS\Serie1\ StartPath=\SYSTEM RpoDb=CTree RpoLanguage=Portuguese RpoVersion=101 LocalFiles=CTree [ENVIRONMENT] SourcePath=I:\SERIE1\APO RootPath=I:\SERIE1 StartPath=\SYSTEM RpoDb=CTree RpoLanguage=Portuguese RpoVersion=101 LocalFiles=CTree

Crie, em todas as estaes que utilizaro o sistema, um mapeamento idntico ao da estao que fez a instalao e cpia (A letra para definir a unidade tem que ser a mesma); Crie nas estaes, cone de acesso para o TotvsSmartClient.exe localizado no diretrio \BIN do sistema. Ex. I:\SERIE1\BIN\TotvsSmartClient.exe; Ateno ao executar este passo, pois erros implicaro em problemas no Registro do Windows. Teste o acesso do sistema nas estaes, caso tudo esteja funcionando corretamente e no seja necessria uma aplicao Srie 1 (First) para testes, desinstale o Srie 1 (First) do drive local;

O uso do Srie 1 (First) em redes Novell com a topologia acima exige uma modalidade Fat Client, ou seja, cada estao efetua seu processamento e o trfego de dados na rede cresce consideravelmente quando comparado s instalaes convencionais em redes NT.

Pgina 34

Pgina 35

10. Outros Aplicativos Instalados

10.1.

TOTVS Development Studio

O TOTVS Development Studio uma ferramenta de edio, compilao e depurao de erros. atravs do TOTVS Development Studio que os analistas do Srie 1 (First) e os usurios do Srie 1 (First) devem criar e manter suas rotinas especficas. O TOTVS Development Studio o nico modo de compilar os arquivos de programas em APOs para serem registrados no TOTVS Application Server. Como ferramenta de edio e depurao, engloba todos os recursos disponveis nas melhores ferramentas de desenvolvimento do mercado.

10.2.

TOTVS Monitor

O TOTVS Monitor utilizado para monitorar as conexes ao TOTVS Application Server. Atravs dele pode-se:

Verificar as conexes ativas; Enviar mensagens para uma ou mais conexes; Capturar a tela de uma conexo. A tela recebida como uma imagem no formato JPEG; Desabilitar novas conexes. Isto til quando se precisa efetuar alguma manuteno e se precisa evitar que outros usurios se conectem.

10.3.

SDU

uma ferramenta para manuteno de arquivos, com os seguintes recursos:


Interface Srie 1 (First); Utiliza os recursos de segurana do Srie 1 (First); Suporte ao banco de dados disponvel pelo Srie 1 (First).

Para acess-lo, deve-se digitar SDU, em Programa Inicial, do TOTVS Smart Client.

Pgina 36

11. Acessando o Srie 1 (First)


Durante a instalao criada a pasta "First" no menu Iniciar com as seguintes opes:

TOTVS Application Server - este o aplicativo que ser executado no Servidor, responsvel pela comunicao entre a estao de trabalho e o Servidor. TOTVS Smart Client - este o aplicativo que ser executado nas estaes de trabalho, responsvel pela interface do Srie 1 (First). TOTVS Monitor - este aplicativo permite monitorar as conexes ao sistema. TOTVS Development Studio - este aplicativo permite a customizao da Nota Fiscal da empresa.

Caso no a empresa no utilize ambiente de rede, estes aplicativos estaro localizados na mesma mquina.

Para acessar o Srie 1 (First): 1. No Servidor, acesse a opo "Serie1" do menu Iniciar e selecione a opo "TOTVS Application Server". O TOTVS Application Server ser carregado.

2. Clique no boto "Minimizar" para mant-lo ativo. 3. Agora, na estao de trabalho, acesse a opo "Serie1" do menu Iniciar e selecione a opo "TOTVS Smart Client". 4. Se o ambiente no estiver em rede, estes aplicativos devem ser carregados a partir do mesmo equipamento. A janela para identificao do usurio apresentada.

Pgina 37

Nesta janela solicitada a identificao do usurio. Atravs da senha possvel verificar quais procedimentos este usurio tem permisso de acesso. 5. No campo "Usurio", digite a identificao do usurio conforme definido na configurao de sua senha, respeitando as letras maisculas e minsculas. No primeiro acesso ao sistema, deve-se informar "Administrador". 6. No campo "Senha", digite a senha do usurio. No primeiro acesso ao sistema, a senha est configurada como vazia. Portanto, apenas clique neste campo. 7. No campo "Data-base", informe a data para gravao dos processamentos. O sistema apresenta a data atual do Ambiente Operacional. Esta data utilizada na gravao das movimentaes e apresentao nas consultas e relatrios. 8. Clique no boto "Entrar" para prosseguir. A janela principal do sistema somente ser carregada se o usurio estiver devidamente identificado.

Pgina 38

11.1.

Identificando sua Empresa


1. Ser necessrio entrar novamente no Srie 1 (First) e informar o nome da empresa na seguinte janela:

2. Aps ser informado o nome da empresa no campo Empresa e clicado no boto Confirmar, a janela de Autorizao da Empresa ser novamente acionada, no entanto, neste momento ser solicitado o caminho onde se encontra o arquivo de autorizao do cliente. Caso ainda no o possua, dever solicit-lo TOTVS.

Pgina 39

3. Aps ser informado o caminho no campo Arquivo de Autorizao do Cliente e clicado no boto Confirmar, o arquivo ser importado e consistido. Se o nome da Empresa for consistido com sucesso, o Srie 1 (First) ser executado normalmente. Caso no seja consistido com sucesso ser necessrio refazer o procedimento de identificao da empresa.

Pgina 40

4. Aps ser informado o caminho no campo Arquivo de Licena de Uso e clicado no boto Confirmar, o arquivo ser importado. Em seguida, ser acionada a seguinte mensagem:

5. O Srie 1 (First) ser fechado aps o boto Ok ser clicado.

11.2.

Consultando o Sistema de Ajuda

O sistema permite ao usurio acessar duas fontes de help por campos e por contexto. Os helps fornecem informaes quanto o objetivo e forma de processamento da rotina, e sobre o que deve ser preenchido em determinado campo.

Ajuda por contexto


O menu Ajuda apresentado, na janela principal, permite navegar pelo sistema completo de documentao.

Pgina 41

Para navegar na documentao: 1. No menu Ajuda, selecione a opo TOTVS Srie 1. Ser apresentada a janela principal da documentao on-line. 1. Clique sobre o menu desejado e selecione a opo de help para consulta.

Para obter informaes sobre a funo de cada rotina: Estando na janela de Manuteno de Dados, o usurio deve pressionar [F1] ou clicar no boto apresentado na parte superior das janelas de processamentos. A Ajuda apresenta informaes sobre o processamento em questo.

Para obter informaes sobre o preenchimento de um campo: Posicione o cursor sobre este e pressione [F1]. O sistema apresenta uma caixa de dilogo, informando o Cdigo Interno do Campo e Orientaes sobre seu preenchimento. Exemplo: B1_COD

Clicando sobre a palavra Ajuda, o sistema apresenta outras caractersticas tcnicas do campo, como:

Tipo - se (N)merico, (C)aracter, (L)gico, (D)ata ou (M)emo

Pgina 42

Tamanho- quantos dgitos podem ser informados no campo Decimais - quantidade de casas decimais, se numrico Funo - caso o campo possua uma funo exclusiva de preenchimento ou verificao, ser apresentado neste item Uso - se a utilizao do campo Livre (preenchimento no obrigatrio) ou Obrigatrio.

Para sair do help, clique fora de sua janela ou pressione [ESC].

Pgina 43

12. TOPConnect
O TOPConnect uma ferramenta de conectividade a bases de dados, permitindo que aplicativos acessem uma ampla variedade de servidores de banco de dados sem a necessidade de gerao de cdigos especficos para cada uma delas. Os bancos de dados hoje suportados pelo TOPConnect so:

Microsoft SQL7 ou superior Oracle 8 ou superior IBM Universal Database (DB2) Informix Postgres 7.1.1 ou superior MySQL

O TOPConnect permite gerenciar as informaes pertinentes utilizao do banco de dados, registrando e apresentado dados, como:

Dados estatsticos de forma grfica com relao : Quantidade de usurios conectados Quantidade de tabelas em utilizao IOs por segundo Mximo de IOs por segundo Relao dos usurios conectados Checagem das querys geradas pelos usurios conectados Quebra de conexo do usurio Mensagens de utilizao do TOPConnect Configuraes Gerais quanto a: Banco de dados em utilizao Relao de usurios e senhas por banco de dados Logins de usurio Configurao de Table Spaces para determinados bancos de dados Definio dos parmetros de criao de tabelas para determinados bancos de dados Validao de conexo, checando os parmetros de conexo com o banco de dados Monitoramento de ndices gerados

Pgina 44

12.1.

Conceito de Ambiente

Para o controle do TOPConnect, a cada um dos bancos de dados suportados deve-se definir o ambiente. O ambiente pode referir-se, por exemplo, a um ambiente real e a outro somente para testes. Neste caso, os dois ambientes devem ser identificados. A identificao do ambiente praticamente a mesma a todos os bancos, exceto para o Oracle, conforme tabela a seguir:
Banco Oracle Microsoft SQL Server IBM DB2 Informix Postgres MySQL O ambiente o nome do DSN ODBC. Ambiente O ambiente o nome de um alias do TNS Listener.

Dessa forma, para cada ambiente criado, deve-se identific-lo no campo respectivo, correspondente ao banco de dados utilizado. Exemplo: Definio de dois ambientes:

Produo Validao

Texto da configurao do arquivo TOTVSAPPSERVER.INI, com a ambiente Produo: [TOPConnect] Topdll=topapi40.dll DataBase=MSSQL7 Server=localhost ALIAS=PRODUCAO CONTYPE=NPIPE

Pgina 45

12.2.

Instalao do TOPConnect

O processo de instalao do TOPConnect bastante simples, realizado atravs de um CD de instalao. A instalao flexvel a dois ambientes distintos:

Ambiente Windows Ambiente Unix e Linux

Para cada ambiente, o processo de instalao diferenciado, no que ser refere s informaes bsicas de instalao do TOPConnect. Para a correta instalao e configurao do TOPConnect, o ideal que sejam realizados por um profissional capacitado, que conhea os bancos de dados mencionados, bem como servidores de instalao. Para maiores informaes, entre em contato com a TOTVS, e acione o Help Desk de acordo com seu contrato.

12.3.

Ambiente Windows

O ambiente de instalao Windows apresenta as etapas de configurao diferentes dos demais ambientes.

Para instalar o TOPConnect no ambiente Windows: 1. Execute o arquivo de instalao do TOPConnect: TOPCONNECT4.EXE. O sistema apresenta numa janela o progresso da fase inicial da instalao. 2. Na seqncia, solicitado a escolha do idioma utilizado pelo instalador, dentre as opes:

Espanhol Ingls Portugus (Brasil)

Pgina 46

3. Selecionado o idioma, clique no boto Ok. O instalador apresenta a tela do Install Shield Wizard, dando incio ao processo de instalao do TOPConnect.

4. A prxima tela apresenta uma mensagem de boas-vindas do instalador. Clique no boto Avanar para dar continuidade instalao.

Pgina 47

5. apresentada a tela para Escolha do local de destino, selecionando o diretrio para instalao do TOPConnect. Como padro, sugerido o caminho C:\Program Files\TOPConnect 4.0. Caso o caminho sugerido no seja o desejado, utilize o boto Procurar para selecionar o novo local.

Pgina 48

6. Selecionado o local de destino e clique no boto Avanar. A tela seguinte refere-se s pastas e atalhos que sero criados no sistema operacional, para acesso ao TOPConnect. Como padro, sugerida a pasta TOPConnect 4.0.

Pgina 49

7. Selecionada a pasta, clique no boto Avanar. Na seqncia o processo de descompactao e cpia dos arquivos iniciado, apresentando uma rgua do progresso de instalao.

Pgina 50

8. Completado 100% da instalao, a tela seguinte apresenta a mensagem sobre o fim da instalao.

Pgina 51

9. Clique no boto Concluir. recomendvel que, concluda a instalao, o sistema seja reiniciado.

12.4.

Ambiente Unix e Linux

O ambiente de instalao Linux e Unix apresenta as etapas de configurao diferentes do ambiente Windows. Para instalar o TOPConnect nos ambientes Unix e Linux: 1. Descompacte o arquivo de instalao no diretrio desejado.

Pgina 52