ProtheusAdvpl

Funções de Acesso a Banco de Dados/SQL no Protheus

DBSetOrder

2 minutos 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 lendo→

Manipulação de Data e Hora

DateDiffMonth

1 minuto 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 lendo→

Funções de Acesso a Banco de Dados/SQL no Protheus

DBSelectArea

2 minutos 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 lendo→

Verificação de Tipos de Variáveis

ValType

2 minutos 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 lendo→

Manipulação de String

RAt

1 minuto 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 “PORTAL PROTHEUSADVPL”(cString= “PORTAL PROTHEUSADVPL”) o conteúdo “P”(cPesq= “P”) onde ao final RAt retornou a última posição de “P” como Continue lendo→

Funções de Acesso a Banco de Dados/SQL no Protheus

GetArea

1 minuto 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 lendo→

Funções de Manipulação de Empresas

FWxFilial

1 minuto 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 lendo→

Manipulação de Data e Hora

DateWorkDay

1 minuto 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 lendo→

Manipulação de String

OEMToAnsi

1 minuto 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 lendo→

Avisos e Alertas

MsgStop

1 minuto 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 lendo→

Manipulação de String

Lower

1 minuto 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

Manipulação de String

PadL

2 minutos 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 conteúdo Continue lendo→

Manipulação de String

Len

1 minuto A função Len retorna o tamanho de uma variável passada como parâmetro. Essa variável pode ser do tipo String, Data, Lógica ou Numérica. Também é uma das funções de manipulação de string em ADVPL. Sintaxe: Len(xParam) Parâmetro(s): Retorno: Observações: Se a cadeia de caracteres especificada for nula (“”), a função Len retornará o valor zero. Entretanto, o caractere nulo, Chr(0), tem o comprimento de uma (1) posição; Deve-se lembrar que no ADVPL cada array multidimensional é composto por vários subarrays. Continue lendo→

Manipulação de String

SubStr

2 minutos A função SubStr retorna parte do conteúdo de uma string especificada, de acordo com a posição inicial deste conteúdo na string e a quantidade de caracteres que deverá ser retornada a partir daquele ponto(inclusive). Ela é também uma das funções de manipulação de string em ADVPL. Sintaxe: SubStr(cTexto,nPos,nQtd) Parâmetro(s): Retorno: Observações: nPos inicia em 1; Se nPos for menor que 0(zero) ou maior do que o tamanho de cTexto, a função retornará uma string vazia; Se nQtd for menor ou igual a 0(zero), a Continue lendo→

Avisos e Alertas

MsgYesNo

2 minutos A função MsgYesNo mostra uma mensagem na tela e espera que o usuário decida, por meio dos botões Sim ou Não, qual ação será tomada na tela do TOTVS Protheus. Ela é uma das funções de Avisos e Alertas em ADVPL. Sintaxe: MsgYesNo(cMsg,cTitulo) Parâmetro(s): Retorno: – Observações: Essa função permite que se mostre uma mensagem para o usuário com as opções Sim e Não. Esses botões são criados automaticamente pela função e permitem que o usuário decida que caminho o processamento deve Continue lendo→

Manipulação de Data e Hora

DateDiffDay

1 minuto A função DateDiffDay retorna a diferença em dias 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. DateDiffDay é uma das funções de manipulação de data e hora em ADVPL. Sintaxe: DateDiffDay(dDataIni,dDataFim) Parâmetro(s): Retorno: Exemplo em ADVPL da função DateDiffDay: É isso aí, finalizamos mais um post aqui no Blog ProtheusAdvpl, caso tenha ficado alguma dúvida deixe seu comentário ou nos Continue lendo→

Menus(CFGX013)

Como Restaurar o Menu SIGACFG com FwSysMenuRestore Após Salvar com o Nome de Outro Módulo

