Defining role assignment report URLs

Create a report URL that outputs role assignments in communities.

Before you begin

To retrieve information about the roles in a community, you must be a community administrator for that community.

About this task

Report URLs for role assignments use the assignRoleActivity report path.

Reports that contain role assignment information include the following optional parameters:
Table 1. assignRoleActivity: Optional parameters
Parameter Acceptable parameter values Description
tid
  • Role that is assigned to a user - 140
  • Role that is removed from a user - 141
  • Role that is assigned to a user group - 142
  • Role removed from a user group - 143
Limits output to a specific activity type. Use only the number, for example tid=140. If not defined, then all valid activities will be used.
uid Identifer for a user in a community Limits output to a specific user that performed the activity
tuid Identifer for a user in a community Limits output to a target user, or the user that was assigned the role. This cannot be used with a UGUID parameter
uguid Identifier for the target user group Limits output to a target user group, or the user group that was assigned the role. This cannot be used with the TUID parameter
rid Identifier for the role Limits output to activity about a specific role
fromTime A UNIX timestamp (the number of seconds since January 1, 1970, 00:00:00 GMT) Defines a the starting time of a time range.
toTime A UNIX timestamp (the number of seconds since January 1, 1970, 00:00:00 GMT) Defines the ending time for a time range
modifiedSince You must use the format: yyyy-MM-dd'T'HH:mm:ss.SSSZ to specify the date since modifications have been made (year-month-dayThour:minutes:seconds.SimpleDateFormat where SimpleDateFormat is milliseconds (S) and timezone (Z)). For example: 2010-06-07T00:00:00.000-0500 Defines the starting time since modifications have been made. Use the modifiedSince parameter when creating report URLs for Rational Insight data warehousing, where you have to return changes that have happened since the last time information was added to the data warehouse.
Note: You can find the identifier values for UID, TUID, UGID, and RID parameters by observing the URL while administrating a community.

Results

The role assignment report returns activity information plus the following data:

Example

Use the following example URL to help you construct the report URL to retrieve role activities information for a specific role.

http://example.com:9080/ram.ws/reporting/assignRoleActivity:rid=1003

Feedback