1 minute A função Recno retorna o número do registro atualmente posicionado na área de trabalhoativa. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL. Sintaxe: Recno() Parâmetro(s): Nenhum Retorno: Exemplo da função Recno em ADVPL: É isso aí, finalizamos aqui mais um post 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 Continue→
1 minute A função FWNoAccent retira os acentos de uma string passada como parâmetro. Ela é uma das funções de manipulação de string em ADVPL. Sintaxe: FWNoAccent(cString) Parâmetro(s): Exemplo da função FWNoAccent em ADVPL: No código ADVPL acima utilizamos a função FWNoAccent para retirar os acentos da string: É 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 Continue→
1 minute A função RecLock efetua o travamento do registro posicionado na área de trabalho ativa, permitindo a inclusão ou alteração das informações do mesmo. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL. Sintaxe: RecLock(cAlias,lOper) Parâmetro(s): Retorno: Exemplo da função RecLock em ADVPL É isso aí, finalizamos aqui mais um post no Blog ProtheusAdvpl. Caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um e-mail para Continue→
1 minute A função Transform converte qualquer valor para uma string formatada. Para isso, formata valores do tipo caractere, data, lógico e numérico, conforme uma string de máscara especificada que inclui uma combinação de strings de template e funções de picture. Ela é uma das funções de manipulação de string em ADVPL. Sintaxe: Transform(xExp,cMasc) Parâmetro(s): Retorno: Observações: Esta função tem a mesma característica, do parâmetro PICTURE, do comando @…SAY; Utilizada para formatar dados que serão enviados à tela ou à impressora. Continue→
1 minute A função Soma1 é utilizada para criar um sequencial de um campo do tipo caractere. Ela é uma função padrão utilizada em objetos do sistema como GetDados, gravações de itens(grid do documento de entrada(MATA103), grid do pedido de venda(MATA410), etc. Ela é uma das funções de Componentes de Interface Visual em ADVPL. Sintaxe: Soma1(cSeq,cPos,lSomMin,lSomComp) Parâmetro(s): Retorno: Exemplo da função Soma1 em ADVPL: Abaixo podemos ver os exemplos da função Soma1 incrementando de forma sequencial caracteres numéricos(“000“) como caracteres alfabéticos(“A“): Continue→
1 minute A função DateDiffYear retorna a diferença em anos entre duas datas informadas nos parâmetros. Essa função recebe duas datas como parâmetros onde o primeiro se refere a data inicial e o segundo a data final. DateDiffYear é uma das funções de manipulação de data e hora em ADVPL. Sintaxe: DateDiffYear(dDataIni,dDataFim) Parâmetro(s): Retorno: Exemplo em ADVPL da função DateDiffYear: É isso aí, finalizamos mais um post aqui no Blog ProtheusAdvpl, caso tenha ficado alguma dúvida deixe seu comentário Continue→
1 minute A função RestArea é utilizada para devolver a situação do ambiente salva através da função GetArea, ou seja, restaurar o ambiente salvo por ela. A última área restaurada é a área que ficará ativa para a aplicação. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL. Sintaxe: RestArea(aArea) Parâmetro(s): Exemplo da função RestArea em ADVPL: Suponhamos que o ambiente ativo seja do alias SA2(Alias()), índice 1(IndexOrd())e registro 320(Recno()) e salvamos esse ambiente Continue→
1 minute A rotina automática ExecAuto MATA220 tem por objetivo criar saldos iniciais(SB9) automaticamente no TOTVS Protheus. Ela é uma das Rotinas Automáticas em ADVPL. Essa rotina automática é muito útil em situações onde nós iremos fazer uma transferência múltipla de produtos(MATA261) e assim podemos criar saldo inicial dos produtos de destinos caso eles não possuam. Sintaxe: MSExecAuto({|x, y| Mata220(x, y)}, aArray, 3) Exemplo em ADVPL da rotina automática ExecAuto MATA220: É isso aí, finalizamos mais um post aqui no Continue→
1 minute A função IsUpper determina se o caractere mais à esquerda de uma string é uma letra maiúscula. Essa função pode ser muito útil em situações que precisamos validar nomes de pessoas por exemplo. Ela também é uma das funções de manipulação de string em ADVPL. Sintaxe: IsUpper(cString) Parâmetro(s): Retorno: Exemplo da função IsUpper em ADVPL: É isso aí, finalizamos aqui mais um post no Blog ProtheusAdvpl. Caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um e-mail para Continue→
1 minute A função Posicione retorna o conteúdo de um campo(SX3) de um registro de uma tabela(SX2) especificado através de uma chave de busca. Ela é uma das Funções do Dicionário de Dados do Protheus em ADVPL. Sintaxe: Posicione(cAlias,nOrdem,cExpr,cCampo,cNickName) Parâmetro(s): Retorno: Exemplo da função Posicione em ADVPL: No código ADVPL acima nós passamos para a função Posicione o alias(tabela) “SA2“(fornecedores), a ordem do índice(nOrdem=1), a chave de busca(xFilial(“SA2“)+cCodFor+cLojaFor) e o campo(“A2_NOME“) que desejamos obter o conteúdo e ao final a Continue→
1 minute A função aScan percorre um array procurando por um valor especificado. Pode ser especificado um valor a ser buscado, ou pode ser informada uma condição de busca através de um bloco de código. Ela é uma das funções de manipulação de array em ADVPL. Sintaxe: aScan(aDestino,xExpr,nInicio,nQtd) Parâmetro(s): Retorno: Exemplo da função aScan em ADVPL: No código ADVPL acima nós passamos para a função aScan o array aLingProg e uma expressão de busca com o bloco código onde Continue→
1 minute A função Year retorna o ano(formato aaaa) correspondente a uma data passada como parâmetro. Ela é uma das funções de manipulação de data e hora em ADVPL. Sintaxe: Year(dData) Parâmetro(s): Retorno: Observações: Quando informado uma data nula(CtoD(“”)), o retorno será zero; 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 Month, que retornam os valores dia e mês respectivamente na forma de números. Continue→
1 minute A função Date retorna a data do sistema como sendo um valor do tipo data. Essa função dispõe um meio de inicializar variáveis de memória com a data corrente, comparando outros valores do tipo data e realizando operações aritméticas relativas à data corrente. Ela é uma das funções de manipulação de data e hora em ADVPL. Sintaxe: Date() Parâmetro(s): — Retorno: Observações: O formato para exibição de datas é controlado pelo comando Set Date; O formato padrão assumido pela Continue→
1 minute A função EoF informa se o posicionamento dos registros está no fim do arquivo/tabela ativo. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL. Sintaxe: Eof() Parâmetro(s): Nenhum. Retorno: Observações: O uso da DBGoBottom não ativa a flag de EoF. Para isto, após sua chamada, é necessário o uso da DBSkip. Exemplo da função EoF em ADVPL: Enquanto não tiver no último registro da tabela SA1 a contagem dos Continue→
2 minutes A função DBSeek permite localizar um registro da área de trabalho ativa, com as informações especificadas na chave de busca, fornecendo um retorno lógico indicando se o posicionamento foi efetuado com sucesso, ou seja, se a informação especificada na chave de busca foi localizada na área de trabalho. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL. Sintaxe: DBSeek(cExpr,lPos) Parâmetro(s): Retorno: Exemplo da função DBSeek em ADVPL: É Continue→
1 minute A função IsDigit é utilizada para determinar se o caractere mais à esquerda de uma string é um dígito, permitindo avaliar se o string especificado começa com um caractere numérico(0 a 9). IsDigit é muito útil para situações onde precisamos validar números em campos. Ela é também uma das funções de manipulação de string em ADVPL. Sintaxe: IsDigit(cString) Parâmetro(s): Retorno: Exemplo de IsDigit em ADVPL: No código ADVPL acima informamos 2 variáveis chamadas cString1 e cString2, a função IsDigit Continue→
2 minutes A função RTrim remove os espaços em branco à direita de uma string. Ela é também uma das funções de manipulação de string em ADVPL. Sintaxe: RTrim(cString) Parâmetro(s): Retorno: Observações: RTrim está relacionada as funções LTrim, 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 de preenchimento. Continue→
1 minute A função IsAlpha é utilizada para determinar se o caractere mais à esquerda em uma cadeia de caracteres é alfabético, permitindo avaliar se o string especificado começa com um caractere alfabético. Um caractere alfabético consiste em qualquer letra maiúscula ou minúscula de “A” a “Z”. IsAlpha é muito útil para situações onde precisamos validar nomes. Ela é também uma das funções de manipulação de string em ADVPL. Sintaxe: IsAlpha(cString) Parâmetro(s): Retorno: Exemplo de IsAlpha em ADVPL: No código Continue→
2 minutes A função DBSetOrder define qual índice será utilizado pela área de trabalho ativa, ou seja, pela área previamente selecionada através da função DBSelectArea. As ordens disponíveis no ambiente Protheus são aquelas definidas na SIX(Índice das Tabelas) ou as ordens disponibilizadas por meio de índices temporários. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL. Sintaxe: DBSetOrder(nOrdem) Parâmetro(s): Observações: Esta ordem é a responsável pela sequência lógica dos registros da tabela corrente; Continue→
1 minute A função DateDiffMonth retorna a diferença em meses entre duas datas informadas nos parâmetros. Essa função recebe duas datas como parâmetros onde o primeiro se refere a data inicial e o segundo a data final. DateDiffMonth é uma das funções de manipulação de data e hora em ADVPL. Sintaxe: DateDiffMonth(dDataIni,dDataFim) Parâmetro(s): Retorno: Exemplo em ADVPL da função DateDiffMonth: É isso aí, finalizamos mais um post aqui no Blog ProtheusAdvpl, caso tenha ficado alguma dúvida deixe seu comentário Continue→
2 minutes A função DBSelectArea define a área de trabalho especificada com sendo a área ativa. Todas as operações subsequentes que fizerem referência a uma área de trabalho a utilização, a menos que a área desejada seja informada explicitamente. Ela também é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL. Sintaxe: DBSelectArea(xArea) Parâmetro(s): Observações: xArea pode ser do tipo numérico, indicando o número da área de trabalho, ou do tipo caractere, indicando o alias de uma área de Continue→
2 minutes A função ValType retorna um caractere que identifica o tipo de dado da variável informada através do parâmetro. Ela é uma das funções de Verificação de Tipos de Variáveis em ADVPL. Sintaxe: ValType(xVariavel) Parâmetro(s): Retorno: Exemplo de ValType em ADVPL: Nós podemos chamar uma função de dentro de ValType e ela retorna o tipo de dado que essa função retorna, como exemplo nós passamos uma chamada da função PSoma() de dentro de ValType:ValType(U_PSoma()) e como a função PSoma retornou um conteúdo Continue→
1 minute A função Rat retorna a última posição de um caracter ou string dentro de outra string especificada. Para isso, a função pesquisa a string destino a partir da direita. Ela é uma das funções de manipulação de string em ADVPL. Sintaxe: Rat(cPesq,cString) Parâmetro(s): Retorno: Exemplo de RAt em ADVPL: No código ADVPL acima utilizamos a função RAt para pesquisar na string “Programação no Protheus”(cString= “Programação no Protheus”) o conteúdo “Pro”(cPesq= “Pro”) onde ao final RAt retornou a última posição de Continue→
1 minute A função GetArea é utilizada para proteger o ambiente ativo no momento de algum processamento específico para salvar uma outra área de trabalho(alias) que não o ativo. Essa função deve ser executada dentro do alias: ALIAS->(GetArea()). Esse ambiente protegido é restaurado utilizando a função RestArea. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL. Sintaxe: GetArea() Parâmetro(s): Nenhum. Retorno(s): Exemplo da função GetArea em ADVPL: Suponhamos que o ambiente ativo seja do Continue→
1 minute A função FWxFilial retorna o código da filial do alias passado como parâmetro. Poderá também de acordo com o parâmetros informados, retornar a string contendo a empresa, unidade de negócio e filial com o tratamento de compartilhamento. Ela é uma das Funções de Manipulação de Empresas em ADVPL. Sintaxe: FWxFilial(cAlias,cEmpUDFil,cModEmp,cModUn,cModFil) Parâmetro(s): Retorno: Exemplo da função FWxFilial 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 Continue→
1 minute A função DateWorkDay retorna a quantidade de dias úteis entre duas datas informadas nos parâmetros. Essa é uma das funções de manipulação de data e hora em ADVPL. Sintaxe: DateWorkDay(dDataIni,dDataFim,lSabado,lDomingo,lFeriado) Parâmetro(s): Retorno: Observação: A função DateWorkDay consulta os feriados cadastrados na Tabela Genérica 63(SX5). Exemplo da função DateWorkDay 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 Continue→
1 minute A função OEMToAnsi converte uma string do formato OEM/MS-DOS Text para ANSI Text(formato do Microsoft Windows). Ela é uma das funções de manipulação de string em ADVPL. Sintaxe: OEMToAnsi(cStringOEM) Parâmetro(s): Retorno: Observações: Ao utilizar um programa baseado no MS-DOS para alimentar uma base de dados, os acentos e caracteres especiais são gravados como texto OEM. Porém, para visualizar esses dados, na interface do Microsoft Windows, é necessário converter a string de OEM/MS-DOS para ANSI Text. Exemplo de OEMToAnsi em Continue→
1 minute A função MsgStop mostra uma mensagem de advertência na tela do TOTVS Protheus. Ela é uma das funções de Avisos e Alertas em ADVPL. Sintaxe: MsgStop(cMsg,cTitulo) Parâmetro(s): Retorno: – Observações: Essa função permite que se mostre uma mensagem para o usuário sem a necessidade de se criar botões de opção. O único botão(Ok) é criado automaticamente pela própria função para que o usuário prossiga o processamento; MsgStop mostra uma imagem representando uma advertência, uma exceção, tornando a identificação do tipo de mensagem Continue→
1 minute A função Lower converte um texto para letras minúsculas. Ela é uma das funções de manipulação de string em ADVPL. Sintaxe: Lower(cTexto) Parâmetro(s): Retorno: Exemplo da função Lower 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/Lower
2 minutes A função PadL adiciona caracteres de preenchimento à esquerda do conteúdo de uma variável passada como parâmetro. Ela é uma das funções de manipulação de string em ADVPL. Sintaxe: PadL(xExp,nTam,cChar) Parâmetro(s): Retorno: Observações: PadL transforma o valor apontado por xExp em string (igual ao comportamento da função cValToChar), e adiciona o caractere definido em cChar à esquerda do valor de xExp até que o comprimento especificado em nTam seja atingido; Caso o comprimento de xExp convertido para string for maior que o especificado em nTam, a função retornará o Continue→