2 minutos Olá, no post de hoje iremos aprender como restaurar o menu do Configurador(SIGACFG) com FwSysMenuRestore após salvar o menu com o nome de outro módulo. Imaginemos a seguinte situação. Nós entramos no módulo configurador(SIGACFG) do TOTVS Protheus para dar uma manutenção no menu de um módulo Protheus, como o compras(SIGACOM) por exemplo, após finalizarmos a manutenção por uma pequena desatenção ao invés de salvarmos o menu com o nome de sigacom.xnu acabamos trocando pelo nome de sigacfg.xnu, substituindo assim o menu do Continue lendo→

Manipulação de String

StrTran

2 minutos A função StrTran é utilizada para pesquisar e substituir um conjunto de caracteres em uma string. Ela é case sensitive, ou seja, diferencia letras maiúsculas e minúsculas. Também é uma das funções de manipulação de string em ADVPL. Sintaxe: StrTran(cString,cPesq,cSubst,nInicio,nQtdSub) Parâmetro(s): Retorno: Exemplo de StrTran em ADVPL: No código ADVPL acima utilizamos a função StrTran para pesquisar na string “Projeto Programação no Protheus”(cString= “Projeto Programação no Protheus”) o conteúdo “Pro”(cPesq= “Pro”) e substituir por “@”(cSubst= “@”) a partir da Continue lendo→

Avisos e Alertas

MsgInfo

1 minuto A função MsgInfo apresenta uma mensagem de informação na tela do TOTVS Protheus. Ela é uma das funções de Avisos e Alertas em ADVPL. Sintaxe: MsgInfo(cMsg,cTitulo) Parâmetro(s): Retorno: Exemplo da função MsgInfo em ADVPL: É isso aí, finalizamos aqui o post sobre a função MsgInfo em ADVPL. 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/MsgInfo

Atualização de Dados

AxCadastro

1 minuto A função AxCadastro é utilizada para montar a tela padrão da MBrowse(modelo 1) no TOTVS Protheus. Ela é uma das funções de Cadastros em componentes de interface visual em ADVPL. AxCadastro disponibiliza algumas opções na sua criação, como: Browse padrão para visualização das informações da base de dados, de acordo com asconfigurações do SX3 – Dicionário de Dados (campo browse); Funções de pesquisa, visualização, inclusão, alteração e exclusão padrões paravisualização de registros simples, sem a opção de cabeçalho e itens. Sintaxe: Continue lendo→

Manipulação de String

Space

1 minuto A função Space retorna uma string com uma quantidade especificada de espaços. Ela é uma das funções de manipulação de string em ADVPL. Sintaxe: Space(nQuant) Parâmetro(s): Retorno: Observações: Caso seja especificado 0 (zero) no parâmetro nQuant, a função retornará uma string nula (“”). Essa função pode ser utilizada, por exemplo, para inicializar uma variável do tipo caractere, antes que a mesma seja associada a um comando Get. Podemos utilizar a função TamSX3 em conjunto com Space; É isso aí, finalizamos aqui o post sobre Continue lendo→

Funções de Acesso a Banco de Dados/SQL no Protheus

Como Utilizar BeginSQL EndSQL no ADVPL

2 minutos Olá, no post de hoje iremos ver como executar query Embedded SQL(SQL integrado ou embutido) utilizando o comandos BeginSQL EndSQL no ADVPL. 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. Um dos comandos utilizados para isso é o BeginSQL EndSQL conforme veremos. Sintaxe: BeginSQL “SUA_TABELA” //Comandos SQL EndSQL Exemplo básico de BeginSQL EndSQL: Características dos comandos de instruções acima: Exemplo dos comandos Continue lendo→

Funções de Validação

Empty

2 minutos Olá, no post de hoje iremos aprender como usar a função Empty no ADVPL. Ela é uma das funções de validação no ADVPL. A função Empty determina se o resultado de uma expressão é vazio. Sintaxe: Empty(xExp) Parâmetro(s): Retorno: Observações: Os critérios para determinar se o valor será considerado vazio, no parâmetro lRet, dependem do tipo de dado, no parâmetro xExp, e das regras de retorno, conforme a tabela regras de retorno: A função Empty no ADVPL poderá ser utilizada para Continue lendo→

