Protheus | Programação

UPDATE em campo MEMO no Protheus — Como Fazer via SQL
SQL e Banco de Dados

UPDATE em campo MEMO no Protheus — Como Fazer via SQL

4 minutos No dia a dia de um Analista Protheus, deparamo-nos com situações onde a manipulação de dados via interface ou rotinas padrão não é suficiente ou performática o bastante. Um dos desafios mais técnicos e cercados de dúvidas é a manutenção de campos do tipo MEMO. Diferente de campos de texto comuns, os campos MEMO no Protheus, quando hospedados em bancos de dados como o Microsoft SQL Server, são armazenados de forma especial. Tentar executar um UPDATE em campo MEMO de maneira convencional Continue lendo→

Pesquisando um Registro de um Alias/Tabela com DBSeek em ADVPL
SQL e Banco de Dados

Pesquisando um Registro de um Alias/Tabela com DBSeek em ADVPL

2 minutos A função DBSeek em ADVPL pesquisa um registro de um alias/tabela ativo, com as informações especificadas na chave de busca, fornecendo um retorno lógico indicando se a pesquisa foi efetuada 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 lendo→

DBSelectArea em ADVPL — Como Posicionar Áreas de Trabalho
SQL e Banco de Dados

DBSelectArea em ADVPL — Como Posicionar Áreas de Trabalho

5 minutos No desenvolvimento de rotinas customizadas no ERP Protheus, a manipulação de múltiplas tabelas simultaneamente é uma constante. Seja para realizar um join manual, validar dados entre diferentes módulos ou gerar relatórios complexos, o desenvolvedor precisa saber exatamente em qual “gaveta” de dados está operando. A função DBSelectArea em ADVPL é o comando fundamental responsável por alternar o foco da thread entre as diversas áreas de trabalho abertas, sendo um conceito vital dentro de ADVPL no Protheus: Dados e Estrutura.   Neste guia Continue lendo→

Como Configurar o SmartClient no TOTVS VSCode
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→

DBGoTop em ADVPL — Como Posicionar no Primeiro Registro
SQL e Banco de Dados

DBGoTop em ADVPL — Como Posicionar no Primeiro Registro

4 minutos No desenvolvimento de rotinas no ERP Protheus, o controle preciso sobre o ponteiro das tabelas é o que diferencia um código estável de um sistema propenso a erros. Muitas vezes, após realizar filtros ou contagens, o ponteiro da tabela acaba no final do arquivo (EOF), e é necessário retornar ao início para processar os dados. A função DBGoTop em ADVPL é o comando nativo responsável por esse reposicionamento lógico, sendo um conceito vital dentro de ADVPL no Protheus: Dados e Estrutura. Neste Continue lendo→

Select em ADVPL — Como Verificar se um Alias está Aberto
SQL e Banco de Dados

Select em ADVPL — Como Verificar se um Alias está Aberto

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→

Como Instalar e Configurar o TOTVS VSCode
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→

At em ADVPL — Como Obter a Posição de uma Substring no Protheus
Manipulação de String

At em ADVPL — Como Obter a Posição de uma Substring no Protheus

3 minutos No desenvolvimento Protheus, a necessidade de encontrar um padrão dentro de um texto é constante. Seja para validar o formato de um e-mail, extrair uma informação de uma chave de nota fiscal ou tratar retornos de APIs, você precisa saber exatamente onde um caractere começa. A função At em ADVPL é a ferramenta nativa para localizar a primeira ocorrência de uma substring, sendo um conceito base em Fundamentos do ADVPL.   Neste guia prático, você aprenderá a sintaxe da função At, como Continue lendo→

Asc em ADVPL — Como Obter o Código ASCII de um Caractere
Manipulação de String

Asc em ADVPL — Como Obter o Código ASCII de um Caractere

3 minutos No desenvolvimento Protheus, muitas vezes precisamos realizar validações de baixo nível, como identificar caracteres especiais, tratar quebras de linha ou validar a entrada de dados em campos de texto. A função Asc em ADVPL é a ferramenta nativa para retornar o valor numérico (código ASCII) de um caractere, sendo um conceito base em Fundamentos do ADVPL.   Neste guia prático, você aprenderá a sintaxe da função Asc, como ela se comporta com strings de múltiplos caracteres e como utilizá-la em conjunto com Continue lendo→

