AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
  • Características del archivo de datos creado
  • Los archivos adicionales creados
  • Gestión de contraseñas
  • Manejo de errores fatales en la creación de un archivo de datos
  • Gestión de conjuntos de caracteres no latinos
  • Replicación: Rango de identificadores
  • Prioridad para definir la ubicación de los archivos de registro
  • Crear o abrir una tabla existente
  • Gestión de índices
  • Creando el archivo de datos a partir de su description
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Realiza las siguientes operaciones:
  • Si el archivo de datos no existe, crea un archivo de datos vacío (extensión ".FIC") con el archivo de índice y el archivo memo, si es necesario.
    La función equivale a HCreation.
  • Si el archivo de datos existe, abre el archivo de datos.
    En este caso, la función equivale a HOpen.
    Para optimizar la llamada a HCreationIfNotFound, el archivo puede abrirse sólo cuando se accede a el archivo de datos por primera vez (utilizando la constante hDelayedOpening).
Observación: La creación de archivos de datos inexistentes en automatic se puede habilitar en el proyecto description (pestaña "Archivos" del proyecto description, "Crear automáticamente los archivos de datos al abrirlos"). La función HCreationIfNotFound se utiliza automáticamente si el archivo de datos no existe al manipularlo por primera vez.
WINDEVHFSQL Classic Si el archivo de datos está registrado, puede especificar la ubicación de los archivos de registro.
HFSQL Client/Server Si se han definido restricciones de integridad y están soportadas, el servidor actualiza las relaciones al crear el archivo de datos.
// Create all the data files described in the analysis
// with the "PSW" password
HCreationIfNotFound("*", "PSW")
// Create the Orders data file (described in the analysis)
HCreationIfNotFound(Orders)
Sintaxis
<Result> = HCreationIfNotFound([<Data file> [, <Password> [, <Path of the JNL file> [, <Path of the JournalOperation file>]]] [, <Option>]])
<Result>: booleano
  • True si se creó o abrió el archivo de datos,
  • False si se produce un problema. La función HError permite identificar el error. Si se produce un error fatal, se requiere un proceso específico para continuar el programa y comprobar si se creó el archivo de datos (ver Notas).
<Data file>: Cadena de caracteres opcional
Nombre del archivo de datos a utilizar.
Si no se especifica este nombre, la función HCreationIfNotFound utilizará el último archivo de datos utilizado por la última función HFSQL (que empieza por "H").
Si este parámetro es igual a "*", se crearán o abrirán todos los archivos de datos del análisis actual. Si se especifica una contraseña, esta se utiliza para todos los archivos de datos.
Este parámetro también puede corresponder al nombre de un grupo de archivos (o Carpeta personal) definido en el análisis (no disponible en Android y Android widget). Si se especifica una contraseña, esta se utiliza para todos los archivos de datos del grupo.
Atención: este parámetro no puede ser una Variable de tipo Descripción del archivo.
<Password>: Cadena de caracteres opcional
  • Contraseña asociada al archivo de datos.
  • Cadena vacía ("") si no se utiliza ninguna contraseña.
<Path of the JNL file>: Cadena de caracteres opcional
Accede a ruta al archivo JNL associated con el archivo de datos registrados. Este parámetro sólo se tiene en cuenta si se registra el archivo de datos. En este caso, el archivo <Nombre de archivo>JNL.fic se creará en la ubicación especificada.
HFSQL Client/Server Este parámetro no debe especificarse. En HFSQL Client/Server, la ruta del archivo JNL es fija y no se puede modificar.
Java Acceso con JDBC: Este parámetro no se tiene en cuenta.
<Path of the JournalOperation file>: Cadena de caracteres opcional
Accede a ruta al archivo de operación de la revista y al archivo de identificación de la revista associated con el archivo de datos registrados.. El archivo JournalOperation contiene todas las operaciones realizadas en el archivo de datos registrados. Este parámetro sólo se tiene en cuenta si se registra el archivo de datos.
HFSQL Client/Server Este parámetro no debe especificarse. En HFSQL Client/Server, la ruta del archivo de operaciones es fija y no se puede modificar.
Java Acceso con JDBC: Este parámetro no se tiene en cuenta.
<Option>: Constante opcional
Optimizar la apertura de los archivos de datos existentes.
hChangeCharsetEl conjunto de caracteres definido con la función ChangeCharset se tendrá en cuenta en el nuevo archivo de datos. Las ordenaciones, búsquedas u otro tipo de operaciones realizadas sobre claves de cadena (cadenas, caracteres, fecha y hora) utilizarán el nuevo carácter set.
hDelayedOpeningSi el archivo de datos ya existe, se abrirá solo al acceder a él por primera vez. Si el archivo de datos no existe, se crea y se abre.
HFSQL Classic Esta constante sólo está disponible para HFSQL Classic.
hNoLinkGestión de la integridad: Las relaciones no se actualizan en el servidor (creación, modificación o eliminación).
Recordatorio: Al crear un archivo de datos, las relaciones se actualizan en el servidor de forma predeterminada.
HFSQL Client/Server Esta constante sólo está disponible para HFSQL Client/Server.
Java Acceso con JDBC: Este parámetro no se tiene en cuenta.
Observaciones
WINDEVUniversal Windows 10 AppJavaHFSQL ClassicHFSQL Client/ServerHyper File 5.5OLE DBConectores Nativos

