ProtheusAdvpl

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

Como Executar Instruções SQL com TCSQLExec no ADVPL

1 minute 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→

Funções de Manipulação de Usuários

UsrRetName

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

Funções de Manipulação de Usuários

RetCodUsr

1 minute 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→

Manipulação de String

FormatIn

1 minute 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→

Manipulação de Data e Hora

Month

1 minute 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→

SX5 - Tabelas Genéricas

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

2 minutes 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→

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

GetLastQuery

2 minutes 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→

Manipulação de String

Upper

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

Manipulação de Data e Hora

Day

1 minute 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→

Manipulação de Arquivos, Discos e IO

ConOut

1 minute 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→

TOTVS VSCode

Como Configurar o SmartClient no TOTVS VSCode

2 minutes 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→

Manipulação de Variáveis Numéricas

Round

1 minute 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→

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

BoF

1 minute 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→

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

DBGoTop

2 minutes 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→

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

Alias

1 minute 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→

Manipulação de String

LTrim

2 minutes 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→

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

Select

2 minutes 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→

Manipulação de Array

aCopy

1 minute 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→

Manipulação de Array

aClone

1 minute 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→

SX7 - Gatilhos de Campos

RunTrigger

1 minute 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→

Manipulação de String

PadR

2 minutes 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→

SX7 - Gatilhos de Campos

ExistTrigger

1 minute Olá, no post de hoje iremos falar de uma das Funções de Gatilhos(SX7)em ADVPL, a função ExistTrigger. Essa função tem por objetivo verificar se existe um gatilho(SX7) para o campo que informamos no parâmetro. Esse processo de verificar a existência de um gatilho(SX7) ajuda em certos tipos de customizações que fazemos no TOTVS Protheus, como por exemplo numa importação de uma planilha(.csv) onde preenchemos um array aCols de uma tela de grid, nesse caso como os processo de inserção das informações não Continue→

Rejeições

Como Corrigir no Protheus a Rejeição 230:IE do Emitente não Cadastrada

3 minutes Olá, no post de hoje iremos aprender como corrigir no protheus a rejeição 230:IE do emitente não cadastrada. Existem algumas situações que podem ocasionar a rejeição 230 de IE(inscrição estadual) não cadastrada na processo de transmissão de nota fiscal eletrônica no Protheus dentre as quais iremos falar agora. Verificar se a inscrição estadual da filial da nota estar preenchida Verificar se o cadastro da inscrição estadual está habilitado no SINTEGRA Verificar no XML da Nota se a tag <IE> tá preenchido com Continue→

SX3 - Campos das Tabelas

GetSX3Cache

1 minute A função GetSX3Cache retorna o conteúdo da SX3(Campos das Tabelas) de um campo informado no parâmetro. Ela é uma das Funções da SX3(Campos das Tabelas) do TOTVS Protheus. Sintaxe: GetSX3Cache(cCampDic,cCampSX3) Parâmetro(s): Retorno: Exemplo da função GetSX3Cache em ADVPL: Podemos ver na imagem abaixo que a função GetSX3Cache retornou o conteúdo da coluna X3_TITULO que se refere ao campo A2_NOME, nesse caso ela retornou o nome “Razão Social” que é o título do campo A2_NOME da tabela de Continue→

SX3 - Campos das Tabelas

TamSX3

1 minute Olá, no post de hoje iremos falar de uma das Funções de Campos(SX3) em ADVPL, a função TamSX3. Essa função tem por objetivo retornar o tamanho de um campo, seu decimal e seu tipo de dado, baseado na tabela de campos SX3. Basicamente essa função retorna um array com informações do campo passado como parâmetro (aCampo[1] = Tamanho do campo, aCampo[2] = Tamanho do decimal do campo, aCampo[3] = Tipo de dado do campo). Sintaxe: TamSx3(cCampo)[nInd] Parâmetro(s): Retorno: Exemplo em ADVPL: Continue→

Manipulação de Data e Hora

Day2Str

1 minute A função Day2Str é uma das funções de manipulação de data e hora em ADVPL. Essa função retorna o dia no formato DD dia uma data informada no parâmetro. Sintaxe: Day2Str (dData) Parâmetro(s): Retorno: Exemplo em ADVPL da função Day2Str: É isso aí, finalizamos aqui o post sobre a função Day2Str 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: Continue→

Uncategorized

Como Corrigir o Erro DBSetOrder – Index not found: XXX Order Number: 1

1 minute Olá, no post de hoje aqui do blog iremos ver como corrigir o erro DBSetOrder – Index not found: XXX Order Number: 1, ocasionado quando entramos em algum rotina do TOTVS Protheus. Conforme indica a mensagem, o erro informa que não foi encontrado o índice da tabela XXX, onde poderá ser uma ou mais dessas tabelas, XX6(Catálogo de Personalizações(CFGA030) e XX7(Itens do Catalogo de Personalizacões). O erro DBSetOrder muitas vezes é ocasionado quando há dois RPOs(Repositórios de Objetos) apontando para a mesma Continue→

Pontos de Entrada

F040CPO – Permissão Para Alteração Em Campos do Contas a Receber(FINA040)

1 minute Bom dia. No post de hoje iremos falar do ponto de entrada F040CPO da rotina do contas a receber(FINA040) do módulo Financeiro(SIGAFIN) do TOTVS Protheus. O ponto de entrada F040CPO tem por finalidade habilitar a alteração de campos(SE1) pois em algumas situações esses campos ficam desabilitados para edição para manter a integridade de informações entre o financeiro e a contabilidade. No exemplo abaixo temos o exemplo em ADVPL de como utilizar esse ponto de entrada: Rotina do contas a receber(FINA040) sem o Continue→

Manipulação de Variáveis Numéricas

Int

1 minute 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 Int. Essa função retorna a parte inteira de um valor especificado no parâmetro, desconsiderando todos os dígitos à direta do ponto decimal. Sintaxe: Int(nValor) Parâmetros(s): Retorno: Exemplo da função Int em ADVPL: É isso aí, finalizamos aqui o post sobre a função Int em ADVPL, caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um Continue→

Manipulação de Data e Hora

CDow

1 minute A função CDow é uma das funções de manipulação de data e hora em ADVPL. Essa função retorna o dia da semana de uma determinada data, no formato de uma string, no idioma Inglês. Sintaxe: cDow(dData) Parâmetro(s): Retorno: No exemplo abaixo podemos ver como utilizar a função CDow em ADVPL, utilizamos algumas condições para mostra o dia da semana em português já que a função CDow retorna o dia da semana em inglês: É isso aí, finalizamos aqui o Continue→