AllwaysFalse

AllwaysFalse

1 minuto Olá, no post de hoje iremos aprender como usar a função AllwaysFalse no ADVPL. Ela é uma das funções de validação no ADVPL.  A função AllwaysFalse foi criada com o objetivo de compatibilidade, sendo que sempre irá retornar um valor lógico falso(.F.), facilitando a especificação desta situação nas parametrizações de validações de modelos de interface pré-definidos no sistema. Sintaxe: AllwaysFalse( )   Parâmetro(s): – Retorno:   Exemplo da função AllwaysFalse no ADVPL:   Bem, finalizamos mais um post aqui no blog. Espero que Continue lendo

Eval

Eval

2 minutos   A função Eval executa um bloco de código em ADVPL. Ela é uma das funções de manipulação de bloco de códigos em ADVPL. Sintaxe: Eval(bBloco,xExp)   Parâmetro(s):   Retorno:     Exemplo da função Eval em ADVPL:  No código ADVPL acima nós criamos um bloco código chamado bSoma que recebe como parâmetro nVal depois iremos somar o conteúdo de nVal com 12 e atribuir o resultado a Y, ao final multiplicamos o conteúdo de Y por nVal e atribuímos o resultado Continue lendo

Como Corrigir o Erro Duplicated function GETMUNSIAF (FOUND in FISA022.PRW)

Como Corrigir o Erro Duplicated function GETMUNSIAF (FOUND in FISA022.PRW)

menos de 1 minuto Olá, no post de hoje iremos falar do erro Duplicated function GETMUNSIAF (FOUND in FISA022.PRW). Esse erro é ocasionado quando tentamos aplicar um patch do TSS no RPO do Protheus ou também o contrário, quando tentamos aplicar um patch do Protheus no RPO do TSS. Nesse caso precisa ser validado o patch e saber qual o RPO deverá ser aplicado a atualização.   Bem, finalizamos mais um post aqui do blog. Qualquer dúvida deixe seu comentário ou envio um e-mail Continue lendo

PadC

PadC

2 minutos A função PadC centraliza o conteúdo de uma variável adicionando caracteres de preenchimento à direita e à esquerda. Ela é a junção de PadR e PadL. Ela é uma das funções de manipulação de string em ADVPL.    Sintaxe: PadC(xExp,nTam,cChar)   Parâmetro(s): Retorno:     Observações: PadC transforma o valor apontado por xExp em string (igual ao comportamento da função cValToChar), e adiciona o caractere definido em cChar à esquerda e à direita do valor de xExp até que o comprimento especificado em nTam seja atingido; Caso o comprimento Continue lendo

ConfirmSX8

ConfirmSX8

1 minuto   Sintaxe: ConfirmSX8()   Parâmetro(s): –   Retorno: –   Exemplo da função ConfirmSX8 em ADVPL: Bem, finalizamos mais um post aqui do blog, espero que tenha entendido. Qualquer dúvida deixe seu comentário abaixo ou nos envie um e-mail para adiliocosta@protheusadvpl.com.br. Nos ajude compartilhando esse conteúdo nos grupos de Protheus e ADVPL/TL++ que participa. Grande abraço e fica com Deus.

GetSXENum

GetSXENum

1 minuto Olá, no post de hoje falaremos de uma das Funções de Controle de Numeração(SXE) no Protheus, a função GetSXENum. GetSXENum tem por objetivo obter o número sequencial do Alias especificado no parâmetro, através da referência aos arquivos de sistema SXE/SXF ou ao servidor de numeração(TOTVS License Server Virtual), quando esta configuração está habilitada no ambiente Protheus. a função GetSXENum trabalha em conjunto com a função ConfirmeSX8, que auxilia na confirmação da numeração automática e a função RollBackSX8, que desfaz toda a operação, voltando Continue lendo

RollBackSX8()

RollBackSX8()

1 minuto Olá, no post de hoje falaremos de uma das Funções de Controle de Numeração(SXE) no Protheus, a função RollBackSX8. RollBackSX8 tem por objetivo desfazer a numeração sequencial gerada pela função GetSXENum, ou seja, ela é o oposto da função ConfirmSX8.     Sintaxe: RollBackSX8()   Parâmetro(s): –   Retorno: –   Exemplo da função ConfirmSX8 em ADVPL: Bem, finalizamos mais um post aqui do blog, espero que tenha entendido. Qualquer dúvida deixe seu comentário abaixo ou nos envie um e-mail para adiliocosta@protheusadvpl.com.br. Nos ajude Continue lendo

FWIsInCallStack

FWIsInCallStack

1 minuto Olá, no post de hoje iremos falar da função FWIsInCallStack, ela é uma das funções de controle de processamento em ADVPL e tem por finalidade verificar se a função passada como parâmetro está em uma pilha de chamada de funções.   Sintaxe: FWIsInCallStack(<cNomeFunc>)   Parâmetro(s):   Retorno:   Exemplo em da função FWIsInCallStack em ADVPL:   Bem, finalizamos mais um post aqui no blog, espero que você tenha entendido, se tiver alguma dúvida deixe seu comentário ou nos envie um e-mail para Continue lendo

Como Executar Instruções SQL com TCSQLExec no ADVPL

Como Executar Instruções SQL com TCSQLExec no ADVPL

1 minuto   Olá, no post de hoje iremos aprender como executar instruções SQL com TCSQLExec no ADVPL,  instruções como UPDATE e INSERT. TCSQLExec  é uma das funções de acesso e manipulação de banco de dados no Protheus e tem por objetivo executar uma instrução de sintaxe SQL(Structured Query Language) diretamente no banco de dados em que está conectado. Sintaxe: TCSQLExec(<cQuery>) Parâmetro(s): Retorno: Exemplo em ADVPL: Bem, finalizamos mais um post aqui no blog. Espero que você tenha entendido, qualquer dúvida nos envie um Continue lendo

UsrRetName

UsrRetName

1 minuto A função UsrRetName retorna o nome do usuário do TOTVS Protheus conforme o código passado como parâmetro. Ela é uma das Funções de Manipulação de Usuários do Protheus. Sintaxe: UsrRetName(cCodUsr)   Parâmetro(s):   Retorno:   Exemplo da função UsrRetName em ADVPL:   Bem, finalizamos mais um post aqui no blog. Espero que tenha entendido, se tiver ficado alguma dúvida deixe seu comentário ou nos mandar um e-mail para adiliocosta@protheusadvpl.com.br. Grande abraço e fica com Deus.   Links de referência: https://www.blogadvpl.com/funcoes-uteis-de-usuario/#page-content  

RetCodUsr

RetCodUsr

1 minuto Olá, no post de hoje iremos falar de uma das funções de manipulação de usuários em ADVPL, a função RetCodUsr. Essa função tem por objetivo retornar o código do usuário corrente do TOTVS Protheus no momento da execução de uma determinada rotina do Protheus. Sintaxe: RetCodUsr( ) Retorno: Exemplo em ADVPL: Bem, finalizamos mais um post aqui no blog. Espero que tenha entendido, se tiver ficado alguma dúvida deixe seu comentário ou nos mandar um e-mail para adiliocosta@protheusadvpl.com.br. Grande abraço e fica Continue lendo

FormatIn

FormatIn

1 minuto Olá, no post de hoje iremos falar da função FormatIn. FormatIn é uma das funções de manipulação de string em ADVPL, seu objetivo é formatar uma string passada como parâmetro e deixá-la pronta para ser utilizada no operador IN de uma query SQL.    Sintaxe: FormatIn( <cString>, <cSep> ) Parâmetro(s): Retorno: Exemplo em ADVPL:   Bem, finalizamos mais um post aqui no blog, espero que você tenha entendido. Qualquer dúvida pode deixar seu comentário ou envie um e-mail para adiliocosta@protheusadvpl.com.br. Grande abraço Continue lendo

Month

Month

1 minuto   A função Month retorna o mês referente a uma determinada data passada como parâmetro. Ela é uma das funções de manipulação de data e hora em ADVPL. Sintaxe: Month(dData)   Parâmetro(s):   Retorno:   Observações: Essa função faz parte de um grupo funções que retornam componentes de um valor data na forma de valores numéricos. Esse grupo inclui as função Day e Year, que retornam os valores dia e ano na forma de números.   Exemplo da função Month em ADVPL:        Continue lendo

Como Usar a Função FWGetSX5 Para Obter Registros da SX5 do Protheus

Como Usar a Função FWGetSX5 Para Obter Registros da SX5 do Protheus

