Difference between revisions of "Manage user accounts"

From ICA-AtoM
Jump to navigation Jump to search
 
(87 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<span class="pageTitle">Set up and manage user accounts</span>
+
[[Main Page]] > [[User manual]] > [[Administer]] > Manage user accounts
  
[[Main Page]] > [[User manual]] > [[UM-7|UM-7 Administer ICA-AtoM]] > UM-7.2 Set up and manage user accounts
 
  
 +
This section describes how to add, edit, and delete user accounts in your ICA-AtoM application.
  
'''This page is currently being updated and is not yet complete'''
 
  
 +
== Add a new user ==
  
This section describes how to add, edit, and delete user accounts in your ICA-AtoM application.
+
<div class="clearfix">
  
 +
<p>[[Image:adminMenu.png|500px|right|thumb|Fig. 1 In the "Admin" menu, select "Users"]]
  
==Add a new user==
+
<ol>
  
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]].
+
<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]].
  
1. Click the ''admin > users'' tab.
+
<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.
  
2. Click ''add new'' in the [[column header]] or the [[add new button]].
+
</ol>
  
 +
</div>
  
3. ICA-AtoM routes you to a blank data entry screen.
+
<div class="clearfix">
  
 +
<p>[[Image:user.png|500px|right|thumb|Fig. 2 Enter the data in the user edit page, then click "Create"]]
  
4. Enter the user's name.
+
<ol>
  
 +
<li>
  
5. 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>
  
6. 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>
  
7. 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]]. As of the current version of ICA-AtoM you can only register them one at a time, by selecting the role, clicking the ''create'' or ''save'' button and repeating for each additional role.
+
</ol>
*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 Add new group, below.
 
*You can refine user permissions in the groups and permissions [[information area]]: see Refine user permissions, below.
 
  
 +
</div>
  
8. Click the [[create button]] to register the new [[user account]].
+
<div class="clearfix">
 +
</div>
  
 +
For more on [[Glossary#User role|user roles]], see [[user roles]].
  
9. ICA-AtoM creates the new account and routes you to the [[view screen]] (View user profile).
+
<ol>
  
 +
<li>
  
==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 users 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]] for one [[archival institution]] only.
+
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.
+
[[Category:User manual]]

Latest revision as of 15: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.