Você está na página 1de 28

26/09/2019 DBVenda -

Código-fonte
Manual de Orientação ao
Desenvolvedor Delphi.

Versão 1.6 -
setembro/2019

Adriano Zanini
ANALISTA DE SISTEMAS
DBVenda - Código-fonte

[ATENÇÃO - ATENÇÃO - ATENÇÃO - ATENÇÃO – ATENÇÃO]


Leia este manual na integra. Fiz com toda atenção para te ajudar.
Tem ocorrido de alguns desses programadores me pedirem ajuda para
pontos que estão aqui no manual (chega ser abusivo). Ou seja, fica nítido
que não leu este manual.

Se você precisar de ajuda, conte comigo. Mas somente para


orientações que não constem neste manual.

DESEJO BOM TRABALHO.

Linguagem/DB:

Delphi 10.3 Rio (ou superior) - 32 bits

Firebird 2.5 – 32 bits

www.altaica.com.br | dbvenda@altaica.com.br
2
DBVenda - Código-fonte

Sumário
Objetivo do manual ....................................................................................................................... 4
Delphi - Banco de dados - Outros requisitos................................................................................. 5
Configurações pré-definidas. ........................................................................................................ 6
Drive e diretório padrão ............................................................................................................ 6
Download do código-fonte ........................................................................................................... 7
Codigo-fonte do “DBVenda” e “DBVendaPDV” ........................................................................ 7
Senha de descompactação .................................................................................................... 7
Download dos componentes necessários ................................................................................. 7
Instalando componentes............................................................................................................... 8
Utilizando o “Migration Tool” ................................................................................................... 8
Grupo de Componentes .......................................................................................................... 11
Instaladores externos (componentes). ................................................................................... 13
Instalar QuickReport ........................................................................................................... 13
Instalar DevExpress ............................................................................................................. 16
Instalar ACBr ........................................................................................................................ 17
Lista de componentes instalados ............................................................................................ 21
Compilando DBVenda (Retaguarda) ....................................................................................... 22
Compilando DBVendaPDV (Frente de Caixa) .......................................................................... 24
Cobrança à parte ......................................................................................................................... 26
Sobre Delphi® - Community Edition ............................................................................................ 27
Autoria do código-fonte .............................................................................................................. 28

Leia este manual na integra e siga com


atenção. Pois se solicitar ajuda para o que já
está aqui no manual, vou cobrar à parte.

www.altaica.com.br | dbvenda@altaica.com.br
3
DBVenda - Código-fonte

Objetivo do manual

Prezado(a) Programador(a), objetivo deste manual não é ensinar usar o DBVenda e/ou
DBVendaPDV(NFC-e/SAT). Apenas ensinar como instalar os componentes necessários. E
configurar seu ambiente de trabalho.

Tudo foi realizado no “Windows 10 Pro 64 bits” (também poderia ser qualquer outro
Windows 64 bits). Instalei Delphi 10.3 Rio (Community Edition) 32 bits. Segui cada etapa deste
manual (que eu mesmo fiz) e tudo correu perfeitamente bem. Ou seja, eu garanto que funciona.
Fiz isso para que você Programador(a) tenha êxito com este manual.

[ATENÇÃO - ATENÇÃO - ATENÇÃO - ATENÇÃO – ATENÇÃO]

POR FAVOR, SE ALGO NÃO FUNCIONAR E DER ERRO NA COMPILAÇÃO, REVEJA O


MANUAL. É TUDO QUESTÃO DE ATENÇÃO. PORTANTO, TENHA ATENÇÃO.

www.altaica.com.br | dbvenda@altaica.com.br
4
DBVenda - Código-fonte

Delphi - Banco de dados - Outros requisitos

• Utilizar Delphi 10.3 Rio. Utilize também para 32 bit.


Não tente compilar em versões inferiores ao Delphi 10.3 Rio. Não terá sucesso nessa tentativa.

• Banco dados DEVE ser o Firebird 2.5. Utilize também para 32 bit.
Se quiser utilizar versão superior, utilize os scripts (para recriar uma base do zero):
“dbvenda_estrutura.sql” – DBVenda - Retaguarda.
“dbvendapdv_estrutura.sql” – DBVendaPDV – Frente de Caixa.

• NÃO instale o FastReport que acompanha o Delphi.


Essa versão que acompanha o instalador do Delphi é muito básica e suscetível a falhas.

[ATENÇÃO - ATENÇÃO - ATENÇÃO - ATENÇÃO – ATENÇÃO]


