[Archivesspace_Users_Group] importing EAD files

Fri Nov 22 14:40:37 EST 2019

Also, the EADChecker web service mentioned in the same article is still around – it’s not exhaustive, but it should find _most_ potential errors that will cause ingest to fail, and output them in a slightly easier to manage format than the ASpace job reports.

https://eadchecker.lib.harvard.edu/

--
Dave Mayo (he/him)
Senior Digital Library Software Engineer
Harvard University > HUIT > LTS

From: <archivesspace_users_group-bounces at lyralists.lyrasis.org> on behalf of "Bowers, Kate A." <kate_bowers at harvard.edu>
Reply-To: Archivesspace Users Group <archivesspace_users_group at lyralists.lyrasis.org>
Date: Friday, November 22, 2019 at 1:28 PM
To: Archivesspace Users Group <archivesspace_users_group at lyralists.lyrasis.org>
Subject: Re: [Archivesspace_Users_Group] importing EAD files

At the end of our article “The Devil’s Shoehorn” https://journal.code4lib.org/articles/12239<https://urldefense.proofpoint.com/v2/url?u=https-3A__journal.code4lib.org_articles_12239&d=DwMFAg&c=WO-RGvefibhHBZq3fL85hQ&r=_Mv1dY22K7jvT5MD7xjbvGVzRDOUMhx4WYcnPSIzYnE&m=UYgSr48CMGfdnE2OBnDCgUOF6ZGFT7F93N86ouIBqMs&s=oAkg7CTdK3RJH2XKEqrnv77KtXvrjCZ3lFgcFvx6Wxo&e=> there is an appendix of problems. Many of these are valid EAD that don’t import.  It is listed by EAD element name. Things may have changed but this at least is a starting-point checklist.

Kate

From: archivesspace_users_group-bounces at lyralists.lyrasis.org <archivesspace_users_group-bounces at lyralists.lyrasis.org> On Behalf Of Sharp, Jennifer
Sent: Friday, November 22, 2019 12:24 PM
To: 'Archivesspace Users Group' <archivesspace_users_group at lyralists.lyrasis.org>
Subject: Re: [Archivesspace_Users_Group] importing EAD files

Thank you so much, Mark! This is immensely helpful. I know the standards have changed since our process was hacked together seven or eight years ago, so I’m not at all surprised I will have to make some updates. I appreciate the links – I will definitely take some time to read through the info.

Jennifer

---
Jennifer Sharp, MSI
Archivist, Hartford History Center
Hartford Public Library
jsharp at hplct.org<mailto:jsharp at hplct.org>
o: 860.695.6332
c: 860.929.6915

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 Custer, Mark
Sent: Friday, November 22, 2019 11:44 AM
To: Archivesspace Users Group <archivesspace_users_group at lyralists.lyrasis.org<mailto:archivesspace_users_group at lyralists.lyrasis.org>>
Subject: Re: [Archivesspace_Users_Group] importing EAD files

Jennifer,

Thanks, this helps a lot!

It looks like there are couple of required elements missing from this file for ArchivesSpace to be able to import it.  Though your file is valid EAD, ArchivesSpace requires all resources to have things like a title, date, extent, as well as a distinct unitid element (which this file is missing).  So, you’d need to add a unitid element, like so:

            <unitdate encodinganalog="245$f" label="Dates: ">1861-1946</unitdate>
            <unitid>Distinct Call Number</unitid>
            <physdesc encodinganalog="300$a" label="Extent:">
                <extent>20 linear feet</extent>
 <!—total aside, but you might also want to change “linear feet” to “linear_feet” with an underscore, otherwise ArchivesSpace will create a duplicate linear feet value in the extent dropdown list, since the ASpace EAD importer uses the database values of those controlled value lists rather than the translation values -->
            </physdesc>

Additionally, all of the lower-level components must have, at the very least, a title OR a date.

In this case, it looks like all of your series have “unitid” elements instead of “unittitle” elements.  But if you change this for all of your series:

<c01 level="series">
                      <did>
                          <unitid>Volumes</unitid>
                      </did>
…

To:

<c01 level="series">
                      <did>
                          <unittitle>Volumes</unittitle>
                      </did>
…

Then you should be good to go with that particular file (see the attached file as an example).

If you have access to an XML Editor like oXygen, check out https://campuspress.yale.edu/yalearchivesspace/2015/07/22/validation-scenarios/<https://urldefense.proofpoint.com/v2/url?u=https-3A__campuspress.yale.edu_yalearchivesspace_2015_07_22_validation-2Dscenarios_&d=DwMF-g&c=WO-RGvefibhHBZq3fL85hQ&r=wwc_Z_TbmWbPFh7My2zRxmrGgCNO-71Fwzlmd8YZVUY&m=fobQAKVcaChp_HywR3zLuL8uJVPJv0gjOBCcg_lf2-w&s=12m7aIC-XzrrGQ_favhMHSgtSPGCpQdESiRUKnLQRbA&e=>.  Regardless, though, my guess is that if you address that “archdesc/unitid” issue and the series-level did/unitid --> did/unittitle issue, that should help with the majority of your files.  There are also other possibilities, like updating the EAD so that you get normalized dates in addition to textual date expressions, but that requires quite a bit more work.

I hope that helps,

Mark

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 Sharp, Jennifer
Sent: Friday, 22 November, 2019 10:30 AM
To: Archivesspace Users Group <archivesspace_users_group at lyralists.lyrasis.org<mailto:archivesspace_users_group at lyralists.lyrasis.org>>
Subject: Re: [Archivesspace_Users_Group] importing EAD files

I have attached one of the files I used earlier this week. The job completed, but when I tried it this morning – both locally and on test.archivesspace.org – it failed.

This, from Tuesday, can’t be too promising:
[cid:image001.jpg at 01D5A138.A1124FB0]

These are today’s errors:
[cid:image002.jpg at 01D5A138.A1124FB0]

Thanks,
Jennifer

---
Jennifer Sharp, MSI
Archivist, Hartford History Center
Hartford Public Library
jsharp at hplct.org<mailto:jsharp at hplct.org>
o: 860.695.6332
c: 860.929.6915

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 Custer, Mark
Sent: Friday, November 22, 2019 9:34 AM
To: Archivesspace Users Group <archivesspace_users_group at lyralists.lyrasis.org<mailto:archivesspace_users_group at lyralists.lyrasis.org>>
Subject: Re: [Archivesspace_Users_Group] importing EAD files

Jennifer,

If you can share a sample EAD file that isn’t uploading, someone might be able to pinpoint the issue that way if the error is in fact due to the file itself.

Additionally, have you tried uploading the file to http://test.archivesspace.org/staff/<https://urldefense.proofpoint.com/v2/url?u=https-3A__nam05.safelinks.protection.outlook.com_-3Furl-3Dhttp-253A-252F-252Ftest.archivesspace.org-252Fstaff-252F-26data-3D02-257C01-257Cmark.custer-2540yale.edu-257Cff5643fd5017466b5f8908d76f60e72f-257Cdd8cbebb21394df8b4114e3e87abeb5c-257C0-257C1-257C637100334298265006-26sdata-3DDwxHX-252FXhjTqTjJ8bw-252FBQ-252BLChOQhHM1piTGBdw0nygLQ-253D-26reserved-3D0&d=DwMF-g&c=WO-RGvefibhHBZq3fL85hQ&r=wwc_Z_TbmWbPFh7My2zRxmrGgCNO-71Fwzlmd8YZVUY&m=fobQAKVcaChp_HywR3zLuL8uJVPJv0gjOBCcg_lf2-w&s=piitAMTBJCwX6zb8Id1PKrJOD7bMciAqJf0254HQMJA&e=>?  If you can upload it successfully there without any additional changes, the error could possibly be due to your setup.

Mark

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 Blake Carver
Sent: Friday, 22 November, 2019 8:56 AM
To: Archivesspace Users Group <archivesspace_users_group at lyralists.lyrasis.org<mailto:archivesspace_users_group at lyralists.lyrasis.org>>
Subject: Re: [Archivesspace_Users_Group] importing EAD files

Have a look for errors in your archivesspace.out log file, there could be some clues there.
________________________________
From: archivesspace_users_group-bounces at lyralists.lyrasis.org<mailto:archivesspace_users_group-bounces at lyralists.lyrasis.org> <archivesspace_users_group-bounces at lyralists.lyrasis.org<mailto:archivesspace_users_group-bounces at lyralists.lyrasis.org>> on behalf of Sharp, Jennifer <jsharp at hplct.org<mailto:jsharp at hplct.org>>
Sent: Friday, November 22, 2019 8:40 AM
To: Archivesspace Users Group <archivesspace_users_group at lyralists.lyrasis.org<mailto:archivesspace_users_group at lyralists.lyrasis.org>>
Subject: Re: [Archivesspace_Users_Group] importing EAD files

Thanks for replying, Miloche and Erhan. Unfortunately, I still haven’t had any luck. These are some old files, so I’m thinking there may be some glitches with the EAD. I’m going to try entering a short one manually and then comparing the code.

Thanks again,

Jennifer

---

Jennifer Sharp, MSI

Archivist, Hartford History Center

Hartford Public Library

jsharp at hplct.org<mailto:jsharp at hplct.org>

o: 860.695.6332

c: 860.929.6915

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 Kottman, Miloche
Sent: Thursday, November 21, 2019 1:36 PM
To: Archivesspace Users Group <archivesspace_users_group at lyralists.lyrasis.org<mailto:archivesspace_users_group at lyralists.lyrasis.org>>
Subject: Re: [Archivesspace_Users_Group] importing EAD files

Jennifer,

When this happens to us, it is usually because the user forgot to change the Import Type to EAD prior to Adding the file they want to import.

On the New Background Job – Import Data page, click on the down arrow and choose EAD.  Then either click on Add file to use windows explorer to find the EAD record or drag the record into the framed white-space.

[cid:image003.jpg at 01D5A138.A1124FB0]

--Miloche

••••••••••••••••••••••••••••••

Miloche Kottman

Head of Cataloging & Archival Processing

University of Kansas Libraries

Lawrence, KS 66045

mkottman at ku.edu<mailto:mkottman at ku.edu>

785-864-3916

From: archivesspace_users_group-bounces at lyralists.lyrasis.org<mailto:archivesspace_users_group-bounces at lyralists.lyrasis.org> <archivesspace_users_group-bounces at lyralists.lyrasis.org<mailto:archivesspace_users_group-bounces at lyralists.lyrasis.org>> On Behalf Of Sharp, Jennifer
Sent: Thursday, November 21, 2019 8:47 AM
To: 'archivesspace_users_group at lyralists.lyrasis.org' <archivesspace_users_group at lyralists.lyrasis.org<mailto:archivesspace_users_group at lyralists.lyrasis.org>>
Subject: [Archivesspace_Users_Group] importing EAD files

Hello,

My library and I are brand new to ArchivesSpace and I am learning as I go along. I’ve encountered an issue I hope is known and/or has a fairly straightforward solution. I have followed the instructions in the user manual for importing EAD files, and upon notification of a successful import and refreshing the page, there are no links in the new records section. I have tried this a few times (different days), with two files. If there is something technically wrong with one file, though, it’s likely to be the same with the other. I’ve also considered it could be something related to our setup. I’d be grateful for any suggestions you may have!

Thanks,

Jennifer

---

Jennifer Sharp, MSI

Archivist, Hartford History Center

Hartford Public Library

jsharp at hplct.org<mailto:jsharp at hplct.org>

o: 860.695.6332

c: 860.929.6915

CAUTION: This email originated from outside of the organization. Do not click links, open attachments, or provide sensitive information unless you recognize the sender and know the content/source is safe.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20191122/64531daf/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.jpg
Type: image/jpeg
Size: 11911 bytes
Desc: image001.jpg
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20191122/64531daf/attachment-0003.jpg>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.jpg
Type: image/jpeg
Size: 3642 bytes
Desc: image002.jpg
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20191122/64531daf/attachment-0004.jpg>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image003.jpg
Type: image/jpeg
Size: 18072 bytes
Desc: image003.jpg
URL: <http://lyralists.lyrasis.org/pipermail/archivesspace_users_group/attachments/20191122/64531daf/attachment-0005.jpg>