Agile Central - WSAPi: Find Timezone settings for a Workspace and a User

Document ID : KB000057542
Last Modified Date : 11/09/2018
Show Technical Document Details
Introduction:

How to find time zone settings for a particular Workspace?

Which one of the two time zone settings - Workspace or User's - takes precedence?

 

Instructions:
FIND WORKSPACE TIME ZONE FOR USERS WITH NO WORKSPACE ADMINISTRATOR RIGHTS:

A regular user does not have access to the Workspace settings in Setup tab where TimeZone can be viewed and set. Workspace settings are accessible to workspace and subscription administrators only. However a regular user may still read a workspace time zone via Web Services API.

There is a Workspace Configuration attribute on Workspace object in WS API.

A workspace query endpoint that fetches WorkspaceConfiguration looks like this:

https://rally1.rallydev.com/slm/webservice/v2.0/workspace/12345?fetch=WorkspaceConfiguration

In this example 12345 is the ObjectID of the workspace. (See this article on how to find ObjectID of workspace.)

Here is the result of the query, redacted for brevity:
Next, paste the URL of workspaceconfiguration/<ObjectID> in another tab of the same browser window, in this example:
https://rally1.rallydev.com/slm/webservice/v2.0/workspaceconfiguration/12351

Note that the ObjectID of the workspace configuration object is not the same as the ObjectID of its workspace.

Here is the result of the query, redacted for brevity:

{
  • WorkspaceConfiguration: { }

}

TimeZone property of the WorkspaceConfiguration object in this example is set to America/Denver.

FIND WORKSPACE TIME ZONE FOR WORKSACE ADMINISTRATORS:

A workspace administrator may see this setting in Setup tab:

User-added image

User-added image

USER TIME ZONE TAKES PRECEDENCE OVER WORKSPACE TIME ZONE

Your user account's time zone can be set in "My Settings" dialog available from the dropdown menu in the upper right corner of Rally screen:

User-added image

User time zone precedence takes precedence. Per Help documentation on setting a user's time zone:

Select the preferred time zone for your individual location from the drop-down list.
The selected time zone setting displays each place the workspace or project name is displayed and is independent of your computer time.
All date and time fields in Rally reflect your selected time zone.
Any selection other than the Use Default value will override the default settings for the workspace.

 

Additional Information:
Related Links: