CATáLOGOEn revisión

Catálogo histórico de includes de Protheus

#Include "<arquivo>.ch"

Consulta la finalidad observada en 50 archivos .ch históricos e identifica cuáles requieren validación actual.

IncludesHistoriaCompilaciónInventarioReferencia histórica

01 · DESCRIPCIÓN GENERAL

Descripción general

El paquete include_001.zip contiene 50 includes y un archivo de control de versiones. La mayoría está fechada el 28 feb. 2007 y contiene encabezados de copyright Microsiga 1997–2003; CTBR040.ch y CTBR150.ch son de 2005. El conjunto documenta la organización histórica de comandos, traducciones y constantes. Sirve para investigación y mantenimiento heredado, pero no sustituye el paquete oficial del release actual.

02 · SINTAXIS

Sintaxis

#Include "<arquivo>.ch"

Parámetros

Protheus.ch

Definiciones y comandos generalesOpcional

Reúne traducciones de funciones Protheus, comandos generales y varias includes especializadas. Símbolos observados: Functions U_, P_, T_, W_ e H_; STACKVAR; Dialog.ch; Font.ch; PTMenu.ch; Print.ch; Colors.ch.

TopConn.ch

SQL y DBAccessOpcional

Declara el comando TCQUERY utilizado para abrir resultados SQL mediante la RDD TOPCONN. Símbolos observados: TCQUERY.

TBIconn.ch

Entorno y RPCOpcional

Agrupa comandos históricos de preparación de entorno, conexión RPC, transacciones y tablas remotas. Símbolos observados: PREPARE ENVIRONMENT; RESET ENVIRONMENT; CREATE/CLOSE RPCCONN; CALLPROC.

StdWin.ch

Sintaxis e interfaz heredadaOpcional

Contiene numerosas traducciones xBase, comandos de flujo y construcciones visuales históricas. Símbolos observados: DO WHILE; ENDIF; ENDCASE; NEXT; DO; CALL; STORE.

SigaWin.ch

Interfaz Protheus heredadaOpcional

Amplía comandos visuales, de impresión y convenciones de funciones de la interfaz histórica de Protheus. Símbolos observados: Debug; BTNAUTFMT; PSAY; USER FUNCTION; PROW(); PCOL().

RWMake.ch

Compatibilidad heredadaOpcional

Reúne comandos antiguos de interfaz e impresión e incluye StdWin.ch. Debe estudiarse para mantenimiento, no adoptarse automáticamente. Símbolos observados: DIALOG; ACTIVATE DIALOG; BITMAP; PSAY; USER FUNCTION.

FileIO.ch

ArchivosOpcional

Define modos de apertura, uso compartido y posicionamiento de funciones de archivos de bajo nivel. Símbolos observados: F_ERROR; FS_SET; FS_RELATIVE; FS_END; FO_READ; FO_WRITE; FO_READWRITE.

Error.ch

Tratamiento de erroresOpcional

Define severidades y categorías numéricas utilizadas por objetos y rutinas de error. Símbolos observados: ES_WARNING; ES_ERROR; ES_CATASTROPHIC; EG_ARG; EG_BOUND; EG_ZERODIV; EG_SYNTAX.

DBInfo.ch

RDD y base de datosOpcional

Reúne identificadores de registros, capacidades RDD, bloqueos y características de tablas. Símbolos observados: DBRI_DELETED; DBRI_LOCKED; DBRI_RECNO; DBI_ISDBF; DBI_GETRECSIZE; DBI_GETLOCKARRAY.

VKey.ch

TecladoOpcional

Define códigos históricos de teclas virtuales usados en eventos de teclado e interfaz. Símbolos observados: VK_RETURN; VK_TAB; VK_SHIFT; VK_CONTROL; VK_ESCAPE e outras VK_*.

Colors.ch

ColoresOpcional

Define constantes de color y la traducción RGB() utilizada por componentes visuales. Símbolos observados: RGB(); CLR_BLACK; CLR_BLUE; CLR_RED; CLR_HGRAY e outras CLR_*.

WinAPI.ch

Windows heredadoOpcional

Reúne constantes de la API de Windows para ventanas, mensajes, botones y estilos. Depende de la plataforma y requiere cautela. Símbolos observados: IDOK; IDCANCEL; BN_CLICKED; CS_*; WS_*.

Retorno

Inventario editorial: 50 archivos .ch, un archivo .scc y 12 páginas prioritarias.

03 · EJEMPLO PRÁCTICO

Investigar una dependencia

// 1. Localiza el comando o la constante.
// 2. Busca el símbolo en las includes del release.
// 3. Confirma la documentación actual.
// 4. Incluye solo el archivo necesario.

Resultado esperado

La dependencia queda explícita y vinculada al release correcto.

BUENAS PRÁCTICAS

Utiliza el catálogo para localizar el posible origen de símbolos heredados.
Confirma cada símbolo en el paquete oficial del release.
Mantén TOTVS.ch como referencia general cuando así lo indique la documentación actual.
Las páginas individuales permanecen en revisión hasta confirmar el soporte.
El material didáctico generado por Google el 8 ago. 2026 se utilizó como pauta, pero sus afirmaciones fueron comprobadas y corregidas cuando confundían editor, preprocesador, funciones convencionales, persistencia MVC o keywords TLPP.

ERRORES COMUNES

Las fechas del ZIP pueden no ser las fechas originales de creación.
CTBR040.ch y CTBR150.ch contienen textos específicos de rutinas.
vssver.scc es metadato de control de versiones.
El paquete no contiene TOTVS.ch y no debe sustituir los archivos del entorno actual.
El contenido generado por IA es una fuente auxiliar; los ejemplos y equivalencias internas requieren verificación técnica.

Contenido relacionado

REFERENCIAS

MICROSIGA SOFTWARE S.A. include_001.zip. Paquete histórico suministrado al proyecto el 8 ago. 2026.
GOOGLE. Diccionario de Comandos, Constantes Comunes y Ejemplos Prácticos. Generado el 8 ago. 2026; revisado y adaptado por la Guía AdvPL.

Estado: En revisión
Página creada el: 08/08/2026 a las 22:05
Última revisión el: 08/08/2026 a las 22:35
Idioma original: Portugués
Revisión: Usina.BR