AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
  • Archivo de datos codificados
  • HFSQL Client/Server
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
<Fuente>.ImportHF55 (Función)
HFSQL ClassicHFSQL Client/ServerDisponible solo con estos tipos de conexión
Importa un archivo de datos Hyper File 5.5 en un archivo de datos en formato HFSQL Classic.
Observaciones:
  • Los dos archivos de datos pueden tener estructuras diferentes.
  • Esta función no está disponible cuando se utiliza un ejecutable independiente..
Ejemplo
// Imports the name and address of customers,
// ignore the other items
IF NOT Customer.ImportHF55("Customer", "C:\AnExample\CUSTOMER.FIC", ...
"C:\AnExample\AnExample.wdd", "", "FullName,Address", ...
"Name,Addr", hDefaultVal + hImpConversion) THEN
  Error("Unable to import")
ELSE
// Process
...
END
Sintaxis

Importar a un archivo de datos con la misma estructura Ocultar los detalles

<Result> = <Source>.ImportHF55(<HF55 File> , <Full path of HF55 File> , <Password of HF55 File> , <Full path of WDD 55 file> , <Password of WDD 55 File> [, <Options> [, <Progress Bar>]])
<Result>: Booleano
  • True si se realizó la operación,
  • False si se produce un error. La función HError permite identificar el problema.
<Source>: Tipo de fuente especificada
Nombre lógico del fichero de datos en formato HFSQL Classic al que se realizará la importación.
<HF55 File>: Cadena de caracteres
Nombre lógico del archivo de datos en formato Hyper File 5.5 descrito en el análisis WINDEV 5.5 (archivo .WDD) y que contiene los datos a importar.
<Full path of HF55 File>: Cadena de caracteres
Acceso completo a ruta del archivo de datos Hyper File 5.5 para importar.
<Password of HF55 File>: Cadena de caracteres
Contraseña associated con el archivo de datos para importar. Esta contraseña se utilizará para descifrar los datos que se encuentran en el archivo de datos. Si no se ha definido ninguna contraseña, utilice una cadena vacía (""").
<Full path of WDD 55 file>: Cadena de caracteres
Acceder a ruta al fichero de análisis.WDD en formato Hyper File 5.5. Este análisis contiene la description (o estructura) del archivo de datos a importar. Todos los formatos de análisis reconocidos por Hyper File 5.5 pueden ser utilizados (WINDEV 5.5B, 5.5, 5.0 y 4.1).
<Password of WDD 55 File>: Cadena de caracteres
Contraseña associated con el análisis que contiene el archivo de datos para importar. Si no se ha definido ninguna contraseña, utilice una cadena vacía (""").
<Options>: Constante o combinación de constantes de tipo Integer (opcional)
Tipo de importación a realizar:
hCopyAutoIdEl identificador automático se copia. No se vuelve a calcular.
Si el archivo de datos HFSQL Classic contiene un identificador automatic mientras que el archivo de datos Hyper File 5.5 no contiene ningún identificador automatic, el identificador automatic se pone a 0 en el archivo de datos HFSQL Classic.
hDefaultValPara los elementos no importados, los valores de Record (HFSQL Classic) actuales se reinicializan con su valor Default.
hImpBreakableLa importación se puede interrumpir pulsando la tecla Esc del teclado. Si se interrumpe la importación, los registros importados se guardan en el archivo de datos. Si es necesario, se realiza automáticamente una operación de reindexación (no se puede interrumpir).
hImpConversionLos artículos de associated no tienen el mismo tipo ni el mismo tamaño: los datos extraídos del archivo de datos importados se convierten o truncan automáticamente.
hImpCreationSi el archivo de datos de importación (HFSQL Classic) existe, se sobrescribe.
hImpIgnoreItemLos elementos encontrados en el archivo de datos de importación (HFSQL Classic) sin elementos associated en el archivo de datos de importación (Hyper File 5.5) se rellenan con su valor Default.
Se ignoran los elementos del archivo de datos importados (Hyper File 5.5) que no coinciden con el archivo de datos importados.
hImpNormal
(valor predeterminado)
Este modo de importación evita cualquier riesgo de pérdida de datos.. La importación no se realiza y se produce un error en los siguientes casos:
  • elementos encontrados en el archivo de datos Hyper File 5.5 sin correspondencia en el archivo de datos HFSQL Classic.
  • Los elementos de associated en los dos archivos de datos pero con un tamaño y/o formato diferente.
Si el archivo de datos de importación (HFSQL Classic) ya existe, se rellena con los datos importados; en caso contrario, se crea el archivo de datos.
No se gestiona la integridad, ni los duplicados.
Los elementos no importados toman el valor del registro en curso.
Los identificadores automáticos se vuelven a calcular.
hImpNoSpaceLos caracteres de espacio que se encuentran al final de la cadena se eliminan automáticamente durante la importación.
hImpTestDuplicatesVerifica los duplicados durante la importación.
hImpTestIntegrityPrueba la integridad durante la importación
<Progress Bar>: Nombre de control o ventana opcional
  • Nombre de la ventana donde se mostrará la barra de progreso de la importación.
  • Nombre de la control Barra de progreso donde se mostrará el progreso de la importación.

Importar a un archivo con una estructura diferente Ocultar los detalles

<Result> = <Source>.ImportHF55(<HF55 File> , <Full path of HF55 File> , <Password of HF55 File> , <Full path of WDD 55 file> , <Password of WDD 55 File> , <List of destination items> , <List of source items> [, <Options> [, <Progress Bar>]])
<Result>: Booleano
  • True si se realizó la operación,
  • False si se produce un error. La función HError permite identificar el problema.
<Source>: Tipo de fuente especificada
Nombre lógico del fichero de datos en formato HFSQL Classic al que se realizará la importación.
<HF55 File>: Cadena de caracteres
Nombre lógico del archivo de datos en formato Hyper File 5.5 descrito en el análisis WINDEV 5.5 (archivo .WDD) y que contiene los datos a importar.
<Full path of HF55 File>: Cadena de caracteres
Acceso completo a ruta del archivo de datos Hyper File 5.5 para importar.
<Password of HF55 File>: Cadena de caracteres
Contraseña associated con el archivo de datos para importar. Esta contraseña se utilizará para descifrar los datos que se encuentran en el archivo de datos. Si no se ha definido ninguna contraseña, utilice una cadena vacía (""").
<Full path of WDD 55 file>: Cadena de caracteres
Acceder a ruta al fichero de análisis.WDD en formato Hyper File 5.5. Este análisis contiene la description (o estructura) del archivo de datos a importar. Todos los formatos de análisis reconocidos por Hyper File 5.5 pueden ser utilizados (WINDEV 5.5B, 5.5, 5.0 y 4.1).
<Password of WDD 55 File>: Cadena de caracteres
Contraseña associated con el análisis que contiene el archivo de datos para importar. Si no se ha definido ninguna contraseña, utilice una cadena vacía (""").
<List of destination items>: Cadena de caracteres
Lista de nombres de artículos encontrados en el archivo de datos HFSQL Classic. Los nombres se pueden delimitar con comillas simples y separar con comas o retornos de carro (CR).
Observación: los nombres correspondientes a las claves compuestas no están permitidos: los valores de las claves compuestas se recalcularán automáticamente cuando se añada el Record en el el archivo de datos.
<List of source items>: Cadena de caracteres
Lista de nombres de los elementos que se encuentran en el archivo de datos de Hyper File 5.5. Los nombres se pueden delimitar con comillas simples y separar con comas o retornos de carro (CR).
Observación: se permiten los nombres correspondientes a las claves compuestas. El número de elementos debe corresponder al número de elementos especificados en <Lista de elementos de destino>.
<Options>: Constante o combinación de constantes de tipo Integer (opcional)
Tipo de importación a realizar:
hCopyAutoIdEl identificador automático se copia. No se vuelve a calcular.
Si el archivo de datos HFSQL Classic contiene un identificador automatic mientras que el archivo de datos Hyper File 5.5 no contiene ningún identificador automatic, el identificador automatic se pone a 0 en el archivo de datos HFSQL Classic.
hDefaultValPara los elementos no importados, los valores de Record (HFSQL Classic) actuales se reinicializan con su valor Default.
hImpBreakableLa importación se puede interrumpir pulsando la tecla ESC. Si se interrumpe la importación, los registros importados se guardan en el archivo de datos. Si es necesario, se realiza automáticamente una operación de reindexación (no se puede interrumpir).
hImpConversionLos artículos de associated no tienen el mismo tipo ni el mismo tamaño: los datos extraídos del archivo de datos importados se convierten o truncan automáticamente.
hImpCreationSi el archivo de datos de importación (HFSQL Classic) existe, se sobrescribe.
hImpIgnoreItemLos elementos encontrados en el archivo de datos de importación (HFSQL Classic) sin elementos associated en el archivo de datos de importación (Hyper File 5.5) se rellenan con su valor Default.
Se ignoran los elementos del archivo de datos importados (Hyper File 5.5) que no coinciden con el archivo de datos importados.
hImpNormal
(valor predeterminado)
Este modo de importación evita cualquier riesgo de pérdida de datos.. La importación no se realiza y se produce un error en los siguientes casos:
  • elementos encontrados en el archivo de datos Hyper File 5.5 sin correspondencia en el archivo de datos HFSQL Classic.
  • Los elementos de associated en los dos archivos de datos pero con un tamaño y/o formato diferente.
Si el archivo de datos de importación (HFSQL Classic) ya existe, se rellena con los datos importados; en caso contrario, se crea el archivo de datos.
No se gestiona la integridad, ni los duplicados.
Los elementos no importados toman el valor del registro en curso.
Los identificadores automáticos se vuelven a calcular.
hImpNoSpaceLos caracteres de espacio que se encuentran al final de la cadena se eliminan automáticamente durante la importación.
hImpTestDuplicatesComprueba los duplicados durante la importación.
hImpTestIntegrityPrueba la integridad durante la importación.
<Progress Bar>: Nombre de control o ventana opcional
  • Nombre de la ventana donde se mostrará la barra de progreso de la importación.
  • Nombre de la control Barra de progreso donde se mostrará el progreso de la importación.
Observaciones

Archivo de datos codificados

Si el archivo de datos en formato HFSQL Classic en el que se debe realizar la importación está cifrado, se debe introducir la contraseña antes de utilizar la función <Fuente>.ImportHF55: utilice la función <Fuente>.Password.

HFSQL Client/Server

Si se va a realizar la importación en un archivo de datos en formato HFSQL Client/Sever, se debe especificar la conexión antes de utilizar la función <Fuente>.ImportHF55. Por ejemplo:
cntHFCS is Connection
MyCSFile.ChangeConnection(cntHFCS)
MyCSFile.ImportHF55(My55File, ...)
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