BINÁRIO

LOBO GUARÁ E A
RELEASE
12.1.23
PERGUNTAS E RESPOSTAS
ADEILTON PLÁCIDO JÚNIOR.
CONSULTOR PROTHEUS
CIENTISTA DA COMPUTAÇÃO
ESPECIALISTA EM BANCOS DE DADOS
WWW.SISTEMATIZEI.COM

BINÁRIO
LOBO GUARÁ E A
RELEASE
12.1.23
PERGUNTAS E RESPOSTAS
APRESENTAÇÃO
BINÁRIO
Se você chegou até aqui, sinta-se privilegiado, pois LOBO GUARÁ E A
“muitos querem o sucesso, contudo poucos buscam RELEASE

conhecimento”. 12.1.23

De antemão agradeço o interesse em receber este

material que foi disponibilizado de forma GRATUITA.
Tem intuito informativo/educacional, afim de que mais
pessoas conheçam o Protheus e suas novas
implementações.

Neste material, falamos sobre o Binário(AppServer)

Lobo Guará e a release 12.1.23, tópicos relacionados ao
software de Enterprise Resource Planning(ERP),
Protheus.

Pedimos respeito às imagens e textos contidos aqui,

não nos responsabilizamos pelo mal uso deste
material, tampouco pela aplicação do conteúdo
expressado nas páginas deste e-book.
O QUE É PROTHEUS
BINÁRIO
Um software que possui sua estrutura no formato de LOBO GUARÁ E A
Enterprise Resource Planning, em português Plano de RELEASE

Recurso Empresarial(ERP), o Protheus hoje está 12.1.23

incorporado à organizações de diversos tipos, tais como

agronegócio, logística, varejo, agricultura, educação,
saúde, construção civil além da área jurídica.

Até as empresas que não se encaixam nas categorias

citadas anteriormente, mas que precisam de um
software que “dê conta” da entrada do produto até a
saída (para as mãos do cliente), adquirem o sistema.

Para que o software se adeque às rotinas do dia a dia da

empresa, assim como aos seus processos, pode-se fazer
o que chamamos de customizações, modificações no
software permitidas pela plataforma Protheus, afim de
que o sistema atenda a empresa.
O QUE É BINÁRIO
BINÁRIO
O application server(AppServer) ou binário, é uma LOBO GUARÁ E A
aplicação intitulada “serviço” cuja função é fazer a RELEASE

conexão entre o usuário e o Protheus, através dele 12.1.23

também é possível configurar o repositório de fontes para

que eles sejam compilados no repositório correto.

Cada Appserver configurado traz consigo caminhos para

que os ambientes possam ser acessados pelos usuários.

Falaremos neste e-book sobre uma nova implementação

feita na arquitetura do Protheus, onde um novo appserver
foi lançado, este chama-se Lobo Guará.

Ao longo deste material você verá algumas

características específicas deste novo application
server. Detalhes sobre o que muda e o que continua,
após esta implementação.
O QUE É RELEASE
BINÁRIO
Liberação ou lançamento, uma release refere-se ao LOBO GUARÁ E A
lançamento de uma nova versão de um produto de RELEASE

software. 12.1.23

Existe um processo denominado ciclo de vida de

liberação de software, cuja definição está ligada ao fato
de que a cada momento que um produto de software é
criado e/ou modificado, os desenvolvedores responsáveis
pela distribuição decidem como distribuir este produto
ou esta modificação. Desta forma esta distribuição,
denomina-se release.
Vejamos o seguinte exemplo:
Protheus 11 → VERSÃO
11.7 | 11.8 → RELEASES
Protheus 12 → VERSÃO
12.1.7 | 12.1.17 | 12.1.1.23 → RELEASES

Já o patch, este tem como intuito atualizar o

software com pequenas partes que foram
mudadas. Podendo ser aplicado, inclusive, de
forma incremental.
 ARQUITETURA DO PROTHEUS
BINÁRIO
Abaixo trazemos uma imagem que mostra a arquitetura LOBO GUARÁ E A
do Protheus, como ele se comunica com o banco de RELEASE

