Programação ADVPL/TLPP

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

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