Difference between revisions of "Manage user accounts"

From ICA-AtoM
Jump to navigation Jump to search
 
(66 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Main Page]] > [[User manual]] > [[UM-7|UM-7 Administer ICA-AtoM]] > UM-7.2 Set up and manage user accounts
+
[[Main Page]] > [[User manual]] > [[Administer]] > Manage user accounts
  
  
Line 5: Line 5:
  
  
==Add a new user==
+
== Add a new user ==
  
[[Image:adminMenu.png|500px|right|thumb|In the Admin menu, select Users]]
+
<div class="clearfix">
  
Every user of the system who needs to be able to create, edit or delete [[database content]] must have a [[user account]]. Only [[Administrator|administrators]] can create new [[User account|user accounts]].
+
<p>[[Image:adminMenu.png|500px|right|thumb|Fig. 1 In the "Admin" menu, select "Users"]]  
  
 +
<ol>
  
1. In the [[Glossary#Admin menu|Admin menu]], select Users.
+
<li>
  
 +
Every user of the system who needs to be able to add, edit, or delete [[Glossary#Database content|database content]] must have a [[Glossary#User account|user account]]. Only [[Glossary#Administrator|administrators]] can add new [[Glossary#User account|user accounts]].
  
2. In ''users/groups'' click on ''users'' if it is not already underlined.
+
<li>
  
 +
In the [[Glossary#Admin menu|admin menu]], select "Users" (Fig. 1). This will take you to a list of current [[Glossary#User account|user accounts]].
 +
The List users page has two presentation options: "Show active only" and "Show inactive only" which allow the Administrator to view active users and inactive users in the system.
  
3. Click ''add new'' in the
+
</ol>
  
 +
</div>
  
4. ICA-AtoM routes you to a blank [[edit screen]].
+
<div class="clearfix">
  
 +
<p>[[Image:user.png|500px|right|thumb|Fig. 2 Enter the data in the user edit page, then click "Create"]]
  
5. Enter the user's name.
+
<ol>
  
 +
<li>
  
6. Enter the user's email address; the email address (rather than the user name) is used when logging in.
+
Click "Add new" in the [[Glossary#Button block|button block]] at the bottom of the List users page. ICA-AtoM routes you to a blank [[Glossary#Edit page|edit page]].
  
 +
<li>
  
7. Enter the user's default [[password]]. Note that users can later change their own [[password]] (see [[UM-2.6|UM-2.6 Change password]]).
+
In the "Basic info" [[Glossary#Information area|information area]] enter the following data (Fig. 2):
 +
* In "Username" enter the user's name
 +
* In "Email" enter the user's email address; the email address (rather than the user name) is used when logging in
 +
* In "Password" enter the user's default [[Glossary#Password|password]]. Note that users can later change their own [[Glossary#Password|password]] (see [[change password]]).
 +
* In "Confirm password" enter the [[Glossary#Password|password]] again
 +
* The default is Active (you must deselect to make the user inactive)
  
 +
<li>
  
8. Select the appropriate [[user role]]. The [[user role]] determines the user's [[Access privilege|access privileges]].
+
In the "Access control" [[Glossary#Information area|information area]] Select the appropriate user group (Fig. 2). The user group, or [[Glossary#User role|user role]] determines the user's [[Glossary#Access privilege|access privileges]]. Select the allowed languages for translation.
  
*For more on [[User role|user roles]], see [[UM-2.3|UM-2.3 User roles]].
+
<li>
*Note that you can add multiple [[User role|user roles]] to an account; for example, a user may need both [[editor]] and [[translator]] [[Access privilege|access privileges]].
 
*To remove a [[user role]] from a saved [[user account]], click the [[delete icon]] next to it in the list above the data entry [[field]].
 
*You can create new user roles by adding new groups. See [[UM-7.2#Add_and_edit_groups|Add and edit groups]], below.
 
*You can refine user permissions in the groups and permissions [[information area]]: see [[UM-7.2#Refine_user_permissions|Refine user permissions]], below.
 
  
 +
</ol>
  
9. Click the [[create button]] to register the new [[user account]].
+
</div>
  
 +
<div class="clearfix">
 +
</div>
  
10. ICA-AtoM creates the new account and routes you to the [[view screen]] (View user profile).
+
For more on [[Glossary#User role|user roles]], see [[user roles]].
  
 +
<ol>
  
== Access control ==
+
<li>
  
[[Image:UM-7.2_1.png|500px|right|thumb|Refine user permissions]]
+
You can add multiple [[Glossary#User role|user roles]] to an account; for example, a user may need both [[Glossary#Editor|editor]] and [[Glossary#Translator|translator]] [[Glossary#Access privilege|access privileges]].
  
ICA-AtoM allows an administrator to refine user permissions. For example, if the software is being used for as a [[multi-repository system]], you can restrict the ability of a user to create, update and delete records for only one [[archival institution]].
+
<li>
  
The following example shows how to permit a user to update [[archival description|archival descriptions]] belonging to only one [[archival institution]].
+
Click "Create". ICA-AtoM creates the new account and routes you to the [[Glossary#View page|view page]] (view user profile).
  
 +
<li>
  
1. In the user [[edit screen]], open the groups and permissions [[information area]].
+
The View user profile screen presents the profile, the information object permissions, the actor permissions and the taxonomy permissions as hyperlinks/tabs.
  
 +
<li>
  
2. In the ''action'' [[drop-down menu]] under ''Add a new permission (archival descriptions)'', select "update".
+
You can refine user permissions in the groups and permissions [[Glossary#Information area|information area]], see [[edit permissions]].
  
 +
</ol>
  
3. Under ''grant/deny'' select "deny".
+
<div class="clearfix">
  
 +
<p>[[Image:Userprofile.png|500px|right|thumb|View user profile]]
  
4. Save the record, then re-open the [[edit screen]].
+
</div>
  
 +
== Add a new group ==
  
5. In the ''action'' [[drop-down menu]] under ''Add a new permission (archival descriptions)'', select "update".
+
<ol>
  
 +
<li>
  
6. Under ''grant/deny'' select "deny" select "grant"
+
<p>[[Image:listGroups.png|500px|right|thumb|Fig. 3 Click "Add new" in the column header to add a new group]]
 +
In the [[Glossary#Admin menu|admin menu]], select "Groups". This will take you to a list of current groups. Click "Add new" in the [[Glossary#Column header|column header]] (Fig. 3).
  
 +
<li>
  
7. Under ''repository'' type the first few letters of an [[archival institution]] and then select the institution from the drop-down menu.
+
<p>[[Image:addGroup.png|500px|right|thumb|Fig. 4 Enter data in the edit page, then click "Create"]]
 +
In "Name" enter the name of the group you wish to add (e.g. "Volunteer"). Add a description, then click "Create" (Fig. 4).
  
 +
<li>
  
8. Save the record.
+
<p>At this point you will need to add [[glossary#Access privilege|access privileges]] for this group. For information on how to do that, see [[edit permissions]].
  
 
+
</ol>
The result is that the user is denied the right to update any [[archival description|archival descriptions]] EXCEPT those from the [[archival institution]] that was selected in step 7. Repeat these steps as often as needed until you have refined the user permissions to the desired extent.
 
 
 
Please note that this feature is at a relatively early stage of development in ICA-AtoM 1.0.8. Future versions will allow for adding multiple permissions without having to save the record after each change, and will also allow permissions to be refined for [[authority record|authority records]], [[archival institution|archival institutions]] and other types of records and activities.
 
 
 
<br />
 
 
 
==Add/edit groups==
 
 
 
[[Image:UM-7.2_2.png|500px|right|thumb|Edit screen for a group]]
 
 
 
[[Image:UM-7.2_3.png|500px|right|thumb|The saved group now appears as a selectable user role in the user edit screen]]
 
 
 
If there is a group of users for whom there need to be identical specific, refined permissions, the [[administrator]] may wish to create a group and add users to it, rather than using an existing group (i.e. [[user role]]) and refining the permissions for each user. For example, an archives may have a group of volunteers which it wishes to provide specific, limited permissions that are different from those of other users.
 
 
 
1. Click the ''admin > users'' tab.
 
 
 
 
 
2. In ''users/groups'' click on ''groups'' if it is not already underlined.
 
 
 
 
 
3. Click ''add new'' in the [[column header]].
 
 
 
 
 
4. ICA-AtoM routes you to a blank [[edit screen]].
 
 
 
 
 
5. Enter the name of the group.
 
 
 
 
 
6. Provide a description of what the group is for.
 
 
 
 
 
7. By default, the group will have no permissions and the [[administrator]] needs to create them. See [[UM-7.2#Refine_user_permissions|Refine user permissions]], above. Note that there is no [[view screen]] for groups and saving the record takes the user back the the groups [[list screen]].
 
 
 
 
 
8. Once a group is saved, it becomes a [[user role]] and can be selected in as the [[user role]] in a user account [[edit screen]]. You can add as many users to a group as required.
 
  
  
 
[[Category:User manual]]
 
[[Category:User manual]]

Latest revision as of 16:54, 30 August 2012

Please note that ICA-AtoM is no longer actively supported by Artefactual Systems.
Visit https://www.accesstomemory.org for information about AtoM, the currently supported version.

Main Page > User manual > Administer > Manage user accounts


This section describes how to add, edit, and delete user accounts in your ICA-AtoM application.


Add a new user

Fig. 1 In the "Admin" menu, select "Users"
  1. Every user of the system who needs to be able to add, edit, or delete database content must have a user account. Only administrators can add new user accounts.
  2. In the admin menu, select "Users" (Fig. 1). This will take you to a list of current user accounts. The List users page has two presentation options: "Show active only" and "Show inactive only" which allow the Administrator to view active users and inactive users in the system.

Fig. 2 Enter the data in the user edit page, then click "Create"
  1. Click "Add new" in the button block at the bottom of the List users page. ICA-AtoM routes you to a blank edit page.
  2. In the "Basic info" information area enter the following data (Fig. 2):
    • In "Username" enter the user's name
    • In "Email" enter the user's email address; the email address (rather than the user name) is used when logging in
    • In "Password" enter the user's default password. Note that users can later change their own password (see change password).
    • In "Confirm password" enter the password again
    • The default is Active (you must deselect to make the user inactive)
  3. In the "Access control" information area Select the appropriate user group (Fig. 2). The user group, or user role determines the user's access privileges. Select the allowed languages for translation.

For more on user roles, see user roles.

  1. You can add multiple user roles to an account; for example, a user may need both editor and translator access privileges.
  2. Click "Create". ICA-AtoM creates the new account and routes you to the view page (view user profile).
  3. The View user profile screen presents the profile, the information object permissions, the actor permissions and the taxonomy permissions as hyperlinks/tabs.
  4. You can refine user permissions in the groups and permissions information area, see edit permissions.

View user profile

Add a new group

  1. Fig. 3 Click "Add new" in the column header to add a new group

    In the admin menu, select "Groups". This will take you to a list of current groups. Click "Add new" in the column header (Fig. 3).

  2. Fig. 4 Enter data in the edit page, then click "Create"

    In "Name" enter the name of the group you wish to add (e.g. "Volunteer"). Add a description, then click "Create" (Fig. 4).

  3. At this point you will need to add access privileges for this group. For information on how to do that, see edit permissions.