AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

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
  • Replication: 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 <Fuente>.Creation.
  • Si el archivo de datos existe, abre el archivo de datos.
    En este caso, la función equivale a <Fuente>.Open.
    Para optimizar la llamada a la función <Fuente>.CreationIfNotFound, el archivo puede abrirse solo cuando se accede a él por primera vez (utilizando la constante hDelayedOpening).
Observación: La creación automática de ficheros de datos inexistentes puede activarse en el proyecto description (pestaña "Ficheros" del proyecto description, "Crear automáticamente los archivos de datos al abrirlos").. La función <Fuente>.CreationIfNotFound 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.
Ejemplo
// Create the Orders data file (described in the analysis)
Customer.CreationIfNotFound()
Sintaxis
<Result> = <Source>.CreationIfNotFound([<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).
<Source>: Tipo de fuente especificada
Nombre del archivo de datos a utilizar.
<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 <Fuente>.ChangeName.
  • 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 <Fuente>.ChangeDir 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 el hDelayedOpening constante se especifica, el archivo de datos solo se abrirá la primera vez que se accede (optimiza la velocidad de <Fuente>.CreationIfNotFound ).
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 .
  • Un archivo de notas (extensión ".MMO") si se han definido uno o más elementos de notas en el archivo description .
  • Un archivo 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 <NombreProyecto>.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 <Fuente>.CreationIfNotFound.
  • antes de crear el archivo de datos con la función <Fuente>.Password.Atención: La contraseña es independiente del cifrado de datos. La encriptación de los datos debe configurarse 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
Parent.CreationIfNotFound()
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

If the hChangeCharset constant is specified, the character set used in el archivo de datos will be the one specified by 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 <Fuente>.Index.
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

Replication: 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.
Esta gama de identificadores automatic figura en la cabecera de cada fichero de datos (".FIC" extension).
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 <Fuente>.CreationIfNotFound).
  2. Ubicación especificada por <Fuente>.ChangeLogDir.
  3. Ubicación especificada en el análisis.
  4. Ubicación del archivo de datos registrado.
Si otra aplicación utiliza <Fuente>.DeclareExternal 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 está soportado, el motor HFSQL prueba sucesivamente todos los tipos OLEDB "compatibles" hasta que encuentra un tipo soportado por la base de datos OLEDB.
WINDEVConectores Nativos

Gestión de índices

<Fuente>.CreationIfNotFound no devuelve ningún mensaje de error si no se puede agregar 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 "Crear 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 25
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 20/06/2023

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