dados e também, qual a função do appserver nesse 12.1.23

emaranhado de conexões.

Imagem que explica a Arquitetura do Protheus

Fonte: Construção própria para fins educacionais utilizando imagens aleatórias,
imagem do Banco de Dados Sql Server de propriedade da Microsoft.

Perceba que a função do appserver é justamente

fazer com que os usuários se conectem ao servidor de
aplicação, este que irá se conectar com o banco de
dados, através do DbAccess.
BINÁRIO LOBO GUARÁ
BINÁRIO
Há alguns meses nos círculos de diálogo dos analistas, LOBO GUARÁ E A
ouve-se falar muito deste animal de hábitos noturnos, o RELEASE

Lobo Guará. Mas espera aí, o que isso tem haver com o 12.1.23

propósito deste material?

Pois bem! Acontece que um novo binário foi lançado e

disponibilizado na nova release do Protheus. O AppServer
recebeu o nome de Lobo Guará, e foi estreado na release
12.1.23(que veremos a frente).

Este novo application server(servidor de aplicação)

promete uma melhor performance, oferecendo mais
escalabilidade além de estar equivalente com a evolução
da linguagem ADVPL, a (TL++).

Ao lado, uma imagem da pasta onde

fica armazenado o binário/AppServer.
RELEASE 12.1.23
BINÁRIO
Em fevereiro de 2019 foi lançada oficialmente a nova LOBO GUARÁ E A
release 12.1.23. Marcada pela possibilidade de ter o RELEASE

dicionário de dados no banco, o que antes eram arquivos 12.1.23

ctree(sx2, sx3, etc.).

Esta nova release promete uma melhor performance.

Estima-se que juntamente com o uso do binário Lobo
Guará, o ganho de velocidade seja até 30% em relação à
release 12.1.17.

Com ela também será possível a utilização de um lock

nativo do banco de dados, durante as transações. Visto
que o dicionário estará no banco, entende-se que o
controle de concorrência será feito de forma mais ágil e
rápida.
EXPIRAÇÕES E LANÇAMENTOS
DE RELEAES BINÁRIO
LOBO GUARÁ E A
Foi implementada uma agenda de releases semestrais, RELEASE
com manutenção por 18 meses. Desta forma a release 12.1.23
vigente 12.1.17 está com expiração prevista para
dezembro de 2019.

Já a 12.1.23, lançada em Fevereiro de 2019, está prevista

para expirar em Setembro de 2020.

Anunciada há alguns meses, a release 12.1.25, isso

mesmo! Uma nova release, e está com disponibilidade
partindo de Julho/2019, com expiração prevista para
Dezembro de 2020(três meses após a expiração da
12.1.23)

Até agora, é de conhecimento que duas outras releases

foram anunciadas, a 12.1.27(lançamento previsto
Janeiro/2020) e a 12.1.29 (lançamento previsto
Julho/2020).
BINÁRIO LOBO GUARÁ
BINÁRIO
Diante desta nova implementação, surgiram muitas LOBO GUARÁ E A
dúvidas e perguntas por parte de quem trabalha com RELEASE

Protheus. Dúvidas estas que espero serem sanadas com 12.1.23

este material.

No decorrer destas páginas, abordaremos algumas

perguntas e respostas, afim de que você possa se inteirar
de conhecimento sobre este novo binário.

1 – Posso usar o Lobo Guará na release 12.1.17?

Não! Não é possível misturar componentes das releases
12.1.17 com 12.1.23, pois o appserver + repositório de
objetos, só funcionam na mesma versão.

Sabe-se por hora, que a partir da release 12.1.23 o

uso do binário Lobo Guará, é obrigatório.
BINÁRIO LOBO GUARÁ
BINÁRIO
Um detalhe interessante e que é do interesse de muitos LOBO GUARÁ E A
analistas é o fato de que o dicionário de dados pode ir RELEASE

para o banco. Ou seja, as tabelas que controlam esta 12.1.23

parte do funcionamento do sistema não serão mais

controladas por arquivos ctree, por exemplo a
SX2(tabelas do banco) e SX3(campos das tabelas), como
também e os arquivos de menus(.XNU).