Funções de Validação

AllwaysTrue

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

Funções de Validação

Como Usar a Função ExistChav no ADVPL

1 minuto Olá, no post de hoje iremos aprender como usar a função ExistChav no ADVPL. Elá é uma das funções de validação no ADVPL. A função ExistChav verifica se o conteúdo especificado existe no arquivo de dados. Sintaxe: ExistChav(cAlias,cExpr,nInd,cHelp) Parâmetro(s): Retorno: Dica: As funções ExistChav e ExistCpo tem algumas semelhanças. Porém, enquanto que a função ExistChav verifica uma chave única, ou seja, verifica se um código já existe no próprio arquivo de dados que está sendo manipulado, a função ExistCpo verifica uma Continue lendo→

Funções de Validação

Como Usar a Função Pertente no ADVPL

1 minuto Olá, no post de hoje iremos aprender como usar a função Pertence no ADVPL. Elá é uma das funções de validação no ADVPL. a Função Pertence verifica se o conteúdo do campo ou variável está contido dentro da expressão informada como parâmetro. Sintaxe: Pertence(cExpr) Parâmetro(s): Retorno: Utilização Essa função normalmente é utilizada em campos que possuem a opção de combo. Ou seja, várias opções disponíveis dentro de uma lista pré-determinada. Exemplo da função Pertence no ADVPL: Nesse exemplo, o conteúdo da Continue lendo→

Funções de Acesso a Banco de Dados/SQL no Protheus

Como Executar Stored Procedure com TCSPExec no ADVPL

1 minuto Olá, no post de hoje iremos aprender como executar stored procedure com TCSPExec no ADVPL. Stored procedure são um conjunto de comandos SQL que podemos criar e armazenar no banco de dados para serem executadas a qualquer momento por programas externos. Em um exemplo mais objetivo, stored procedure são funções que criamos que contém comandos SQL e assim podemos chamar essas funções para execução desses comandos SQL. No nosso exemplo nesse post a função TCSPExec em ADVPL executa uma stored procedure definida. Continue lendo→

Comandos ADVPL

Exit

1 minuto Olá, no post de hoje iremos falar de um dos comandos ADVPL, o comando Exit. O comando Exit em ADVPL causa a saída de um ciclo de repetição While … EndDo ou For … Next, transferindo o fluxo de execução do programa para a primeira linha de instrução imediatamente seguinte ao EndDo ou Next. Sintaxe: Exit Parâmetro(s): Nenhum Utilização: Utiliza-se o comando Exit para forçar a finalização de uma estrutura de repetição While … EndDo ou For … Next, Continue lendo→

Manipulação de String

Right

1 minuto A função Right retorna um determinado número da caracteres à direita de uma string passada como parâmetro. Ela é uma das funções de manipulação de string em ADVPL. Sintaxe: Left(cTexto,nNumCar) Parâmetro(s): Retorno: Observações: Caso o parâmetro nNumCar seja maior que o tamanho da string, será retornada a própria string informada no parâmetro; Caso o parâmetro nNumCar seja menor ou igual a 0 (zero), a função retornará uma string vazia; Caso o parâmetro nNumCar seja menor que 0 (zero), a Continue lendo→

SX6 - Parâmetros do Sistema

GetMV

1 minuto Olá, no post de hoje iremos falar da função GetMV, essa é uma das Funções de Parâmetros(SX6) em ADVPL. A função GetMV é responsável por obter o conteúdo de um parâmetro da tabela SX6 do dicionário de dados do TOTVS Protheus. Sintaxe: GetMV(cParam) Parâmetro(s): Retorno: Exemplo da função GetMV em ADVPL: Bem, finalizamos mais um post aqui do blog, espero que tenha entendido o conteúdo sobre a função GetMV. Qualquer dúvida deixe seu comentário abaixo ou nos Continue lendo→