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
  • función HDeclareExternal: Uso con el proveedor de Conectores Nativos y/o OLE DB
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
Importa temporalmente la descripción de un archivo de datos en el análisis actual a partir de un archivo de datos HFSQL existente. El archivo de datos se abre. Para dejar de utilizar este archivo description, llame a HCancelDeclaration.
WINDEVWEBDEV - Código ServidorReportes y ConsultasCódigo de Usuario (UMC)Ajax
// Declare a WDSupplier data file from the full path
// of the HFSQL Classic file (.FIC extension included)
HDeclareExternal("C:\SalesMgt\Supplier.fic", "WDSupplier")
IF ErrorOccurred = True THEN
// Error while declaring the file, display the error
Error(HErrorInfo())
END
Sintaxis
WINDEVWEBDEV - Código ServidorReportes y ConsultasUniversal Windows 10 AppAndroidWidget Android iPhone/iPadIOS WidgetMac CatalystJavaCódigo de Usuario (UMC)AjaxHFSQL Classic

Usar archivos HFSQL Classic (Usuario único o usuarios múltiples) Ocultar los detalles

<Result> = HDeclareExternal(<Full path of the HFSQL file> , <Alias> [, <Password>])
<Result>: booleano
  • True si se realizó la operación,
  • False si se produce un problema. La función HErrorInfo permite identificar el error.
<Full path of the HFSQL file>: Cadena de caracteres
Ruta completa de acceso al archivo de datos HFSQL cuya descripción será importada (hasta 260 caracteres). Este nombre debe contener el ruta y la extensión del archivo de datos.
Si se utiliza la función HDeclareExternal en un procedimiento almacenado, la ruta del archivo de datos debe ser relativa a la base de datos actual.
<Alias>: Cadena de caracteres
Nombre lógico del archivo de datos. Este nombre se usará para manipular el archivo de datos. El nombre también puede corresponder a una variable de tipo Data Source.
<Password>: Cadena de caracteres opcional
  • Contraseña asociada al archivo de datos.
  • Cadena vacía ("") si no se utiliza ninguna contraseña.
Si se especifica la contraseña, esta se conservará: no es necesario volver a especificar la contraseña en las siguientes funciones que manipulan el archivo de datos.
WINDEVWEBDEV - Código ServidorReportes y ConsultasAndroidWidget Android iPhone/iPadIOS WidgetMac CatalystJavaCódigo de Usuario (UMC)AjaxHFSQL Client/ServerOLE DBConectores Nativos

Usar un acceso OLE DB, un Conector Nativo, HFSQL Client/Server o una conexión existente Ocultar los detalles

<Result> = HDeclareExternal(<Data file> , <Alias> , <Connection>)
<Result>: booleano
  • True si se realizó la operación,
  • False si se produce un problema. La función HErrorInfo permite identificar el error.
<Data file>: Cadena de caracteres
Nombre del archivo de datos en la base de datos externa.
HFSQL Client/Server Este parámetro corresponde al nombre físico del archivo de datos, relativo a la base de datos (extensión incluida). Ejemplo: "myfile.fic" (o si la base de datos tiene subdirectorios: ".\directorio\miarchivo.fic").
Si el archivo de datos está protegido con una contraseña, esta se debe especificar con la función HPass antes de utilizar HDeclareExternal.
<Alias>: Cadena de caracteres
Nombre lógico del archivo de datos. Este nombre se usará para manipular el archivo de datos en la aplicación actual. El nombre también puede corresponder a una variable de tipo Data Source.
<Connection>: Cadena de caracteres
Conexión a una base de datos. Esta conexión se ha definido en el editor de análisis o se ha descrito programáticamente con el HDescribeConnection.
Android Sólo están disponibles las conexiones a una base de datos HFSQL Client/Server.
WINDEVWEBDEV - Código ServidorReportes y ConsultasCódigo de Usuario (UMC)AjaxOLE DBConectores Nativos

Usar un acceso OLE DB o un Conector Nativo Ocultar los detalles

<Result> = HDeclareExternal(<Data file> , <Alias> , <User> [, <Password> [, <Data source> [, <OLE DB provider or Native Connector> [, <Access>]]]])
<Result>: booleano
  • True si se realizó la operación,
  • False si se produce un problema. La función HErrorInfo permite identificar el error.
<Data file>: Cadena de caracteres
Nombre del archivo de datos en la base de datos externa.
<Alias>: Cadena de caracteres
Nombre lógico del archivo de datos. Este nombre se usará para manipular el archivo de datos en la aplicación actual.
<User>: Cadena de caracteres
Nombre del usuario de la fuente de datos.
<Password>: Cadena de caracteres opcional
Contraseña del archivo de datos a abrir (si existe una contraseña).
<Data source>: Cadena de caracteres opcional
Ruta completa de la fuente de datos.
<OLE DB provider or Native Connector>: Cadena de caracteres opcional
Nombre del proveedor de OLE DB o una de las siguientes constantes:
hNativeAccessAS400Conector Nativo AS/400 (módulo opcional)
hNativeAccessDB2Conector Nativo DB2 (módulo opcional)
hNativeAccessInformixConector Nativo Informix (módulo opcional)
hNativeAccessMariaDBConector Nativo MariaDB (módulo opcional de WINDEV/WEBDEV)
hNativeAccessMySQLConector Nativo MySQL (módulo opcional)
hNativeAccessOracleConector Nativo Oracle (módulo opcional)
hNativeAccessPostgreSQLConector Nativo PostgreSQL (módulo opcional de WINDEV/WEBDEV)
hNativeAccessProgressConector Nativo Progress (módulo opcional)
hNativeAccessSQLAzureConector Nativo SQL Azure (módulo opcional, viene con el Conector Nativo SQL Server)
hNativeAccessSQLiteConector Nativo SQLite
hNativeAccessSQLServerConector Nativo SQL Server (módulo opcional)
hNativeAccessSybaseConector Nativo Sybase (módulo opcional)
hNativeAccessXBaseConector Nativo xBase
hNativeAccessXMLConector Nativo XML
hODBCProveedor OLE DB para ODBC. Le permite acceder a una fuente ODBC declarada en las fuentes de datos ODBC de Windows.
hOledbAccess97Proveedor OLE DB para Access 97
hOledbAccess2000Proveedor OLE DB para Access 2000
hOledbAccess2007Proveedor OLE DB para Access 2007
hOledbAccess2010Proveedor OLE DB para Access 2010
hOledbDBase5Proveedor OLE DB para dBase 5
hOledbExcel2000Proveedor OLE DB para Excel 2000
hOledbExcel2007Proveedor OLE DB para Excel 2007
hOledbExcel97Proveedor OLE DB para Excel 97
hOledbLotus4Proveedor OLE DB para Lotus 4
hOledbOracleProveedor OLE DB para Oracle
hOledbSQLServerProveedor OLE DB para SQL Server
Atención: Para utilizar una conexión OLE DB, es necesario:
  • instalar MDAC versión 2.6 o posterior (instalación realizada con WINDEV/WEBDEV, al crear la versión cliente)
  • instalar el proveedor OLE DB que corresponde a la base de datos utilizada.
<Access>: Constante opcional
Configura el tipo de acceso al archivo de datos.
hOReadSe puede acceder al archivo de datos en modo de solo lectura. Solo se pueden leer registros. No se pueden agregar o eliminar.
hOReadWrite
(valor predeterminado)
Se puede acceder al archivo de datos en modo de lectura y escritura. Se pueden leer y escribir nuevos registros.
Observaciones
  • Todas las funciones HFSQL se pueden utilizar en el archivo de datos importado, excepto la gestión de la integridad.
  • Se pueden importar tantas descripciones como sea necesario.
  • Esta función se puede utilizar con archivos de datos en formato XML.
  • La segunda sintaxis de esta función no se puede utilizar durante un acceso a una base de datos a través del Acceso remoto.
  • Para utilizar la función HDeclareExternal en un procedimiento almacenado:
    • se debe especificar la ruta relativa del archivo de datos con respecto al directorio de la base de datos que contiene el procedimiento almacenado. La ruta debe incluir el nombre y la extensión del archivo de datos.
    • no se debe utilizar ninguna conexión: se utilizará la base de datos en la que se encuentra el procedimiento almacenado.
  • Por defecto, si el proyecto actual:
    • está asociado a un análisis, el modo bloqueo aplicado a los archivos de datos es el modo de usuarios múltiples (los archivos no se bloquean cuando se abren y las otras aplicaciones pueden acceder a ellos).
    • no está asociado a un análisis, el modo de bloqueo aplicado a los archivos de datos es el modo de usuario único: los archivos se bloquean en modo de lectura y escritura tan pronto como se abren. Este modo impide que otras aplicaciones accedan a los archivos que ya han sido abiertos por la aplicación actual.
WINDEVWEBDEV - Código ServidorReportes y ConsultasCódigo de Usuario (UMC)AjaxOLE DBConectores Nativos

función HDeclareExternal: Uso con el proveedor de Conectores Nativos y/o OLE DB

Por Default, el nombre lógico pasado a HDeclareExternal se considera como el único nombre en el tabla. Se encapsula utilizando los caracteres de encapsulación correspondientes a la base de datos o especificados por el proveedor de la base de datos OLE antes de ser enviados a la base de datos (esto se utiliza para gestionar los nombres de tabla que contienen caracteres especiales).
Para proporcionar un nombre de archivo compuesto por <Nombre de usuario>.<Nombre de tabla> (o según la base de datos, <Nombre de esquema>.<Nombre de tabla>) en HDeclareExternal, estos nombres deben estar ya formateados (utilizando los caracteres de encapsulación correspondientes a la base de datos, o especificados por el proveedor de OLE DB).
Ejemplo de para SQLServer:
Los caracteres de encapsulación son " " " ".
Para renombrar CLIENTE como DBO.CLIENTE utilizando HDeclareExternal, debe pasar "DBO". "CLIENTE".
Por lo tanto, se debe utilizar el siguiente código:
HDeclareExternal("""DBO"".""CUSTOMER""", dsCustomer, "MyConnection")
Componente: wd290hf.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/05/2022

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