fbpx

ADVPL | O que é User Function e Static Function No TOTVS Protheus?

ADVPL | O que é User Function e Static Function No TOTVS Protheus?

Está em busca de aprender as principais functions, ou funções, de forma rápida e prática na versão mais recente do sistema de ERP TOTVS Protheus?

Então esse conteúdo é para você, acompanhe nossa aula sobre linguagem ADVPL do TOTVS Protheus.

Nesta aula você vai aprender as principais funções na hora de criar um fonte customizado no TOTVS Protheus e vamos explicar o que são e o funcionamento de cada uma delas, clique no vídeo e assista agora mesmo.

Está sem tempo para assistir o vídeo, então acompanhe o nosso resumo logo abaixo:

Entendendo as Static Functions e User Functions

O comando function permite que o usuário crie a programação e chame as informações. Em um comando function, os parâmetros são pré definidos pela TOTVS Protheus.

As funções são normalmente utilizadas para conter um bloco de instruções que, uma vez processado, fornece um valor como resultado. Este valor pode ser utilizado em expressões nas quais a função pode ser diretamente incluída

A definição de uma função inicia-se pelo comando function e finaliza-se pelo comando return. Declarações de funções não podem ser intercaladas por outras declarações de funções.

As funções são um elemento essencial no desenvolvimento em ERP TOTVS Protheus. Podemos classificá-las em duas categorias principais:

  • Static functions e
  • User functions.

As static functions são declaradas dentro do mesmo arquivo .PRW, sendo assim, só podem ser chamadas por outras funções dentro desse mesmo arquivo.

Já as user functions são independentes do arquivo .PRW e também podem ser invocadas por qualquer outra função no TOTVS Protheus.


Exemplo Prático

Utilizaremos o Visual Studio Code para demonstrar o funcionamento dessas funções. Acompanhe a criação de uma user function  e uma static function e veja suas diferenças na prática.

Para criar um novo fonte, clique em adicionar folha e um novo arquivo será criado.

Clique sobre o arquivo gerado para inserir a nomenclatura e finalizar a criação do fonte. Digite “Tipo_func.” e a extensão que irá utilizar para a programação: 

  • PRW para ADVPL ou
  • TLPP para TL ++

No primeiro exemplo acompanhe a estrutura da declaração de uma user function, que tem a finalidade de retornar uma mensagem de alerta para o usuário, que visualizará uma caixa de diálogo pré-programada com a mensagem digitada e o botão “OK”.

Após escrever o código, realizamos a compilação pressionando Ctrl + F9 ou utilizando o menu. Em seguida, executamos o código pressionando F5. 

Para executar a user function, na nomenclatura, utilize o padrão “U_ ” e o nome da função.

Pressione Enter e a user function será executada. Para finalizar basta clicar em “Ok”.

No segundo exemplo acompanhe a estrutura da declaração de uma static function, observe que utilizamos a mesma estrutura, apenas alterando o nome e o tipo da função. Observe que para a static function funcionar corretamente, deve estar inserida dentro da user function.

Ao executar, observa-se a diferença no comportamento entre chamar uma static function diretamente e uma user function, que, por sua vez, pode chamar outras funções de forma mais flexível.

Esse foi um breve resumo sobre User Function e Static Function do TOTVS Protheus, recomendamos que assista o nosso vídeo completo no início da página pois nele apresentamos uma explicação completa de cada ponto apresentado nesse artigo.

Para se matricular em nossos cursos e conferir as aulas completas, veja os nossos links logo abaixo:

Curso Desenvolvedor Protheus

Combo Desenvolvedor Completo 

Todos nossos cursos

Caso precise de mais informações Clique Aqui e assista o nosso vídeo na integra ou entre em contato conosco.

A RFB Sistemas é uma consultoria independente e que pode auxiliar a sua empresa com serviços relacionados ao TOTVS Protheus e Power BI da MIcrosoft. Clique aqui para ter um atendimento personalizado!

Sobre nós:

A RFB Sistemas é uma consultoria e escola há mais de 15 anos no mercado e já atuamos em diferentes setores e portes de empresas ajudando a implantar a melhor solução para gerenciar os seus negócios, o que possibilita que sua empresa consiga tomar decisões mais rápidas, assertivas e claro otimizando resultados. Além disso já capacitamos mais de 1.600 profissionais a utilizarem as ferramentas, como: TOTVS Protheus e RM, Microsoft Power BI e Excel

Artigos Sugeridos

  • O que é uma consultoria Totvs Protheus? Clique Aqui
  • Qual a melhor ferramenta de dashboard TOTVS Protheus ou Power BI? Clique Aqui

Documentação e Referências

Comandos ADVPL TOTVS Protheus, clique aqui

 

Protheus, TOTVS, Microsiga e RM são marcas registradas pertencentes a TOTVS S/A.
A RFB Sistemas é uma consultoria independente da TOTVS, e não possui qualquer relação comercial ou de parceria com a TOTVS.
Os conteúdos apresentados nesse artigo não expressam a opinião da TOTVS, e foi criado exclusivamente para fins didáticos.