PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
WinDevWebDev - Server codeWebDev - Browser codeWinDev MobileReports and QueriesWindowsLinuxWindows MobileWindows PhoneWindows Store appsAndroidAndroid Widget iPhone/iPadJavaPHPAjaxUser code (UMC)External languageHFSQLHFSQL Client/ServerStored proceduresHyper File 5.5OLE DBODBCNative Accesses

SaaSConnect (Function)
In French: SaaSConnecte

Authenticates a user of a SaaS site toward the SaaS webservice that manages the site.

Note: Once the connection is established by SaaSConnect, you have the ability to access all the sites. SaaSCheckService is used to check the access rights.

Example
// Connection to the Webservice in charge of the site
IF SaaSConnect(EDT_LOGIN, EDT_PASSWORD) = False THEN
IF ErrorOccurred = True THEN
sErrorMessage = CR + ErrorInfo(errFullDetails)
RESULT sErrorMessage
ELSE
RESULT "Connection to SaaS site denied."
END
END

// Pass a specific syntax (without parameter) to specify that we are checking the access to the site
// The client has at least one valid subscription to at least one service of the site
IF SaaSCheckService() = False THEN
IF ErrorOccurred = True THEN
sErrorMessage = CR + ErrorInfo(errFullDetails)
RESULT sErrorMessage
ELSE
RESULT "Connection to the SaaS service of the site denied."
END
END

// Use the connection to the HFSQL Client/Server or Classic database
// defined in the SaaS administrator on the server, for the site data.
IF HChangeConnection("*", SaaSClientConnection()) = False THEN
sErrorMessage = HErrorInfo(hErrFullDetails)
RESULT sErrorMessage
END

RESULT "Connection OK"

Syntax
<Result> = SaaSConnect(<User> , <Password> [, <Webservice>])
<Result>: Boolean
  • True if the authentication was successful,
  • False otherwise. To find out the error details, use ErrorInfo.
<User>: Character string (with quotes)
Connection name of the SaaS user.
<Password>: Character string (with quotes)
Password of the SaaS user.
<Webservice>: Optional character string (with quotes)
Webservice to use. This parameter corresponds to:
  • the name of the host of the SaaS webservice (for example, "Computer", "Computer.MyNetwork.fr" , "http://MyDomain.com").
  • the full URL of the SaaS webservice (for example, "http://domain.com/WDSAAS190_WEB/WDSaaS190.awws").
By default, the connection will be established to the SaaS webservice installed with the WebDev application server on the local computer.

Remarks
  • If SaaSConnect is run several times, an implicit disconnection is performed every time (SaaSDisconnect).
  • If the authentication is successful, the next SaaSxx functions will implicitly use the SaaS account specified during the last call to SaaSConnect. The runtime context will be closed by SaaSDisconnect.
  • To increase security, we recommend that you use the HTTPS protocol, both to access the page containing the call to SaaSConnect and in the Webservice URL. The server must be configured to accept this protocol.
  • If the Webservice is accessed in HTTPS, the SSL certificate used must not produce any security exception.
  • Versions 16 and later
    SaaSChangePassword allows you to modify the password of the connected user.
    New in version 16
    SaaSChangePassword allows you to modify the password of the connected user.
    SaaSChangePassword allows you to modify the password of the connected user.

Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment