Skip to content

Users

On the users tab you can:

  • see all users
  • create new users
  • enable/disable users
  • see who is active
  • logout users
  • delete users
  • manage security groups

Managing users and groups

Adding users

You can add individual user accounts using the Add new user menu option. We recommend using securitySheet for managing all users and groups and automatic syncrhonization into TM1.

img

Modifying user groups

Click any user to modify their security groups and perform user actions. Use checkboxes to specify user's groups. By default the selected groups are displayed first, so if you select a new group it will move to the top. To change this behaviour click the Group header to order groups by name:

img

You can access user action menu by clicking the three dots button at the top right corner. Depending on the user current status, the menu will contain the following options:

  • Delete user
  • Logout user (available for active users only)
  • Disable user (available for enabled users only)
  • Enable user (available for disabled users only)
  • Impersonate user

Copy to clipboard

Click the user name to copy it to clipboard

Disabling users

You can disable all non-admin users from the users menu or you can disable individual users by clicking the Disable user menu option on the user screen. This option does not show up if a user is disabled. The option is greyed out if the selected user belongs to ADMIN security group.

TIP

The Disable non-admin users feature is handy when you want to deploy a release, reload some big dimensions or do any other tasks and you would like to prevent object locking by possible users interactions.

Enabling users

You can enable all disabled users from the users menu or you can enable individual users by clicking the Enable user menu option on the user screen. The option does not show up if the selected user is enabled.

Copying user groups

You can copy/paste groups from one user to another one, which will replace all the tager user groups.

img

TIP

When you click Copy user groups, the group list is also copied to your clipboard so you can paste it in a sheet or as a text anywhere.

Deleting users

Use the Delete menu to delete the user

Logging out users

Use the Logout menu option on the user screen to logout the selected user. The option is displayed for active users only.

Impersonating users

Use the Impersonate menu to impersonate the selected user. When you impersonate a user, you can see cubes and dimensions (on the model tab), dimension elements in the subset editor as the selected user. The exploration data will also be refreshed based on the impersonated user credentials. In addition, the impersonate icon will be displayed at the top, you can click the icon to disable impersonification:

img

Security sheet

When defining a ::tm1env you can specify -securitySheet parameter and indicate the sheet which you want to synchronize users, groups and assignments from. By default TeamOne will look for user IDs in column 1 (groups shoud follow after the user ID column) and will skip 1 header row. This can be customized by specifying the -startRow and -startColumn parameters. If the -securityRecreate parameter is checked, TeamOne will delete all non-admin users first, then will recreate all users and setup their group assignments. Once you configure -securitySheet, the sync security option will become available in the sidebar menu:

img

The easiest way to make a users sheet is to use the Create security sheet option, which will insert a new sheet and add all users & groups there. You will just need to set the sheet name as the securitySheet option value.

img

Using Google Sheets Data > Data validation feature it is possible to create a group dropdown by selecting your group list range:

img

img

Now you can search and assign groups from a dropdown:

img

"Hierarchy-like" group dropdowns

You can prepend spaces to your group names so they appear like a hierarchy in dropdowns. TeamOne will automatically trim all spaces when updating the security in TM1.

If using namespace in ::tm1env definition, you can prepend the user IDs with namespace/ and add semicolons at the end (TeamOne will strip it when creating/updating users in TM1). This will allow you to add all users to a Cognos group in one shot using the type method. Do not use CAMIDs in user ID column.

img

New users and groups

New users and groups will be created if they do not exist.

Access

Use Data > Protected sheets and ranges to give certain users (usually some managers) access to update users and groups.

See sheetName parameter example

See Users and groups sheet example

TM1 Top

Users threads

You can open TM1 top from the sidebar menu. It displays all users sessions, including info about the used interface (Architect, TM1Web or REST API) and what they are doing at the moment. For instance, if someone is executing a process, you will be able to see the process name and the execution time.

img

Killing threads

You can click a user thread to cancel it.

Security tracer

Using TeamOne Security tracer you can quickly and easily troubleshoot users access and instantly get the full picture of TM1 cube, dimension, hierarchy, element and data security. Simply select a user and a cube cell and TeamOne will show and explain the user's security level.

img

TM1USER() function

TeamOne Security tracer may produce incorrect results if using TM1USER() function in security cube rules, since it will be evaluated to the current account used to login from TeamOne.

}CubeProperties

Currently TeamOne Security tracer does not support CELLSECURITYMOSTRESTRICTIVE and CELLSECURITYDEFAULTVALUE values set in }CubeProperties cube. Though those settings are rarely used in IBM PA projects, we will be adding it in the future TeamOne versions.