Accessions¶

Add a new accession record¶

1. In the main menu located in the header bar, click the “Add” menu and select “Accession records” from the drop-down menu.

2. AtoM takes you to an accession record edit page screen for data entry. If you have the Accession mask enabled, then the Accession number field will be automatically assigned a Unique ID based on the mask settings - for more information, see: Accession mask. If the mask setting is turned off, the field will be empty. Add a unique value to the Accession number field or make edits to the pre-populated one as needed.

Tip

Administrators can turn the accession mask on or off, and alter the default accession mask and counter (from which the accession number is generated) by navigating to Admin > Settings > Accession mask. For more information, see: Accession mask and Enable accession mask in Settings - see also the example provided in the section on altering the accessions mask for legacy accessions, below.

3. If you attempt to use a value for the Accession number that is not unique (i.e. is already in use by another accession record), AtoM will provide a warning, and will not allow the record to be saved until the Accession number is edited and a unique value is added.

4. The accession record edit template provides a variety of field types for data entry (e.g., calendar, free-text, pop-up dialogs and drop-downs). Remember to click on each information area to access the data entry fields grouped under it. Enter data as required (further information on filling out specific parts of the accession record is included below).
5. Click the “Create” button in the button block to create and save the new accession record. If you do not want to keep the record you can click the “Cancel” button and remove the record.

Back to top

Add alternative identifiers to your accession¶

In addition to the primary accession number, you can also add additional alternative identifiers from the edit page of an accession record. This can be useful for capturing legacy identifiers, transfer IDs, conservation treatment numbers, barcodes, and more. You can add multiple alternative identifers, and each can be assigned a type (using terms managed as a user-editable controlled vocabulary in a taxonomy) and an accompanying free-text descriptive note.

In the Edit accession record screen, under the Accession number field (located at the top of the edit page), click the text reading “Add alternative identifier(s)”. AtoM will display new fields below the accession number:

There are three fields available per identifier:

• Type: A term or phrase that characterizes the nature of the identifier.
• Identifier: A code that is assigned to the material to support identification in the course of processes and activities such as acquisition, transfer, ingest, and conservation.
• Note: Additional information about the identifier, including contextual information on the purpose of the identifier.

The “Type” field is a drop-down menu containing controlled vocabulary terms. It’s not possible to add new terms in this screen, but users with sufficient access permissions can modify and delete existing terms, and add new terms as needed, via Manage > Taxonomies.

Tip

The taxonomy controlling the values available in the Type field is called “Accession alternative identifier type.” In new installations, the only default term included is “Accession alternative identifier.” For more information on how to add, edit, and delete terms in a taxonomy, see:

• Terms

The “Identifier” field on the right, and the larger “Note” field below it, are both free-text fields.

You can also add multiple identifiers as needed. Click the “Add new” link in the bottom of the alternative identifier widget, and a new set of fields will appear:

When you’re done, you can continue data entry elsewhere in the accession record edit page as needed. Remember to scroll down and click the Save button in the button block at the bottom of the page when you’re done with your edits!

Back to top

Add a donor¶

In the Edit accession record screen, under the Donor/Transferring body area you can enter the names and contact information for related donors using the donor dialog. Click the “Add new” button to open the Donor dialog and add a new donor.

In the donor dialog that will pop-up, the Name field at the top of the dialog is an autocomplete field. To link to an existing donor record, begin typing the name of the related Donor into the Name field - as you type, matches will appear in a drop-down menu below the field and you can click on a name there to select it. Alternatively, you can create a new donor record by typing a new name, and completing the other related fields in the Donor dialog.

Fields in the donor dialog are organized into 3 tabs - Main, Physical location, and Other details. Be sure to click on each tab and complete the related fields in the dialog as needed. Fields available in the donor dialog include:

• Name - an autcomplete field where you can link to an existing donor record or enter a new name to create a new donor record.
• Main tab:
  • Contact person
  • Telephone
  • Fax
  • Email
  • URL
• Physical location tab:
  • Street address
  • Region/province
  • Country
  • Postal code
  • City
  • Latitude
  • Longitude
• Other details tab:
  • Contact type
  • Note

When new information is entered into the donor dialog, a new Donor record is created. Alternatively, if you have selected an existing donor using the autcomplete values in the Name field, you can edit the existing contact information.

Donor records can be accessed via the main menu by navigating to Manage > Donors.

Tip

Donor records can be created and managed separately from accession records. For a full explanation of donors, go to the Donor records page

Back to top

Add rights to an accession record¶

