VTableInfo

Las funciones de esta clase permiten acceder a la información de la estructura de una tabla.
Tiene funciones generales de la tabla, como ver su id o su tipo, y funciones para obtener información de sus subobjetos: campos, indices e históricos.
También nos permite obtener otros VTablaInfo de las tablas enlazadas como maestros o históricos.
Funciones
De tabla
Retorno
Función
String
​comments()
String
​id()
String
​idRef()
Boolean
​isInMemory()
String
​name()
Number
​registerLength()
String
​singleName()
Number
​type()
De campos
Retorno
Función
Numer
​fieldBindType( Number nCampo )
String
​fieldBoundedTableId( Number nCampo )
VTableInfo
​fieldBoundedTableInfo( Number nPlural )
Number
​fieldBufferLen( Number nCampo )
String
​fieldComments( Number nCampo )
String
​fieldComments( String szIdCampo )
Number
​fieldCount()
Number
​fieldDecimals( Number nCampo )
String
​fieldId( Number nCampo )
Boolean
​fieldIsSigned( Number nCampo )
Number
​fieldMaximumValue( Number nCampo )
Number
​fieldMinimumValue( Number nCampo )
String
​fieldName( Number nCampo )
String
​fieldName( Number nCampo, Number nLenguaje, [Number nPais=0] )
String
​fieldName( String szIDPrimarioCampo )
String
​fieldName( String szIDPrimarioCampo, Number nLenguaje, [Number nPais=0] )
Number
​fieldObjectType( Number nCampo )
String
​fieldParentFieldId( Number nCampo )
Number
​fieldParentFieldNumber( Number nCampo )
Number
​fieldType( Number nCampo )
De índices
Retorno
Función
Number
​indexCount()
String
​indexId( Number nIndex )
String
​indexName( Number nIndex )
Number
​indexType( Number nIndex )
De históricos
Retorno
Función
String
​pluralBoundedIndexId( Number nPlural )
​VObjectInfo​
​pluralBoundedIndexInfo( Number nPlural )
String
​pluralBoundedTableId( Number nPlural )
VTableInfo
​pluralBoundedTableInfo( Number nPlural )
Number
​pluralCount()
String
​pluralId( Number nPlural )
String
​pluralName( Number nPlural )
De localizadores por Id
Retorno
Función
Number
​findField( String szIDPrimarioCampo )
Number
​findIndex( String szIDPrimarioIndice )
Number
​findPlural( String szIDPrimarioHist )
Enumeraciones
Tipos de campo
FieldTypeAlpha256 = 00 - Alfa 256
FieldTypeAlpha128 = 01 - Alfa 128
FieldTypeAlpha64 = 02 - Alfa 64
FieldTypeAlpha40 = 03 - Alfa 40
FieldTypeAlphaLatin1 = 04 - Alfa Latin1
FieldTypeAlphaUtf16 = 05 - Alfa UTF-16
FieldTypeNumeric = 06 - Numérico
FieldTypeDate = 07 - Fecha
FieldTypeTime = 08 - Hora
FieldTypeDateTime = 09 - Tiempo (fecha y hora)
FieldTypeBool = 10 - Booleano
FieldTypeObject = 11 - Objeto
FieldTypeFormulaNumeric = 12 - Fórmula numérica
FieldTypeFormulaAlfa = 13 - Fórmula alfabética
FieldTypeFormulaDate = 14 - Fórmula fecha
FieldTypeFormulaDateTime = 15 - Fórmula tiempo (fecha y hora)
FieldTypeVirtualBind = 18 - Puntero virtual
Tipos de campos objeto
ObjectTypePicture = 0 - Imagen
ObjectTypeText = 1 - Texto
ObjectTypeRichText = 2 - Texto enriquecido
ObjectTypeBinary = 3 - Binario
ObjectTypeFormula = 4 - Fórmula dinámica
Tipos de enlaces de campo (bindType)
BindTypeNone = 0 - Ninguno
BindTypeMaster = 1 - Tabla maestra
BindTypeStatic = 2 - Tabla estática
BindTypeIndirectReal = 3 - Indirecto real
BindTypeIndirectVirtual = 4 - Indirecto virtual
BindTypeSingularPluralPos = 5 - Singular de plural por posición
BindTypeSingularPluralIndex = 6 - Singular de plural por índice
BindTypeAdjacentSibling = 7 - Hermano contiguo
BindTypeMasterExt = 8 - Maestro de extensión
Tipos de índices
IndexTypeSingleKey = 0 - Clave única
IndexTypeWords = 1 - Palabras
IndexTypeMultiKey = 2 - Múltiples claves
IndexTypeAcceptRepeat = 3 - Acepta repetidas
IndexTypeWordParts = 4 - Trozos de palabras
Tipos de tablas
TypeMaster = 0 - Maestra
TypeHistorical = 1 - Histórica
TypeMasterSub = 2 - Submaestra
TypeMasterTree = 3 - Arbolada
TypeMasterExt = 4 - Maestro de extensión
Documentación de funciones
Funciones de tabla
String comments()
Devuelve el valor de la propiedad comentarios de la tabla.
Esta función se ha incorporado al API a partir de la versión 7.14
String id()
Devuelve el identificador de la tabla. Por ejemplo: "CLIENTES".
String idRef()
Devuelve el idRef (Alias_Aplicación/Id_Tabla) de la tabla. Por ejemplo: "ERP/CLIENTES".
Boolean isInMemory()
Devuelve true si la tabla reside en memoria.
String name()
Devuelve el nombre plural de la tabla en el idioma configurado. Si no se especifican valores asume el idioma en curso. El código de país es opcional.
Parámetros:
nLenguage: código del idioma. Ver tabla de idiomas en documentación de Qt.
nPais: código del país. Ver tabla de idiomas en documentación de Qt.
Number registerLength()
Devuelve la longitud en bytes del registro de la tabla.
String singleName()
Devuelve el nombre singular de la tabla.
Number type()
Devuelve el código de tipo de tabla. Ver enum de tipos de tablas.
Funciones de campos
Numer fieldBindType( Number nCampo )
Devuelve el tipo de enlace del campo. Ver enum de tipos de enlaces de campo.
Parámetros:
nCampo: número de campo, el primero es el 0.
String fieldBoundedTableId( Number nCampo )
Devuelve el identificador de la tabla enlazada.
Parámetros:
nCampo: número de campo, el primero es el 0.
VTableInfo fieldBoundedTableInfo( Number nPlural )
Devuelve un objeto de la clase VTableInfo de la tabla enlazada.
Parámetros:
nPlural: número ordinal del plural en la tabla.
Number fieldBufferLen( Number nCampo )
Devuelve el tamaño en bytes de los caracteres que admite el buffer del campo. Por ejemplo un campo Alfa40 de 2 bytes de buffer, que puede almacenar 3 caracteres, devolverá 2.
Parámetros:
nCampo: número de campo, el primero es el 0.
String fieldComments( Number nCampo )
Devuelve el valor de la propiedad comentarios del campo.
Parámetros:
nCampo: número de campo, el primero es el 0.
Esta función se ha incorporado al API a partir de la versión 7.14
String fieldComments( String szIdCampo )
Devuelve el valor de la propiedad comentarios del campo.
Parámetros:
szIdCampo: identificador del campo.
Esta función se ha incorporado al API a partir de la versión 7.14
Number fieldCount()
Devuelve el número de campos del registro de la tabla.
Number fieldDecimals( Number nCampo )
Devuelve el nº de decimales de un campo numérico.
Parámetros:
nCampo: número de campo, el primero es el 0.
String fieldId( Number nCampo )
Devuelve el identificador del campo.
Parámetros:
nCampo: número de campo, el primero es el 0.
Boolean fieldIsSigned( Number nCampo )
Devuelve true si el campo numérico admite signo.
Parámetros:
nCampo: número de campo, el primero es el 0.
Number fieldMaximumValue( Number nCampo )
Devuelve el valor máximo de un campo numérico.
Parámetros:
nCampo: número de campo, el primero es el 0.
Number fieldMinimumValue( Number nCampo )
Devuelve el valor mínimo de un campo numérico.
Parámetros:
nCampo: número de campo, el primero es el 0.
String fieldName( Number nCampo )
Devuelve el nombre del campo.
Parámetros:
nCampo: número de campo, el primero es el 0.
String fieldName( Number nCampo, Number nLenguaje, [Number nPais=0] )
Devuelve el nombre del campo en el idioma y país especificados en los parámetros.
Parámetros:
nCampo: número de campo, el primero es el 0.
nLenguaje: número que corresponde al código del lenguaje (Tabla de código Qt).
nPais: número que corresponde al código del país (Tabla de códigos Qt).
String fieldName( String szIDPrimarioCampo )
Devuelve el nombre del campo.
Parámetros:
szIDPrimarioCampo: identificador del campo.
String fieldName( String szIDPrimarioCampo, Number nLenguaje, [Number nPais=0] )
Devuelve el nombre del campo en el idioma y país especificados en los parámetros.
Parámetros:
szIDPrimarioCampo: identificador del campo.
nLenguaje: número que corresponde al código del lenguaje (Tabla de código Qt).
nPais: número que corresponde al código del país (Tabla de códigos Qt).
Number fieldObjectType( Number nCampo )
Devuelve el tipo de objeto de un campo objeto. Ver enum de tipos de campos objeto.
Parámetros:
nCampo: número de campo, el primero es el 0.
String fieldParentFieldId( Number nCampo )
Devuelve el identificar del campo padre de una tala submaestra.
Parámetros:
nCampo: número de campo, el primero es el 0.
Number fieldParentFieldNumber( Number nCampo )
Devuelve el número de campo del campo padre de una tala submaestra.
Parámetros:
nCampo: número de campo, el primero es el 0.
Number fieldType( Number nCampo )
Devuelve el tipo de campo. Ver enum de tipos de campo.
Parámetros:
nCampo: número de campo, el primero es el 0.
Funciones de índices
Number indexCount()
Devuelve el número de índices de la tabla.
String indexId( Number nIndex )
Devuelve el identificador del índice.
Parámetros:
nIndex: número de orden del índice, el primer valor es el 0.
String indexName( Number nIndex )
Devuelve el nombre del índice.
Parámetros:
nIndex: número de orden del índice, el primer valor es el 0.
Number indexType( Number nIndex )
Devuelve el identificador del índice. Ver enum de tipos de índices.
Parámetros:
nIndex: número de orden del índice, el primer valor es el 0.
Funciones de históricos
String pluralBoundedIndexId( Number nPlural )
Devuelve el identificador del índice de la tabla enlazada maestra.
Parámetros:
nPlural: número de orden del plural, el primero valor es el 0.
VObjectInfo pluralBoundedIndexInfo( Number nPlural )
Devuelve un objeto de la clase VObjectInfo del índice de la tabla enlazada maestra.
Parámetros:
nPlural: número de orden del plural, el primero valor es el 0.
String pluralBoundedTableId( Number nPlural )
Devuelve el identificador de la tabla enlazada maestra.
Parámetros:
nPlural: número de orden del plural, el primero valor es el 0.
VTableInfo pluralBoundedTableInfo( Number nPlural )
Devuelve un objeto de la clase VTableInfo de la tabla enlazada maestra.
Parámetros:
nPlural: número de orden del plural, el primero valor es el 0.
Number pluralCount()
Devuelve el número de enlaces plurales de la tabla.
String pluralId( Number nPlural )
Devuelve el identificado del plural.
Parámetros:
nPlural: número de orden del plural, el primero valor es el 0.
String pluralName( Number nPlural )
Devuelve el nombre del plural.
Parámetros:
nPlural: número de orden del plural, el primero valor es el 0.
Funciones de localizadores por Id
Number findField( String szIDPrimarioCampo )
Devuelve el número de campo de un identificador.
Parámetros:
szIdPrimarioCampo: identificador del campo.
Number findIndex( String szIDPrimarioIndice )
Devuelve el número del índice de un identificador.
Parámetros:
szIdPrimarioIndice: identificador del índice.
Number findPlural( String szIDPrimarioHist )
Devuelve el número del enlace plural de un identificador.
Parámetros:
szIdPrimarioIndice: identificador del enlace plural.
Ejemplos
1. Controlar si es una tabla maestra normal
1
if (VTableInfo.TypeMaster == theRegisterIn.tableInfo().type())
2
{
3
    .....
4
}
5
​
6
o bien
7
​
8
if (VTableInfo.TypeMaster == theRegisterListIn.tableInfo().type())
9
{
10
    .....
11
}
Copied!
2. Eliminar todos los plurales de la tabla ENT-M de vERP
1
/**
2
 * Eliminar todos los plurales de un registro
3
 *
4
 * @param {Object} root Objeto desde el que se ejecuta  la función
5
 * @param {VRegister} registro Registro del que se desean eliminar los plurales
6
 * @returns {Boolean} True si se han eliminado todos los plurales o false en caso contrario
7
 */
