Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNDAMENTOEm revisão

SX3 — Campos

Define a estrutura e propriedades dos campos.

SX3 — CamposAdvPL
01 · VISÃO GERAL

Visão geral

SX3 integra estrutura e apresentação: tipo, tamanho, decimais e regras precisam acompanhar os consumidores do campo. Não fixe comprimento de código de produto no fonte quando ele pode variar no dicionário. O exemplo comunitário usa TamSX3 e acessa tamanho e decimais nas duas primeiras posições; aqui validamos tipo e comprimento antes de indexar, sem afirmar que essas são todas as posições possíveis. O exemplo não modifica metadados e seu resultado varia conforme a configuração. (Fontes: refs. 1–2.)

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed683()
    Local aInfo := TamSX3("B1_COD")
    // Validar a estrutura observada antes de acessar suas posicoes.
    If ValType(aInfo) == "A"
        If Len(aInfo) >= 2
            ConOut(aInfo[1])
            ConOut(aInfo[2])
        EndIf
    EndIf
Return Nil
Resultado esperado

Em ambiente preparado, exibe tamanho e decimais de B1_COD se o retorno tiver a estrutura esperada. Valores não são fixados aqui. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Alteração de tamanho exige revisar grupos de campos, índices, integrações e base física; usar ferramenta suportada e homologar dependências.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. Dicionário de Dados: tabelas, funções e usos. Consulta em 2026-10-28.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_469_Funcao_TamSX3.prw. Arquivo completo consultado; adaptação editorial. Consulta em 2026-10-28.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha