Skip to first unread message

Jennifer Mürset

Jan 5, 2022, 10:29:46 AM1/5/22
to AtoM Users

I am looking for a mapping for OAI-PMH. Is there somewhere a mapping available for AtoM fields to Dublin Core XML and to EAD 2002 XML elements output? Unfortunately, I have not found anything yet.

Thanks for your support

Best Regards

Dan Gillean

Jan 5, 2022, 12:43:21 PM1/5/22
to ICA-AtoM Users
Hi Jennifer, 

We don't have an updated crosswalk showing all possible standards templates, fields, and their relevant XML fields - we used to maintain spreadsheets like this, but they became very difficult to maintain over time with so many different content standards and export templates. However, I can provide you some links that should give you most of what you need, and a suggestion on how to find the rest. 

First, the data entry pages have some of this information. For example, you can find the ISAD template EAD XML mappings on this page: 
However, the DC XML fields are not crosswalked here. You can see the DC XML mappings on the DC template data entry page: 
I will admit that while I don't think anything major has changed, there have been a couple releases since I have exhaustively gone through all these pages and confirmed they are fully up to date, so please keep this in mind. 

In light of this, one of the best ways to create your own crosswalk is to import one of our sample CSV templates, and then export it in the desired XML format. I've added the relevant ISAD number and field name in each sample CSV template, so when exported as XML, you can easily see how they are rendered.

I've gone ahead and done this in my local test Vagrant instance, and am attaching the results for you, using the ISAD CSV template as the basis. 

There's not an easy way in the UI to to get the OAI identifier of a record, but you can use the following SQL query: 
Replace your-slug-here with the actual slug of your target record. 

For information on how to access the MySQL command prompt, see: 
See also: 
The actual full identifier you will use in an OAI request depends on your OAI settings, as it combines the configured site base URL, OAI repository name you've configured, and the unique OAI identifier automatically generated by AtoM. So for example, in my test instance, though the SQL query above just returned a value like 12345, the value I used in the OAI Get Record query was You can see the Get Record OAI query format here: 
I hope this helps! 

Dan Gillean, MAS, MLIS
AtoM Program Manager
Artefactual Systems, Inc.
he / him

You received this message because you are subscribed to the Google Groups "AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to
To view this discussion on the web visit

Jennifer Mürset

Jan 5, 2022, 4:55:13 PM1/5/22
to AtoM Users
Hi Dan,

Thank you for the detailed answer. It helps a lot.


Reply all
Reply to author
0 new messages