8
velneoDB.eliminarPlurales = function (root, registro) {
9
​
10
    "use strict";
11
​
12
    // VARIABLES: declaración de las variables
13
    var listaPlurales,
14
        indice = 0,
15
        numPlurales,
16
        numRegistro = 0,
17
        numRegistros,
18
        pluralId,
19
        registroPlural,
20
        retorno = true,
21
        tablaInfo,
22
        transActiva,
23
        transNueva;
24
​
25
    // PROCESO: se leen todas las tablas de la aplicación incluídas las heredadas
26
    if (root) {
27
​
28
        // Si no hay transacción se crea una nueva      
29
        transActiva = theRoot.existTrans();
30
        if (transActiva === false) {
31
            transNueva = theRoot.beginTrans("Eliminando históricos de la tabla " + tablaInfo.name());
32
        }
33
        if (transActiva || transNueva) {
34
​
35
            // Se analiza la tabla para recorrer sus plurales
36
            tablaInfo = registro.tableInfo();
37
            numPlurales = tablaInfo.pluralCount();
38
​
39
            // Se recorren los plurales de la tabla
40
            for (indice; indice < numPlurales; indice += 1) {
41
                pluralId = tablaInfo.pluralId(indice);
42
                listaPlurales = theRegisterIn.loadPlurals(pluralId);
43
                numRegistros = listaPlurales.size();
44
​
45
                // Se eliminan los registros plurales
46
                if (numRegistros > 0) {
47
                    for (numRegistro; numRegistro < numRegistros; numRegistro += 1) {
48
                        registroPlural = listaPlurales.readLockingAt(numRegistro);
49
                        if (registroPlural.deleteRegister() === false) {
50
                            retorno = false;
51
                        }
52
                    }
53
                }
54
            }
55
​
56
            // Si se ha creado una transacción nueva, se cierra
57
            if (transNueva === true) {
58
                theRoot.commitTrans();
59
            }
60
        }
61
    }
62
​
63
    // RETORNO: retornor true si se han podido eliminar todos los plurales
64
    return retorno;
65
};
Copied!

VSysInfo

VTabWidget

Última actualización 1yr ago

Copiar enlace

Contenidos

Funciones

Enumeraciones

Documentación de funciones

Funciones de tabla

Funciones de campos

Funciones de índices

Funciones de históricos

Funciones de localizadores por Id

Ejemplos

1. Controlar si es una tabla maestra normal

2. Eliminar todos los plurales de la tabla ENT-M de vERP