|
|
|
|
|
|
|
|
|
|
- Utilizar una cadena de caracteres para el proveedor OLE DB
- Si se produce un error, no se conserva la descripción de la conexión
- Se abren dos conexiones en el servidor
- Validez de la conexión
- Pseudo-conexión a una base de datos HFSQL Classic
gpwOpenConnection (Función)
  No disponible con estos tipos de conexión
Abre una conexión a una base de datos Cliente/Servidor específica para administrar archivos de Groupware Usuario en modo Cliente/Servidor. La conexión permanece abierta hasta el final de la aplicación. gpwOpenConnection establece y abre una conexión con los archivos de datos de Groupware Usuario. Para utilizar la misma conexión para todos los archivos de datos de la aplicación, utilice HChangeConnection. A continuación, gpwOpen se utiliza para especificar la ubicación de los archivos de datos para la gestión de derechos, así como la ubicación de los archivos de datos para la identificación de los usuarios.
IF gpwOpenConnection("gpwCx", "Test", "MotPasseMySQL", ...
"Serveur_apollon", "TEST", hNativeAccessMySQL) = False THEN
Error(HErrorInfo())
ELSE
nRes is int = gpwOpen()
IF nRes <> gpwOk THEN
SWITCH nRes
CASE gpwError :
Error("Erreur à l'initialisation.", ErrorInfo())
CASE gpwUnknownUser :
Error("Utilisateur inconnu.")
CASE gpwInvalidPassword :
Error("Mot de passe invalide.")
END
END
HChangeConnection("*", "gpwCx")
Trace(HNbRec(CEDEX))
END
gpwInitAnalysis()
GPWUTILISATEUR is Data Source
CNX_GPWu_HFCS is Connection
sMotDePasseGPWu is string = "PCSGPW2001"
CNX_GPWu_HFCS.Provider = hAccessHFClientServer
CNX_GPWu_HFCS.User = "UserServerHf"
CNX_GPWu_HFCS.MotDePasse = "MotDePasseServerHF"
CNX_GPWu_HFCS.Server = "ServeurHF"
CNX_GPWu_HFCS.Database = "GPWu"
CNX_GPWu_HFCS.Encryption = hEncryptionNO
gpwOpenConnection(CNX_GPWu_HFCS)
HChangeConnection(GPWUTILISATEUR, CNX_GPWu_HFCS)
HPass(GPWUTILISATEUR, sMotDePasseGPWu)
HCreationIfNotFound(GPWUTILISATEUR)
HChangePassword(GPWUTILISATEUR, "TEST")
CASE ERROR:
Error(HErrorInfo() + CR + ErrorInfo())
Sintaxis
Definir y abrir una conexión Ocultar los detalles
<Result> = gpwOpenConnection(<Connection name> , <Username> [, <Password>] , <Data source> [, <Database>] , <OLE DB provider or Native Connector> [, <Access> [, <Extended information>]] , <Additional options>)
<Result>: booleano - True si se realizó la operación,
- False si se produce un problema. La función HErrorInfo permite identificar el error.
La apertura real de la conexión no se realiza con la función gpwOpenConnection. La función puede devolver True incluso si los valores pasados como parámetro son incorrectos.
Utilice gpwOpen para especificar la ubicación de los archivos de datos para la gestión de derechos, así como la ubicación de los archivos de datos para la identificación de los usuarios. Los directorios deben especificarse en relación con el directorio del servidor.
<Connection name>: Cadena de caracteres Nombre de la nueva conexión a definir y abrir. Este nombre no debe ser utilizado por otra conexión (definida en el análisis, o con HOpenConnection o HDescribeConnection). <Username>: Cadena de caracteres Nombre del usuario que se conecta a la base de datos Cliente/Servidor. Este parámetro es devuelto por la propiedad CtUserName. <Password>: Cadena opcional o cadena secreta Contraseña definida para la conexión a la base de datos Cliente/Servidor (si existe esta contraseña). Si no se requiere una contraseña, utilice una cadena vacía ("") o la palabra clave NULL.
 Novedad versión 2025Cadenas secretas: Si utiliza el almacén de cadenas secretas, el tipo de cadena secreta utilizado para este parámetro debe ser "ANSI o Unicode string". Para obtener más información sobre las cadenas secretas y el almacén, consulte Almacén de cadenas secretas. <Data source>: Cadena de caracteres Ruta completa de la fuente de datos. La conexión se creará y abrirá para esta fuente de datos. Este parámetro es devuelto por la propiedad CtDatabase. <Database>: Cadena de caracteres opcional Nombre de la base de datos que se utilizará en la fuente de datos. Si no se requiere este parámetro, utilice una cadena vacía (""). Este parámetro es devuelto por la propiedad CtInitialCatalog. <OLE DB provider or Native Connector>: Cadena de caracteres o constante - Nombre del proveedor OLE DB utilizado. Para obtener fácilmente la cadena a utilizar, seleccione la opción "Conexión" en el editor de análisis (ver Notas).
