PC SOFT

ONLINE HELP
 WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • How to use gpwOpen?
  • Pre-launched sessions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
gpwOpen (Function)
In french: gpwOuvre
AjaxNot available
ODBCOLE DBNot available with these kinds of connection
Opens the login window or page of user groupware.
Remark: This function is required only if the user groupware was integrated with the "Manual run" option. If the option "Automatic start" has been selected, this function is ignored.
Versions 25 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
Android This function is now available for Android applications.
New in version 25
iPhone/iPad This function is now available for iPhone/iPad applications.
Android This function is now available for Android applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Android This function is now available for Android applications.
Example
// Opens the login window of user groupware
nRes is int = gpwOpen("c:\GpwUser")
// If the login failed
IF nRes <> gpwOk THEN
SWITCH nRes
CASE gpwCancel: Info("The Cancel button was clicked.")
CASE gpwError: Error("Error while initializing the groupware.")
CASE gpwUnknownUser: Error("Unknown user.")
CASE gpwInvalidPassword: Error("Invalid password")
END
EndProgram()
END
// Retrieve the first name of user
FirstName is string = gpwGetUserInfo(gpwInfoFirstName)
Info("Welcome" + FirstName)
Syntax
Versions 25 and later
AndroidiPhone/iPad

Specific syntax for Android and iOS applications Hide the details

gpwOpen(<WLanguage procedure>)
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") called when the login window is closed.
This procedure has the following format:
PROCEDURE <Procedure name>(<Connection> is boolean)
The <Connection> is a boolean:
  • True if the user is connected,
  • False if the user is not connected.
New in version 25
AndroidiPhone/iPad

Specific syntax for Android and iOS applications Hide the details

gpwOpen(<WLanguage procedure>)
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") called when the login window is closed.
This procedure has the following format:
PROCEDURE <Procedure name>(<Connection> is boolean)
The <Connection> is a boolean:
  • True if the user is connected,
  • False if the user is not connected.
AndroidiPhone/iPad

Specific syntax for Android and iOS applications Hide the details

gpwOpen(<WLanguage procedure>)
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") called when the login window is closed.
This procedure has the following format:
PROCEDURE <Procedure name>(<Connection> is boolean)
The <Connection> is a boolean:
  • True if the user is connected,
  • False if the user is not connected.
Versions 25 and later
AndroidiPhone/iPad

Specific syntax for Android and iOS applications Hide the details

gpwOpen(<WLanguage procedure> [, <User database>])
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") called when the login window is closed.
This procedure has the following format:
PROCEDURE <Procedure name>(<Connection> is boolean)
The <Connection> is a boolean:
  • True if the user is connected,
  • False if the user is not connected.
<User database>: Integer constant
Database of users and rights to use:
gpwDatabaseDefaultThe database of users and rights depends on the application start mode:
  • if the application is launched in GO mode (Go simulator or Go on phone with WMDev), the test database will be used as the database of users and rights.
  • if the application is launched from the version deployed on the mobile device, or an Android emulator, the production database will be used as the database of users and rights.
gpwDatabaseProductionForces the use of the user and production rights database regardless of the application start mode.
gpwDatabaseTestForces the use of the user and test rights database regardless of the application start mode.
New in version 25
AndroidiPhone/iPad

Specific syntax for Android and iOS applications Hide the details

gpwOpen(<WLanguage procedure> [, <User database>])
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") called when the login window is closed.
This procedure has the following format:
PROCEDURE <Procedure name>(<Connection> is boolean)
The <Connection> is a boolean:
  • True if the user is connected,
  • False if the user is not connected.
<User database>: Integer constant
Database of users and rights to use:
gpwDatabaseDefaultThe database of users and rights depends on the application start mode:
  • if the application is launched in GO mode (Go simulator or Go on phone with WMDev), the test database will be used as the database of users and rights.
  • if the application is launched from the version deployed on the mobile device, or an Android emulator, the production database will be used as the database of users and rights.
