get_records.Rd

% Generatedbyroxygen2:donoteditbyhand
% PleaseeditdocumentationinR/get_record.R
\name{get_records}
\alias{get_records}
\title{Getrecords}
\usage{
get_records(
ids,
prefix="oai_dc",
url="http://api.gbif.org/v1/oai-pmh/registry",
as="parsed",
...
)
}
\arguments{
\item{ids}{TheOAI-PMHidentifierfortherecord.Oneormore.Required.}

\item{prefix}{specifiesthemetadataformatthattherecordswillbe
returnedin.Default: \code{oai_dc}}

\item{url}{(character) OAI-PMHbaseurl.DefaultstotheURLfor
arXiv's OAI-PMH server (http://export.arxiv.org/oai2)
or GBIF'sOAI-PMH server (http://api.gbif.org/v1/oai-pmh/registry)}

\item{as}{(character) Whattoreturn.Oneof"parsed" (default),
or"raw" (rawtext)}

\item{...}{Curloptionspassedonto \code{\link[httr]{GET}}}
}
\value{
anamedlistofdata.frame's, or lists, or raw text
}
\description{
Get records
}
\details{
There are some finite set of results based on the OAI prefix.
We will provide parsers as we have time, and as users express interest.
For prefix types we have parsers for we return a list of data.frame's,
foreachidentifier, onedata.frameforthe \code{header} bitsofdata, and
onedata.frameforthe \code{metadata} bitsofdata.

Forprefixeswedon't have parsers for, we fall back to returning raw
XML, so you can at least parse the XML yourself.

Because some XML nodes are duplicated, we join values together of
duplicated node names, separated by a semicolon (\verb{;}) with no
spaces. You can seprarate them yourself easily.
}
\examples{
\dontrun{
get_records("87832186-00ea-44dd-a6bf-c2896c4d09b4")

ids <- c("87832186-00ea-44dd-a6bf-c2896c4d09b4", 
 "d981c07d-bc43-40a2-be1f-e786e25106ac")
(res <- get_records(ids))
lapply(res, "[[", "header")
lapply(res, "[[", "metadata")
do.call(rbind, lapply(res, "[[", "header"))
do.call(rbind, lapply(res, "[[", "metadata"))

# Get raw text
get_records("d981c07d-bc43-40a2-be1f-e786e25106ac", as = "raw")

# from arxiv.org
get_records("oai:arXiv.org:0704.0001", url = "http://export.arxiv.org/oai2")
}
}