ProtheusAdvpl

Manipulação de String

Formatando uma String para ser Utilizada no Operador IN do SQL com FormatIn em ADVPL

1 minuto A função FormatIn em ADVPL formata uma String passada como parâmetro para ser utilizada no operador IN do SQL e assim ser executada numa query SQL. Ela é uma das funções de Manipulação de String em ADVPL. Sintaxe: FormatIn( <cString>, <cSep> ) Parâmetro(s): Retorno: Exemplo da função FormatIn 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 e fica com Deus. Links Continue lendo→

Manipulação de Data e Hora

Retornando o Mês de uma Data com Month em ADVPL

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→

Funções de Tabelas Genéricas-SX5

Obtendo Informações de Tabelas Genéricas(SX5) com FWGetSX5 em ADVPL

2 minutos A função FWGetSX5 em ADVPL obtém informações de tabelas genéricas(SX5) do TOTVS Protheus, como filial, tabela, chave e descrição. Ela é uma das funções de manipulação das tabelas genéricas SX5 do Protheus. Sintaxe: FWGetSX5(cTab,cChave,cIdioma) Parâmetros: Retorno: Exemplo da função FWGetSX5 em ADVPL: Abaixo temos o console.log(gerado dentro do TOTVS AppServer) mostrando os registros da SX5 através da função FWGetSX5: Bem, por hoje finalizamos mais um post aqui do Blog/Site ProtheusAdvpl. Espero que você tenha entendido. Se tiver ficado Continue lendo→

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

Obtendo Informações da Última Query Executada com GetLastQuery em ADVPL

2 minutos A função GetLastQuery() em ADVPL a última query executada via BeginSql / EndSqldentro 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 Continue lendo→

Manipulação de String

Convertendo um Texto para Letras Maiúsculas com Upper em ADVPL

1 minuto A função Upper em ADVPL 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 da função 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

Retornando o Dia do Mês de uma Data com Day em ADVPL

1 minuto A função Day em ADVPL 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. Continue lendo→

Manipulação de Arquivos, Discos e IO

Mostrando uma Mensagem do TOTVS AppServer em Console com ConOut em ADVPL

2 minutos A função ConOut mostra uma mensagem do TOTVS AppServer em console e também acrescenta uma mensagem no arquivo de console(console.log), quando o TOTVS AppServer está sendo executado em modo console. Ela é uma das funções de manipulação de arquivos, discos e IO em ADVPL. 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 terminal Continue lendo→

TDS 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→

Manipulação de Variáveis Numéricas

Arredondando um Valor Numérico com Round em ADVPL

1 minuto A função Round em ADVPL arredonda um valor numérico até uma quantidade especificada de casas decimais. É uma das funções de manipulação de variáveis numéricas em ADVPL. 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 número de casas decimais 2, contido Continue lendo→

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

Verificando se o Posicionamento dos Registros de um Alias/Tabela está no Início com BoF em ADVPL

1 minuto A função BoF em ADVPL verifica se o posicionamento dos registros está no início do alias/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 Continue lendo→

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

Posicionando no Primeiro Registro de um Alias/Tabela com DBGoTop em ADVPL

2 minutos A função DBGoTop em ADVPL 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 Continue lendo→

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

Retornando Alias de uma Tabela com Alias em ADVPL

2 minutos A função Alias em ADVPL retorna o alias (Ex.:”SA1″) de uma tabela ou á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á Continue lendo→

Manipulação de String

Removendo Espaços em Branco à Esquerda de uma String com LTrim em ADVPL

2 minutos A função LTrim em ADVPL 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→

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

Verificando se um Alias/Tabela Está Aberto com Select

2 minutos A função Select em ADVPL verifica de um alias/tabela está aberto para uso. Se tiver ela retorna um número que pode variar de 0(zero) a 250. Se não for especificado, é retornado o número do Alias/Tabela 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 Continue lendo→

Manipulação de Array

Copiando Elementos de um Array para Outro com aCopy em ADVPL

2 minutos A função aCopy em ADVPL 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 Continue lendo→

Manipulação de Array

Duplicando um Array com aClone em ADVPL

1 minuto A função aClone em ADVPL 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 Continue lendo→

Funções de Gatilhos de Campos-SX7

Executando um Gatilho(SX7) de um Campo com RunTrigger em ADVPL

2 minutos A função RunTrigger em ADVPL executa um gatilho(SX7) de um campo(SX3) informado no parâmetro. Ela é uma das Funções de Manipulação de Gatilhos de Campos(SX7) em ADVPL. 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á que por ser um processo manual o Protheus Continue lendo→

Manipulação de String

Replicate

1 minuto A função Replicate é utilizada para replicar(repetir) uma string um número de vezes informado. Elá é uma das funções de manipulação de string em ADVPL. Sintaxe: Replicate(cString,nVezes) Parâmetro(s): Retorno: Exemplo da função Replicate em ADVPL: É isso aí, finalizamos aqui o post sobre a função Replicate 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/Replicate

Manipulação de String

Adicionando Caracteres de Preenchimento à Direita do Conteúdo de uma Variável com PadR em ADVPL

2 minutos A função PadR em ADVPL tem por finalidade adicionar caracteres de preenchimento à direita do conteúdo de uma variável passada como parâmetro. Ela é uma das funções de Manipulação de String em ADVPL. 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 Continue lendo→

Funções de Gatilhos de Campos-SX7

Verificando se Existe um Gatilho(SX7) para um Campo com ExistTrigger em ADVPL

2 minutos A função ExistTrigger em ADVPL verifica se existe um gatilho(SX7) de um determinado campo(SX3) informado no parâmetro. Ela é uma das Funções de Manipulação de Gatilhos de Campos(SX7) em ADVPL. 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 é de forma padrão Continue lendo→

Rejeições/Erros

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

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

Funções de Campos das Tabelas-SX3

Obtendo o Conteúdo de um Campo(SX3) com GetSX3Cache em ADVPL

2 minutos A função GetSX3Cache em ADVPL obtém o conteúdo de um campo da SX3(Campos das Tabelas) 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 lendo→

Funções de Campos das Tabelas-SX3

Obtendo Informações de um Campo(SX3) com TamSX3 em ADVPL

2 minutos A função TamSX3 em ADVPL obtém informações de um campo(SX3) como o tamanho do campo, 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). Ela é uma das Funções de Campos(SX3) em ADVPL. Sintaxe: TamSx3(cCampo)[nInd] Parâmetro(s): Retorno: Exemplo da função TamSX3 em ADVPL: Continue lendo→

Manipulação de Data e Hora

Day2Str

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

Uncategorized

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

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

Pontos de Entrada

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

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

Manipulação de Variáveis Numéricas

Obtendo a Parte Inteira de um Numérico com Int em ADVPL

1 minuto A função Int em ADVPL obtém a parte inteira de um numérico passado como parâmetro, desconsiderando todos os dígitos à direita do ponto decimal. Ela é uma das funções de manipulação de variáveis numéricas em ADVPL. 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 e-mail para adiliocosta@protheusadvpl.com.br, até um Continue lendo→

Manipulação de Data e Hora

Obtendo o Nome do Dia da Semana em Inglês de uma Data com CDow em ADVPL

2 minutos A função CDow em ADVPL obtém o nome do dia da semana em inglês de uma data passada como parâmetro. Ela é uma das funções de manipulação de data e hora em ADVPL. 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 lendo→

TDS VSCode

Como Instalar e Configurar o TOTVS VSCode

8 minutos Olá, aqui é Adilio Costa, no post de hoje iremos aprender como instalar e configurar o TOTVS VSCode(Plugin TOTVS Developer Studio for VSCode), a nova extensão de ADVPL/TL++ da Totvs para a IDE VSCODE. No post iremos abordar os seguintes tópicos: Baixando e Instalando o VSCode Para baixarmos o VSCode acesse o link Download VSCode, você deverá ver uma tela como a imagem abaixo: Nesse post iremos instalar o VSCode para o sistema operacional Windows, mas você poderá instalar em outras plataformas Continue lendo→

Configuração de Perguntas(CFGA540)

Como Configurar Perguntas e Bloquear Parâmetros de Relatórios do Protheus 12

6 minutos Olá, no post de hoje iremos aprender como configurar perguntas e bloquear parâmetros de relatórios do Protheus 12. A utilização desse recurso de configuração de perguntas é ideal para situações em que queremos restringir informações de relatórios a certos usuários do protheus. Para entender melhor vamos a um cenário que ocorreu em uma empresa cliente que prestamos serviço: Todo final de mês o setor da contabilidade precisa solicitar informações de valores de pagamentos ao setor pessoal, valores de folha de pagamento, Continue lendo→