Baixe o DBVenda, e instale no seu computador. É necessário para criar toda estrutura de pastas
necessárias, para que você possa desenvolver e testar.

www.altaica.com.br | dbvenda@altaica.com.br
5
DBVenda - Código-fonte

Configurações pré-definidas.

Drive e diretório padrão

Vamos padronizar, para facilitar o trabalho de configuração deste manual. E deverá conter o
seguinte endereço: “C:\projetos\componentes”
1. No seu Explorer (de arquivos), vá em C:\
▪ Crie uma pasta chamada: Projetos
▪ Crie uma subpasta dentro de “Projetos” chamada Componentes

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
6
DBVenda - Código-fonte

Download do código-fonte

Codigo-fonte do “DBVenda” e “DBVendaPDV”

1. Acesse site: www.altaica.com.br


▪ Clique em “Download”
▪ Faça download do código-fonte “DBVenda”.
▪ Salve preferencialmente dentro de “C:\Projetos”

[como está na tela]

Senha de descompactação
▪ Senha DBVenda/NF-e: Somente após confirmação de pagamento.
(se você já pagou foi enviada pra você no seu e-mail ou Whatsapp)

▪ Senha DBVendaPDV /NFC-e/SAT: Somente após confirmação de pagamento.


(se você já pagou foi enviada pra você no seu e-mail ou Whatsapp)

Download dos componentes necessários


O link indicando local de download dos componentes está no arquivo “Link_Componentes.txt”.
Está na pasta:

▪ “C:\projetos\Sistemas\DBVenda\Projeto”
▪ Ou “C:\projetos\Sistemas\FrenteCaixa\Projeto”.
▪ Faça o download (está no arquivo “Link_Componentes.txt”)
▪ Salve na pasta “C:\Projetos”

www.altaica.com.br | dbvenda@altaica.com.br
7
DBVenda - Código-fonte

Instalando componentes
Utilizando o “Migration Tool”

Poucos sabem disso, o Delphi tem uma ferramenta chamada “Migration Tool”. Que
Exporta/Importa configuração do Delphi. Resumindo, com o “Migration Tool” vamos mapear
no Delphi (“Library Path”) o endereço (pasta) de cada componente.

1. Procure no Windows por Migration Tool.


Dica (Delphi 10.3 Rio): "C:\Program Files (x86)\Embarcadero\Studio\20.0\bin\migrationtool.exe"

2. Execute o “Migration Tool”.

3. Clique na opção “Import settings from a migration file” e clique no botão ao lado [...].

4. Abra o arquivo “LibraryPath.idesettings” (é um XML de configurações).

Caminho: “C:\Projetos\componentes\LibraryPath.idesettings”

[como está na tela]

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
8
DBVenda - Código-fonte

5. Clique em “Next>>”

6. Em “Select settings to import” deixe marcado “Win32” e clique em “Next>>”.

[como está na tela]

7. Selecione “Rad Studio 10.3”, em “select product version to import (…)”. E após clique
em “Finish”.

www.altaica.com.br | dbvenda@altaica.com.br
9
DBVenda - Código-fonte

[como está na tela]

8. Após clique em “Finish” aparecerá essa tela. Clique em “Close”.

[como está na tela]

Pronto. Com essas configurações realizadas a “Library Path” está configurada com as
pastas necessárias. Próximo passo instalar componentes.

www.altaica.com.br | dbvenda@altaica.com.br
10
DBVenda - Código-fonte

Grupo de Componentes
1. Com seu Delphi Rio (10.3) aberto, abra o grupo de projeto “ComponentesDBVenda.groupproj”,
fica em “C:\projetos\componentes”

[como está na tela]

2. Após abrir, clique com botão direito do mouse sobre o grupo de projetos, e selecione a opção
“Build All”.

Dica: “Build All” força a uma [re]compilação completa e assim evitamos erros futuros.

[como está na tela]

E aguarde a compilação completa, ao final aparecerá uma tela de conclusão. Não ocorrerá
qualquer erro.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
11
DBVenda - Código-fonte

3. Após a compilação (usando “Build All”) vamos instalar os componentes visuais.


Selecione todos itens da lista que tem ícone indica ser um VCL (Visual Component
Library). E clique em “Install”.

[como está na tela]

4. Aguarde a instalação. Ao concluir não deverá aparecerá qualquer mensagem (indica


sucesso na instalação). Os ícones mudarão a cor.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
12
DBVenda - Código-fonte

Instaladores externos (componentes).


Feche o Delphi (nesse processo o Delphi não pode estar em execução). Nesse processo
vamos instalar QuickRepor, DevExpress e ACBr

Instalar QuickReport
1. Vá em “C:\projetos\componentes\QR6DXE10_3_Rio_W64_installer”, execute
“QR6DXE10_3_Rio_W64_installer.exe”.

[como está na tela]

2. Nessa tela “Select Languages”, selecione “Delphi”.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
13
DBVenda - Código-fonte

3. Selecione “Win32 only” (lembre-se, estamos usando Delphi 32 bit) .

[como está na tela]

4. Clique em “I Accept” (eu aceito). E clique em “Next”.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
14
DBVenda - Código-fonte

5. Não precisa alterar. Clique em “Next”. Próxima tela clique em “Install”.

[como está na tela]

6. Clique em “Finish”. Instalação está concluída.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
15
DBVenda - Código-fonte

Instalar DevExpress
1. Vá em “C:\projetos\componentes\DevExpress_VCL_18.2.1_for_Delphi_10.3_Rio”.
2. Execute (ATENÇÃO) o aplicativo “DxAutoInstaller2.1.11.exe” como “administrador”
(usando botão direito do mouse sobre o aplicativo).

[como está na tela]

3. Clique no botão (indicado na seta vermelha), vai solicitar uma pasta.


▪ Informe “C:\projetos\componentes\DevExpress_VCL_18.2.1_for_Delphi_10.3_Rio”.
▪ Por padrão cada checkbox já vem selecionado (não precisei marcar nada).
▪ Clique em “Install”.

(em um computador desktop Core i5 – 16 GB de RAM levou 3 minutos)

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
16
DBVenda - Código-fonte

4. Aguarde a instalação
▪ Após terminar clique em “Close”.
▪ Feche a tela de instalação clicando em “Exit” (ou “X” da tela)

[como está na tela]

Instalar ACBr
Você terá que fazer download do ACBr utilizando o Tortoise SVN. Nesse manual não
ensinarei como fazer download dos componentes ACBr. Porém, caso não saiba como fazer, há
no Youtube um excelente vídeo (não é autoria minha) de um colega desenvolvedor que ensina
como fazer download.
Titulo: " Delphi - Instalar o pacote de componentes ACBR"
Link: " youtube.com/watch?v=InekwPJLo_E "
Após baixar o ACBr na pasta “C:\Projetos” na subpasta ACBr (como está na imagem abaixo):
1. Vá em “C:\projetos\componentes\ACBr”.
▪ Execute (ATENÇÃO) o aplicativo “ACBrInstall_Trunk2.exe” como “administrador” (usando
botão direito do mouse sobre o aplicativo).
▪ Após executar, clique em “Proximo”.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
17
DBVenda - Código-fonte

2. No campo Diretorio onde será instalado, informe “C:\projetos\componentes\ACBr”.


▪ Deixe tudo (EXATAMENTE) como está nessa tela.
▪ Após executar, clique em “Proximo”

[como está na tela]

3. Selecione todos componentes clicando no botão (seta vermelha).


▪ Após executar, clique em “Proximo”

www.altaica.com.br | dbvenda@altaica.com.br
18
DBVenda - Código-fonte

[como está na tela]

4. Clique em “Proximo”.

[como está na tela]

5. Clique em “Instalar”.
▪ Aguarde a instalação.

www.altaica.com.br | dbvenda@altaica.com.br
19
DBVenda - Código-fonte

[como está na tela]

6. A instalação deverá ocorrer com sucesso.


▪ Clique em “OK”.
▪ Clique em “Próximo”.
▪ Clique em “Finalizar” (irá fechar o instalador).

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
20
DBVenda - Código-fonte

7. Clique em “Finalizar” (irá fechar o instalador).

[como está na tela]

Lista de componentes instalados

Seguindo cada procedimento para instalação dos componentes, você terá instalado até aqui e
com êxito, todos os componentes necessários. E assim compilará o código-fonte 100%. Sem
erros.

• ACBr - Conjunto de componentes operacionais e fiscais.

• DevExpress - Conjunto de componentes VCL

• FastReport - Conjunto de componentes para relatórios

• QuickReport - Conjunto de componentes para relatórios


(Nas primeiras versões desse sistema era tudo em QuickReport. Não migrei tudo pra FastReport)

• Fortes Report - Conjunto de componentes para relatórios


(Há uma incompatibilidade entre ACBr e FastReport. Uso unicamente para emitir DANFE)

• EditDialog - Componente DBEdit com pesquisa em tempo real.

• AZButtonEdit - Componente DBEdit com pesquisa em tempo real.


(posteriormente substituirá por completo o “EditDialog”).

www.altaica.com.br | dbvenda@altaica.com.br
21
DBVenda - Código-fonte

Compilando o projeto (código-fonte)

Abra o seu Delphi 10.3 Rio (ou superior).

Compilando DBVenda (Retaguarda)


1. Abra o projeto “DBVenda.dpr” (NF-e | Retaguarda do Frente de Caixa)
▪ Pode estar em outra pasta com outro nome. Aqui é um mero padrão de exemplo.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
22
DBVenda - Código-fonte

2. Compilar o projeto DBVenda.


▪ Vamos fazer uma [re]compilação completa “Shift + F9”.
▪ Ou vá no menu “Project” → “Build DBVenda Shift+F9”.

[como está na tela]

3. DBVenda compilou 100%. Sem erro.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
23
DBVenda - Código-fonte

Compilando DBVendaPDV (Frente de Caixa)


1. Abra o projeto “DBVendaPDV.dpr”
▪ Pode estar em outra pasta com outro nome. Aqui é um mero padrão de
exemplo.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
24
DBVenda - Código-fonte

2. Compilar o projeto “DBVendaPDV” (Frente de Caixa | NFC-e / SAT / PDV).


▪ Vamos fazer uma [re]compilação completa “Shift + F9”.
▪ Ou vá no menu “Project” → “Build DBVendaPDV Shift+F9”.

[como está na tela]

3. DBVendaPDV compilou 100%. Sem erro.

[como está na tela]

www.altaica.com.br | dbvenda@altaica.com.br
25
DBVenda - Código-fonte

Cobrança à parte

Caso queira que eu faça a instalação (por acesso remoto) cobro R$


90,00 a parte. E apenas para instalar/configurar os componentes e deixar o
código-fonte compilando com êxito.

DESEJO SUCESSO E BOM TRABALHO.

www.altaica.com.br | dbvenda@altaica.com.br
26
DBVenda - Código-fonte

Sobre Delphi® - Community Edition


Utilize um Delphi original (e registrado). A licença é gratuita e vale por 12 meses. Poderá renovar
por mais 12 meses gratuitamente. Assim você não precisa usar Delphi pirateado. E assim sucessivamente
nos anos seguintes. Serial do instalador será enviado no seu e-mail. Eu tenho recomendado a todos que
utilizem Delphi CE (Community Edition). Eu mesmo utilizo essa versão (não sou empresa e sou
desenvolvedor autônomo). Versão que me atende muito bem.

O link (sem aspas) para cadastro e download do Delphi CE é esse (link testado em 26/09/2019):
“ www.embarcadero.com/br/products/delphi/starter/free-download ”

NÃO AUXÍLIO EM INSTALAÇÃO DE DELPHI.

[tela de cadastro é bem simples]

www.altaica.com.br | dbvenda@altaica.com.br
27
DBVenda - Código-fonte

Autoria do código-fonte

Eu Adriano Zanini, sou autor/desenvolvedor. Não autorizei e não autorizo outras

pessoas a vender meu código-fonte. Você poderá modificar o que desejar, mudar aparência, dar

outro nome, etc. Porém, como já comentado, o código-fonte fica somente para você (ou sua

empresa).

▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
▓▓ SISTEMA...............: DBVenda Retaguarda / Frente de Caixa ▓▓
▓▓ PORTE DE EMPRESA......: Para micro e pequena empresa ▓▓
▓▓ SEGMENTO..............: Comércio em geral que emita Vendas/NF-e/NFC-e/SAT ▓▓
▓▓ LINGUAGEM/DB..........: Delphi 10.3 Rio (32 bits) | Firebird 2.5 (32 bits) ▓▓
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▓▓ DATA..................: 26/09/2019 ▓▓
▓▓ AUTOR/PROGRAMADOR.....: Adriano Zanini (2019) ▓▓
▓▓ E-MAIL................: dbvenda@altaica.com.br ▓▓
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▓▓ Você não pode comercializar o codigo-fonte. Nem mesmo parcialmente! ▓▓
▓▓ Comercialize somente o sistema compilado (com o nome/interface que desejar). ▓▓
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
▓▓ ▓▓
▓▓ NÃO FAREI ALTERAÇÕES/CUSTOMIZAÇÕES. É POR SUA CONTA. ▓▓
▓▓ ▓▓
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

www.altaica.com.br | dbvenda@altaica.com.br
28