After an accession record is created, you may add a rights record to it by clicking “More” then “Create new rights” in the button block at the bottom of the accession record’s view page.

The rights entry page will appear. Multiple rights basis and granted rights can be added. For a full explanation of rights, go to the Rights page.

Back to top

Link an accession record to an archival description¶

Users have the option of linking a new accession record with an existing archival description in the AtoM database. The Archival description information area is located at the bottom of the accession record edit page.

Placing the cursor in the data field will activate a drop-down list of all archival descriptions entered into the database. The User selects the appropriate archival description by moving through the list (a blue highlight will indicate which record you are selecting). Then Save the record by clicking “Save” in the button block at the bottom of the accession edit page.

Tip

Users can link an accession record to a fonds/collection level archival description or lower levels of description including sous- fonds, series, sub-series, and files. You can link to multiple archival descriptions as needed by repeating the steps above.

Back to top

View the accession record¶

After creating an accession record, save your new data by clicking “Save” in the button block at the bottom of the accession record edit page (A user also has the option of clicking “Cancel”, but all data entered will be lost), you can review the data in the accession record view page.

Notice that the linked archival description is now presented as a hyperlink in the accession record.

In the button block at the bottom of the screen you have the option(s) to:

• Edit the accession record
• Add an accrual to the accession
• Create an archival description from the accession
• Delete an accession record
• Under the “More button” you have the option to Add rights to an Accession record

Tip

You can always return to your accession record later via the main menu, by navigating to Manage > Acessions and selecting a record from the accessions browse page

Back to top

Link an accession to a physical storage container¶

In addition to supporting a free-text “Location information” field in the main accession record edit page, AtoM also supports the ability to link an accession record to a physical storage container. One accession record can be linked to many storage containers, just as one physical storage container can be linked to many accession records and archival descriptions.

For detailed instructions on how to link physical storage containers to accession records, see:

• Link physical storage

Edit an existing accession record¶

Existing accession records can be upated at any time by a logged-in user with edit privileges.

1. Navigate to the record you want to edit. You can do this via the main menu in the AtoM header bar, by clicking on Manage > Accessions. For more information on navigation in AtoM, see: Access content
2. AtoM will redirect you to the accession record browse page. Select the record you want by clicking on the hyperlink Identifier. You can also search for an accession record with the accession records search box located at the bottom of the browse page. For more information on searching for accession records in AtoM, see: Searching for accession records.

Tip

Archival descriptions that are created from an accession record will have a hyperlink to their related accession record. The hyperlink is located in the “Accession” information area at the bottom of the archival description view page.

Logged-in users with permissions can select the hyperlink accession record identifier and AtoM will take them to the related accession record view page. Unauthenticated users (i.e. those who are not logged in) will not be able to see the Accessions area; logged-in Users without permissions can see the hyperlink but cannot access the accession record.

3. Once you have selected an accession record, you will be redirected to the selected record’s view page. To enter edit mode, you can either click the “Edit” button in the button block at the bottom of the view page, or click on any of the information area headings in the accession record. The accession record will reload in edit mode.

4. On loading, the edit page displays the record with all information areas closed; click on an information area to access the fields grouped under it.
5. Add or edit data as required
6. To discard all changes, click the “Cancel” button in the button block; AtoM returns you to the view page, with no changes saved.
7. To save your changes, click the “Save” button in the button block. AtoM will reload the page in view mode, with all changes saved, so you can review your work.

Back to top

Add an accrual¶

An accrual is “an acquisition additional to a unit of description already held by a repository” (ISAD glossary). AtoM users with edit permissions can add an accrual to an existing accession record. To do so:

1. Navigate to the accession record to which you would like to add an accrual. Instructions on how to do so are outlined above in Edit an existing accession record.
2. When you have selected the accession record, scroll to the bottom of the view page and click the “Add accrual” button in the button block.

3. You will be redirected to an accession record edit page, but but at the top of the edit template a message will read: “You are creating an accrual of the accession YYY-MM-DD/#.” (where YYYY-MM-DD/# represents the Accession number to which you are adding an accrual)

4. The edit template provided for the accrual is the same as that of a new accession record. Add data as required. See Add a new accession record above for more information on working with the accession record template.
5. After completing the new accrual information in the edit page, click on “Create” in the button block at the bottom of the page. Your new data will be saved, and you will be redirected to a view page where you can review your work.
6. When viewing the accession record for the accrual, you will notice that in the Administrative information area an “Accrual to” data field shows the related original accession record. The data is a hyperlink that can be clicked to navigate to the original accession record.

7. Alternatively, if a User views the original accession record, in the Administrative area an “Accruals” data field shows the related accrual.

Back to top

Add a legacy accession record¶

Users who have recently migrated to AtoM, or are catching up on a backlog of accessions, may need to add new accession records that have older dates encoded in the accession number. There are several ways this can be done in AtoM - however, the first two require that a user have administrator access to the application.

Method 2: Altering the Accessions mask¶

Users interested in creating an accession record that has a legacy accession number associated with it via the AtoM user interface, can do so by first editing the Accessions mask in the Admin > Settings > Global area, and then creating a new accession record.

By default, AtoM creates the accession record identifier as a unique number compiled from [YEAR MONTH DAY Incremental#] - this is denoted in the Global settings “Accession mask” as %Y-%m-%d/#i. A fixed value can be entered for any of the date variables (year, month, day) used in the accession mask, to create a number of legacy accessions from the same year and month, for example.

EXAMPLE

To create a number of accessions from October 1998, an administrator could edit the Accession mask like so: 1998-10/#i

If the changes are saved in Admin > Settings > Global, then when a user next creates a new accession record, the accession number will read:

• 1998-10/1

And the following accession record’s identifier (accession number) will read:

• 1998-10/2

Warning

These changes will stay in effect until an administrator returns to the global settings menu via Admin > Settings > Global and returns the Accession mask to the default setting. Don’t forget to do this, or all your new accessions will appear to be legacy accessions!

Method 3: Disabling the Accessions mask¶

The accessions mask is provided to help users apply consistent and unique identifiers to accessions. Users always have the ability to edit the pre-populated values provided by the accessions mask when creating a new accession record.

However, when working with legacy accessions, it may be easier to simply disable the accessions mask, and manually populate the Accession number field. An administrator can do this via Admin > Settings - for more information, see: Accession mask and Enable accession mask in Settings.

Note that, even with the Accessions mask disabled, AtoM will still attempt to enforce unique Accession number values. If you attempt to use a value for the Accession number that is not unique (i.e. is already in use by another accession record), AtoM will provide a warning, and will not allow the record to be saved until the Accession number is edited and a unique value is added.

Back to top

Create an archival description from an accession record¶

After you create a new accession record, you can create an archival description by clicking on the button “Create Archival description” in the button block.

Archival descriptions can be generated from an accession record at any time; it does not have to be at the time of creation. To create an archival description from an existing accession record, follow the first steps outlined in Edit an existing accession record to browse existing accession records and select the one that you would like to use.

The accession record is not aimed at end-user description, but AtoM provides the option to create an archival description from an accession record to prevent uneccessary re-entry of existing data an improve a user’s workflow. The following archival description fields inherit the data entered into the accession record:

• Title
• Name of creator(s)
• Archival/custodial history
• Scope & content
• Physical condition

Name access points (drawn from creators) and Rights added to the accession record are also inherited into the archival description.

When you navigate to the accession record you want to work with:

1. Scroll to the bottom of the accession record’s view page.
2. Click the “Create archival description” button located in the button block.

3. AtoM will generate an archival description using the fields listed above, and then will take you to the new description’s view page. You can see that the data you entered into the accession record fields: title, name of creator, archival/custodial history, scope & content and physical condition are all inherited into the archival description. If you added rights to the accession they are also inherited.
4. The new archival description is saved as a draft record - the title of the new description is derived from the data entered into the title field of the originating accession record.
5. The archival description can now be edited by clicking on the “Edit” button in the button block at the bottom of the description’s view page. For more information on editing an archival description, see: Edit an existing archival description.
6. A link to the original accession record is maintained in the Accession information area in the archival description. Similarly, a link to the archival description is added to the related accession record. These are hyperlinks; clicking them in either record will take the user to the related record.

Back to top

Delete an accession record¶

To delete an accession record in AtoM:

1. Navigate to the accession record you want to delete. You can locate all accessions in AtoM by clicking on “Manage” in the main menu (located in the AtoM header bar) and selecting “Accessions” from the drop-down menu. For more information on navigation in AtoM, see Access content. For more information on locating accession records in AtoM, see the Edit an existing accession record section above.
2. Scroll to the bottom of the selected accession record’s view page, where the button block is located.

3. If you click on the “Delete” button, AtoM will offer a warning. If the accession has accruals associated with it this will be noted in the warning message - accruals will not be deleted with an accession, and must be deleted separately
4. If you choose to proceed and click “Confirm” the entire accession record will be permanently deleted. Clicking “Cancel” will return a user to the accession record view page.

Back to top