Com a migração citada no parágrafo anterior, estas

tabelas ficarão armazenadas no Sistema Gerenciador de
Banco de Dados(SGBD).

2 - Mas afinal de contas, o que vai para o banco de

dados?
• Metadados • Empresas
SXs SIGAMAT.emp
XX8
• Usuários XX9
SIGAPSS.spf
• Help
• Menus SIGAHLP
Todos os arquivos .XNU
(inclusive os customizados) • Perfis de usuários
Profile
BINÁRIO LOBO GUARÁ
BINÁRIO
Diante do conteúdo explanado na página anterior, LOBO GUARÁ E A
disponibilizamos mais duas perguntas que podem estar RELEASE

se passando na sua cabeça. 12.1.23

3 – Migrei a release 12.1.17 para 12.1.23, sou obrigado

à migrar o dicionário de dados?
Não! Acontece que essa migração apesar de estar
disponível, não é obrigatória. Nem na release 12.1.23,
tampouco na 12.1.25. Mas como já foi dito, a realização
deste procedimento pode aumentar a performance de
funcionamento do sistema.

4 – Caso eu queria migrar, posso migrar parcialmente?

Por exemplo, migrar os metadados(SX) e deixar os
menus como estão, via arquivos XNU.
Não! Neste caso não existe migração parcial de
dicionário de dados. Ou a migração é feita totalmente
ou não é feita.
BINÁRIO LOBO GUARÁ
BINÁRIO
Já que estamos falando do dicionário de dados e das LOBO GUARÁ E A
tabelas SX, falaremos sobre uma novidade relacionada ao RELEASE

controle de numeração. Que consiste na forma com que o 12.1.23

Protheus controla a sequência automática dos campos

nas tabelas.

Atualmente pode ser feito pelo License Server ou pelos

arquivos de tabela ctree SXE e SXF(tabelas que guardam
as sequências numéricas).

Abaixo, observe uma comparação entre os dois modos:

Gráfico explicativo comparativo

Fonte: http://tdn.totvs.com/pages/releaseview.action?pageId=309411140
BINÁRIO LOBO GUARÁ
BINÁRIO
Podemos ver na imagem uma comparação com as duas LOBO GUARÁ E A
formas de trabalho relacionadas ao controle de RELEASE

numeração. 12.1.23

Observa-se que quando utilizado o método das tabelas

SXE/SXF, a velocidade é 36 vezes maior do que pelo
License Server. E sabemos que quanto maior o tempo,
pior é o desempenho do processo.

5– Migrei a release 12.1.17 para 12.1.23, sou obrigado à

utilizar o controle de numeração via License Server?
Não! Porém é recomendado, visto que foi evidenciado
um ganho considerável na performance do processo.

6 – Para a release 12.1.25, o controle pode ser

feito pela SXE/SXF??
Não! Diferente da 12.1.23, na release 12.1.25 o uso
do controle de numeração via License Server é
obrigatório.
BINÁRIO LOBO GUARÁ
BINÁRIO
Desde o Protheus 12, a utilização do ctree ficou LOBO GUARÁ E A
obrigatória, as tabelas antes armazenadas nos arquivos RELEASE

.dbf, passaram à ser ctree(.dtc). Contudo ainda na release 12.1.23

12.1.17 é possível fazer algumas operações com o .dbf.

Sabe-se que é possível fazer append(anexar) de dados

utilizando este formato(.dbf). Bem como fazer uma cópia
dos registros e salvar neste formato de arquivo. Muitos
inclusive utilizam o software LibreOffice Calc, para editar
os arquivos .dbf.

Agora na release 12.1.23 as coisas mudaram, não utiliza-

se mais o arquivo .dbf.

7 – Posso utilizar .dbf na release 12.1.23?

Não! À partir da release 12.1.23 o formato .dbf
deixou de ser utilizado.
BINÁRIO LOBO GUARÁ
BINÁRIO
Existem empresas que ainda utilizam o dicionário de LOBO GUARÁ E A
dados em .dbf. RELEASE
12.1.23