gpwDatabaseProductionForces the use of the user and production rights database regardless of the application start mode.
gpwDatabaseTestForces the use of the user and test rights database regardless of the application start mode.
AndroidiPhone/iPad

Specific syntax for Android and iOS applications Hide the details

gpwOpen(<WLanguage procedure> [, <User database>])
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") called when the login window is closed.
This procedure has the following format:
PROCEDURE <Procedure name>(<Connection> is boolean)
The <Connection> is a boolean:
  • True if the user is connected,
  • False if the user is not connected.
<User database>: Integer constant
Database of users and rights to use:
gpwDatabaseDefaultThe database of users and rights depends on the application start mode:
  • if the application is launched in GO mode (Go simulator or Go on phone with WMDev), the test database will be used as the database of users and rights.
  • if the application is launched from the version deployed on the mobile device, or an Android emulator, the production database will be used as the database of users and rights.
gpwDatabaseProductionForces the use of the user and production rights database regardless of the application start mode.
gpwDatabaseTestForces the use of the user and test rights database regardless of the application start mode.
Remarks

How to use gpwOpen?

gpwOpen is used to customize the start mode of user groupware. This allows you to run code lines, to open windows or pages, ... before opening the connection window or page of user groupware.
Example for using this function: in a multilingual application that is using the user groupware, the first window or page of the application is used to choose the runtime language. When creating the application, you must:
  • choose not to automatically run the user groupware during its integration
  • open the window or page for language selection as first application window, then call the login window or page with gpwOpen.
Versions 25 and later
AndroidiPhone/iPad If the user groupware is enabled in "Manual run" mode, the following operations must performed:
  • Do not define a first project window.
  • Call gpwOpen in the "Initializing" event of the project.
  • Open the first project window from the WLanguage code of the procedure passed as a parameter to gpwOpen.
New in version 25
AndroidiPhone/iPad If the user groupware is enabled in "Manual run" mode, the following operations must performed:
  • Do not define a first project window.
  • Call gpwOpen in the "Initializing" event of the project.
  • Open the first project window from the WLanguage code of the procedure passed as a parameter to gpwOpen.
AndroidiPhone/iPad If the user groupware is enabled in "Manual run" mode, the following operations must performed:
  • Do not define a first project window.
  • Call gpwOpen in the "Initializing" event of the project.
  • Open the first project window from the WLanguage code of the procedure passed as a parameter to gpwOpen.
Versions 20 and later

Pre-launched sessions

If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site".
New in version 20

Pre-launched sessions

If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site".

Pre-launched sessions

If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site".
Business / UI classification: Neutral code
Component: wd260gpu.dll
See also
Minimum version required
  • Version 9
This page is also available for…
Comments
Exemplo de uso do comando gpwOpen()
//Conexao
ok, ok1, ok2, ok3 is boolean

myConn is Connection
myConn..Provider = hNativeAccessSQLServer
myConn..User = "adriano"
myConn..Password = "adriano@2016"
myConn..Source = "192.168.0.162\projeto01"
myConn..Database = "projeto01"
myConn..Access = hOReadWrite

ok1 = HOpenConnection(myConn)
IF ok1 = False THEN
Info(ErrorOccurred() +" - "+ HErrorInfo())
END


IF gpwInitAnalysis() = False THEN
Error(ErrorInfo())
ok2 = False
ELSE

ok2 = True
IF gpwOpen() = gpwOk
ok3 = True
ELSE
Info(ErrorOccurred() +" - "+ HErrorInfo())
ok3 = False
END

END

NextTitle("Atenção")

IF ok1 = True AND ok2 = True AND ok3 = True THEN //deve dar tudo ok

Info("Conectou com sucesso no banco de dados!")

ELSE

Info("Falha ao tentar conectar no Servidor")

END
BOLLER
28 Nov. 2016