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/iPadIOS WidgetApple WatchMac CatalystUniversal 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. Se recomienda utilizar HDescribeConnection y HChangeConnection para:
  • gestionar los parámetros avanzados disponibles para algunas bases de datos (cursores, transacciones,...),
  • manipular una conexión con nombre.
WINDEVWEBDEV - Código ServidorReportes y ConsultasCódigo de Usuario (UMC)AjaxHFSQL ClassicHFSQL Client/ServerOLE DBConectores 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 Connector> [, <Access> [, <Test operation> [, <Optional information>]]]]]]])
<Result>: booleano
  • True si se realizó la operación,
  • False si se produce un problema. La función HErrorInfo permite identificar el error.
<Table name>: Cadena de caracteres
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>: Cadena de caracteres opcional
Nombre de usuario que se utilizará para abrir el archivo de datos.
<Password>: Cadena de caracteres opcional
Contraseña de conexión (si existe).
<Database>: Cadena de caracteres opcional
Ruta completa de la fuente de datos.
<OLE DB server or Native Connector>: Cadena de caracteres opcional o constante
Nombre del proveedor de OLE DB o una de las siguientes constantes:
hAccessHF7Pseudo-conexión a una base de datos HFSQL Classic
hAccessHFClientServerConector Nativo a una base de datos HFSQL Client/Server
hNativeAccessAS400Conector Nativo AS/400 (módulo opcional de WINDEV/WEBDEV)
hNativeAccessDB2Conector Nativo DB2 (módulo opcional de WINDEV/WEBDEV)
hNativeAccessInformixConector Nativo Informix (módulo opcional de WINDEV/WEBDEV)
hNativeAccessMariaDBConector Nativo MariaDB (módulo opcional de WINDEV/WEBDEV)
hNativeAccessMySQLConector Nativo MySQL (módulo opcional de WINDEV/WEBDEV)
hNativeAccessOracleConector Nativo Oracle (módulo opcional de WINDEV/WEBDEV)
hNativeAccessOracleLiteConector Nativo Oracle (módulo opcional de WINDEV Mobile)
hNativeAccessPostgreSQLConector Nativo PostgreSQL (módulo opcional de WINDEV/WEBDEV)
hNativeAccessProgressConector Nativo Progress (módulo opcional de WINDEV/WEBDEV)
hNativeAccessSQLAzureNative SQL Azure Connector (módulo opcional de WINDEV/WEBDEV, proporcionado con Conector Nativo SQL Server)
hNativeAccessSQLiteConector SQLite nativo (incluido con WINDEV/WEBDEV)
hNativeAccessSQLServerConector Nativo SQL Server (módulo opcional de WINDEV/WEBDEV)
hNativeAccessSQLServerMobileConector Nativo SQL Server (módulo opcional de WINDEV Mobile)
hNativeAccessSybaseConector Nativo Sybase (módulo opcional de WINDEV/WEBDEV)
hNativeAccessXBaseConector nativo xBase (incluido con WINDEV/WEBDEV)
hNativeAccessXMLConector XML nativo (incluido 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
hOledbExcel97Proveedor OLE DB para Excel 97
hOledbExcel2000Proveedor OLE DB para Excel 2000
hOledbExcel2007Proveedor OLE DB para Excel 2007
hOledbLotus4Proveedor OLE DB para Lotus 4
hOledbOracleProveedor OLE DB para Oracle
hOledbSQLServerProveedor OLE DB para SQL Server
OLE DB Atención: Para utilizar una conexión OLE DB, es necesario:
  • instalar MDAC versión 2.6 o posterior (instalación realizada por WINDEV/WEBDEV y al crear el programa instalación)
  • instalar el proveedor OLE DB que corresponde a la base de datos utilizada.
    Este parámetro es devuelto por la CtOLEDBProvider Property.
<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.
<Test operation>: Constante opcional
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 utiliza por defecto cuando se accede a una base de datos hORead.
<Optional information>: Cadena de caracteres opcional
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:
OLE DB "catálogo inicial = dbo"
ODBC "base de datos = dbo"
Conectores Nativos MySQL: "catálogo inicial = dbo"
OLE DBConectores Nativos Las palabras clave reconocidas por OLE DB y Conectores Nativos se presentan en la página de Información opcional de conexión.
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 a HConnect, el tabla se cierra y se vuelve a abrir con los nuevos parámetros de conexión.
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd290hf.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