Características del archivo de datos creado

Las características del archivo de datos creado son las siguientes:
  • Nombre del archivo de datos:
    Nombre físico definido en la descripción del archivo de datos en el editor de análisis. Este nombre se puede modificar antes de crear el archivo de datos con la función HChangeName.
  • Directorio del archivo de datos:
    Directorio definido en la descripción del archivo de datos en el editor de análisis. Este directorio se puede modificar antes de crear el archivo de datos con las funciones HChangeDir y HSubstDir.
    Observación: Si la UAC está activada (Windows Vista y posteriores), la ubicación de los datos es específica: los datos no se encontrarán en el directorio de la aplicación, sino en un directorio específico de Windows. En este caso, debe crear el directorio de datos de la aplicación (puede get el ruta con fDataDirUser).
  • El orden de los elementos creados en el archivo físico es el orden físico de los elementos creados en el análisis, y no el orden lógico.
  • Contenido del archivo de datos:
    El archivo de datos creado está vacío, pero no significa que su tamaño sea nulo (el archivo contiene un encabezado que describe su estructura).
Observación: El archivo de datos se abre si ya existe (mismo nombre, mismo directorio). Si se especifica la constante hDelayedOpening, el archivo de datos sólo se abrirá la primera vez que se acceda a él (optimiza la velocidad de HCreationIfNotFound).
WINDEVUniversal Windows 10 AppHFSQL ClassicHFSQL Client/ServerHyper File 5.5OLE DBConectores Nativos

Los archivos adicionales creados

Al crear un archivo de datos, se pueden crear los siguientes archivos además de el archivo de datos:
  • Un archivo de índice (extensión "NDX") si se han definido una o más claves en el archivo description.
  • Archivo de memo A (extensión "MMO") si se han definido uno o más elementos de memo en el archivo description.
  • Un fichero de registro (".JNL" extension). Este archivo se crea sólo si la opción correspondiente fue seleccionada durante el archivo description (véase el siguiente párrafo).
    Universal Windows 10 App Este archivo no se crea.
  • Un archivo <ProjectName>.REP. Este archivo contiene la lista de archivos de datos que maneja la aplicación. Este fichero se crea (o rellena) si la gestión de .REP está activada (HSetREP). Si se especifica la constante hDelayedOpening, el archivo .REP se actualizará durante la apertura del archivo automatic realizada durante el primer acceso a el archivo de datos. Para obtener más información, consulte Archivo .REP.
    Universal Windows 10 App Este archivo no se crea.

Gestión de contraseñas

La contraseña se puede definir:
  • directamente al crear o abrir el archivo de datos con la función HCreationIfNotFound.
  • antes de crear el archivo de datos con la función HPass.Atención: La contraseña es independiente del cifrado de datos. La encriptación de los datos debe ser configurada durante el archivo description en el editor de análisis (pestaña "Detalles").
Conectores Nativos La contraseña no es associated con un archivo de datos sino con una base de datos. Esta contraseña debe especificarse durante la conexión (HConnect).

Manejo de errores fatales en la creación de un archivo de datos

Si se produce un error fatal al crear un archivo de datos, puede ser interesante continuar el programa mientras se comprueba si el archivo de datos fue creado o no.. Para ello, le recomendamos que realice la siguiente excepción: Process:
WHEN EXCEPTION IN
HCreationIfNotFound(PARENT)
DO
Error("HFSQL error: " + HError())
ELSE
Trace("The file is created")
END
WINDEVUniversal Windows 10 AppHFSQL ClassicHFSQL Client/ServerHyper File 5.5OLE DBConectores Nativos

