Difference between revisions of "OAI manual Set up the harvest"

From Archives Portal Europe Wiki
Jump to: navigation, search
(select the set that you want to harvest)
m (Protected "OAI manual Set up the harvest" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading])
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
To set up the harvest, you just have to follow the instructions displayed on the screen. How does the tool function? It sends the requests to the repository by using the normal [[https://www.openarchives.org/OAI/openarchivesprotocol.html OAI-PMH syntax]] (beginning with the first request: the verb '''''Identify''''') and proposes the choices between the different possibilities offered by the repository as soon as it receives the answers.
+
The content of this page has been integrated into the [https://www.archivesportaleurope.net/tools/for-content-providers/data-preparation/oai-harvester-manual/ website of Archives Portal Europe] now.
 
+
<div>__TOC__<br/><br/></div>
+
== indicate the address of your repository ==
+
 
+
The first question the tool will ask you is the url of the OAI-PMH server. This url or web address must include the prefix: '''''http''''' or '''''https''''', for example: [http://www.gahetna.nl/archievenoverzicht/oai-pmh?verb=Identify http://www.gahetna.nl/archievenoverzicht/oai-pmh]
+
 
+
[[File:APE_OAIHarvester_manual_04.png|600px|thumb|left|OAI Harvester manual, figure 4]]
+
<br clear=all>
+
 
+
The tool then asks you to indicate whether your are using a proxy server. In some network environments access to the internet is secured via a proxy server. If that is the case, then enter the url or web address of the proxy server (ask the administrator of your network environment about this). In case you don't use a proxy server, for example in case you use the tool at home, then you can skip answering this question by pressing the enter key.
+
 
+
[[File:APE_OAIHarvester_manual_05.png|600px|thumb|left|OAI Harvester manual, figure 5]]
+
<br clear=all>
+
 
+
The harvester begins its dialogue with the repository by sending the request verbs and providing the according answers: list of metadata, list of sets, etc.
+
 
+
== select the type of metadata that you want to harvest ==
+
 
+
The tool lists the types of metadata found in the repository and asks you to select one of them:
+
 
+
[[File:APE_OAIHarvester_manual_06.png|600px|thumb|left|OAI Harvester manual, figure 6]]
+
<br clear=all>
+
 
+
In this example, data are provided in three different types of metadata: oai_dc ([http://dublincore.org/specifications/ Dublin Core/XML]), oai_ead (a short basic version of an [https://www.loc.gov/ead/tglib/index.html EAD/XML finding aid]), and oai_ead_full (the complete full version of an [https://www.loc.gov/ead/tglib/index.html EAD/XML finding aid]). Let's choose 3: oai_ead_full.
+
 
+
== select the set that you want to harvest ==
+
 
+
Then the tool lists the datasets found in the repository with the chosen metadata format and gives them an arbitrary number to allow you to choose one.
+
Please note that you can harvest only one dataset at a time, so if you want to harvest everything or more than one dataset, then you have go through this whole process per dataset.
+
 
+
[[File:APE_OAIHarvester_manual_07.png|600px|thumb|left|OAI Harvester manual, figure 7]]
+
<br clear=all>
+
 
+
In this example you have 4 datasets, let's choose 1.
+
 
+
== select the FROM and TO dates ==
+
 
+
== select the harvest method ==
+
 
+
== select the type of records that you want to save ==
+
 
+
== start the harvest ==
+
 
+
== retrieve the files ==
+
 
+
 
+
[[Category:Tools_OAI_Harvester_manual]]
+

Latest revision as of 09:03, 28 October 2022

The content of this page has been integrated into the website of Archives Portal Europe now.