cValToChar em ADVPL — Como Converter Tipos de Dados para Caractere
Conversão de Dados

cValToChar em ADVPL — Como Converter Tipos de Dados para Caractere

3 minutos   No desenvolvimento Protheus, a conversão de tipos de dados é uma tarefa obrigatória. Muitas vezes precisamos exibir o conteúdo de uma variável numérica, lógica ou de data em uma mensagem para o usuário ou gravá-la em um arquivo de texto. A função cValToChar em ADVPL é a ferramenta mais versátil para isso, pois permite converter diversos tipos de dados para String de forma simplificada, sendo um pilar em Fundamentos do ADVPL.   Neste guia prático, você aprenderá a sintaxe da função Continue lendo→

Adicionando um Elemento em um Array com aAdd em ADVPL
Manipulação de Array

Adicionando um Elemento em um Array com aAdd em ADVPL

2 minutos A função aAdd em ADVPL adiciona um novo elemento no final de um array, aumentando o seu tamanho. O conteúdo do novo elemento será o resultado fornecido pela expressão. Ela é uma das funções de manipulação de array em ADVPL. *Caso a expressão não seja especificada, será atribuído o valor NIL ao novo elemento.   Sintaxe: aAdd( < aDest >, < xExpr > )   Parâmetros:     Retorno:   A função aAdd simplifica alguma situações, por exemplo, nós poderíamos ter a seguinte Continue lendo→

aSize em ADVPL — Como Alterar o Tamanho de um Array no Protheus
Manipulação de Array

aSize em ADVPL — Como Alterar o Tamanho de um Array no Protheus

4 minutos No desenvolvimento Protheus, trabalhar com coleções de dados exige flexibilidade. Muitas vezes, iniciamos um processo com um array de tamanho fixo, mas precisamos expandi-lo para comportar novos registros ou reduzi-lo para otimizar a memória. A função aSize em ADVPL é a ferramenta nativa para realizar esse redimensionamento, sendo um conceito fundamental em Manipulação de Array.   Neste guia prático, você aprenderá como utilizar a aSize para aumentar ou diminuir arrays, entendendo o comportamento do sistema com valores nulos e descarte de elementos. Continue lendo→

Str em ADVPL — Como Converter Número em String
Conversão de Dados

Str em ADVPL — Como Converter Número em String

3 minutos No dia a dia do desenvolvedor Protheus, a conversão de tipos de dados é uma das tarefas mais recorrentes. Seja para exibir um valor numérico em uma mensagem de alerta ou para concatenar um código com uma descrição, você precisará transformar números em texto. A função Str em ADVPL é a ferramenta nativa para essa finalidade, sendo um pilar essencial em Fundamentos do ADVPL.   Neste guia objetivo, vamos entender como a Str funciona, seus parâmetros de tamanho e decimais, e como Continue lendo→

Convertendo uma String Formatada(aaaammdd) para Data com SToD em ADVPL
Conversão de Dados

Convertendo uma String Formatada(aaaammdd) para Data com SToD em ADVPL

1 minuto A função SToD  em ADVPL converte uma String formatada(aaaammdd) para o tipo de dado Data no formato americano de mês, dia e ano(mm/dd/aa). Ela é uma das funções para conversão de tipo de dados em ADVPL. É o inverso da função DToS. Sintaxe: SToD(cData)   Argumento(s):   Retorno:   Exemplo: No exemplo abaixo utilizamos a função SToD e informamos como parâmetro a função a string “20230711” e o retorno é uma data no formato americano mês, dia e ano mm/dd/aa. Exemplo da Continue lendo→

DToS em ADVPL — Como Converter Data para String Formatada
Conversão de Dados

DToS em ADVPL — Como Converter Data para String Formatada

3 minutos No desenvolvimento Protheus, a manipulação de datas exige precisão, especialmente quando precisamos criar chaves de busca ou ordenar registros em arquivos temporários. A função DToS em ADVPL é a ferramenta nativa para converter uma variável do tipo Data para uma String no formato AAAAMMDD. Diferente da função DTOC, que segue o padrão local (DD/MM/AA), a DToS garante que a ordenação alfabética coincida com a cronológica, um conceito base em Fundamentos do ADVPL. este guia objetivo, você aprenderá a sintaxe da função DToSe Continue lendo→