Hoje quero falar das principais Includes usadas para criação de programas em AdvPL, os famosos arquivos *.ch.
Um dia destes me perguntaram quais são as principais Includes, que se deve usar no desenvolvimento de um programa em AdvPL. E a minha resposta foi: depende do que se está desenvolvendo!
Então precisamos entender bem a usabilidade de cada Include. Por exemplo, a Include a TOTVS.ch é muito utilizada atualmente, porque já carrega dentro de sua arquitetura as outras Includes essenciais para o funcionamento de um programa, sendo que em raríssimos casos precisamos adicionar outras Includes.
E agora falando sobre o meu dia a dia como desenvolvedor AdvPL, a experiências adquirida em projetos que atuo e já atuei as includes que indico dependendo o tipo de projetos são;
- Ap5Mail.ch – Include utilizada antigamente para disparo de e-Mail, não sendo mais necessária no dias de hoje, bastando utilizar a Include TOTVS.ch e a classe TMailMessage()
- ApWebSrv.ch – Include utilizada para a chamada de WebServices
- ApWizard.ch – Include utilizada na criação de telas no formato Wizard, não sendo mais necessário o uso, se utilizado a Include TOTVS.ch e a classe FWWizardControl()
- Colors.ch – Esta Include possui cores pré definidas em constantes (como CLR_HRED, CLR_HBLUE, etc), porém acredito ser mais fácil o uso da função RGB().
- FWMVCDef.ch – Include repleta de recursos e constantes para criação de fontes em MVC
- FWPrintSetup.ch – Include prove recursos e constantes para criação de relatórios gráficos, utilizando a classe FWMSPrinter()
- FileIO.ch – Include utilizada para controlar input e output de arquivos, atualmente não sendo necessário o uso, se utilizar a Include TOTVS.ch e as classes FWFileWriter() e FWFileReader()
- Font.ch – Include de fontes, mas se fizer uso na Include TOTVS.ch e a classe TFont(), terá um resultado muito melhor.
- ParmType.ch – Include utilizada para tipagem de parâmetros vindo em funções, que atualmente pode ser substituído pelo uso da Include TOTVS.ch juntamente com prefixo Default ao se receber um parâmetro
- PonCalen.ch – Include relacionada ao Ponto Eletrônico
- Protheus.ch – Include padrão do Protheus, devendo se utilizar como padrão a TOTVS.ch
- RPTDef.ch – Include disponibiliza alguns recursos para relatórios do Protheus
- RWMake.ch – Include possui recursos para montagens da tela, a mesma antecede a Protheus.ch, mas atualmente deve-se utilizar a TOTVS.ch
- TOTVS.ch – Include padrão para as customizações
- TbiCode.ch – Include comumente usada para fazer integrações entre sistemas, juntamente com TbiConn.ch
- TbiConn.ch – Include comumente usada para fazer integrações entre sistemas, juntamente com TbiCode.ch
- TopConn.ch – Include mantem recursos e funções para uso de conexões via Top Connect (como a tão utilizada TCQuery())
- XMLxFun.ch – Include com recursos para integração com arquivos XML, exemplo a função XMLDelNode()
Não posso deixar de citar também as Includes específicas, como as de relatórios, um exemplo podemos supor a existência da rotina de relatório FINR000.prx que provavelmente existirá o arquivo FINR000.ch, contendo palavras (constantes) em português, inglês e espanhol.
Caso você queira saber um pouco mais sobre como utilizar as Includes RWMake.ch ou Protheus.ch ou TOTVS.ch, acesse o link abaixo:
TDN-TOTVS – ADV0100_CH_TOTVS_RDMAKE_PROTHEUS
Terminal de Informação (Um vasto conteúdo sobre ADVPL, site que utilizado como inspiração de alguns conteúdos)
Turma é isto, e espero ter contribuído de alguma forma, até a próxima!
