Difference between revisions of "Add/edit terms"

From ICA-AtoM
Jump to navigation Jump to search
Line 6: Line 6:
  
 
[[Image:um3-5Taxonomy.png|500px|right|thumb|Drop-down value lists draw terms from taxonomies]]
 
[[Image:um3-5Taxonomy.png|500px|right|thumb|Drop-down value lists draw terms from taxonomies]]
 
  
 
Throughout ICA-AtoM, [[Glossary#Controlled vocabulary|controlled vocabularies]] are used to generate drop-down [[Glossary#Value list|value lists]] to restrict data entry in certain fields to certain values. ICA-AtoM stores these values as [[Glossary#Term|term]] records in the database, and assigns them to [[Glossary#Taxonomy|taxonomies]].  
 
Throughout ICA-AtoM, [[Glossary#Controlled vocabulary|controlled vocabularies]] are used to generate drop-down [[Glossary#Value list|value lists]] to restrict data entry in certain fields to certain values. ICA-AtoM stores these values as [[Glossary#Term|term]] records in the database, and assigns them to [[Glossary#Taxonomy|taxonomies]].  
Line 12: Line 11:
 
*E.g. the "Type of entity" field of an [[Glossary#Authority record|authority record]] can take only one of ''Corporate body, Person, Family''. Each of these values is a [[Glossary#Term|term]] assigned to the "Actor entity types" [[Glossary#Taxonomy|taxonomy]].
 
*E.g. the "Type of entity" field of an [[Glossary#Authority record|authority record]] can take only one of ''Corporate body, Person, Family''. Each of these values is a [[Glossary#Term|term]] assigned to the "Actor entity types" [[Glossary#Taxonomy|taxonomy]].
  
ICA-AtoM ships with a fixed number of [[Glossary#Taxonomy|taxonomies]] containing default values ([[Glossary#Term|terms]]). Some [[Glossary#Term|terms]] are '''locked''', i.e. cannot be deleted or edited, because they are accessed by the application's code. Most [[Glossary#Term|terms]] can be edited or deleted and all [[Glossary#Taxonomy|taxonomies]] can be assigned new [[Glossary#Term|terms]] in addition to any locked values.
+
ICA-AtoM ships with a fixed number of [[Glossary#Taxonomy|taxonomies]] containing default values ([[Glossary#Term|terms]]). Some [[Glossary#Term|terms]] are '''locked''', i.e. cannot be deleted or edited, because they are accessed by the application's underlying code. Most [[Glossary#Term|terms]], however, can be edited or deleted, and all [[Glossary#Taxonomy|taxonomies]] can be assigned new [[Glossary#Term|terms]] in addition to any locked values.
 +
 
 +
*Note that users (even [[Glossary#Administrator|administrators]]) '''cannot''' add new [[Glossary#Taxonomy|taxonomies]]; the number and names of [[Glossary#Taxonomy|taxonomies]] are fixed and can only be altered by [[Glossary#Developer|developers]] working directly with the code.
  
This page describes how to edit [[Glossary#Taxonomy|taxonomies]] by adding, editing or deleting their [[Glossary#Term|terms]].
 
  
For detailed notes on individual fields, see the following pages:
+
This page describes how to edit [[Glossary#Taxonomy|taxonomies]] by adding, editing or deleting their [[Glossary#Term|terms]]. Note that you must have at least [[Glossary#Editor|editor access privileges]] to edit [[Glossary#Taxonomy|taxonomies]]. For detailed notes on individual fields, see the following pages:
 
*[[UM-3.5.1|Data entry: terms]].
 
*[[UM-3.5.1|Data entry: terms]].
  

Revision as of 14:18, 5 June 2008

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.

Edit taxonomies (terms)

Main Page > (UM) User manual > UM-3 Add / edit content > UM-3.5 Edit taxonomies (terms)

Overview

Drop-down value lists draw terms from taxonomies

Throughout ICA-AtoM, controlled vocabularies are used to generate drop-down value lists to restrict data entry in certain fields to certain values. ICA-AtoM stores these values as term records in the database, and assigns them to taxonomies.

  • E.g. the "Type of entity" field of an authority record can take only one of Corporate body, Person, Family. Each of these values is a term assigned to the "Actor entity types" taxonomy.

ICA-AtoM ships with a fixed number of taxonomies containing default values (terms). Some terms are locked, i.e. cannot be deleted or edited, because they are accessed by the application's underlying code. Most terms, however, can be edited or deleted, and all taxonomies can be assigned new terms in addition to any locked values.


This page describes how to edit taxonomies by adding, editing or deleting their terms. Note that you must have at least editor access privileges to edit taxonomies. For detailed notes on individual fields, see the following pages:

For exiting edit mode (return to the view mode), see the following page:


Add a term to a taxonomy

Create a new description
Create a new description

1. Click the Add / edit tab on the Main menu bar.


2. Click the "Archival description" sub-tab on the Main menu bar; ICA-AtoM takes you to the List screen showing all existing archival descriptions.


3. Click the Add new text that appears in the "Name" column header or the Add new button at the foot of the list; ICA-AtoM creates a new record and routes you to a blank Edit screen for data entry.


4. Enter data (see Data entry: archival descriptions for detailed explanations and notes on fields).


5. Click the Save button to commit the new record.


6. Note that the behaviour of the Cancel button changes after you first click the Save button.

  • Before the first save, "Cancel" = "delete the new record" (i.e. do not commit).
  • After the first save, the record is committed. A Delete button now appears for deleting, while "Cancel" = "do not commit the data entered since the last save".


Edit an existing description

Edit an existing description
File:Um3-1Edit2.png
Edit an existing description


1. Navigate to the description you want to delete.

  • For more information on navigation in ICA-AtoM, see in this manual: Access content.


2. Switch from View mode to Edit mode by clicking the Record title bar or Edit button; this takes you to the Edit screen. It displays the record with all record areas closed; click on an area to access the fields grouped under it.


3. Add / revise data as required (see Data entry: archival descriptions) for detailed explanations and notes on fields).


4. To discard all changes, click the Cancel button; ICA-AtoM returns you to the View screen, with no changes saved.


5. To save changes, click the Save button; ICA-AtoM commits the changes and re-loads the page.

  • Note that re-loading the page causes all record areas to close; this behaviour will be revised in a future release of ICA-AtoM (e.g. page will stay open as it was before save).


Delete an existing description

File:Um3-1Delete.png
Delete an existing description

To delete an archival description:


1. Navigate to the description you want to delete.

  • For more information on navigation in ICA-AtoM, see in this manual: Access content.


2. Switch from View mode to Edit mode by clicking the Record title bar or Edit button; this takes you to the Edit screen.


3. Click the Delete button.


4. ICA-AtoM prompts you to confirm the delete request; click "OK".


5. ICA-AtoM deletes the record and returns you to the List screen.


6. Note the following consequences of deleting an archival description:

  • If the record has lower-level descriptions registered to it (is a "parent record"), all the lower-level records are also deleted - e.g. if you delete a series, any sub-series, files or items that belong to the series will also be deleted.
  • Any date events associated with the description are deleted.


Last revised: 2 June 2008 (ICA-AtoM v0.6)



Last revised: 2 June 2008 (ICA-AtoM v0.6)