2 minutos Olá, no post de hoje iremos falar da função FWGetSX5 do ADVPL. A função FWGetSX5 é uma das funções de manipulação das tabelas genéricas SX5 do Protheus e tem por finalidade obter o registros da SX5 de acordo com os parâmetros passados. Ela retorna um array bidimensional conforme o exemplo abaixo: Objetivo: Retornar registros das tabelas genéricas SX5 do Protheus. Sintaxe: FWGetSX5 ( < cTab >, [ cChave ] , [cIdiom] ) → aDadosSX5 Parâmetros: RetornoaDadosSX5 (Array de caracteres) Logo abaixo temos um Continue lendo

GetLastQuery

GetLastQuery

2 minutos Olá, no post de hoje iremos falar da função auxiliar GetLastQuery() dentro do desenvolvimento de querys no TOTVS Protheus.  Muitas vezes como forma de facilitar o desenvolvimento de querys no Protheus utilizamos o que chamamos de Embedded SQL, que são querys SQL embutidas no código ADVPL, no entanto quando vamos depurar um código ADVPL que tenha essas características não é possível colocar pontos de paradas entre as instruções BeginSQL e EndSQL, assim não conseguiremos obter a consulta SQL que foi montada dentro Continue lendo

Upper

Upper

1 minuto A função Upper converte um texto para letras maiúsculas. Ela é uma das funções de manipulação de string em ADVPL.    Sintaxe: Upper(cTexto)   Parâmetro(s): Retorno:     Exemplo de Upper em ADVPL:   É isso aí, finalizamos mais um post aqui no Blog ProtheusAdvpl. Caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um e-mail para adiliocosta@protheusadvpl.com.br, até um próximo post, grande abraço e fica com Deus. Link(s) de referência(s): https://tdn.totvs.com/display/tec/Upper  

Day

Day

1 minuto   A função Day retorna o dia do mês de uma determinada data informada no parâmetro. Ela é uma das funções de manipulação de data e hora em ADVPL. Sintaxe: Day(dData)   Parâmetro(s):   Retorno:   Observações: O retorno será igual a zero(0) para uma data em branco, inválida ou se 29 de Fevereiro e o ano não for bissexto; Essa função faz parte de um grupo funções que retornam componentes de um valor data na forma de valores numéricos. Esse grupo Continue lendo

ConOut

ConOut

1 minuto Olá, a função ConOut é uma das funções de manipulação de arquivos, discos e IO em ADVPL. Ela tem como objetivo acrescentar uma mensagem no arquivo de console(console.log) do TOTVS AppServer ou mesmo no terminal, quando o TOTVS AppServer está sendo executado em modo console. A função ConOut é muito útil em situações onde estamos fazendo análise de erros e precisamos saber qual o problema está ocasionando o erro, assim com a função ConOut podemos analisar através do arquivo log ou via Continue lendo

Como Configurar o SmartClient no TOTVS VSCode

Como Configurar o SmartClient no TOTVS VSCode

2 minutos Olá, no post de hoje iremos aprender como configurar o SmartClient no TOTVS VSCode. Por padrão quando vamos usar o TOTVS VSCode pela primeira vez ele apresenta uma tela para configurarmos um workspace e logo em seguida pede para que possamos configurar o SmartClient que vai ser utilizado, onde selecionamos(clicando em Choose File) e selecionando o diretório dele, conforme é mostrado na imagem abaixo: No entanto existem algumas situações em que precisamos reconfigurar o SmartClient no TOTVS VSCode, seja porque ele mudou Continue lendo

Round

Round

1 minuto Olá, no post de hoje iremos falar de uma das funções de manipulação de variáveis numéricas em ADVPL, a função Round, essa função arredonda um valor numérico até uma quantidade especificada de casas decimais.   Sintaxe: Round(<nValor>,<nDec>)   Parâmetros(s):   Retorno:   Exemplo da função round em ADVPL: nDec := 2 nValor := 63.9399999 Round(nValor,nDec) -> 63.94 No exemplo acima utilizamos a função Round e informamos como primeiro parâmetro  o valor de 63.9399999,  contido na variável nValor e no segundo parâmetro  o Continue lendo

BoF

BoF

1 minuto A função BoF informa se o posicionamento dos registros está no início do arquivo/tabela ativo. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: Bof()   Parâmetro(s): Nenhum. Retorno:       Exemplo da função BoF em ADVPL: Enquanto não tiver no primeiro registro da tabela SA1 a contagem dos registros vai sendo feita.     É isso aí, finalizamos aqui mais um post no Blog ProtheusAdvpl. Caso tenha ficado alguma Continue lendo

