Skip to main content
Version: 7.9


This function is used in Python Scripting.


Returns a PyDataSet holding information about all of the sessions (logged-in users) on the Gateway. Optional regular-expression based filters can be provided to filter the username or the username and the project returned.

The PyDataSet returned has these columns:

  • username (String)
  • project (String)
  • address (String)
  • isDesigner (Boolean)
  • clientId (String)
  • creationTime (Date)

Note that this function will not return all sessions across a cluster - only the cluster node that is being communicated with by the client who makes the call.

New in 7.9.9


This function accepts keyword arguments.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.


system.util.getSessionInfo([usernameFilter] [, projectFilter])


StringusernameFilterA regular-expression based filter string to restrict the list by username. [optional]
StringprojectFilterA regular-expression based filter string to restrict the list by project [optional]


PyDataSet - A dataset representing the Gateway's current sessions.



Code Examples

Example #1
# This code would get the entire table of sessions and put it in an adjacent table
table = event.source.parent.getComponent("Table")
sessions = system.util.getSessionInfo() = system.db.toDataSet(sessions)
Example #2
# This code would count the number of times a user named "billy" is logged in
sessions = system.util.getSessionInfo("billy")
system.gui.messageBox("Billy has %d sessions" % len(sessions))
Example #3
# This code would return session info on all users starting with the letters "bi"
sessions = system.util.getSessionInfo("bi.*")
Example #4
# This code uses a single character wildcard in the username
sessions = system.util.getSessionInfo("")
Example #5
# This code would return session info on a user named "bill.smith"
sessions = system.util.getSessionInfo("bill\.smith")