Hoje vou mostrar as principais bibliotecas usadas em AdvPL, os famosos arquivos ch.
Recentemente, um dos meus alunos perguntou sobre os principais arquivos .ch, e se deve usar o arquivo TOTVS.ch ou o Protheus.ch.
A biblioteca TOTVS.ch, dentro dela é carregado a arquitetura de outras bibliotecas essenciais para o funcionamento do programa, sendo que em raríssimos casos nós precisamos adicionar ou alterar outras bibliotecas.
Mesmo assim, desde 2011 (quando comecei a trabalhar com o Protheus), elenquei as includes mais utilizadas dentro dos fontes customizados dos projetos que participei:
- Ap5Mail.ch – Antiga biblioteca para disparo de e-Mail, hoje não é necessário mais usá-la, basta utilizar a biblioteca TOTVS.ch e a classe TMailMessage()
- ApWebSrv.ch – Biblioteca para utilização com WebServices
- ApWizard.ch – Antiga biblioteca para criação de telas no formato Wizard, hoje não é necessário mais usá-la, basta utilizar a biblioteca TOTVS.ch e a classe FWWizardControl()
- Colors.ch – Biblioteca com várias cores pré definidas em constantes (como CLR_HRED, CLR_HBLUE, etc), porém hoje não é tão mais usual, pode-se substituir pela função RGB()
- FWMVCDef.ch – Biblioteca com constantes e recursos para criação de fontes em MVC
- FWPrintSetup.ch – Biblioteca com constantes e recursos para criação de relatórios gráficos, como a classe FWMSPrinter()
- FileIO.ch – Antiga biblioteca para controlar input e output de arquivos, hoje não é mais necessário usá-la, basta utilizar a biblioteca TOTVS.ch e as classes FWFileWriter() e FWFileReader()
- Font.ch – Antiga biblioteca com tipos comuns de fontes, hoje não é mais necessário usá-la, basta utilizar biblioteca TOTVS.ch e a classe TFont()
- ParmType.ch – Antiga biblioteca para tipagem de parâmetros vindo em funções, hoje não é mais necessário, basta utilizar a biblioteca TOTVS.ch junto com prefixo Default ao receber um parâmetro
- PonCalen.ch – Biblioteca com conteúdos relacionados ao Ponto Eletrônico
- Protheus.ch – Antiga biblioteca padrão do Protheus, deve-se utilizar por padrão a TOTVS.ch
- RPTDef.ch – Biblioteca com alguns recursos para relatórios do Protheus
- RWMake.ch – Antiga biblioteca que possui recursos para montagens da tela, ela antecede a Protheus.ch, então deve-se utilizar a TOTVS.ch
- TOTVS.ch – Biblioteca padrão para as customizações
- TbiCode.ch – Biblioteca usada geralmente para fazer integrações entre sistemas, usada juntamente com TbiConn.ch
- TbiConn.ch – Biblioteca usada geralmente para fazer integrações entre sistemas, usada juntamente com TbiCode.ch
- TopConn.ch – Biblioteca com funções e recursos para usar com conexões via Top Connect (como a famosa TCQuery)
- XMLxFun.ch – Biblioteca com recursos para integração com arquivos XML, como por exemplo a função XMLDelNode()
Além dessas citadas acima, existem as bibliotecas específicas de relatórios, por exemplo, supondo que exista o relatório MATR000.prx, provavelmente existirá o arquivo MATR000.ch e dentro dele palavras em português, inglês e em espanhol.
Para quem quiser saber mais sobre utilizar RWMake.ch ou Protheus.ch ou TOTVS.ch: https://tdn.totvs.com/display/public/PROT/ADV0100_CH_TOTVS_RDMAKE_PROTHEUS
E você, se lembra de mais alguma outra biblioteca que eu esqueci de citar no artigo? Deixe nos comentários.
Bom pessoal, por hoje é só.
Abraços e até a próxima.
cara, eu tive um problema, o meu tem erro na .ch, acho q nao tenho a biblioteca mais, pode me ajudar
Bom dia Pedro, tudo joia?
Se possível, poste a mensagem de erro que foi exibida.
Tenha um ótimo e abençoado sábado.
Um grande abraço.