|
- How to use the gpwOpen function?
- Pre-launched sessions
gpwOpen (Function) In french: gpwOuvre
 Not available
  Not available with these kinds of connection
Opens the login window or page of user groupware. Note: This function is required only if the user groupware was integrated with the "Manual start" option. This function is ignored if "Auto run" was selected.
// 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 18 and later
Syntax of new user groupware Hide the details
<Result> = gpwOpen([<Directory of groupware files>])
<Result>: Integer constant Result regarding the opening of login window/page.
| | | gpwCancel | The user clicked the "Cancel" button found in the login window of Groupware. | | gpwError | An error occurred. To find out the error details, use ErrorInfo. | | gpwInvalidPassword | The password is not valid. It does not correspond to the user password described in the groupware database. | | gpwOk | The user is connected. | | gpwUnknownUser | The user is not referenced in the database of user groupware. |
<Directory of groupware files>: Optional character string (with quotes) These data files are used to manage the users and their rights. By default, these data files are created in a subdirectory of your project (EXE\GPW_<Project name> directory).
If this parameter corresponds to an empty string ("") or if it is not specified, the default directory of the user groupware will be used.  New in version 18
Syntax of new user groupware Hide the details
<Result> = gpwOpen([<Directory of groupware files>])
<Result>: Integer constant Result regarding the opening of login window/page.
| | | gpwCancel | The user clicked the "Cancel" button found in the login window of Groupware. | | gpwError | An error occurred. To find out the error details, use ErrorInfo. | | gpwInvalidPassword | The password is not valid. It does not correspond to the user password described in the groupware database. | | gpwOk | The user is connected. | | gpwUnknownUser | The user is not referenced in the database of user groupware. |
<Directory of groupware files>: Optional character string (with quotes) These data files are used to manage the users and their rights. By default, these data files are created in a subdirectory of your project (EXE\GPW_<Project name> directory).
If this parameter corresponds to an empty string ("") or if it is not specified, the default directory of the user groupware will be used.
Syntax of new user groupware Hide the details
<Result> = gpwOpen([<Directory of groupware files>])
<Result>: Integer constant Result regarding the opening of login window/page.
| | | gpwCancel | The user clicked the "Cancel" button found in the login window of Groupware. | | gpwError | An error occurred. To find out the error details, use ErrorInfo. | | gpwInvalidPassword | The password is not valid. It does not correspond to the user password described in the groupware database. | | gpwOk | The user is connected. | | gpwUnknownUser | The user is not referenced in the database of user groupware. |
<Directory of groupware files>: Optional character string (with quotes) These data files are used to manage the users and their rights. By default, these data files are created in a subdirectory of your project (EXE\GPW_<Project name> directory).
If this parameter corresponds to an empty string ("") or if it is not specified, the default directory of the user groupware will be used.
Syntax of the former user groupware (kept for backward compatibility) Hide the details
<Result> = gpwOpen([<Directory of rights file> [, <Directory of user files>]])
<Result>: Integer constant Result regarding the opening of login window/page.
| | | gpwCancel | The user clicked the "Cancel" button found in the login window of Groupware. | | gpwError | An error occurred. To find out the error details, use ErrorInfo. | | gpwInvalidPassword | The password is not valid. It does not correspond to the user password described in the groupware database. | | gpwOk | The user is connected. | | gpwUnknownUser | The user is not referenced in the database of user groupware. |
<Directory of rights file>: Optional character string (with quotes) These data files are used to manage the rights granted to the users for the different windows of the application. These files are specific to the application. By default, these data files are created in a subdirectory of your project (EXE\GPW_<Project name> directory).
If this parameter corresponds to an empty string ("") or if it is not specified, the default directory of the user groupware will be used.
<Directory of user files>: Optional character string (with quotes) These data files can be common to several applications. By default, these data files are created in a subdirectory of your project (EXE\GPW_<Project name> directory). You can define the location of the user groupware files common to several applications. In this case, you must specify the path of data files to use.
If this parameter corresponds to an empty string ("") or if it is not specified, the default directory of the user groupware will be used.
Remarks How to use the gpwOpen function? 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 20 and laterPre-launched sessions If your project uses pre-launched sessions, this function must not be used in the project "Initializing" event. This function must be used in the event "Initializing the project after connection to the site". New in version 20Pre-launched sessions If your project uses pre-launched sessions, this function must not be used in the project "Initializing" event. 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 project "Initializing" event. This function must be used in the event "Initializing the project after connection to the site".
This page is also available for…
|
|
|
| |
| 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 |
|
|
|
| |
| |
| |
| |
| |
| |
| | |
| |