Introduction
This section helps us to have a general overview of the general
collection in Finna. For this purpose we use a separate function
fetch_finna. This document demonstrates the use of the
fetch_finna function to retrieve data from the Finna API
with various queries and parameters.
Example 1: Fetching EAD Records
EAD records refer to archival descriptions encoded using the Encoded Archival Description (EAD) standard, an XML-based framework designed to describe archival materials, collections, and finding aids in a structured, machine-readable format.
Purpose of EAD Records
EAD records provide detailed information about archival collections, enabling better organization, discovery, and access to historical and cultural resources stored in archives, libraries, and museums.
What EAD Records Contain
An EAD record typically includes metadata such as:
-
Collection Title: Name of the archival
collection.
-
Creator(s): Person(s) or organization(s)
responsible for the collection.
-
Dates: Time period covered by the materials.
-
Extent: Size or physical description (e.g., number
of boxes or folders).
-
Scope and Content: Overview of what the collection
contains.
-
Biographical/Historical Note: Background on the
creator or related historical context.
-
Arrangement: How the materials are organized.
-
Access and Use Conditions: Restrictions or
guidelines for accessing the materials.
- Container List: Detailed inventory of items or series in the collection.
library(finna)
result <- fetch_finna(
query = "record_format:ead",
limit = 0,
facets = "building",
lng = "fi",
prettyPrint = TRUE
)
print(result)## # A tibble: 3 × 4
## value translated count href
## <chr> <chr> <int> <chr>
## 1 0/KA/ Kansallisarkisto 2060481 ?lookfor=recor…
## 2 0/KOTUS/ Kotimaisten kielten keskus 683 ?lookfor=recor…
## 3 0/siirtolaisuusinstituutti/ Siirtolaisuusinstituutti 1526 ?lookfor=recor…Example 2: Fetching EAD3 Records
library(finna)
result <- fetch_finna(
query = "record_format:ead3",
limit = 0,
facets = "building",
lng = "fi",
prettyPrint = TRUE
)
print(result)## # A tibble: 12 × 4
## value translated count href
## <chr> <chr> <int> <chr>
## 1 0/AALTOARKISTO/ Aalto-yliopiston arkisto 51656 ?lookfor=re…
## 2 0/hka/ Helsingin kaupunginarkisto 321291 ?lookfor=re…
## 3 0/NLF/ Kansalliskirjasto 78724 ?lookfor=re…
## 4 0/kansan_arkisto/ Kansan Arkisto 215758 ?lookfor=re…
## 5 0/merkki/ Median museo ja arkisto Merkki 10973 ?lookfor=re…
## 6 0/pta/ Porvarillisen Työn Arkisto 22965 ?lookfor=re…
## 7 0/FINLIT/ Suomalaisen Kirjallisuuden Seura 32995 ?lookfor=re…
## 8 0/elka/ Suomen Elinkeinoelämän Keskusarkisto 498432 ?lookfor=re…
## 9 0/SCA/ Svenska centralarkivet 13299 ?lookfor=re…
## 10 0/SLS/ Svenska litteratursällskapet i Finland 68969 ?lookfor=re…
## 11 0/tyovaen_arkisto/ Työväen Arkisto 261044 ?lookfor=re…
## 12 0/fsd/ Yhteiskuntatieteellinen tietoarkisto 2320 ?lookfor=re…More Metadata Formats in Finna can be found in the link here.