DBGoTop

DBGoTop

2 minutos A função DBGoTop posiciona no primeiro registro lógico da tabela corrente . Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: DBGoTop()   Parâmetro(s): Nenhum. Observações: A sequência lógica depende da ordem e do filtro ativo na tabela corrente. Portanto, o primeiro registro lógico pode não ser o primeiro registro físico. Exemplo da função DBGoTop em ADVPL: Vamos supor que nós tenhamos 5 registros na tabela SA2(Fornecedores) do TOTVS Protheus conforme os Continue lendo

Alias

Alias

1 minuto A função Alias retorna o alias(Ex.:”SA1″) de uma área de trabalho especificada no parâmetro nArea. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: Alias(nArea)   Parâmetro(s): Retorno(s):     Observações: Alias é uma função de banco de dados utilizada para determinar o alias da área de trabalho especificada. Alias é o nome atribuído a uma área de trabalho quando um arquivo de banco de dados está em uso. O nome atribuído Continue lendo

LTrim

LTrim

2 minutos A função LTrim remove os espaços em branco à esquerda de uma string. Ela é também  uma das funções de manipulação de string em ADVPL.    Sintaxe: LTrim(cString)   Parâmetro(s): Retorno:     Observações: LTrim está relacionada as funções RTrim, que remove os espaços em branco à esquerda, e a AllTrim, que remove os espaços em branco à esquerda e à direita; O inverso de AllTrim, RTrim e LTrim são as funções PadC, PadR e PadL, que centralizam, alinham à direita ou à esquerda as strings, respectivamente, através da inserção de caracteres Continue lendo

Select

Select

2 minutos A função Select determina o número da área de trabalho de um alias. O número retornado pode variar de 0(zero) a 250. Se não for especificado, é retornado o número da área de trabalho corrente. Caso seja especificado e o alias não existir, Select retorna zero. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.    Sintaxe: Select(cAlias)   Parâmetro(s): Retorno:   Observações: Essa função é muito útil em situações onde queremos verificar Continue lendo

aCopy

aCopy

1 minuto   A função aCopy realiza a cópia de elementos de um array de origem para um outro de destino, considerando que esse de destino já possua a estrutura para receber essa cópia. Ela é uma das funções de manipulação de array em ADVPL. Sintaxe: aCopy(aOrigem,aDestino,nInicio,nQtd,nPosDest)   Parâmetro(s):   Retorno:     Exemplo da função aCopy em ADVPL:    Podemos ver na imagem abaixo que a função aCopy copiou os elementos do array aOrigem para o array aDestino:       É isso aí, Continue lendo

aClone

aClone

1 minuto   A função aClone realiza a cópia dos elementos de um array para outro array integralmente, ou seja, duplica um array(estrutura e elementos). Ela é uma das funções de manipulação de array em ADVPL. Sintaxe: aClone(aArray)   Parâmetro(s):   Retorno:     Exemplo da função aClone em ADVPL:    Podemos ver na imagem abaixo que a função aClone duplicou array aNum no array aDuplic e assim aDuplic apresenta os mesmos elementos de aNum:       É isso aí, finalizamos mais um Continue lendo

RunTrigger

RunTrigger

1 minuto Olá, no post de hoje iremos falar de uma das funções de Funções de Gatilhos(SX7) em ADVPL, a função RunTrigger. Essa função tem por objetivo executar um gatilho(SX7) para o campo que informamos no parâmetro. Essa função é muito útil em situações que executamos rotinas customizadas no Protheus e que necessitam que os gatilhos envolvidos sejam executados, como exemplo temos a importação de uma planilha(.csv) onde podemos alimentar um array aCols(uma tela com grid) e nesse processo precisamos executar os gatilhos já Continue lendo

PadR

PadR

2 minutos A função PadR  é uma função de manipulação de string em ADVPL. Essa função tem por finalidade adicionar caracteres de preenchimento à direita do conteúdo de uma variável passada como parâmetro. Sintaxe: PadR(xExp,nTam,cCarac) Parâmetro(s): Retorno:   Observações sobre a função PadR: PadR transforma o valor apontado por xExp em string (igual ao comportamento da função cValToChar), e adiciona o caractere definido em cCarac à direita do valor de xExp até que seja atingido o tamanho definido em nTam. Caso o terceiro parâmetro Continue lendo