7 – Se o meu dicionário é em .dbf, como farei para

migrar para a 12.1.23?
Desta forma o primeiro passo é migrar de .dbf para ctree,
e após isso migrar para a 12.1.23 ou 12.1.25. Mas fiquem
atentos, “.dbf não faz parte mais do cotidiano da 12.1.23”.

CODEANALYSIS – FERRAMENTA DE VARREDURA DE FONTES

Um detalhe muito importante relacionado à migração do
dicionário de dados para o SGBD, é o uso obrigatório de
uma ferramenta chamada CodeAnalysis.
8 – O que é e qual a função do CodeAnalysis?

Uma ferramenta capaz de analisar os fontes que

fazem parte do projeto de customizações da
empresa. Tem como intuito verificar os possíveis
bugs, assim como auxiliar na correção dos
pontos identificados.
BINÁRIO LOBO GUARÁ
BINÁRIO
Em um breve resumo, ele faz uma varredura em seus LOBO GUARÁ E A
fontes e por fim, emite um resultado que pode conter RELEASE

observações e/ou mudanças obrigatórias. 12.1.23

Após 100% dos bugs corrigidos, é feita uma solicitação de

chave para autorizar a migração.

9 – Chave para autorizar a migração, não entendi, o que

é essa chave?
Para que a migração ocorra, é necessário a utilização de
um token, esta autenticação acontece após a execução do
CodeAnalysis. Este token é enviado pelo suporte do
framework após a correção de 100% dos bugs apontados
pelo CodeAnalysis.

Sabe-se da importância da execução do

CodeAnalysis, pode ajudar muito no tocante às
customizações. Pois irá garantir que os códigos
estejam em conformidade com as boas práticas de
desenvolvimento, assim como para garantir a
integridade do sistema.
 BINÁRIO LOBO GUARÁ
BINÁRIO
A necessidade da execução do CodeAnalysis pode ser LOBO GUARÁ E A
RELEASE
facilmente explicada quando mensuramos os impactos de 12.1.23

ter o dicionário no banco de dados, por exemplo, se antes

era possível fazer um comando DbSeek nas tabelas SX1,

ou mesmo um RecLock, como no exemplo abaixo:

Função responsável por criar registro na tabela SX1 de perguntas.

Após a migração não será mais possível. Estas e outras

situações semelhantes, como a criação de Consultas
Padrão(SXB) deverão ser feitas via Configurador.
BINÁRIO LOBO GUARÁ
BINÁRIO
Pare por um instante e pense nos seus fontes, será que LOBO GUARÁ E A
você tem alguma customização que contenha trechos RELEASE

semelhantes aos da imagem na página anterior? Se sim, 12.1.23

e se você está pensando em migrar o dicionário para o

banco, terá que fazer esta varredura via CodeAnalysis, e
realizar todos os ajustes apontados.

10 – Mas e se eu não migrar o dicionário para o banco,

sou obrigado à executar o CodeAnalysis mesmo assim?
Não! Esta execução só é obrigatória para quem desejar
levar o dicionário de dados para o banco.

Por fim, vale ressaltar que para cada tipo de bug

encontrado via CodeAnalysis, existe uma documentação
específica que orienta o analista/consultor a reparar
o código afim de resolver o empecilho.
BINÁRIO LOBO GUARÁ
BINÁRIO
TL++ A EVOLUÇÃO DA LINGUAGEM ADVPL LOBO GUARÁ E A
Uma novidade que surgiu com o lançamento do binário RELEASE

Lobo Guará foi a linguagem TL++, esta que é a evolução 12.1.23

do ADVPL, usado para construção de fontes(.prw) no

Protheus.

Esta nova implementação veio acompanhada de muitas

novidades, como por exemplo o aumento de caracteres
para criação de variáveis. Isso mesmo! Agora com a TL++
é possível criar uma variável com mais de 10 caracteres, e
que possa ser lida sem conflitos.

11 – Ah que legal! Então eu posso utilizar esta linguagem

na release 12.1.17?

Não! A TL++ só está disponível para o binário Lobo

