Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

GETSXENUM()

GetSXENum(cAlias,cCampo,[cAliasSXE],[nOrdem],[cGroup],[cBranch])

Obtém numeração sequencial no controle SXE/SXF ou servidor de numeração.

GETSXENUM()AdvPL
01 · VISÃO GERAL

Visão geral

Alias e campo são obrigatórios; ordem de índice, alias de controle e grupo/filial são opcionais. A ordem padrão 1 exige que o campo numerado seja o primeiro após filial. Grupo e filial só têm efeito quando ambos são informados. A TOTVS desaconselha chamada direta no inicializador padrão, pois ela pode reservar números fora de inclusão. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

GetSXENum(cAlias,cCampo,[cAliasSXE],[nOrdem],[cGroup],[cBranch])

Parâmetros

cAlias
CaractereObrigatório

Alias numerado.

cCampo
CaractereObrigatório

Campo numerado.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed474()
    // Bloco nao executado: reserva exige fluxo de confirmacao ou liberacao.
    Local bReserve := {|cAlias,cField,nOrder| GetSXENum(cAlias,cField,,nOrder)}
    ConOut(ValType(bReserve))
Return Nil
Resultado esperado

Prepara bloco sem consumir número; não é uma implementação completa de inclusão. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Integrar confirmação ou rollback da reserva ao resultado real da operação; não confirmar apenas porque um número foi obtido.
  • 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. GETSXENUM%28%29. TDN. Consulta em 2026-10-27.
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