|
|
|
|
- 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
HCreationIfNotFound (Función)
No disponible con este tipo de conexión
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 la función HCreationIfNotFound, 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 HCreationIfNotFound se utiliza automáticamente si el archivo de datos no existe al manipularlo por primera vez.
// 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.
<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.
<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.
<Option>: Constante opcional Optimizar la apertura de los archivos de datos existentes. | | hChangeCharset | El 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. | hDelayedOpening | Si 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. | hNoLink | Gestió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.
|
Observaciones 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 configurarse durante el archivo description en el editor de análisis (pestaña "Detalles").
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
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.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|