This function is used in Python Scripting.

Description

This function returns a mapping of roster names to a list of usernames contained in the roster.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.alarm.getRosters()

  • Parameters

Nothing

  • Returns

Dictionary[String, List[String]] A dictionary that maps roster names to a list of usernames in the roster. The list of usernames will be empty if no users have been added to the roster.

  • Scope

Gateway, Vision Client, Perspective Session

Code Examples
Code In Action - Listing All the Users in a Roster from a Vision Client
# This script will get all the rosters and list the users in them.
rosters = system.alarm.getRosters()
for key, values in rosters.iteritems():
	# key is the roster name, values is a dict of usernames
	print 'Roster', key, 'contains these users:'
	for value in values:
		print '  ', value
Code In Action - Listing All the Users in a Roster from a Perspective Session
# This script will get all the rosters and list the users in them.
rosters = system.alarm.getRosters()
for key, values in rosters.iteritems():
	# key is the roster name, values is a dict of usernames
	system.perspective.print('Roster ' + key + ' contains these users:')
	for value in values:
		system.perspective.print('  ' + value)
Output
Roster Admins contains these users:
   admin
Roster Supervisors contains these users:
   asmith
   jdoe

Keywords

system alarm getRosters, alarm.getRosters