PC SOFT

AYUDA EN LÍNEA
DE WINDEV, WEBDEV Y WINDEV MOBILE


Este contenido proviene de una traducción automática.. Haga clic aquí para ver la versión original en inglés.
  • 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 AppWindows Mobile
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.
Observación: A partir de la versión 19, HFSQL es el nuevo nombre de HyperFileSQL.
Ejemplo
WINDEVWEBDEV - Código ServidorReportes y ConsultasAjaxCódigo de Usuario (UMC)HFSQLHFSQL Client/ServerOLE DBConectores Nativos
HConnect("Salaries", "", "", ...
"C:\My Documents\MyDatabase.mdb", "Microsoft.JET.OLEDB.4.0", hOReadWrite)
Windows Mobile
HConnect("salaries", "", "", "MyDatabase", "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.
Windows Mobile Nombre de la base de datos SQL Server CE u Oracle Lite definida en Pocket PC.
<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)
Versiones 20 y posteriores
hNativeAccessMariaDB
Nueva funcionalidad versión 20
hNativeAccessMariaDB
hNativeAccessMariaDB
Acceso 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)
Versiones 16 y posteriores
hNativeAccessSQLAzure
Nueva funcionalidad versión 16
hNativeAccessSQLAzure
hNativeAccessSQLAzure
Acceso Nativo SQL Azure (módulo opcional de WINDEV/WEBDEV con Native SQL Server Access)
Versiones 15 y posteriores
hNativeAccessSQLite
Nueva funcionalidad versión 15
hNativeAccessSQLite
hNativeAccessSQLite
Acceso 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
Versiones 19 y posteriores
hOledbAccess2010
Nueva funcionalidad versión 19
hOledbAccess2010
hOledbAccess2010
Proveedor 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
Windows Mobile Las constantes disponibles son las siguientes:
hAccessHF7Pseudo-conexión a una base de datos HFSQL Mobile
hNativeAccessOracleConector Nativo Oracle Lite (módulo opcional)
hNativeAccessSQLServerConector Nativo SQL Server CE (módulo opcional)
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 de instalación)
  • instalar el proveedor OLE DB que corresponde a la base de datos utilizada.
    Este parámetro es devuelto por la propiedad ..CtOLEDBProvider.
<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:
OLE DB "catálogo inicial = dbo"
ODBC "base de datos = dbo"
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 : wd250hf.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