o
- una de las siguientes constantes:
| | | hAccessHF7 | Pseudoconexión a una base de datos HFSQL Classic (monousuario o multiusuario) | | hAccessHFClientServer | Conexión a una base de datos HFSQL Cliente/Servidor | | hNativeAccessAS400 | Acceso/Conector AS/400 nativo (módulo opcional) | | hNativeAccessDB2 | Native DB2 Access/Connector (módulo opcional) | | hNativeAccessInformix | Native Informix Access/Connector (módulo opcional) | | hNativeAccessMySQL | Native MySQL Access/Connector (módulo opcional) | | hNativeAccessOracle | Native Oracle Access/Connector (módulo opcional) | | hNativeAccessPostgreSQL | Native PostgreSQL Access/Connector (módulo opcional) | | hNativeAccessProgress | Acceso Nativo Progress (módulo opcional) | | hNativeAccessSQLServer | Native SQL Server Access/Connector (módulo opcional) | | hNativeAccessSybase | Conector nativo SAP ASE (módulo opcional) | | hNativeAccessxBase | Acceso/Conector xBase nativo | | hODBC | Proveedor OLE DB para ODBC.
Permite acceder a una fuente ODBC declarada en las fuentes de datos ODBC de Windows. | | hOledbAccess97 | Proveedor OLE DB para Access 97 | | hOledbAccess2000 | Proveedor OLE DB para Access 2000 | | hOledbDBase5 | Proveedor OLE DB para dBase 5 | | hOledbExcel97 | Proveedor OLE DB para Excel 97 | | hOledbExcel2000 | Proveedor OLE DB para Excel 2000 | | hOledbLotus4 | Proveedor OLE DB para Lotus 4 | | hOledbOracle | Proveedor OLE DB para Oracle | | hOledbSQLServer | Proveedor OLE DB para SQL Server |
<Access>: Constante opcional Configura el tipo de acceso a la base de datos. | | | hORead | Se puede acceder a la base de datos en modo de solo lectura. Solo se pueden leer registros. No es posible agregar o eliminar registros. | hOReadWrite
(valor predeterminado) | Se puede acceder a la base de datos en lectura/escritura. Es posible leer y escribir nuevos registros. |
Este parámetro es devuelto por la propiedad CtAccess. <Extended information>: Cadena de caracteres opcional Información opcional insertada en la cadena de conexión a la base de datos. Si se reconocen palabras clave específicas, la información correspondiente se extrae de la cadena de conexión. El resto de la cadena de conexión se envía a la base de datos. A continuación, los parámetros extraídos son procesados por el Conector Nativo o el acceso OLE DB utilizado.
Estas palabras clave deben especificarse utilizando el siguiente formato: ".<Keyword> = <Value>".
Este parámetro puede recuperarse utilizando la propiedad CtExtendedInfo. <Additional options>: Constante Si no se especifica este parámetro, el motor HFSQL define automáticamente los parámetros que se deben utilizar en función de la base de datos a la que se accede y del proveedor OLE DB utilizado.Para forzar algunos parámetros, se pueden combinar las siguientes constantes: - Ubicación del cursor
| | | hClientCursor | Cursor utilizado por MDAC. Por lo general, ofrece más funcionalidades que un cursor del lado servidor. Un cursor del lado cliente siempre es estático. | | hServerCursor | Cursor utilizado por la base de datos. Este cursor puede aplicar fácilmente los cambios realizados por otros usuarios en los datos. |
- Tipo de cursor
| | | hDynamicCursor | Este cursor ofrece una gran cantidad de funcionalidades, pero consume mucha memoria. Este cursor admite todos los tipos de desplazamiento. Puede acceder a todas las operaciones de inserción, actualización y eliminación realizadas por otros usuarios. | | hForwardOnlyCursor | Este cursor es rápido y consume poca memoria. El cursor solo puede desplazarse hacia adelante, del primer al último registro. Los cambios realizados por otros usuarios no son visibles. | | hOpenKeysetCursor | Este cursor utiliza un conjunto de registros fijo. Solo se almacena la clave de cada registro y no el registro como tal (consume menos memoria). No se puede acceder a los registros eliminados. Los cambios realizados por otros usuarios son visibles (pero no los registros agregados). | | hStaticCursor | Crea una copia de todos los registros de la consulta en la memoria (alto consumo de memoria). Se admiten todos los tipos de desplazamiento. |
- Modo de bloqueo
| | | hOptimisticCursor | El registro se bloquea durante la actualización | | hPessimisticCursor | El registro se bloquea mientras se edita. | | hReadOnlyCursor | El conjunto de registros manipulados no puede modificarse. |
Nota: No todos los proveedores de OLE DB admiten todos los tipos de cursor.
Abrir una conexión definida por una variable de conexión Ocultar los detalles
<Result> = gpwOpenConnection(<Connection used>)
<Result>: booleano - True si se realizó la operación,
- False si se produce un problema. La función HErrorInfo permite identificar el error.
La apertura real de la conexión no se realiza con la función gpwOpenConnection. La función puede devolver True incluso si los valores pasados como parámetro son incorrectos. Utilice gpwOpen para especificar la ubicación de los archivos de datos para la gestión de derechos, así como la ubicación de los archivos de datos para la identificación de los usuarios. Los directorios deben especificarse en relación con el directorio del servidor.
<Connection used>: Variable de tipo Connection Nombre de la variable Conexión a abrir. Este nombre no debe ser utilizado por otra conexión (definida en el análisis, o con HOpenConnection o HDescribeConnection). Observaciones Utilizar una cadena de caracteres para el proveedor OLE DB Para encontrar fácilmente la cadena de caracteres que se debe utilizar para definir el proveedor OLE DB, le recomendamos seguir los siguientes pasos: - En el editor de análisis del modelo de datos, abra la ventana de descripción de la conexión. Vaya al panel "Análisis", grupo "Conexión" y haga clic en "Conexiones".
- Seleccione el proveedor que se utilizará ("Conexión mediante").
- Enseguida, se muestra la cadena de caracteres que corresponde al proveedor. Esta cadena de caracteres se puede utilizar en la sintaxis 2 en lugar de las constantes.
Si se produce un error, no se conserva la descripción de la conexión Si la conexión no se abre, no se valida la descripción de la conexión. Por lo tanto, es posible redefinir una conexión con el mismo nombre. Por ejemplo, si falla un intento de conexión con la contraseña predeterminada, puede volver a intentarlo con una contraseña diferente. Se abren dos conexiones en el servidor El Groupware Usuario utiliza dos contextos HFSQL. En el Centro de Control HFSQL, observará dos conexiones para una única instancia de la aplicación. Validez de la conexión gpwOpenConnection funciona de la misma manera que HDescribeConnection, es decir, no establece la conexión inmediatamente. La función gpwOpenConnection identifica los parámetros de conexión que se utilizarán para establecer la conexión. Para validar esta conexión, se puede llamar a la función HOpenConnection antes de gpwOpenConnection con los mismos parámetros. Por lo tanto, los parámetros de conexión ya se comprobarán cuando gpwOpenConnection .
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|