Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

FieldPut

FieldPut( nPos, xValue ) --> xRet

Asigna valor tipado a campo de registro bloqueado.

FieldPutAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

FieldPut requiere valor compatible y bloqueo como asignación directa. Devuelve valor asignado, no éxito completo de negocio. GitHub cambia quinto campo SA1 sin comprobar RecLock; adaptación usa tabla propia, localiza nombre, comprueba tipo/tamaño y escribe solo con lock. No sustituye validación ni errores de rutina completa. EDTRB es alias propio de prueba abierto; ED_COD, si se utiliza, es campo carácter de tamaño 10 del esquema didáctico. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

FieldPut( nPos, xValue ) --> xRet

Parámetros

nPos
NuméricoObligatorio

Posición válida del campo.

xValue
CualquieraObligatorio

Valor compatible con tipo/tamaño.

Retorno

Valor asignado; Nil si número de campo inválido.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed385()
    Local nPosicion
    Local aEstructura
    Local cValor := "MUESTRA"
    If Select("EDTRB") > 0
        nPosicion := EDTRB->(FieldPos("ED_COD"))
        If nPosicion > 0 .And. !EDTRB->(Eof())
            aEstructura := EDTRB->(DBStruct())
            If aEstructura[nPosicion,2] == "C" .And. aEstructura[nPosicion,3] >= Len(cValor)
                // Escribir solo en registro de prueba bloqueado.
                If RecLock("EDTRB", .F.)
                    EDTRB->(FieldPut(nPosicion, cValor))
                    EDTRB->(MsUnlock())
                EndIf
            EndIf
        EndIf
    EndIf
Return Nil
Resultado esperado

Asigna texto ficticio solo con requisitos; sin prueba de persistencia Protheus. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Usar solo tabla propia con estructura conocida. Calificar alias, comprobar posición y administrar contexto según contrato.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. FieldPut. TDN. Consulta el 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Acesso a Dados/FieldPut.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. Consulta el 2026-10-26.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha