[Archivesspace_Users_Group] Adding a value and translation to a controlled value list

Brad Westbrook brad.westbrook at lyrasis.org
Wed Mar 18 11:53:10 EDT 2015

Hi, Angela,

Here are some step-by-step instructions, clipped from the ArchivesSpace training manual, for changing the translation values for the controlled value lists as Mike describes in his post below.


To change the Translation value, the en.yml file in which translation values are encoded needs to be edited:

[cid:image001.jpg at 01D06172.2F73F940]

Close the ArchivesSpace Application

*         Find the en.yml file in the enums folder.

*         Make a copy of the en.yml file and save it under a slightly different name (e.g., en-defaults.yml) or in a different place.  If necessary, it will be easier to revert to the default en.yml file.

*         Open the en.yml file with a text editor such as Notepad or Wordpad and find the list of values to be edited:

[cid:image002.jpg at 01D06172.2F73F940]

*         Then modify the translation value for an item on the list.  The translation value is the string after the colon:

[cid:image003.png at 01D06172.2F73F940]

*         Launch the ArchivesSpace application.  The new translation value will appear in the controlled value list:

[cid:image004.jpg at 01D06172.2F73F940]

Note:   If your ArchivesSpace application is networked, the database or system administrator will likely need to change the translation values.

From: archivesspace_users_group-bounces at lyralists.lyrasis.org [mailto:archivesspace_users_group-bounces at lyralists.lyrasis.org] On Behalf Of Rush, Michael
Sent: Wednesday, March 18, 2015 8:30 AM
To: Archivesspace Users Group
Subject: Re: [Archivesspace_Users_Group] Adding a value and translation to a controlled value list


Here at the Beinecke we use "Bookseller" as the source relator for all purchases, regardless of whether they are books or not. A large percentage of our accessions (books and manuscripts) are purchases and to us, frankly, it's all the same. Consistency is more important in this case than semantics.

But, to address your actual question, the web application does not have a way to provide the translation for a newly added entry in a controlled value list.  That must be done manually in the en.yml file where all of the "translations" are stored.  There was a logic behind this design decision, I think so that you could have translations into different languages.

Anyway, you need to edit the en.yml file located in the archivesspace\locales\enums directory wherever you have the application installed.  Do note that this is distinct from the en.yml file that is in the archivesspace\locales directory. The former is just for enumerated value lists. The latter is for field labels, tips, and user defined field names, etc.

I hope this helps.

Michael Rush
Accessioning Archivist
Beinecke Rare Book and Manuscript Library
Yale University

The Beinecke Library's building will close for renovation from May 2015 through August 2016. The reading room will close at 4:45 pm on Friday, May 8; the building's public exhibition space will remain open through May 18. A temporary reading room will open in Sterling Memorial Library on Tuesday, May 19, but access to some collections may be limited during the renovation. For details, please visit our renovation website at http://beineckelibraryrenovation.yale.edu/.

From: archivesspace_users_group-bounces at lyralists.lyrasis.org<mailto:archivesspace_users_group-bounces at lyralists.lyrasis.org> [mailto:archivesspace_users_group-bounces at lyralists.lyrasis.org] On Behalf Of Angela Kroeger
Sent: Tuesday, March 17, 2015 4:19 PM
To: archivesspace_users_group at lyralists.lyrasis.org<mailto:archivesspace_users_group at lyralists.lyrasis.org>
Subject: [Archivesspace_Users_Group] Adding a value and translation to a controlled value list

We have an accession that was purchased, not donated. From the accession record, I want to link to the agent record using a role of "Source" and relator of "Seller."

"Seller" wasn't in the drop menu and "Donor" isn't appropriate. "Bookseller" was on the list, but these are papers, not books.

The hover text for the relator term says to see the MARC Code List for Relators. (http://www.loc.gov/marc/relators/relaterm.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__www.loc.gov_marc_relators_relaterm.html&d=AwMFAg&c=-dg2m7zWuuDZ0MUcV7Sdqw&r=YS5hc6Y1lOT1TtyVttLi03AZkslG_CEfkP65BQFGJ3M&m=_wbG2QW8qKs2SmBRPqgzYLnPh-Wobybf0hb0avAcwo0&s=KdnNhOLNZdzvH3Z-xwsfQn_6e0_4agbzTtxZAYH6Jxc&e=>) "Seller" is on that list, so it is valid to add to the ArchivesSpace drop menu.

I tried to add Seller to the controlled value list for Linked Agent Archival Record Relators. When I selected Create Value, it prompted me to input a value, but no translation. I input the value "sll" from the MARC Code List. Now, however, both the value and translation are listed as "sll" with no apparent means to change the translation to "Seller."

I am tempted to delete that and add Seller as the value, so it will also be the translation that displays to staff and the public, but I know that is the wrong solution. The existing values all use the MARC 3-letter codes, and the existing translations all use the natural language terms. I would think that I should be able to follow that established pattern.

What am I doing wrong?

Thank you!

Angela Kroeger
akroeger at unomaha.edu<mailto:akroeger at unomaha.edu>
Archives and Special Collections Associate
Dr. C.C. and Mabel L. Criss Library
University of Nebraska at Omaha
(402) 554-4159

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20150318/37bb75f3/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.jpg
Type: image/jpeg
Size: 12867 bytes
Desc: image001.jpg
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20150318/37bb75f3/attachment.jpg>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.jpg
Type: image/jpeg
Size: 32989 bytes
Desc: image002.jpg
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20150318/37bb75f3/attachment-0001.jpg>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image003.png
Type: image/png
Size: 11488 bytes
Desc: image003.png
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20150318/37bb75f3/attachment.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image004.jpg
Type: image/jpeg
Size: 13367 bytes
Desc: image004.jpg
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20150318/37bb75f3/attachment-0002.jpg>

More information about the Archivesspace_Users_Group mailing list