zotero-db/translators/US National Archives Research Catalog.js

{
	"translatorID": "f8b5501a-1acc-4ffa-a0a5-594add5e6bd3",
	"label": "US National Archives Research Catalog",
	"creator": "Philipp Zumstein",
	"target": "^https?://catalog\\.archives\\.gov/",
	"minVersion": "3.0",
	"maxVersion": "",
	"priority": 100,
	"inRepository": true,
	"translatorType": 4,
	"browserSupport": "gcsibv",
	"lastUpdated": "2023-01-17 18:26:20"
}

/*
	***** BEGIN LICENSE BLOCK *****

	Copyright © 2017 Philipp Zumstein
	
	This file is part of Zotero.

	Zotero is free software: you can redistribute it and/or modify
	it under the terms of the GNU Affero General Public License as published by
	the Free Software Foundation, either version 3 of the License, or
	(at your option) any later version.

	Zotero is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	GNU Affero General Public License for more details.

	You should have received a copy of the GNU Affero General Public License
	along with Zotero. If not, see <http://www.gnu.org/licenses/>.

	***** END LICENSE BLOCK *****
*/


function detectWeb(doc, url) {
	if (url.includes('/id/')) {
		return "book";
		// something like archival material would be more appropriate...
		// but for now we use this type to save some information
	}
	// multiples will not work easily because the API will then return
	// somehow an empty json, thus we skipped this here.
	return false;
}


async function doWeb(doc, url) {
	let position = url.indexOf('/id/');
	let id = url.substr(position + 4);
	let jsonURL = `https://catalog.archives.gov/proxy/advanced-search?naId_is=${id}&allowLegacyOrgNames=true`;
	let json = (await requestJSON(jsonURL)).body.hits.hits[0]._source.record;

	let item = new Zotero.Item("book");
	item.title = json.title;
	var creators = [];
	if (json.creators) {
		creators.push(...json.creators);
	}
	if (json.ancestors) {
		for (let ancestor of json.ancestors) {
			if (ancestor.creators) {
				creators.push(...ancestor.creators);
			}
		}
	}
	for (var i = 0; i < creators.length; i++) {
		creators[i] = creators[i].heading.replace('(Most Recent)', '');
		if (creators[i].includes(", ")) {
			creators[i] = creators[i].replace(/, \d{4}\s*-\s*(\d{4})?$/, '').replace(/\([^(]+\)/, '');
			item.creators.push(ZU.cleanAuthor(creators[i], "author", true));
		}
		else {
			creators[i] = creators[i].replace(/\.? ?\d\d?\/\d\d?\/\d\d\d\d-\d\d?\/\d\d?\/\d\d\d\d/, '');
			if (creators[i].length > 255) {
				creators[i] = creators[i].substr(0, 251) + '...';
			}
			item.creators.push({ lastName: creators[i].trim(), creatorType: 'author', fieldMode: true });
		}
	}
	if (json.coverageStartDate) {
		item.date = json.coverageStartDate.logicalDate.replace('-01-01', '');
		// Use issued if we have a date range
		if (json.coverageEndDate) {
			item.extra = 'issued: ' + item.date + '/'
				+ json.coverageEndDate.logicalDate.replace('-12-31', '');
		}
	}
	else {
		item.date = json.date;
	}
	if (json.ancestors.length) {
		item.series = json.ancestors[0].title;
	}
	item.abstractNote = json.scopeAndContentNote;
	if (json.physicalOccurrences) {
		for (let p of json.physicalOccurrences) {
			if (p.referenceUnits.length && p.referenceUnits[0].name) {
				item.archive = p.referenceUnits[0].name.replace(/\[.*\]/, '');
				break;
			}
		}
	}
	item.archiveLocation = json.localIdentifier;
	item.extra = (item.extra || '') + '\nNational Archives Identifier: ' + json.naId;
	
	item.complete();
}

/** BEGIN TEST CASES **/
var testCases = [
	{
		"type": "web",
		"url": "https://catalog.archives.gov/id/486076",
		"items": [
			{
				"itemType": "book",
				"title": "The Struggle for Trade Union Democracy, December 1947",
				"creators": [
					{
						"lastName": "Supreme Commander for the Allied Powers. Economic and Scientific Section. Director for Labor. Labor Division",
						"creatorType": "author",
						"fieldMode": true
					}
				],
				"date": "1945",
				"archive": "National Archives at College Park - Textual Reference",
				"extra": "issued: 1945/1952\nNational Archives Identifier: 486076",
				"libraryCatalog": "US National Archives Research Catalog",
				"series": "Records of Allied Operational and Occupation Headquarters, World War II",
				"attachments": [],
				"tags": [],
				"notes": [],
				"seeAlso": []
			}
		]
	},
	{
		"type": "web",
		"url": "https://catalog.archives.gov/id/5496901",
		"items": [
			{
				"itemType": "book",
				"title": "Alien Case File for Francisca Torre Vda De Garcia",
				"creators": [
					{
						"lastName": "Department of Justice. Immigration and Naturalization Service",
						"creatorType": "author",
						"fieldMode": true
					}
				],
				"abstractNote": "This file consists of an alien case file for Francisca Torre Vda De Garcia.  Date of birth is listed as 10/10/1901.  Country is listed as Cuba.  Port of Entry is Miami, Florida.  Date of entry is 03/08/1973.  Father is listed as Zotero.  Mother is listed as Candita.  Alias name is listed as Francisca Torres.",
				"archive": "National Archives at Kansas City",
				"archiveLocation": "A20229735/085-08-0653/Box 186",
				"extra": "National Archives Identifier: 5496901",
				"libraryCatalog": "US National Archives Research Catalog",
				"series": "Records of U.S. Citizenship and Immigration Services",
				"attachments": [],
				"tags": [],
				"notes": [],
				"seeAlso": []
			}
		]
	},
	{
		"type": "web",
		"url": "https://catalog.archives.gov/id/603604",
		"items": [
			{
				"itemType": "book",
				"title": "Manuscripts and Notes",
				"creators": [
					{
						"firstName": "Harriet C.",
						"lastName": "Brown",
						"creatorType": "author"
					}
				],
				"abstractNote": "This series contains book drafts and correspondence.",
				"archive": "Herbert Hoover Library",
				"extra": "National Archives Identifier: 603604",
				"libraryCatalog": "US National Archives Research Catalog",
				"series": "Harriet Connor Brown Papers",
				"attachments": [],
				"tags": [],
				"notes": [],
				"seeAlso": []
			}
		]
	}
]
/** END TEST CASES **/