WebApps:UserAdministration

Available from CoP 10 HF 3.0

The user administration provides a tool to administrate user roles and users. A user itself has no specific permissions. It receives the permissions by getting assigned to one or more user roles. If a user receives different permission levels from different user roles onto the same alement, writing permissions do always overrule reading permissions and reading permissions always overrule if there is no right onto an element at all. That means: If a user receives write permissions from one user role, but is also assigned to a user role with only reading permissions and also to a user role with no permissions at all, the user is permitted to write onto this element.

System requirements

The requirements can be found here.

Invocation

<WebAppUrl of server (replace "+" with Servername/IP address)>/useradministration

Example:

https://server:4443/coplanner/useradministration

Invocation with e.g. Tiles should be done with Session-Variable @Session_WebAppUrl@. e.g.:

@Session_WebAppUrl@/useradministration

Extended Invocation

• hideSessionHeader: Defines if the session header should be visible or not (true fades out the Session-Header). Default while opening is false.

Menu

Button	Action
	Back to last page.
	Open/Close of display text of menu.
	Checkin-/out
	Update of data in the mask
	Basic settings for new and imported user roles (available from CoP 10 HF 3.3)
Error creating thumbnail: File missing	Open overview of permissions (available from CoP 10 HF 3.3)
	Saves all changes
	Deletes the selected element
	Creates new user role
	Creates new user
	Import from the Active Directory
Error creating thumbnail: File missing	Transfer permissions from one user role to another (available from CoP 10 HF 3.3)

Users

The general settings for users can be set here as well as the assignments to the user roles.

Login options

• CoPlanner authentification: The user is created in the CoPlanner System. As a consequence also the password will be set in CoPlanner.
• Windows authentification: The user is also a user within you domain. The password is the same as at the Windows login. It is also possible to logon with a user from another domain/another computer. In this case the credentials have to be entered in the following format: <nameofdomain>\<username>. For example: "mycompanydomain\j.doe". In this case the whole path has to be enterend. The system then tries to logon the user onto that domain.
• SAML authentification: authentification through SAML

Role membership

User roles can be drag and dropped into the Role membership section on the right side below the search window. The role assignments can be deleted with the red x.

Hint  When a user is not assigned to a user role, it is shown in yellow color. (available from CoP 10 HF 3.3)

User roles

The user roles contain the general settings and the detailed permissions.

General Settings

In addition to the name an the description of the user it can be defined if users of this role are allowed to edit scenarios without changing to the powerUser mode.

New elements settings

In this section the default permission settings for dimension elements can be defined. They can be set to write, read or no access. This settings are getting applied initially after the user role has been saved in the first place. If this setttings are modified later on, they apply only for newly created dimensions. For existing dimensions no permissions and default settings will be changed. For exisiting dimensions please use the "2 - Permissions" section.

Members

Members can be assigned from the sidetree via drag and drop. They can be removed via the red x.

Hint: Multiselection (assignment of multiple users to one role or multiple roles to one user at once) (available from CoP 10 HF 3.3)  It is possible to assign more than one user to a role at once and vice versa. The following example describes the assignment of multiple users to one role. 1. Mark the user role of your choice in the sidetree. 2. Now press and hold the CTRL Button and click with the mouse onto a user that you want to assign to the role. (It is IMPORTANT to press the CTRL button, because otherwise a new selection will happen and the target role you want to assign the user to is not shown anymore.) 3. It is now possible to add users to your selection through using the SHIFT or CTRL key + Mouseclicks. 4. When you have finished the selection of the users, you can drag and drop to the right into the memberlist of the role. As an alternative you can just use the treeview on the left. Just mark multiple users of your choice and drag and drop them onto the user role of your choice also on the left side in the treeview.

Hint  When a role has no user assigned to it, it is shown in yellow color. (available from CoP 10 HF 3.3)

Permissions

The permissions are seperated into Shared Objects, Scenarios and all dimensions/subsets.

The shared objects are read only. The scenarios can be set to read and write. The default values are not shown here they are getting defined over the first page of the roles.

Explanation of the overview:

• green checkmark: the permission is set for all elements
• yellow checkmark: the permission is set for only for some of the elements. The tooltip shows how many are available.
• red checkmark: the permission is not set for any element

Additionally to the Read and Write permissions for dimensions also the default for new elements can be defined. If that is for example changed from read to write, users of this role can automatically write onto newly created dimension elements of this structure. Exisiting elements remain unchanged.

A click onto the dimensions name opens a detailview of the structure in which the permissions for every dimensionelement can be modified. In order to change the whole substructure, please click onto elementname and the corresponding symbol next the the search field.

Further menus/functions

Active Directory Import

The menu can be accessed over the Error creating thumbnail: File missing in the side tree. With CoPlanner it is possible to import roles and users from the Active directory. When you click onto the symbol the following window opens.

Error creating thumbnail: File missing

Domain:

Enter the domain from which you want to import the user roles/users into the field "Define the LDAP request here"

Example Domain: wien.company1.com

Please follow this notation: CN=Users, DC=wien, DC=company1, DC=com

A click onto the "Load" button shows the objects from the active directory:

Prefix the user with the domain:

By activating this option the name of the domain in the text field will be inserted in front of the user name when importing users.

Keep role membership:

By activating this option the role membership will be kept when importing users. Otherwise the users will be set up in the system role “everyone”.

Basic settings (available from CoP 10 HF 3.3)

The menu can be accessed over the Error creating thumbnail: File missing button on the left side. The default permissions for new rolres can be set here.

Permission overview (available from CoP 10 HF 3.3)

The menu can be accessed over the Error creating thumbnail: File missing button on the left side. In this menu the permissions per role/users/objects can be viewed. Only combinations excluding full acecess are shown.

Accessible %: In this column the percentage is of the dimensions elements is shown that are generally accessible (reading or writing).

Read-only %: In this column the percentage of the accessable elements are shown that the user has read only permissions for.

Full access %: In this column the percentage of the accessable elements are shown that the user has writing permissions for.

Through clicking onto the three dots a detail area jump is performed. In the detail area the dimension elements are shown and it is also possible to show from which user role the user got permissions to a specific element.