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
  • Configuración de la conexión
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 App
Otros
Procedimientos almacenados
Redefine uno o más parámetros de conexión a través de Conector Nativo (Access, SQL Server, MySQL u Oracle) o a través de un acceso OLE DB en un tabla o set específico de tablas. A continuación, se abren las tablas (o se crean si no existen). Se ejecuta la operación de prueba especificada.
Observaciones:
  • La nueva redefinición de la conexión se utilizará hasta que sea cancelada por HConnect. Se cancelará automáticamente al final de la solicitud.
  • Por Default, las características de conexión se definen en el editor de análisis, para una o más tablas.
Importante
La función HConnect permite definir fácilmente una conexión a una base de datos. Le recomendamos que utilice HDescribeConnection y luego HChangeConnection para:
  • gestionar los parámetros avanzados disponibles para algunas bases de datos (cursores, transacciones,...),
  • manipular una conexión con nombre.
Ejemplo
HFSQLHFSQL Client/ServerConectores Nativos
HConnect("Salaries", "", "", ...
"C:\My Documents\MyDatabase.mdb", "Microsoft.JET.OLEDB.4.0", hOReadWrite)
Sintaxis
<Result> = HConnect(<Table name> [, <User> [, <Password> [, <Database> [, <OLE DB Server or Native Access> [, <Access> [, <Test operation> [, <Optional information>]]]]]]])
<Result>: Boolean
  • True si se realizó la operación,
  • False si se produce un problema. La función HErrorInfo permite identificar el error.
<Table name>: Character string (with quotes)
Nombre de la tabla (archivo de datos) a abrir, y para el cual la conexión debe ser redefinida. Si no se especifica ningún otro parámetro, se reinicia el archivo de datos con los parámetros de Default definidos en el análisis.
  • Si este parámetro es igual a "*", el cambio se aplicará a todas las tablas manejadas por el Conector Nativo (también llamado Acceso Nativo). En este caso, se deben especificar todos los parámetros de conexión.
  • Si este parámetro es igual a "*" y no se especifican otros parámetros, todos los archivos de datos de todos los Conectores Nativos definidos en el análisis se restablecen a los parámetros de Default.