Guará, sendo assim, como ele só é utilizado a partir da
12.1.23, vale o mesmo para a utilização da TL++.
BINÁRIO LOBO GUARÁ
BINÁRIO
TL++ A EVOLUÇÃO DA LINGUAGEM ADVPL LOBO GUARÁ E A
12 – Mas e o que eu fiz em ADVPL, está perdido? RELEASE

Não! Os fontes construídos em ADVPL são compatíveis 12.1.23

com a TL++, as duas linguagens se conversam.

O legado da linguagem será mantido, sendo assim todas

as suas implementações feitas em ADVPL, serão válidas
na TL++.

Recursos como nomes longos são novidades citadas nesta

nova linguagem. Por exemplo, em ADVPL devemos
respeitar o limite de 10 caracteres na construção de
variáveis.

Se você declarar uma variável chamada nNumero123

e logo em seguida declarar outra chamada
nNumero1234, esta será lida no lugar daquela, pois o
ADVPL interpreta somente o nNumero123, visto que
em ADVPL, uma variável não pode ter mais que 10
caracteres na sua composição do nome.
BINÁRIO LOBO GUARÁ
BINÁRIO
TL++ A EVOLUÇÃO DA LINGUAGEM ADVPL LOBO GUARÁ E A
Veja o exemplo abaixo: RELEASE

#Include ‘Protheus.ch' 12.1.23

Local nNumero123 := 100

Local nNumero1234 := 999

MsgInfo("Valor: " + cValToChar(nNumero123) ,"Atenção!")

Return

Conclusão:
Note que mesmo chamando a variável nNumero123,
que recebe o valor 100, o valor exibido é 999, isto
porque só foram interpretados os 10 primeiros dígitos
da variável nNumero1234, sendo assim ele atribuiu o
valor 999 à variável nNumero123, que era 100 e
passou à receber 999.
AGRADECIMENTOS
BINÁRIO
Agradeço a Deus pelo dom da vida, assim como à você LOBO GUARÁ E A
que se interessou por este material, feito com muito zelo RELEASE

e distribuído GRATUITAMENTE afim de que possa 12.1.23

contribuir com o seu aprendizado, bem como com a sua

carreira.

Não somos os donos da verdade, desta forma se você

tem alguma contribuição à ser feita para que este
material fique melhor, envie a sua opinião por e-mail, que
iremos avaliar com muito carinho e gratidão.

Espero que este e-book tenha mudado sua vida, assim

como aprender Protheus mudou a minha, nosso intuito é
distribuir conhecimento, pois acreditamos que este pode
mudar a vida das pessoas, para melhor.
REFERÊNCIAS
BINÁRIO
• Webinar Porque migrar para a 12.1.23 realizado em LOBO GUARÁ E A
05/06/2019. RELEASE
• http://www.jjconsulting.com.br/o-que-e-o-protheus/ 12.1.23
• https://blog.vindi.com.br/totvs-protheus-como-
funciona/
• https://pt.wikipedia.org/wiki/Ciclo_de_vida_de_libera
%C3%A7%C3%A3o_de_software
• http://tdn.totvs.com/display/framework/Microsiga+Pr
otheus
• http://tdn.totvs.com/pages/viewpage.action?pageId=
6064442
• http://tdn.totvs.com/display/tec/Application+Server
• https://centraldeatendimento.totvs.com/hc/pt-
br/articles/360010698491-Novo-Bin%C3%A1rio-
AppServer-Lobo-Guar%C3%A1-
• http://tdn.totvs.com/display/tec/Nomes+longos
• http://tdn.totvs.com/pages/releaseview.action?pageId
=360450442
• http://tdn.totvs.com/pages/releaseview.action?pageI
d=309411140
• http://tdn.totvs.com/display/framework/TOTVS+Cod
eAnalysis

Imagem Lobo Guará

• https://br.pinterest.com/pin/87116574025296974/
EXTRAS
BINÁRIO
• Se inscreva em nosso canal do Youtube, Sistematizei LOBO GUARÁ E A
Vídeo com o resumo do Webinar RELEASE
12.1.23

Vídeo sobre a Arquitetura do Protheus