Gestión de conjuntos de caracteres no latinos

Si se especifica la constante hChangeCharset, el carácter set utilizado en el archivo de datos será el especificado por ChangeCharset. El orden, las búsquedas, ... en claves de tipo String (cadenas, caracteres, fecha y hora) se realizarán de acuerdo con este conjunto de caracteres.
El carácter set utilizado puede ser modificado por HIndex.
Observación: el tamaño de los elementos de cadena especificados en el análisis se expresa en bytes y no en caracteres. Dependiendo del carácter set utilizado, es posible que tenga que aumentar el tamaño del artículo (si los caracteres utilizados están codificados en 2 bytes, por ejemplo).
WINDEVHFSQL ClassicHFSQL Client/ServerHyper File 5.5

Replicación: Rango de identificadores

Los identificadores de automatic para los archivos de las réplicas de los suscriptores utilizan una gama de identificadores que difiere de la utilizada por el archivo de la réplica maestra y por los otros archivos de las réplicas de los suscriptores.
Este rango de identificadores de automatic está escrito en el encabezado de cada archivo de datos (extensión "FIC").
Este rango se inicializa:
Para más detalles, consulte la página web de consecuencias de la implementación de la réplica.
WINDEVHFSQL ClassicHyper File 5.5

Prioridad para definir la ubicación de los archivos de registro

La ubicación de los archivos de registro se define según el siguiente orden de prioridad:
  1. Ubicación especificada al crear el archivo de datos de registro (función HCreationIfNotFound).
  2. Ubicación especificada por HChangeLogDir.
  3. Ubicación especificada en el análisis.
  4. Ubicación del archivo de datos registrado.
Si otra aplicación utiliza HDeclareExternal en un archivo de datos registrado, los cambios realizados por esta aplicación se guardan en los archivos de registro especificados en la cabecera del archivo de datos HFSQL registrado.
HFSQL Client/Server La ubicación de los archivos de registro es fija y no se puede modificar.. Para obtener más información, consulte Archivos de registro en modo Cliente/Servidor.
WINDEVOLE DB

Crear o abrir una tabla existente

Si la tabla ya existe, se abre la tabla.
Si la tabla no existe ya, se crea la tabla. Al crear un tabla, WINDEV y WEBDEV intentan crear los ítems en el tipo OLE DB correspondientes al tipo HFSQL. Si este tipo no es soportado, el motor HFSQL prueba sucesivamente todos los tipos de OLEDB "compatibles" hasta que encuentra un tipo que es soportado por la base de datos OLEDB.
WINDEVConectores Nativos

Gestión de índices

HCreationIfNotFound no devuelve ningún mensaje de error si no se puede añadir un índice. El tabla se crea sin el índice que está causando el problema.. En este caso, se pueden encontrar duplicados en un elemento definido como clave única por WINDEV o WEBDEV si la base de datos externa no soporta las claves únicas.

Creando el archivo de datos a partir de su description

El archivo de datos puede ser creado directamente desde su description en el editor de análisis. Para ello, seleccione "Create el archivo de datos" de el menú contextual del archivo de datos (en el gráfico de análisis) y seleccione el directorio en el que debe crearse el archivo de datos.
Componente: wd290hf.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
EXAMPLE
//EXEMPLO USE

iniresult is string = INIRead("APP","VERSAO","",fDataDir() + ["\"] +"CONFIG.INI")

IF (Num = 1 AND iniresult = "") OR (Num = 1 AND iniresult = 0) THEN

Info("UMA VEZ")

INIWrite("APP","VERSAO","2",fDataDir() + ["\"] +"CONFIG.INI")

Info(INIRead("VIAVAREJO","VERSAO","","CONFIG.INI"))

fDelete(fDataDir() + ["\"] +"t000_config.fic")
fDelete(fDataDir() + ["\"] +"t000_config.ndx")
fDelete(fDataDir() + ["\"] +"t000_config.mmo")

end

HModifyStructure("*",hmsBackgroundTask) // 1.º CODE ORDER

HCreationIfNotFound("*","app488640") // 2.º CODE ORDER
BOLLER
06 10 2017

Última modificación: 13/01/2023

Señalar un error o enviar una sugerencia | Ayuda local