<User>: Optional character string (with quotes)
Nombre de usuario que se usará para abrir el archivo de datos.
<Password>: Optional character string (with quotes)
Contraseña de conexión (si existe).
<Database>: Optional character string (with quotes)
Ruta completa de la fuente de datos.
<OLE DB Server or Native Access>: Optional character string or constant
Nombre del proveedor OLE DB o una de las siguientes constantes:
hAccessHF7Pseudo-conexión a una base de datos HFSQL Classic
hAccessHFClientServerAcceso Nativo a una base de datos HFSQL Client/Server
hNativeAccessAS400Acceso Nativo AS/400 (módulo opcional de WINDEV/WEBDEV)
hNativeAccessDB2Acceso Nativo DB2 (módulo opcional de WINDEV/WEBDEV)
hNativeAccessInformixAcceso Nativo Informix (módulo opcional de WINDEV/WEBDEV)
hNativeAccessMariaDBAcceso Nativo MariaDB (módulo opcional de WINDEV/WEBDEV)
hNativeAccessMySQLAcceso Nativo MySQL (módulo opcional de WINDEV/WEBDEV)
hNativeAccessOracleAcceso Nativo Oracle (módulo opcional de WINDEV/WEBDEV)
hNativeAccessOracleLiteAcceso Nativo Oracle (módulo opcional de WINDEV Mobile)
hNativeAccessPostgreSQLAcceso Nativo PostgreSQL (módulo opcional de WINDEV/WEBDEV)
hNativeAccessProgressAcceso Nativo Progress (módulo opcional de WINDEV/WEBDEV)
hNativeAccessSQLAzureAcceso Nativo SQL Azure (módulo opcional de WINDEV/WEBDEV con Native SQL Server Access)
hNativeAccessSQLiteAcceso nativo a la base de datos SQLite (suministrada con WINDEV/WEBDEV)
hNativeAccessSQLServerAcceso Nativo SQL Server (módulo opcional de WINDEV/WEBDEV)
hNativeAccessSQLServerMobileNative SQL Server Access (módulo opcional de WINDEV Mobile)
hNativeAccessSybaseAcceso Nativo Sybase (módulo opcional de WINDEV/WEBDEV)
hNativeAccessXBaseAcceso Nativo xBase (proporcionado con WINDEV/WEBDEV)
hNativeAccessXMLAcceso Nativo XML (proporcionado con WINDEV/WEBDEV)
hODBCProveedor OLE DB para ODBC (permite acceder a una fuente de datos 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
hOledbExcel2007Proveedor OLE DB para Excel 2007
hOledbExcel2000Proveedor OLE DB para Excel 2000
hOledbExcel97Proveedor OLE DB para Excel 97
hOledbLotus4Proveedor OLE DB para Lotus 4
hOledbOracleProveedor OLE DB para Oracle
hOledbSQLServerProveedor OLE DB para SQL Server
<Access>: Optional constant
Configura el tipo de acceso al archivo de datos.
hOReadWrite
(valor predeterminado)
Se puede acceder al archivo de datos en modo de lectura y escritura. Se pueden leer y escribir nuevos registros.
hOReadSe puede acceder al archivo de datos en modo de solo lectura. Solo se pueden leer registros. No se pueden agregar o eliminar.
<Test operation>: Optional constant
Configure el tipo de operación que se realizará en la base de datos para comprobar la conexión.
hHCreationIfNotFound
(Valor predeterminado)
Comprueba la conexión abriendo o creando un archivo de datos (si el archivo de datos no existe). Esta operación solo es posible en modo hOReadWrite.
hHOpenComprueba la conexión abriendo un archivo de datos. Este valor se usa de forma predeterminada al acceder a una base de datos en modo hORead.
<Optional information>: Optional character string
Información sobre la base de datos. Esta información depende del acceso nativo utilizado.
Información insertada en la cadena para la conexión a la base de datos. Por ejemplo, algunas fuentes de datos le permiten especificar la base de datos que se utilizará. Con SQLServer, la base de datos "Master" es la base de datos Default pero se pueden utilizar otras bases de datos, "dbo" por ejemplo. Esta información se especifica en el parámetro <Información opcional> mediante la siguiente sintaxis:
Conectores Nativos MySQL: "catálogo inicial = dbo"
Observaciones

Configuración de la conexión

  • La descripción de la tabla debe conocerse al llamar a la función HConnect (la tabla debe haberse descrito en el análisis, o con las funciones HDeclare o HDescribeFile).
  • La función HConnect abre la conexión y la tabla. Se crea la tabla si no existe. Para este caso específico, la función HConnect equivale a HCreationIfNotFound.
  • Al redefinir la conexión, sólo se tienen en cuenta los parámetros especificados.. El valor de los parámetros no especificados con la función HConnect corresponde al valor definido en el editor de análisis.
  • Si sólo se especifica el <nombre de la tabla>, HConnect cancela la redefinición de la conexión para las tablas especificadas. Se tendrán en cuenta los parámetros definidos en el editor de análisis.
  • Cuando el parámetro <Nombre de la tabla> es igual a "*", el cambio se aplica a todas las tablas Conector Nativo definidas en el análisis. En este caso, sólo se tienen en cuenta los parámetros <Usuario>, <Contraseña>, <Base de datos> y <Acceso>.
  • Para Cancel un cambio de conexión realizado en las tablas, <Nombre de la tabla> debe ser igual a "*" y no se debe especificar ningún otro parámetro.
  • Si se especifica la fuente de datos, la función HConnect ignora los posibles HSubstDir/HChangeDir.
  • Si un tabla está abierto cuando se llama HConnect, el tabla se cierra y luego se vuelve a abrir con los nuevos parámetros de conexión.
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd270hf.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Example

Example
Nagyro.ini
======================
[Nagyro]
Server = 192.168.1.180
User = sa
Password = 777777777
BD = producao
======================


PROCEDURE DB_Inicialize(TrueFalse)

Server, User, Password, BD is string

IF TrueFalse = True THEN

PathFile is string = fCurrentDir(fCurrentDrive()) +"\Nagyro.ini"

IF fFileExist(PathFile) = True THEN

Server = INIRead("Nagyro", "Server", "", PathFile)
IF ErrorOccurred THEN
Error()
END

User = INIRead("Nagyro", "User", "", PathFile)
IF ErrorOccurred THEN
Error()
END

Password = INIRead("Nagyro","Password", "", PathFile)
IF ErrorOccurred THEN
Error()
END

BD = INIRead("Nagyro", "BD", "", PathFile)
IF ErrorOccurred THEN
Error()
END

HCloseConnection(ConnNativa)

ConnNativa..Server = Server
ConnNativa..User = User
ConnNativa..Password = Password
ConnNativa..Database = BD
ConnNativa..Provider = hNativeAccessSQLServer
ConnNativa..Access = hOReadWrite
ConnNativa..ExtendedInfo = "Extended information"
ConnNativa..CursorOptions = hClientCursor

ok is boolean = HOpenConnection(ConnNativa)

IF ok = False
Info(ErrorInfo())
Close()
END

END

END
adrianoboller
09 02 2015

Última modificación: 27/05/2022

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