blob: bc1bbca1352812968093ee8f763e367b55cbeea1 [file] [log] [blame]
Marc Kupietz6ddece42023-12-18 17:02:36 +01001% Generated by roxygen2: do not edit by hand
2% Please edit documentation in R/textMetadata.R
3\name{textMetadata,KorAPConnection-method}
4\alias{textMetadata,KorAPConnection-method}
5\alias{textMetadata}
6\title{Retrieve metadata for a text, identified by its sigle (id)}
7\usage{
8\S4method{textMetadata}{KorAPConnection}(kco, textSigle, verbose = kco@verbose)
9}
10\arguments{
11\item{kco}{\code{\link[=KorAPConnection]{KorAPConnection()}} object (obtained e.g. from \code{new("KorAPConnection")})}
12
13\item{textSigle}{unique text id (concatenation of corpus, document and text ids, separated by \code{/}, e.g. ) or vector thereof}
14
15\item{verbose}{logical. If \code{TRUE}, additional diagnostics are printed. Defaults to \code{kco@verbose}.}
16}
17\value{
Marc Kupietz3687a8c2024-01-24 16:18:36 +010018Tibble with columns for each metadata property. In case of errors, such as non-existing texts/sigles, the tibble will also contain a column called \code{errors}.
19If there are metadata columns you cannot make sense of, please ignore them. The function simply returns all the metadata it gets from the server.
Marc Kupietz6ddece42023-12-18 17:02:36 +010020}
21\description{
22Retrieves metadata for a text, identified by its sigle (id) using the corresponding KorAP API
23(see \href{https://github.com/KorAP/Kustvakt/wiki/Service:-Metadata-Retrieval}{Kustvakt Wiki}).
24}
25\examples{
26\dontrun{
27new("KorAPConnection") \%>\% textMetadata(c("WUD17/A97/08542", "WUD17/B96/57558", "WUD17/A97/08541"))
28}
29
30}