Use search parameters for the Cristin API and return the results
as a tibble. See CristinWrangler
Cristin(
id = NULL,
doi = NULL,
title = NULL,
contributor = NULL,
issn = NULL,
unit = NULL,
institution = NULL,
user = NULL,
category = NULL,
published_since = NULL,
published_before = NULL,
created_since = NULL,
created_before = NULL,
modified_since = NULL,
modified_before = NULL,
year_reported = NULL,
project_code = NULL,
funding_source = NULL,
funding = NULL,
lang = NULL,
page = 1,
per_page = 1000,
max.results = NULL,
no.results = FALSE,
sort = NULL,
filter = NULL,
fields = "all",
open.query = NULL,
all.results = TRUE,
force = FALSE,
remove.duplicates = TRUE,
silent = FALSE,
base.url = "https://api.cristin.no/v2/results",
custom.url = NULL,
use.identifiers = TRUE,
crossref.search = FALSE,
autosearch = TRUE,
zotero = NULL,
zotero.import = TRUE,
zotero.check = TRUE,
remove.na = TRUE,
replace.na = "book",
force.type = NULL,
override = FALSE,
polite = TRUE,
log = list()
)
A list with (exported) items from Cristin
The Cristin id of the result, Default: NULL
DOI name (e.g. doi=10.1000/123456), Default: NULL
The title of the result, Default: NULL
Author's name or Cristin person id, Default: NULL
The issn of the result, Default: NULL
Id (e.g. unit=185.53.18.10), Default: NULL
Id (one number, e.g. institution=185), name or acronym of the institution the contributors belong to, Default: NULL
A person's username in Cristin together with the institution id separated by colon (e.g., `askeladd:185`), Default: NULL
Categories. See category codes, Default: NULL
Results published since and inclusive the given year, (yyyy), Default: NULL
Results published before and inclusive the given year, (yyyy), Default: NULL
Results created since and inclusive the given date, (yyyy-mm-dd), Default: NULL
Results created before and inclusive the given date, (yyyy-mm-dd), Default: NULL
Results modified since and inclusive the given date, (yyyy-mm-dd), Default: NULL
Results modified before and inclusive the given date, (yyyy-mm-dd), Default: NULL
The year a result was reported, Default: NULL
Project code is the internal reference number used by funding source, Default: NULL
Funding source code e.g: NFR, Default: NULL
Funding source code e.g: NFR, and project_code together separated by colon (e.g., NFR:1234), Default: NULL
Two letter language code, Default: NULL
Page number. See pagination, Default: 1
Number of items per page (1000 is max). See pagination, Default: 1000
Do you need a limit?, Default: NULL
Do you need only the number of results?, Default: FALSE
Sorts on `category` and/or `year_published`. See search and sort. Default sort order is on `cristin_result_id` in ascending order, Default: NULL
Vector of cateogries to include in results. See category code, Default: NULL
`fields = all` gives a list of result objects with all available fields. If this parameter is omitted, a list of result summaries with fewer fields will be returned, Default: all
Define your own query terms, Default: NULL
Find all results in query, Default: TRUE
Force is seldom wise, but sometimes..., Default: FALSE
Remove duplicates if TRUE, Default: TRUE
c2z is noisy, tell it to be quiet, Default: FALSE
The base url for the Cristin API, Default: https://api.cristin.no/v2/results
Define your own Cristin API url, Default: NULL
Use if ISBN/DOI identifiers if enabled, Default: TRUE
Query Crossref database based on title, authors, and date if enabled, Default: FALSE
Results could be automatically evaluated (based on some logic) or you could inspect them manually if set to FALSE, Default: TRUE
A list with information on the specified Zotero library (e.g., id, API key, collections, and items), Default: NULL
Use CristinWrangler
to wrangle metadata
into an acceptable format for Zotero, Default: TRUE
Check for Cristin references already stored in Zotero, Default: TRUE
Cristin contains many, more or less, obscure categories, and not all are (yet) supported. By default these are removed, however, if this option is set to FALSE unsupported categories are treated according to replace.na, Default: TRUE
May the odds be in your favor and replace unsupported categories with a predefined itemType if remove.na is set to false, Default: 'book'
Force all items to a predefined itemType, Default: NULL
Put your faith in the algorithms and the identifiers (i.e., DOI/ISBN) and override what is reported in Cristin, Default: FALSE
Please store you email in `.Renviron` to query Crossref, Default: TRUE
A list for storing log elements, Default: list()
Please see #' https://oeysan.github.io/c2z/
# \donttest{
# Simple `Cristin` search by id
example <- Cristin(id = "840998")
# Print index using `ZoteroIndex`
if (any(nrow(example$results))) {
ZoteroIndex(example$results) |>
dplyr::select(name) |>
print(width = 80)
}
# }
Run the code above in your browser using DataLab