servoy sReturnTypes2100%height: 30px;2Supported ClientssWordListSmartClientsWordListWebClientsWordListNGClientsWordListMobileClientservoy sSummary12%30%58%height: 30px;3Constants SummaryConstant representing the accessible flag for form security.Constant representing the delete flag for table security.Constant representing the insert flag for table security.Constant representing the read flag for table security.Constant representing the tracking flag for table security (tracks sql insert/update/delete).Constant representing the tracking flag for table security (tracks sql select).Constant representing the update flag for table security.Constant representing the viewable flag for form security.servoy sSummary12%30%58%height: 30px;3Methods SummaryAdds an user to a named group.Authenticate the given credentials against the mobile service solution.Authenticate to the Servoy Server using one of the installed authenticators or the Servoy default authenticator.Authenticate to the Servoy Server using one of the installed authenticators or the Servoy default authenticator.Returns a boolean value for security rights.Returns a boolean value for security rights.Returns a boolean value for security rights.Returns a boolean value for security rights.Changes the groupname of a group.Changes the username of the specified userUID.Returns true if the password for that userUID is correct, else false.Creates a group, returns the groupname (or null when group couldn't be created).Creates a new user, returns new uid (or null when group couldn't be created or user alreay exist).Creates a new user, returns new uid (or null when group couldn't be created or user alreay exist).Deletes a group, returns true if no error was reported.Deletes an user.Returns the client ID.Returns the form elements UUID's as dataset, the one with no name is the form itself.Get all the groups (returns a dataset).Retrieves the username of the currently logged in user on operating system level.Get all the groups of the current user.Get all the groups for given user UID.Get the current user name (null if not logged in), finds the user name for given user UID if passed as parameter.Get the current user name (null if not logged in), finds the user name for given user UID if passed as parameter.Get the current user UID (null if not logged in); finds the userUID for given user_name if passed as parameter.Get the current user UID (null if not logged in); finds the userUID for given user_name if passed as parameter.Get all the users in the security settings (returns a dataset).Get all the users in the security settings (returns a dataset).Check whatever the current user is part of the specified groupCheck whatever the user specified as parameter is part of the specified group.Login to be able to leave the solution loginForm.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.voidLogout the current user and close the solution, if the solution requires authentication and user is logged in.Removes an user from a group.Set a new password for the given userUID.voidSets the security settings; the entries contained in the given dataset will override those contained in the current security settings.voidSet the tenant value for this Client, this value will be used as the value for all tables that have a column marked as a tenant column.Set a new userUID for the given userUID.constantservoy sDetail2100%height:30px2Constants DetailsACCESSIBLEname
ACCESSIBLE
dessIndent
Constant representing the accessible flag for form security.
ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowDELETEname
DELETE
dessIndent
Constant representing the delete flag for table security.
ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowINSERTname
INSERT
dessIndent
Constant representing the insert flag for table security.
ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowREADname
READ
dessIndent
Constant representing the read flag for table security.
ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowTRACKINGname
TRACKING
dessIndent
Constant representing the tracking flag for table security (tracks sql insert/update/delete).
ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowTRACKING_VIEWSname
TRACKING_VIEWS
dessIndent
Constant representing the tracking flag for table security (tracks sql select).
ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowUPDATEname
UPDATE
dessIndent
Constant representing the update flag for table security.
ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowVIEWABLEname
VIEWABLE
dessIndent
Constant representing the viewable flag for form security.
Adds an user to a named group.
Note: this method can only be called by an admin.
prs
Parameters
sIndenta_userUIDthe user UID to be addedgroupNamethe group to add toret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowauthenticatename
authenticate(credentials)
dessIndent
Authenticate the given credentials against the mobile service solution.
It will set the credentials and then do a sync call to the server.
prs
Parameters
sIndentcredentialsarray whose elements are passed as arguments to the authenticator method, in case of servoy built-in authentication this should be [username, password]ret
Returns
sIndentclients
Supported Clients
sIndentNGClient,MobileClientsam
Sample
sIdentjavascriptlastDetailRowauthenticatename
authenticate(authenticator_solution, method)
dessIndent
Authenticate to the Servoy Server using one of the installed authenticators or the Servoy default authenticator.
Note: this method should be called from a login solution.
prs
Parameters
sIndentauthenticator_solutionauthenticator solution installed on the Servoy Server, null for servoy built-in authenticationmethodauthenticator method, null for servoy built-in authenticationret
Authenticate to the Servoy Server using one of the installed authenticators or the Servoy default authenticator.
Note: this method should be called from a login solution, once logged in, the authenticate method has no effect.
prs
Parameters
sIndentauthenticator_solutionauthenticator solution installed on the Servoy Server, null for servoy built-in authenticationmethodauthenticator method, null for servoy built-in authenticationcredentialsarray whose elements are passed as arguments to the authenticator method, in case of servoy built-in authentication this should be [username, password]ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowcanDeletename
canDelete(dataSource)
dessIndent
Returns a boolean value for security rights.
prs
Parameters
sIndentdataSourcethe datasourceret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowcanInsertname
canInsert(dataSource)
dessIndent
Returns a boolean value for security rights.
prs
Parameters
sIndentdataSourcethe datasourceret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowcanReadname
canRead(dataSource)
dessIndent
Returns a boolean value for security rights.
prs
Parameters
sIndentdataSourcethe datasourceret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowcanUpdatename
canUpdate(dataSource)
dessIndent
Returns a boolean value for security rights.
prs
Parameters
sIndentdataSourcethe datasourceret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowchangeGroupNamename
changeGroupName(oldGroupName, newGroupName)
dessIndent
Changes the groupname of a group.
Note: this method can only be called by an admin.
prs
Parameters
sIndentoldGroupNamethe old namenewGroupNamethe new nameret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowchangeUserNamename
changeUserName(a_userUID, username)
dessIndent
Changes the username of the specified userUID.
Note: this method can only be called by an admin user or a normal logged in user changing its own userName.
prs
Parameters
sIndenta_userUIDthe userUID to work onusernamethe new usernameret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowcheckPasswordname
checkPassword(a_userUID, password)
dessIndent
Returns true if the password for that userUID is correct, else false.
prs
Parameters
sIndenta_userUIDthe userUID to check the password forpasswordthe new passwordret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowcreateGroupname
createGroup(groupName)
dessIndent
Creates a group, returns the groupname (or null when group couldn't be created).
Note: this method can only be called by an admin.
prs
Parameters
sIndentgroupNamethe group name to createret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowcreateUsername
createUser(username, password)
dessIndent
Creates a new user, returns new uid (or null when group couldn't be created or user alreay exist).
Note: this method can only be called by an admin.
prs
Parameters
sIndentusernamethe usernamepasswordthe user passwordret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowcreateUsername
createUser(username, password, userUID)
dessIndent
Creates a new user, returns new uid (or null when group couldn't be created or user alreay exist).
Note: this method can only be called by an admin.
prs
Parameters
sIndentusernamethe usernamepasswordthe user passworduserUIDthe user UID to useret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowdeleteGroupname
deleteGroup(groupName)
dessIndent
Deletes a group, returns true if no error was reported.
Note: this method can only be called by an admin.
prs
Parameters
sIndentgroupNamethe name of the group to deleteret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowdeleteUsername
deleteUser(userUID)
dessIndent
Deletes an user. returns true if no error was reported.
Note: this method can only be called by an admin.
prs
Parameters
sIndentuserUIDThe UID of the user to be deleted.ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowgetClientIDname
getClientID()
dessIndent
Returns the client ID.
ret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowgetElementUUIDsname
getElementUUIDs(formname)
dessIndent
Returns the form elements UUID's as dataset, the one with no name is the form itself.
prs
Parameters
sIndentformnamethe formname to retieve the dataset forret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowgetGroupsname
getGroups()
dessIndent
Get all the groups (returns a dataset).
first id column is deprecated!, use only the group name column.
Check whatever the user specified as parameter is part of the specified group.
prs
Parameters
sIndentgroupNamename of the group to checkuserUIDUID of the user to checkret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowloginname
login(username, a_userUID, groups)
dessIndent
Login to be able to leave the solution loginForm.
Example: Group names may be received from LDAP (Lightweight Directory Access Protocol) - a standard protocol used in web browsers and email applications to enable lookup queries that access a directory listing.
prs
Parameters
sIndentusernamethe username, like 'JamesWebb'a_userUIDthe user UID to process login forgroupsthe groups arrayret
Returns
sIndentclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowlogoutname
logout()
dessIndent
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
prs
Parameters
sIndentsolutionToLoadthe solution to load after logoutclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowlogoutname
logout(solutionToLoad, method)
dessIndent
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
prs
Parameters
sIndentsolutionToLoadthe solution to load after logoutmethodthe method to run in the solution to loadclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowlogoutname
logout(solutionToLoad, method, argument)
dessIndent
Logout the current user and close the solution, if the solution requires authentication and user is logged in.
You can redirect to another solution if needed; if you want to go to a different url, you need to call application.showURL(url) before calling security.logout() (this is only applicable for Web Client).
An alternative option to close a solution and to open another solution, while keeping the user logged in, is application.closeSolution().
prs
Parameters
sIndentsolutionToLoadthe solution to load after logoutmethodthe method to run in the solution to loadargumentthe argument to pass to the method to runclients
Sets the security settings; the entries contained in the given dataset will override those contained in the current security settings.
NOTE: The security.getElementUUIDs and security.setSecuritySettings functions can be used to define custom security that overrides Servoy security.
For additional information see the function security.getElementUUIDs.
prs
Parameters
sIndentdatasetthe dataset with security settingsclients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowsetTenantValuename
setTenantValue(value)
dessIndent
Set the tenant value for this Client, this value will be used as the value for all tables that have a column marked as a tenant column.
This results in adding a table filter for that table based on that column and the this value.
<p>
This value will be auto filled in for all the columns that are marked as a tenant column.
</p>
<p>
When this is set to a value then all databroadcast from other clients will only be recieved by this client when other clients also have
this tenant value set or from clients with no tenant value set. So be sure that you don't access or depend on data from tenant based tables which are outside of this tenant value.
</p>
prs
Parameters
sIndentvaluethe tenant value used for all tenant columns.clients
Supported Clients
sIndentSmartClient,WebClient,NGClientsam
Sample
sIdentjavascriptlastDetailRowsetUserUIDname
setUserUID(a_userUID, newUserUID)
dessIndent
Set a new userUID for the given userUID.
Note: this method can only be called by an admin.
prs
Parameters
sIndenta_userUIDthe userUID to set the new user UID fornewUserUIDthe new user UIDret